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 里程碑验收标准：

• 生产环境正常运行
• 用户验收测试通过
• 文档齐全
• 培训完成
• 正式上线

---

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