diff --git a/Makefile b/Makefile
index 08faaa9d..75b36c8f 100644
--- a/Makefile
+++ b/Makefile
@@ -122,7 +122,7 @@ else
SEED_MODE=reset $(PYTHON) scripts/seed_demo.py
endif
-db-setup: migrate-up init-prod seed-demo
+db-setup: migrate-up init-prod create-cms-defaults seed-demo
@echo "ā
Database setup complete!"
@echo "Run 'make dev' to start development server"
@@ -133,6 +133,12 @@ backup-db:
@echo "Creating database backup..."
@$(PYTHON) scripts/backup_database.py
+# CMS default content pages
+create-cms-defaults:
+ @echo "š Creating default CMS content pages..."
+ $(PYTHON) scripts/create_default_content_pages.py
+ @echo "ā
CMS defaults created"
+
# =============================================================================
# TESTING
# =============================================================================
@@ -314,7 +320,8 @@ help:
@echo " seed-demo - Seed demo data (3 vendors)"
@echo " seed-demo-minimal - Seed minimal demo (1 vendor)"
@echo " seed-demo-reset - DELETE ALL and reseed"
- @echo " db-setup - Full dev setup (migrate + init + seed)"
+ @echo " create-cms-defaults - Create default CMS content pages"
+ @echo " db-setup - Full dev setup (migrate + init + cms + seed)"
@echo " backup-db - Backup database"
@echo ""
@echo "=== TESTING ==="
@@ -367,15 +374,19 @@ help-db:
@echo " seed-demo-minimal - Create 1 demo vendor only"
@echo " seed-demo-reset - DELETE ALL data and reseed (DANGEROUS!)"
@echo ""
+ @echo "CMS CONTENT:"
+ @echo " create-cms-defaults - Create default content pages (about, faq, etc.)"
+ @echo ""
@echo "WORKFLOWS:"
- @echo " db-setup - Complete dev setup (migrate + init + seed)"
+ @echo " db-setup - Complete dev setup (migrate + init + cms + seed)"
@echo " db-reset - Nuclear option: rollback + reset + reseed"
@echo ""
@echo "TYPICAL FIRST-TIME SETUP:"
@echo " 1. make migrate-up # Apply migrations"
@echo " 2. make init-prod # Create admin user"
- @echo " 3. make seed-demo # Add demo data"
- @echo " 4. make dev # Start developing"
+ @echo " 3. make create-cms-defaults # Create CMS pages"
+ @echo " 4. make seed-demo # Add demo data"
+ @echo " 5. make dev # Start developing"
@echo ""
@echo "PRODUCTION SETUP:"
@echo " 1. Set ENV=production or ENVIRONMENT=production"
diff --git a/scripts/create_default_content_pages.py b/scripts/create_default_content_pages.py
new file mode 100755
index 00000000..927559c3
--- /dev/null
+++ b/scripts/create_default_content_pages.py
@@ -0,0 +1,550 @@
+#!/usr/bin/env python3
+"""
+Create Default Platform Content Pages (CMS)
+
+This script creates platform-level default content pages that all vendors inherit.
+These pages serve as the baseline content for:
+- About Us
+- Contact
+- FAQ
+- Shipping Policy
+- Return Policy
+- Privacy Policy
+- Terms of Service
+
+Vendors can override any of these pages with their own custom content.
+
+Prerequisites:
+ - Database migrations must be applied
+ - content_pages table must exist
+
+Usage:
+ python scripts/create_default_content_pages.py
+
+ # Or with make:
+ make create-cms-defaults
+"""
+
+import sys
+from pathlib import Path
+from datetime import datetime, timezone
+
+# Add project root to path
+project_root = Path(__file__).parent.parent
+sys.path.insert(0, str(project_root))
+
+from sqlalchemy.orm import Session
+from sqlalchemy import select
+
+from app.core.database import SessionLocal
+from models.database.content_page import ContentPage
+
+
+# ============================================================================
+# DEFAULT PAGE CONTENT
+# ============================================================================
+
+DEFAULT_PAGES = [
+ {
+ "slug": "about",
+ "title": "About Us",
+ "content": """
+
+
Welcome to Our Platform
+
We are a multi-vendor e-commerce platform connecting quality sellers with customers worldwide.
+
+
Our Mission
+
To empower independent businesses and artisans by providing them with the tools and platform they need to reach customers globally.
+
+
What We Offer
+
+ - Curated selection of quality products from verified vendors
+ - Secure payment processing and buyer protection
+ - Fast and reliable shipping options
+ - Dedicated customer support
+
+
+
Our Values
+
+ - Quality: We work only with vendors who meet our quality standards
+ - Transparency: Clear pricing, policies, and communication
+ - Customer First: Your satisfaction is our priority
+ - Innovation: Continuously improving our platform and services
+
+
+
Get in Touch
+
We're here to help! Reach out to us through any of the following channels:
+
+
Customer Support
+
For questions about orders, products, or general inquiries:
+
+ - Email: support@example.com
+ - Phone: 1-800-EXAMPLE (Mon-Fri, 9am-6pm EST)
+ - Live Chat: Available on our website during business hours
+
+
+
Business Inquiries
+
Interested in becoming a vendor or partnering with us?
+
+ - Email: vendors@example.com
+
+
+
Office Address
+
+ 123 Commerce Street
+ Suite 456
+ City, State 12345
+ United States
+
+
+
Response Time
+
We typically respond to all inquiries within 24 hours during business days.
+
+
Frequently Asked Questions
+
+
Orders & Shipping
+
+
How do I track my order?
+
Once your order ships, you'll receive a tracking number via email. You can also view your order status in your account dashboard.
+
+
How long does shipping take?
+
Shipping times vary by vendor and destination. Most orders arrive within 3-7 business days. See our Shipping Policy for details.
+
+
Do you ship internationally?
+
Yes! We ship to most countries worldwide. International shipping times and costs vary by destination.
+
+
Returns & Refunds
+
+
What is your return policy?
+
Most items can be returned within 30 days of delivery. See our Return Policy for complete details.
+
+
How do I request a refund?
+
Contact the vendor directly through your order page or reach out to our support team for assistance.
+
+
Payments
+
+
What payment methods do you accept?
+
We accept all major credit cards, PayPal, and other secure payment methods.
+
+
Is my payment information secure?
+
Yes! We use industry-standard encryption and never store your full payment details.
+
+
Account
+
+
Do I need an account to make a purchase?
+
No, you can checkout as a guest. However, creating an account lets you track orders and save your preferences.
+
+
How do I reset my password?
+
Click "Forgot Password" on the login page and follow the instructions sent to your email.
+
+
Shipping Policy
+
+
Shipping Methods
+
We offer multiple shipping options to meet your needs:
+
+ - Standard Shipping: 5-7 business days
+ - Express Shipping: 2-3 business days
+ - Overnight Shipping: Next business day
+
+
+
Shipping Costs
+
Shipping costs are calculated based on:
+
+ - Package weight and dimensions
+ - Destination address
+ - Selected shipping method
+
+
Free standard shipping on orders over $50!
+
+
Processing Time
+
Orders are typically processed within 1-2 business days. You'll receive a confirmation email when your order ships with tracking information.
+
+
International Shipping
+
We ship to most countries worldwide. International shipping times vary by destination (typically 7-21 business days).
+
+ - Customs fees and import duties are the responsibility of the recipient
+ - International orders may be subject to customs inspection
+
+
+
Tracking
+
All orders include tracking. You can monitor your package status through:
+
+ - Your account dashboard
+ - Email notifications
+ - Carrier tracking website
+
+
+
Delivery Issues
+
If you experience any delivery issues, please contact us within 7 days of the expected delivery date.
+
+
Return & Refund Policy
+
+
30-Day Return Window
+
Most items can be returned within 30 days of delivery for a full refund or exchange.
+
+
Return Requirements
+
To be eligible for a return, items must:
+
+ - Be in original condition with tags attached
+ - Include original packaging and accessories
+ - Not be used or damaged
+ - Include proof of purchase
+
+
+
Non-Returnable Items
+
The following items cannot be returned:
+
+ - Personalized or custom-made items
+ - Perishable goods
+ - Health and personal care items
+ - Digital downloads
+ - Sale or clearance items (marked as final sale)
+
+
+
How to Return
+
+ - Log into your account and go to "Order History"
+ - Select the order and click "Request Return"
+ - Choose items and provide reason for return
+ - Print the prepaid return label
+ - Pack items securely and attach label
+ - Drop off at any authorized carrier location
+
+
+
Refund Process
+
Once we receive your return:
+
+ - We'll inspect the items (2-3 business days)
+ - Approved refunds are processed within 5-7 business days
+ - Refunds go to original payment method
+ - You'll receive email confirmation
+
+
+
Return Shipping
+
Return shipping is free for defective or incorrect items. For other returns, a $5.99 return shipping fee will be deducted from your refund.
+
+
Exchanges
+
We offer free exchanges for different sizes or colors of the same item. Contact support to arrange an exchange.
+
+
Damaged or Defective Items
+
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.
+
+
Privacy Policy
+
Last Updated: [Date]
+
+
Information We Collect
+
We collect information you provide directly:
+
+ - Name, email address, and contact information
+ - Shipping and billing addresses
+ - Payment information (processed securely by our payment processor)
+ - Order history and preferences
+
+
+
We automatically collect:
+
+ - Browser type and device information
+ - IP address and location data
+ - Cookies and similar tracking technologies
+ - Usage data and analytics
+
+
+
How We Use Your Information
+
We use your information to:
+
+ - Process and fulfill your orders
+ - Communicate about orders and account
+ - Provide customer support
+ - Send marketing communications (with your consent)
+ - Improve our platform and services
+ - Prevent fraud and enhance security
+
+
+
Information Sharing
+
We share your information only when necessary:
+
+ - Vendors: To fulfill your orders
+ - Service Providers: Payment processors, shipping carriers, analytics
+ - Legal Requirements: When required by law
+
+
We never sell your personal information to third parties.
+
+
Your Rights
+
You have the right to:
+
+ - Access your personal data
+ - Correct inaccurate information
+ - Request deletion of your data
+ - Opt-out of marketing communications
+ - Export your data
+
+
+
Data Security
+
We implement industry-standard security measures including:
+
+ - SSL/TLS encryption for data transmission
+ - Secure password hashing
+ - Regular security audits
+ - Limited employee access to personal data
+
+
+
Cookies
+
We use cookies to enhance your experience. You can control cookies through your browser settings.
+
+
Children's Privacy
+
Our platform is not intended for children under 13. We do not knowingly collect information from children.
+
+
Changes to This Policy
+
We may update this policy periodically. Significant changes will be communicated via email.
+
+
Contact Us
+
For privacy-related questions, contact us at privacy@example.com
+
+
Terms of Service
+
Last Updated: [Date]
+
+
1. Acceptance of Terms
+
By accessing and using this platform, you accept and agree to be bound by these Terms of Service.
+
+
2. Account Registration
+
You must:
+
+ - Be at least 18 years old
+ - Provide accurate and complete information
+ - Maintain the security of your account
+ - Notify us of unauthorized access
+
+
+
3. User Conduct
+
You agree not to:
+
+ - Violate any laws or regulations
+ - Infringe on intellectual property rights
+ - Transmit harmful code or viruses
+ - Harass or harm other users
+ - Engage in fraudulent activities
+ - Scrape or data mine our platform
+
+
+
4. Product Listings
+
Product information is provided by vendors. While we strive for accuracy:
+
+ - Descriptions may contain errors
+ - Prices are subject to change
+ - Availability is not guaranteed
+ - Images are representative
+
+
+
5. Orders and Payment
+
+ - All orders are subject to acceptance
+ - We reserve the right to refuse or cancel orders
+ - Prices include applicable taxes unless stated otherwise
+ - Payment must be received before order processing
+
+
+
6. Intellectual Property
+
All content on this platform is protected by copyright, trademark, and other laws. You may not:
+
+ - Reproduce or distribute our content
+ - Create derivative works
+ - Use our trademarks without permission
+
+
+
7. Disclaimer of Warranties
+
This platform is provided "as is" without warranties of any kind, express or implied.
+
+
8. Limitation of Liability
+
We are not liable for indirect, incidental, or consequential damages arising from your use of the platform.
+
+
9. Indemnification
+
You agree to indemnify and hold us harmless from claims arising from your use of the platform or violation of these terms.
+
+
10. Dispute Resolution
+
Disputes will be resolved through binding arbitration in accordance with the rules of the American Arbitration Association.
+
+
11. Governing Law
+
These terms are governed by the laws of [State/Country], without regard to conflict of law principles.
+
+
12. Changes to Terms
+
We may modify these terms at any time. Continued use constitutes acceptance of modified terms.
+
+
13. Contact
+
For questions about these terms, contact legal@example.com
+