sboulahtit/orion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3c2b559282cf98d9beb8d92c34f63db1a29b7e45
orion/scripts/seed/create_default_content_pages.py
Samir Boulahtit 3c2b559282 fix: consolidate CMS page seed scripts and fix 3 bugs 
- Fix `ContentPage.store_id is None` (Python identity check, always
  False) → use `.is_(None)` for proper SQLAlchemy NULL filtering
- Create pages for ALL platforms instead of only OMS
- Merge create_platform_pages.py into create_default_content_pages.py
  (5 overlapping pages, only platform_homepage was unique)
- Delete redundant create_platform_pages.py
- Update Makefile, install.py, and docs references

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-14 21:18:47 +01:00

648 lines
22 KiB
Python
Executable File
Raw Blame History

#!/usr/bin/env python3
"""
Create Default Platform Content Pages (CMS)
This script creates platform-level default content pages for ALL platforms.
Pages include:
- Platform Homepage (platform marketing page)
- About Us
- Contact
- FAQ
- Shipping Policy
- Return Policy
- Privacy Policy
- Terms of Service
Pages are created per-platform (unique constraint: platform_id + store_id + slug).
Stores can override any of these pages with their own custom content.
Prerequisites:
- Database migrations must be applied
- content_pages table must exist
- Platforms must exist (run init_production.py first)
Usage:
python scripts/seed/create_default_content_pages.py
# Or with make:
make create-cms-defaults
"""
import sys
from datetime import UTC, datetime
from pathlib import Path
# Add project root to path
project_root = Path(__file__).parent.parent
sys.path.insert(0, str(project_root))
import contextlib
from sqlalchemy import select
from sqlalchemy.orm import Session
# Register all models with SQLAlchemy so string-based relationships resolve
for _mod in [
"app.modules.billing.models",
"app.modules.inventory.models",
"app.modules.cart.models",
"app.modules.messaging.models",
"app.modules.loyalty.models",
"app.modules.catalog.models",
"app.modules.customers.models",
"app.modules.orders.models",
"app.modules.marketplace.models",
"app.modules.cms.models",
]:
with contextlib.suppress(ImportError):
__import__(_mod)
from app.core.database import SessionLocal
from app.modules.cms.models import ContentPage
from app.modules.tenancy.models import Platform
# ============================================================================
# PLATFORM HOMEPAGE (is_platform_page=True)
# ============================================================================
PLATFORM_HOMEPAGE = {
"slug": "platform_homepage",
"title": "Welcome to Our Multi-Store Marketplace",
"content": """
<p class="lead">
Connect stores with customers worldwide. Build your online store and reach millions of shoppers.
</p>
<p>
Our platform empowers entrepreneurs to launch their own branded e-commerce stores
with minimal effort and maximum impact.
</p>
""",
"meta_description": "Leading multi-store marketplace platform. Connect with thousands of stores and discover millions of products.",
"meta_keywords": "marketplace, multi-store, e-commerce, online shopping, platform",
"show_in_footer": False,
"show_in_header": False,
"is_platform_page": True,
"template": "modern",
"display_order": 0,
}
# ============================================================================
# DEFAULT STORE CONTENT PAGES (is_platform_page=False)
# ============================================================================
DEFAULT_PAGES = [
{
"slug": "about",
"title": "About Us",
"content": """
<div class="prose-content">
<h2>Welcome to Our Platform</h2>
<p>We are a multi-store e-commerce platform connecting quality sellers with customers worldwide.</p>
<h3>Our Mission</h3>
<p>To empower independent businesses and artisans by providing them with the tools and platform they need to reach customers globally.</p>
<h3>What We Offer</h3>
<ul>
<li>Curated selection of quality products from verified stores</li>
<li>Secure payment processing and buyer protection</li>
<li>Fast and reliable shipping options</li>
<li>Dedicated customer support</li>
</ul>
<h3>Our Values</h3>
<ul>
<li><strong>Quality:</strong> We work only with stores who meet our quality standards</li>
<li><strong>Transparency:</strong> Clear pricing, policies, and communication</li>
<li><strong>Customer First:</strong> Your satisfaction is our priority</li>
<li><strong>Innovation:</strong> Continuously improving our platform and services</li>
</ul>
</div>
""",
"meta_description": "Learn about our mission to connect quality stores with customers worldwide",
"meta_keywords": "about us, mission, values, platform",
"show_in_footer": True,
"show_in_header": True,
"display_order": 1,
},
{
"slug": "contact",
"title": "Contact Us",
"content": """
<div class="prose-content">
<h2>Get in Touch</h2>
<p>We're here to help! Reach out to us through any of the following channels:</p>
<h3>Customer Support</h3>
<p>For questions about orders, products, or general inquiries:</p>
<ul>
<li><strong>Email:</strong> support@example.com</li>
<li><strong>Phone:</strong> 1-800-EXAMPLE (Mon-Fri, 9am-6pm EST)</li>
<li><strong>Live Chat:</strong> Available on our website during business hours</li>
</ul>
<h3>Business Inquiries</h3>
<p>Interested in becoming a store or partnering with us?</p>
<ul>
<li><strong>Email:</strong> stores@example.com</li>
</ul>
<h3>Office Address</h3>
<p>
123 Commerce Street<br>
Suite 456<br>
City, State 12345<br>
United States
</p>
<h3>Response Time</h3>
<p>We typically respond to all inquiries within 24 hours during business days.</p>
</div>
""",
"meta_description": "Contact our customer support team for assistance with orders, products, or inquiries",
"meta_keywords": "contact, support, customer service, help",
"show_in_footer": True,
"show_in_header": True,
"display_order": 2,
},
{
"slug": "faq",
"title": "Frequently Asked Questions",
"content": """
<div class="prose-content">
<h2>Frequently Asked Questions</h2>
<h3>Orders & Shipping</h3>
<h4>How do I track my order?</h4>
<p>Once your order ships, you'll receive a tracking number via email. You can also view your order status in your account dashboard.</p>
<h4>How long does shipping take?</h4>
<p>Shipping times vary by store and destination. Most orders arrive within 3-7 business days. See our <a href="/shipping">Shipping Policy</a> for details.</p>
<h4>Do you ship internationally?</h4>
<p>Yes! We ship to most countries worldwide. International shipping times and costs vary by destination.</p>
<h3>Returns & Refunds</h3>
<h4>What is your return policy?</h4>
<p>Most items can be returned within 30 days of delivery. See our <a href="/returns">Return Policy</a> for complete details.</p>
<h4>How do I request a refund?</h4>
<p>Contact the store directly through your order page or reach out to our support team for assistance.</p>
<h3>Payments</h3>
<h4>What payment methods do you accept?</h4>
<p>We accept all major credit cards, PayPal, and other secure payment methods.</p>
<h4>Is my payment information secure?</h4>
<p>Yes! We use industry-standard encryption and never store your full payment details.</p>
<h3>Account</h3>
<h4>Do I need an account to make a purchase?</h4>
<p>No, you can checkout as a guest. However, creating an account lets you track orders and save your preferences.</p>
<h4>How do I reset my password?</h4>
<p>Click "Forgot Password" on the login page and follow the instructions sent to your email.</p>
</div>
""",
"meta_description": "Find answers to common questions about orders, shipping, returns, and more",
"meta_keywords": "faq, questions, help, support",
"show_in_footer": True,
"show_in_header": False,
"display_order": 3,
},
{
"slug": "shipping",
"title": "Shipping Policy",
"content": """
<div class="prose-content">
<h2>Shipping Policy</h2>
<h3>Shipping Methods</h3>
<p>We offer multiple shipping options to meet your needs:</p>
<ul>
<li><strong>Standard Shipping:</strong> 5-7 business days</li>
<li><strong>Express Shipping:</strong> 2-3 business days</li>
<li><strong>Overnight Shipping:</strong> Next business day</li>
</ul>
<h3>Shipping Costs</h3>
<p>Shipping costs are calculated based on:</p>
<ul>
<li>Package weight and dimensions</li>
<li>Destination address</li>
<li>Selected shipping method</li>
</ul>
<p>Free standard shipping on orders over $50!</p>
<h3>Processing Time</h3>
<p>Orders are typically processed within 1-2 business days. You'll receive a confirmation email when your order ships with tracking information.</p>
<h3>International Shipping</h3>
<p>We ship to most countries worldwide. International shipping times vary by destination (typically 7-21 business days).</p>
<ul>
<li>Customs fees and import duties are the responsibility of the recipient</li>
<li>International orders may be subject to customs inspection</li>
</ul>
<h3>Tracking</h3>
<p>All orders include tracking. You can monitor your package status through:</p>
<ul>
<li>Your account dashboard</li>
<li>Email notifications</li>
<li>Carrier tracking website</li>
</ul>
<h3>Delivery Issues</h3>
<p>If you experience any delivery issues, please contact us within 7 days of the expected delivery date.</p>
</div>
""",
"meta_description": "Learn about our shipping methods, costs, and delivery times",
"meta_keywords": "shipping, delivery, tracking, international",
"show_in_footer": True,
"show_in_header": False,
"display_order": 4,
},
{
"slug": "returns",
"title": "Return & Refund Policy",
"content": """
<div class="prose-content">
<h2>Return & Refund Policy</h2>
<h3>30-Day Return Window</h3>
<p>Most items can be returned within 30 days of delivery for a full refund or exchange.</p>
<h3>Return Requirements</h3>
<p>To be eligible for a return, items must:</p>
<ul>
<li>Be in original condition with tags attached</li>
<li>Include original packaging and accessories</li>
<li>Not be used or damaged</li>
<li>Include proof of purchase</li>
</ul>
<h3>Non-Returnable Items</h3>
<p>The following items cannot be returned:</p>
<ul>
<li>Personalized or custom-made items</li>
<li>Perishable goods</li>
<li>Health and personal care items</li>
<li>Digital downloads</li>
<li>Sale or clearance items (marked as final sale)</li>
</ul>
<h3>How to Return</h3>
<ol>
<li>Log into your account and go to "Order History"</li>
<li>Select the order and click "Request Return"</li>
<li>Choose items and provide reason for return</li>
<li>Print the prepaid return label</li>
<li>Pack items securely and attach label</li>
<li>Drop off at any authorized carrier location</li>
</ol>
<h3>Refund Process</h3>
<p>Once we receive your return:</p>
<ul>
<li>We'll inspect the items (2-3 business days)</li>
<li>Approved refunds are processed within 5-7 business days</li>
<li>Refunds go to original payment method</li>
<li>You'll receive email confirmation</li>
</ul>
<h3>Return Shipping</h3>
<p>Return shipping is free for defective or incorrect items. For other returns, a $5.99 return shipping fee will be deducted from your refund.</p>
<h3>Exchanges</h3>
<p>We offer free exchanges for different sizes or colors of the same item. Contact support to arrange an exchange.</p>
<h3>Damaged or Defective Items</h3>
<p>If you receive a damaged or defective item, please contact us within 7 days of delivery with photos. We'll send a replacement or full refund immediately.</p>
</div>
""",
"meta_description": "Our 30-day return policy ensures your satisfaction with every purchase",
"meta_keywords": "returns, refunds, exchange, policy",
"show_in_footer": True,
"show_in_header": False,
"display_order": 5,
},
{
"slug": "privacy",
"title": "Privacy Policy",
"content": """
<div class="prose-content">
<h2>Privacy Policy</h2>
<p><em>Last Updated: [Date]</em></p>
<h3>Information We Collect</h3>
<p>We collect information you provide directly:</p>
<ul>
<li>Name, email address, and contact information</li>
<li>Shipping and billing addresses</li>
<li>Payment information (processed securely by our payment processor)</li>
<li>Order history and preferences</li>
</ul>
<p>We automatically collect:</p>
<ul>
<li>Browser type and device information</li>
<li>IP address and location data</li>
<li>Cookies and similar tracking technologies</li>
<li>Usage data and analytics</li>
</ul>
<h3>How We Use Your Information</h3>
<p>We use your information to:</p>
<ul>
<li>Process and fulfill your orders</li>
<li>Communicate about orders and account</li>
<li>Provide customer support</li>
<li>Send marketing communications (with your consent)</li>
<li>Improve our platform and services</li>
<li>Prevent fraud and enhance security</li>
</ul>
<h3>Information Sharing</h3>
<p>We share your information only when necessary:</p>
<ul>
<li><strong>Stores:</strong> To fulfill your orders</li>
<li><strong>Service Providers:</strong> Payment processors, shipping carriers, analytics</li>
<li><strong>Legal Requirements:</strong> When required by law</li>
</ul>
<p>We never sell your personal information to third parties.</p>
<h3>Your Rights</h3>
<p>You have the right to:</p>
<ul>
<li>Access your personal data</li>
<li>Correct inaccurate information</li>
<li>Request deletion of your data</li>
<li>Opt-out of marketing communications</li>
<li>Export your data</li>
</ul>
<h3>Data Security</h3>
<p>We implement industry-standard security measures including:</p>
<ul>
<li>SSL/TLS encryption for data transmission</li>
<li>Secure password hashing</li>
<li>Regular security audits</li>
<li>Limited employee access to personal data</li>
</ul>
<h3>Cookies</h3>
<p>We use cookies to enhance your experience. You can control cookies through your browser settings.</p>
<h3>Children's Privacy</h3>
<p>Our platform is not intended for children under 13. We do not knowingly collect information from children.</p>
<h3>Changes to This Policy</h3>
<p>We may update this policy periodically. Significant changes will be communicated via email.</p>
<h3>Contact Us</h3>
<p>For privacy-related questions, contact us at privacy@example.com</p>
</div>
""",
"meta_description": "Learn how we collect, use, and protect your personal information",
"meta_keywords": "privacy, data protection, security, policy",
"show_in_footer": False,
"show_in_header": False,
"show_in_legal": True,
"display_order": 6,
},
{
"slug": "terms",
"title": "Terms of Service",
"content": """
<div class="prose-content">
<h2>Terms of Service</h2>
<p><em>Last Updated: [Date]</em></p>
<h3>1. Acceptance of Terms</h3>
<p>By accessing and using this platform, you accept and agree to be bound by these Terms of Service.</p>
<h3>2. Account Registration</h3>
<p>You must:</p>
<ul>
<li>Be at least 18 years old</li>
<li>Provide accurate and complete information</li>
<li>Maintain the security of your account</li>
<li>Notify us of unauthorized access</li>
</ul>
<h3>3. User Conduct</h3>
<p>You agree not to:</p>
<ul>
<li>Violate any laws or regulations</li>
<li>Infringe on intellectual property rights</li>
<li>Transmit harmful code or viruses</li>
<li>Harass or harm other users</li>
<li>Engage in fraudulent activities</li>
<li>Scrape or data mine our platform</li>
</ul>
<h3>4. Product Listings</h3>
<p>Product information is provided by stores. While we strive for accuracy:</p>
<ul>
<li>Descriptions may contain errors</li>
<li>Prices are subject to change</li>
<li>Availability is not guaranteed</li>
<li>Images are representative</li>
</ul>
<h3>5. Orders and Payment</h3>
<ul>
<li>All orders are subject to acceptance</li>
<li>We reserve the right to refuse or cancel orders</li>
<li>Prices include applicable taxes unless stated otherwise</li>
<li>Payment must be received before order processing</li>
</ul>
<h3>6. Intellectual Property</h3>
<p>All content on this platform is protected by copyright, trademark, and other laws. You may not:</p>
<ul>
<li>Reproduce or distribute our content</li>
<li>Create derivative works</li>
<li>Use our trademarks without permission</li>
</ul>
<h3>7. Disclaimer of Warranties</h3>
<p>This platform is provided "as is" without warranties of any kind, express or implied.</p>
<h3>8. Limitation of Liability</h3>
<p>We are not liable for indirect, incidental, or consequential damages arising from your use of the platform.</p>
<h3>9. Indemnification</h3>
<p>You agree to indemnify and hold us harmless from claims arising from your use of the platform or violation of these terms.</p>
<h3>10. Dispute Resolution</h3>
<p>Disputes will be resolved through binding arbitration in accordance with the rules of the American Arbitration Association.</p>
<h3>11. Governing Law</h3>
<p>These terms are governed by the laws of [State/Country], without regard to conflict of law principles.</p>
<h3>12. Changes to Terms</h3>
<p>We may modify these terms at any time. Continued use constitutes acceptance of modified terms.</p>
<h3>13. Contact</h3>
<p>For questions about these terms, contact legal@example.com</p>
</div>
""",
"meta_description": "Read our terms of service governing the use of our platform",
"meta_keywords": "terms, conditions, legal, agreement",
"show_in_footer": False,
"show_in_header": False,
"show_in_legal": True,
"display_order": 7,
},
]
# ============================================================================
# SCRIPT FUNCTIONS
# ============================================================================
def _page_exists(db: Session, platform_id: int, slug: str) -> bool:
"""Check if a page already exists for the given platform and slug."""
existing = db.execute(
select(ContentPage).where(
ContentPage.platform_id == platform_id,
ContentPage.store_id.is_(None),
ContentPage.slug == slug,
)
).scalar_one_or_none()
return existing is not None
def _create_page(
db: Session, platform_id: int, page_data: dict, *, is_platform_page: bool = False
) -> bool:
"""Create a single content page. Returns True if created, False if skipped."""
slug = page_data["slug"]
title = page_data["title"]
if _page_exists(db, platform_id, slug):
print(f" Skipped: {title} (/{slug}) - already exists")
return False
page = ContentPage(
platform_id=platform_id,
store_id=None,
slug=slug,
title=title,
content=page_data["content"],
content_format="html",
template=page_data.get("template", "default"),
meta_description=page_data["meta_description"],
meta_keywords=page_data["meta_keywords"],
is_platform_page=is_platform_page,
is_published=True,
published_at=datetime.now(UTC),
show_in_footer=page_data.get("show_in_footer", True),
show_in_header=page_data.get("show_in_header", False),
show_in_legal=page_data.get("show_in_legal", False),
display_order=page_data["display_order"],
created_at=datetime.now(UTC),
updated_at=datetime.now(UTC),
)
db.add(page)
print(f" Created: {title} (/{slug})")
return True
def create_default_pages(db: Session) -> None:
"""
Create default platform content pages for ALL platforms.
This function is idempotent - it will skip pages that already exist.
"""
print("\n" + "=" * 70)
print("Creating Default Platform Content Pages (CMS)")
print("=" * 70 + "\n")
# Load all platforms
platforms = db.execute(select(Platform)).scalars().all()
if not platforms:
print(" No platforms found. Run init_production.py first.")
return
total_created = 0
total_skipped = 0
for platform in platforms:
print(f" Platform: {platform.name} (code={platform.code})")
created_count = 0
skipped_count = 0
# Create platform homepage
if _create_page(db, platform.id, PLATFORM_HOMEPAGE, is_platform_page=True):
created_count += 1
else:
skipped_count += 1
# Create default store content pages
for page_data in DEFAULT_PAGES:
if _create_page(db, platform.id, page_data):
created_count += 1
else:
skipped_count += 1
print(f" --- {created_count} created, {skipped_count} skipped")
print()
total_created += created_count
total_skipped += skipped_count
db.commit()
print("=" * 70)
print("Summary:")
print(f" Platforms: {len(platforms)}")
print(f" Created: {total_created} pages")
print(f" Skipped: {total_skipped} pages (already exist)")
print(f" Total: {total_created + total_skipped} pages")
print("=" * 70 + "\n")
if total_created > 0:
print("Default platform content pages created successfully!\n")
print("Next steps:")
print(
" 1. View pages at: /about, /contact, /faq, /shipping, /returns, /privacy, /terms"
)
print(" 2. Stores can override these pages through the store dashboard")
print(" 3. Edit platform defaults through the admin panel\n")
else:
print("All default pages already exist. No changes made.\n")
# ============================================================================
# MAIN EXECUTION
# ============================================================================
def main():
"""Main execution function."""
print("\nStarting Default Content Pages Creation Script...\n")
db = SessionLocal()
try:
create_default_pages(db)
print("Script completed successfully!\n")
except Exception as e:
print(f"\nError: {e}\n")
db.rollback()
raise
finally:
db.close()
if __name__ == "__main__":
main()
Reference in New Issue View Git Blame Copy Permalink