# 16 开发路线图

## 第一阶段必须先做设计

在写大量代码之前，先输出：

1. 系统架构
2. 模块划分
3. 数据库 ER 关系
4. 核心数据表
5. 租户隔离方案
6. 库存模型
7. 入库流程
8. 出库流程
9. 订单模型
10. 权限模型
11. API 设计
12. Queue / Scheduler 设计
13. Python Service 边界
14. Docker 开发环境
15. 项目目录结构

## 第一阶段不要直接实现业务

先在 `docs/` 目录下生成以下设计文档及目录结构说明：

- ARCHITECTURE.md
- database/（数据库总览、ER 关系与表结构设计，入口 `database/README.md`）
- API.md
- DEVELOPMENT.md
- DOCKER.md

确认架构合理之后，再开始数据库和代码。建议优先产出 `docs/database/` 中的表结构设计，把租户、仓库、库位、SKU、库存、库存流水、入库、出库这几个核心模型定死。

## 开发顺序

严格按照以下顺序：

| Phase | 内容 |
| --- | --- |
| 1 | 项目架构设计 |
| 2 | Laravel 基础项目 |
| 3 | Vue 3 + Element Plus Admin |
| 4 | SaaS 租户 / 用户 / RBAC |
| 5 | 仓库 / 库区 / 库位 |
| 6 | 商品 / SKU / 客户 |
| 7 | 库存核心模型 |
| 8 | 库存流水 / 库存并发 |
| 9 | 入库 |
| 10 | 出库 |
| 11 | 拣货 / 波次 / 打包 / 发货 |
| 12 | 物流 |
| 13 | 报表 |
| 14 | 第三方订单接口 |
| 15 | Python AI / Data Service |
| 16 | 测试 / 性能 / 安全 |
| 17 | Docker / Production |

## 每个 Phase 开始前

先说明本阶段：

- 目标
- 涉及模块
- 数据库变化
- API 变化
- 前端变化
- 测试方案
- 风险

然后再实施。

## 第一步任务

不要写业务代码。先检查当前工作区，然后输出：

1. 当前项目状态
2. 推荐的最终目录结构
3. 系统架构图
4. Laravel / Vue / Python 三者职责边界
5. SaaS 多租户方案
6. WMS 核心领域模型
7. 核心数据库表清单
8. 库存模型设计
9. 入库 / 出库流程
10. API 分层设计
11. Queue / Scheduler 设计
12. Python Service 设计
13. Docker 开发环境设计
14. Phase 1 实施计划

**暂时不要创建大量代码文件，先完成架构设计。**