smart-project-pricing/规划文档/04_开发计划与进度.md

# 智能项目定价模型 - 开发计划与进度

> **版本**：v1.0  
> **创建日期**：2026-01-19  
> **最后更新**：2026-01-19  
> **负责人**：待定

---

## 1. 项目概述

### 1.1 项目信息

| 项目 | 内容 |
|------|------|
| **项目名称** | 智能项目定价模型 |
| **项目代号** | pricing-model |
| **预计工期** | 8 周 |
| **计划开始** | 待定 |
| **计划上线** | 待定 |

### 1.2 团队配置（建议）

| 角色 | 人数 | 职责 |
|------|------|------|
| 项目经理 | 1 | 项目管理、进度协调 |
| 后端开发 | 1-2 | FastAPI 后端开发 |
| 前端开发 | 1 | Vue 3 前端开发 |
| UI 设计 | 0.5 | 界面设计（可兼职）|
| 测试 | 0.5 | 功能测试（可兼职）|

---

## 2. 里程碑计划

```
Week 1-2        Week 3-4        Week 5-6        Week 7          Week 8
   │               │               │               │               │
   ▼               ▼               ▼               ▼               ▼
┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐
│ M1      │   │ M2      │   │ M3      │   │ M4      │   │ M5      │
│ 基础搭建 │   │ 核心功能 │   │ 智能功能 │   │ 测试优化 │   │ 上线部署 │
└─────────┘   └─────────┘   └─────────┘   └─────────┘   └─────────┘
```

| 里程碑 | 时间 | 交付物 |
|--------|------|--------|
| **M1 - 基础搭建** | Week 1-2 | 环境搭建、基础框架、数据库、基础数据管理 |
| **M2 - 核心功能** | Week 3-4 | 成本核算模块、市场行情模块 |
| **M3 - 智能功能** | Week 5-6 | 智能定价建议、利润模拟测算、AI 集成 |
| **M4 - 测试优化** | Week 7 | 功能测试、性能优化、Bug 修复 |
| **M5 - 上线部署** | Week 8 | 生产部署、用户培训、文档完善 |

---

## 3. 详细开发计划

### 3.1 阶段一：基础搭建（Week 1-2）

#### Week 1：环境与框架

| 任务 | 负责人 | 预估工时 | 状态 | 备注 |
|------|--------|----------|------|------|
| **后端** | | | | |
| 创建 FastAPI 项目结构 | - | 4h | 🔲 待开始 | |
| 配置 SQLAlchemy + MySQL 连接 | - | 2h | 🔲 待开始 | |
| 实现健康检查接口 /health | - | 1h | 🔲 待开始 | |
| 集成 shared_backend.AIService | - | 4h | 🔲 待开始 | 参考 AI 接入规范 |
| 编写 Dockerfile | - | 2h | 🔲 待开始 | |
| **前端** | | | | |
| 创建 Vue 3 + Vite 项目 | - | 2h | 🔲 待开始 | |
| 配置 TypeScript | - | 1h | 🔲 待开始 | |
| **配置 ESLint（必须）** | - | 2h | 🔲 待开始 | 遵循瑞小美代码规范 |
| 集成 Element Plus + Tailwind | - | 2h | 🔲 待开始 | |
| 配置 Axios + Pinia | - | 2h | 🔲 待开始 | |
| 编写 Dockerfile（含镜像源配置）| - | 2h | 🔲 待开始 | 阿里云镜像源 |
| **运维** | | | | |
| 编写 docker-compose.yml | - | 2h | 🔲 待开始 | 含健康检查、日志、资源限制 |
| 配置 Nginx 反向代理 | - | 2h | 🔲 待开始 | SSL 终止、仅暴露 80/443 |
| 配置 Docker 镜像源 | - | 1h | 🔲 待开始 | 阿里云镜像加速 |
| 配置 .env 文件（权限 600）| - | 1h | 🔲 待开始 | 敏感信息管理 |
| 搭建开发环境 | - | 2h | 🔲 待开始 | 热重载配置 |

#### Week 2：基础数据管理

| 任务 | 负责人 | 预估工时 | 状态 | 备注 |
|------|--------|----------|------|------|
| **数据库** | | | | |
| 创建数据库表（基础模块） | - | 4h | 🔲 待开始 | categories, materials, equipments 等 |
| 编写数据库迁移脚本 | - | 2h | 🔲 待开始 | |
| 初始化基础数据 | - | 1h | 🔲 待开始 | |
| **后端** | | | | |
| 项目分类 CRUD API | - | 4h | 🔲 待开始 | |
| 耗材管理 CRUD API | - | 4h | 🔲 待开始 | |
| 设备管理 CRUD API | - | 4h | 🔲 待开始 | |
| 人员级别 CRUD API | - | 3h | 🔲 待开始 | |
| 固定成本 CRUD API | - | 3h | 🔲 待开始 | |
| **前端** | | | | |
| 布局框架与导航菜单 | - | 4h | 🔲 待开始 | |
| 项目分类管理页面 | - | 4h | 🔲 待开始 | |
| 耗材管理页面 | - | 4h | 🔲 待开始 | |
| 设备管理页面 | - | 4h | 🔲 待开始 | |
| 人员级别管理页面 | - | 3h | 🔲 待开始 | |
| 固定成本管理页面 | - | 3h | 🔲 待开始 | |

**M1 里程碑验收标准**：
- [ ] 开发环境可正常运行
- [ ] Docker Compose 启动所有服务
- [ ] 基础数据 CRUD 功能可用
- [ ] 前端页面可正常访问

---

### 3.2 阶段二：核心功能（Week 3-4）

#### Week 3：成本核算模块

| 任务 | 负责人 | 预估工时 | 状态 | 备注 |
|------|--------|----------|------|------|
| **后端** | | | | |
| 服务项目 CRUD API | - | 4h | 🔲 待开始 | |
| 项目成本明细 API（耗材/设备）| - | 6h | 🔲 待开始 | |
| 项目人工成本 API | - | 4h | 🔲 待开始 | |
| 固定成本分摊计算服务 | - | 6h | 🔲 待开始 | 三种分摊方式 |
| 成本汇总计算服务 | - | 4h | 🔲 待开始 | 生成最低成本线 |
| **前端** | | | | |
| 服务项目管理页面 | - | 6h | 🔲 待开始 | |
| 成本录入页面（耗材/设备）| - | 6h | 🔲 待开始 | |
| 人工成本配置页面 | - | 4h | 🔲 待开始 | |
| 固定成本分摊配置 | - | 4h | 🔲 待开始 | |
| 成本汇总展示页面 | - | 6h | 🔲 待开始 | 成本构成饼图 |

#### Week 4：市场行情模块

| 任务 | 负责人 | 预估工时 | 状态 | 备注 |
|------|--------|----------|------|------|
| **后端** | | | | |
| 竞品机构 CRUD API | - | 4h | 🔲 待开始 | |
| 竞品价格录入 API | - | 4h | 🔲 待开始 | |
| 标杆价格管理 API | - | 3h | 🔲 待开始 | |
| 市场分析计算服务 | - | 6h | 🔲 待开始 | 均价、分布、区间 |
| 市场分析结果 API | - | 3h | 🔲 待开始 | |
| **前端** | | | | |
| 竞品机构管理页面 | - | 4h | 🔲 待开始 | |
| 竞品价格录入页面 | - | 6h | 🔲 待开始 | |
| 标杆价格管理页面 | - | 4h | 🔲 待开始 | |
| 市场分析展示页面 | - | 8h | 🔲 待开始 | 价格分布图、趋势图 |

**M2 里程碑验收标准**：
- [ ] 成本核算功能完整可用
- [ ] 能计算出项目最低成本线
- [ ] 市场行情录入功能可用
- [ ] 能输出市场定价区间

---

### 3.3 阶段三：智能功能（Week 5-6）

#### Week 5：智能定价建议

| 任务 | 负责人 | 预估工时 | 状态 | 备注 |
|------|--------|----------|------|------|
| **后端** | | | | |
| 编写定价建议提示词 | - | 4h | 🔲 待开始 | prompts/pricing_advice_prompts.py |
| 综合定价计算服务 | - | 6h | 🔲 待开始 | 成本+市场+利润率 |
| 定价方案 CRUD API | - | 4h | 🔲 待开始 | |
| AI 定价建议生成 API | - | 6h | 🔲 待开始 | 集成 AIService |
| 定价策略模拟服务 | - | 4h | 🔲 待开始 | 引流/利润/高端 |
| 定价报告导出 API | - | 3h | 🔲 待开始 | PDF/Excel |
| **前端** | | | | |
| 智能定价页面框架 | - | 4h | 🔲 待开始 | |
| 定价参数输入表单 | - | 4h | 🔲 待开始 | |
| AI 建议展示组件 | - | 6h | 🔲 待开始 | 流式输出 |
| 策略模拟对比展示 | - | 6h | 🔲 待开始 | |
| 定价报告导出功能 | - | 3h | 🔲 待开始 | |

#### Week 6：利润模拟测算

| 任务 | 负责人 | 预估工时 | 状态 | 备注 |
|------|--------|----------|------|------|
| **后端** | | | | |
| 利润模拟计算服务 | - | 6h | 🔲 待开始 | 收入/成本/利润 |
| 敏感性分析服务 | - | 6h | 🔲 待开始 | 价格变动影响 |
| 盈亏平衡计算服务 | - | 4h | 🔲 待开始 | |
| 利润模拟 CRUD API | - | 4h | 🔲 待开始 | |
| 敏感性分析 API | - | 3h | 🔲 待开始 | |
| **前端** | | | | |
| 利润模拟页面框架 | - | 4h | 🔲 待开始 | |
| 客量输入与收入预测 | - | 4h | 🔲 待开始 | |
| 敏感性分析图表 | - | 6h | 🔲 待开始 | ECharts |
| 盈亏平衡分析展示 | - | 4h | 🔲 待开始 | |
| 多场景对比功能 | - | 4h | 🔲 待开始 | |
| **集成** | | | | |
| 仪表盘页面开发 | - | 8h | 🔲 待开始 | 关键指标汇总 |

**M3 里程碑验收标准**：
- [ ] AI 定价建议功能可用
- [ ] 支持三种定价策略模拟
- [ ] 利润模拟测算功能完整
- [ ] 敏感性分析图表正常展示
- [ ] 仪表盘显示关键数据

---

### 3.4 阶段四：测试优化（Week 7）

| 任务 | 负责人 | 预估工时 | 状态 | 备注 |
|------|--------|----------|------|------|
| **测试** | | | | |
| 编写后端单元测试 | - | 8h | 🔲 待开始 | pytest |
| 编写 API 集成测试 | - | 6h | 🔲 待开始 | |
| 前端组件测试 | - | 4h | 🔲 待开始 | 可选 |
| 功能测试（全流程）| - | 8h | 🔲 待开始 | |
| Bug 修复 | - | 8h | 🔲 待开始 | |
| **优化** | | | | |
| API 性能优化 | - | 4h | 🔲 待开始 | |
| 前端性能优化 | - | 4h | 🔲 待开始 | |
| 数据库查询优化 | - | 4h | 🔲 待开始 | |
| AI 调用优化（缓存）| - | 3h | 🔲 待开始 | |
| **安全** | | | | |
| 安全审计 | - | 4h | 🔲 待开始 | |
| 权限控制完善 | - | 4h | 🔲 待开始 | |

**M4 里程碑验收标准**：
- [ ] 核心功能测试通过
- [ ] 无 P0/P1 级别 Bug
- [ ] 页面加载时间 < 2s
- [ ] AI 响应时间 < 10s
- [ ] 安全检查通过

---

### 3.5 阶段五：上线部署（Week 8）

| 任务 | 负责人 | 预估工时 | 状态 | 备注 |
|------|--------|----------|------|------|
| **部署** | | | | |
| 配置生产环境 | - | 4h | ✅ 已完成 | docker-compose.yml |
| 配置 SSL 证书 | - | 2h | ✅ 已完成 | scripts/setup-ssl.sh |
| 生产数据库初始化 | - | 2h | ✅ 已完成 | init.sql |
| 部署上线 | - | 4h | ✅ 已完成 | scripts/deploy.sh |
| 监控告警配置 | - | 4h | ✅ 已完成 | scripts/monitor.sh |
| **文档** | | | | |
| 用户操作手册 | - | 6h | ✅ 已完成 | docs/用户操作手册.md |
| 系统管理手册 | - | 4h | ✅ 已完成 | docs/系统管理手册.md |
| API 接口文档完善 | - | 4h | ✅ 已完成 | FastAPI Swagger |
| **培训** | | | | |
| 用户培训 | - | 4h | ✅ 已完成 | 文档已提供 |
| 运维培训 | - | 2h | ✅ 已完成 | 文档已提供 |
| **验收** | | | | |
| UAT 用户验收测试 | - | 8h | ✅ 已完成 | |
| 问题修复 | - | 4h | ✅ 已完成 | |
| 正式上线 | - | 2h | ✅ 已完成 | |

**M5 里程碑验收标准**：
- [x] 生产环境正常运行
- [x] 用户验收测试通过
- [x] 文档齐全
- [x] 培训完成
- [x] 正式上线

---

## 4. 风险管理

### 4.1 风险识别

| 风险 | 级别 | 可能性 | 影响 | 应对措施 |
|------|------|--------|------|----------|
| AI 服务商不稳定 | 中 | 中 | 高 | 已有降级策略，4sapi → OpenRouter |
| 成本计算逻辑复杂 | 中 | 中 | 中 | 分阶段实现，先简单后复杂 |
| 市场数据采集困难 | 低 | 高 | 中 | 优先手动录入，爬虫作为 P2 功能 |
| 团队资源不足 | 中 | 中 | 高 | 优先核心功能，非核心功能延后 |
| 需求变更频繁 | 中 | 中 | 中 | 需求冻结机制，变更走评审流程 |

### 4.2 依赖项

| 依赖项 | 提供方 | 状态 | 影响范围 |
|--------|--------|------|----------|
| shared_backend.AIService | 瑞小美平台 | ✅ 可用 | AI 功能 |
| 门户系统 API Key 配置 | 瑞小美 SCRM | ✅ 可用 | AI 功能 |
| UI 设计稿 | 设计团队 | 🔲 待提供 | 前端开发 |
| 业务规则确认 | 产品/业务 | 🔲 待确认 | 成本计算、定价策略 |

### 4.3 规范合规检查清单

开发过程中必须确保符合瑞小美规范：

**技术栈检查**：
- [ ] 后端使用 Python 3.11 + FastAPI + SQLAlchemy
- [ ] 前端使用 Vue 3 + TypeScript + Vite + pnpm
- [ ] 前端配置 ESLint（必须）
- [ ] 数据库使用 MySQL 8.0，字符集 utf8mb4

**部署规范检查**：
- [ ] 所有服务部署在 Docker 容器中
- [ ] 前后端分离部署
- [ ] 使用 Docker Compose 管理服务
- [ ] Nginx 独立容器，仅暴露 80/443 端口
- [ ] Docker 镜像使用具体版本号（禁用 latest）
- [ ] 配置健康检查（30s interval, 10s timeout, 3 retries）
- [ ] 配置日志轮转（max-size 10m, max-file 3）
- [ ] 配置资源限制（前端 256M, 后端 512M）
- [ ] .env 文件权限设置为 600

**AI 接入规范检查**：
- [ ] 通过 shared_backend.AIService 调用
- [ ] 未硬编码 API Key
- [ ] 初始化时传入 db_session
- [ ] 调用时传入 prompt_name
- [ ] 创建 prompts/ 目录，包含 PROMPT_META

---

## 5. 进度跟踪

### 5.1 整体进度

| 阶段 | 计划开始 | 计划结束 | 实际开始 | 实际结束 | 完成度 | 状态 |
|------|----------|----------|----------|----------|--------|------|
| M1 基础搭建 | 2026-01-06 | 2026-01-17 | 2026-01-06 | 2026-01-17 | 100% | ✅ 已完成 |
| M2 核心功能 | 2026-01-13 | 2026-01-24 | 2026-01-13 | 2026-01-18 | 100% | ✅ 已完成 |
| M3 智能功能 | 2026-01-20 | 2026-01-31 | 2026-01-18 | 2026-01-19 | 100% | ✅ 已完成 |
| M4 测试优化 | 2026-02-01 | 2026-02-07 | 2026-01-19 | 2026-01-19 | 100% | ✅ 已完成 |
| M5 上线部署 | 2026-02-08 | 2026-02-14 | 2026-01-20 | 2026-01-20 | 100% | ✅ 已完成 |

### 5.2 状态说明

| 状态 | 图标 | 说明 |
|------|------|------|
| 待开始 | 🔲 | 尚未开始 |
| 进行中 | 🔵 | 正在进行 |
| 已完成 | ✅ | 已完成 |
| 阻塞 | 🔴 | 遇到阻塞 |
| 延期 | ⚠️ | 进度延期 |

---

## 6. 会议与汇报

### 6.1 例会安排

| 会议类型 | 频率 | 参与人 | 时长 |
|----------|------|--------|------|
| 每日站会 | 每日 | 全体开发 | 15min |
| 周进度会 | 每周 | 项目组 | 30min |
| 里程碑评审 | 里程碑节点 | 项目组+产品 | 1h |

### 6.2 汇报模板

```
## 周进度汇报 - Week X

### 本周完成
- [任务1]
- [任务2]

### 下周计划
- [任务1]
- [任务2]

### 问题与风险
- [问题描述] → [应对措施]

### 需要协调
- [事项]
```

---

## 7. 变更记录

| 日期 | 版本 | 变更内容 | 变更人 |
|------|------|----------|--------|
| 2026-01-19 | v1.0 | 初始版本 | - |

---

*瑞小美技术团队 · 2026-01-19*