548f91c37f
- 移除后端产品、目的地、活动专题等废弃模块的数据库表与业务代码，删除冗余API接口 - 删除小程序端详情页、线路组件等冗余代码，移除搜索工具与测试用例，调整导航逻辑 - 清理管理端废弃的类型定义、编辑器与测试代码 - 更新项目文档，修正模块维护说明与接口文档内容
1.5 KiB
1.5 KiB
WonderQ-Admin 后端规划摘要
当前定位
WonderQ-Admin 是 WonderQ 的独立后端 API 服务，当前技术栈已调整为 Python + FastAPI + SQLAlchemy 2 + Alembic + PostgreSQL，通过 Docker Compose 部署 API、PostgreSQL 和 Redis。
核心目标
- 为 H5 前台提供稳定的 Public API。
- 为后台管理端提供 JWT 鉴权的 Admin API。
- 保留现有 PostgreSQL 数据和主要接口路径，降低前端联调成本。
- 使用 Alembic 管理后续数据库迁移，已有数据库通过
alembic stamp head接入 baseline。
当前业务模块
- 首页配置：轮播、目的地、发布版本。
- 线路产品：列表、详情、图片、详情区块、状态和排序。
- 线索：前台提交、后台列表、状态流转。
- 媒体：媒体资源登记。
- 审计：后台关键变更写入
AuditLog。
近期优先级
- 保持 Public/Admin API 与现有前端调用兼容。
- 补充更多 PostgreSQL 集成测试，覆盖迁移、seed 和核心接口。
- 建立生产迁移流程：备份、
alembic stamp head、后续增量迁移。 - 按实际业务继续扩展权限、订单、客户和消息模块。
安全与部署原则
- 生产环境必须替换
JWT_SECRET，禁止使用示例值。 - 不提交
.env、日志、数据库备份和任何真实密钥。 python -m app.seed会重置内容数据，生产环境执行前必须明确确认。- Docker Compose 适合本地和单机部署；生产可按相同环境变量拆分到托管数据库或容器平台。