chore: PostgreSQL migration compatibility and infrastructure improvements
Database & Migrations: - Update all Alembic migrations for PostgreSQL compatibility - Remove SQLite-specific syntax (AUTOINCREMENT, etc.) - Add database utility helpers for PostgreSQL operations - Fix services to use PostgreSQL-compatible queries Documentation: - Add comprehensive Docker deployment guide - Add production deployment documentation - Add infrastructure architecture documentation - Update database setup guide for PostgreSQL-only - Expand troubleshooting guide Architecture & Validation: - Add migration.yaml rules for SQL compatibility checking - Enhance validate_architecture.py with migration validation - Update architecture rules to validate Alembic migrations Development: - Fix duplicate install-all target in Makefile - Add Celery/Redis validation to install.py script - Add docker-compose.test.yml for CI testing - Add squash_migrations.py utility script - Update tests for PostgreSQL compatibility - Improve test fixtures in conftest.py Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -2,13 +2,24 @@
|
||||
|
||||
This guide covers deploying the Wizamart platform to production environments.
|
||||
|
||||
!!! tip "New to deployment?"
|
||||
Start with the [Infrastructure Guide](infrastructure.md) for a complete overview of architecture options.
|
||||
|
||||
## Deployment Options
|
||||
|
||||
| Option | Best For | Guide |
|
||||
|--------|----------|-------|
|
||||
| **Traditional VPS** | Direct server access, debugging | [Production Guide](production.md) |
|
||||
| **Docker Compose** | Consistent environments, easy rollbacks | [Docker Guide](docker.md) |
|
||||
| **Managed Services** | Minimal ops, small teams | See [Infrastructure Guide](infrastructure.md#option-3-managed-services-minimal-ops) |
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Python 3.11+
|
||||
- PostgreSQL 14+ (production) or SQLite (development)
|
||||
- Redis (optional, for caching/sessions)
|
||||
- PostgreSQL 15+ (required - SQLite not supported)
|
||||
- Redis (required for Celery background jobs)
|
||||
- Docker (for development database)
|
||||
- Tailwind CSS CLI (standalone binary)
|
||||
- uv package manager
|
||||
|
||||
## Environment Configuration
|
||||
|
||||
|
||||
Reference in New Issue
Block a user