Pārlūkot izejas kodu

docs: 创建项目章程、验收标准、项目日志、环境检查清单

阶段零 T0.8 文档准备完成:
- charter.md: 项目章程(目标、功能模块、技术架构、里程碑)
- acceptance-criteria.md: M1-M4 里程碑验收标准
- project-log.md: 项目生命周期日志
- environment-checklist.md: 环境就绪检查清单
wubinggen 9 stundas atpakaļ
vecāks
revīzija
540c3c1b67
4 mainītis faili ar 347 papildinājumiem un 0 dzēšanām
  1. 132 0
      docs/acceptance-criteria.md
  2. 86 0
      docs/charter.md
  3. 54 0
      docs/environment-checklist.md
  4. 75 0
      docs/project-log.md

+ 132 - 0
docs/acceptance-criteria.md

@@ -0,0 +1,132 @@
+# 里程碑验收标准
+
+## M1 需求分析验收
+
+### 量化检查项
+
+- [ ] spec.md 每个功能模块有独立章节
+- [ ] use-cases.md 覆盖 charter.md 中每个功能点(61个)
+- [ ] constraints.md 包含所有技术约束和业务约束
+- [ ] "给下游团队的关键信息"完整
+
+### 交付产物
+
+| 文件 | 说明 |
+|------|------|
+| spec.md | 需求规格文档 |
+| use-cases.md | 用例文档 |
+| constraints.md | 约束条件 |
+| DELIVERY-MANIFEST.md | 交付清单 |
+
+### 覆盖度要求
+
+- 模块数覆盖:≥ 10/10
+- 功能点覆盖:≥ 61/61
+
+---
+
+## M2 架构设计验收
+
+### 量化检查项
+
+- [ ] api-definition.md 接口数 ≥ spec.md 功能点数
+- [ ] DDL 每张表有字段注释
+- [ ] 设计文档包含系统架构图、数据流图
+- [ ] "给下游团队的关键信息"完整
+
+### 交付产物
+
+| 文件 | 说明 |
+|------|------|
+| design.md | 架构设计文档 |
+| api-definition.md | 接口定义 |
+| tech-stack.md | 技术选型说明 |
+| DELIVERY-MANIFEST.md | 交付清单 |
+
+### 覆盖度要求
+
+- API 接口覆盖:≥ 61 个接口
+- 数据库表覆盖:≥ 15 张表
+
+---
+
+## M3 编码实现验收
+
+### 量化检查项
+
+- [ ] DELIVERY-MANIFEST.md 中注明编译自检结果
+- [ ] 业务领导复核 `mvn compile` 零错误
+- [ ] 每个 Controller 方法对应 api-definition.md 中一个接口
+- [ ] 风险导向分层代码抽查通过
+- [ ] MyBatis XML 无 `${}` 注入风险
+
+### 交付产物
+
+| 文件 | 说明 |
+|------|------|
+| 代码文件 | src/main/java/ 下的业务代码 |
+| MyBatis XML | src/main/resources/mapper/ 下的映射文件 |
+| DELIVERY-MANIFEST.md | 交付清单(含修改文件清单) |
+
+### 代码质量要求
+
+- Controller 类:无硬编码密钥,用户输入有校验
+- Service 类:异常处理合理,关键路径有日志
+- MyBatis XML:全部使用 `#{}` 参数化
+- 文件行数:≤ 500 行/文件
+
+---
+
+## M4 测试验收
+
+### 量化检查项
+
+- [ ] 测试用例数 ≥ use-cases.md 用例数
+- [ ] 自动化测试 `mvn test` 通过
+- [ ] Bug 清单含复现步骤+严重等级
+- [ ] 测试覆盖业务领导指定的重点场景
+- [ ] 核心接口测试覆盖率 ≥ 80%
+
+### 交付产物
+
+| 文件 | 说明 |
+|------|------|
+| test-cases.md | 测试用例 |
+| test-report.md | 测试报告 |
+| bug-list.md | Bug 清单 |
+| DELIVERY-MANIFEST.md | 交付清单 |
+| src/test/java/ | 自动化测试代码 |
+
+### 测试质量要求
+
+- 通过率:`mvn test` 全部通过
+- 独立性:每个测试方法独立运行
+- 可重复:同一测试多次运行结果一致
+- 不修改源代码:测试代码不得修改 src/main/java/
+- JUnit 4 风格:使用 `@Test` 注解
+
+---
+
+## 阶段零验收
+
+### 环境就绪检查
+
+| 序号 | 检查项 | 状态 |
+|------|--------|------|
+| 1 | `mvn compile` 零错误 | ✓ |
+| 2 | 数据库连接正常,全量表结构创建完成 | □ |
+| 3 | OSS Bucket 可访问 | □ |
+| 4 | 短信 SDK 可调用 | □ |
+| 5 | Redis 连接正常 | □ |
+| 6 | 微信小程序开发者账号就绪 | □ |
+| 7 | Git 仓库可 push/pull | ✓ |
+| 8 | `mvn spring-boot:run` 启动无报错 | □ |
+
+### 文档就绪检查
+
+| 序号 | 检查项 | 状态 |
+|------|--------|------|
+| 1 | docs/charter.md 已创建 | ✓ |
+| 2 | docs/acceptance-criteria.md 已创建 | ✓ |
+| 3 | docs/project-log.md 已创建 | □ |
+| 4 | docs/environment-checklist.md 已创建 | □ |

+ 86 - 0
docs/charter.md

@@ -0,0 +1,86 @@
+# 项目章程 — 洒渔镇苹果产业供需对接平台
+
+## 项目基本信息
+
+- **项目名称**: 洒渔镇苹果产业供需对接平台
+- **项目代号**: SAYU-APP
+- **启动时间**: 2026-05-30
+- **项目负责**: 业务领导
+
+## 项目目标
+
+为云南昭通洒渔镇苹果产业构建一个供需对接平台,服务于四类主体:
+
+1. **果农** — 发布果园信息、招工需求、查看行情
+2. **工人** — 查看招工信息、报名务工、管理个人档案
+3. **客商** — 查看货源信息、联系果农、批量采购
+4. **农资商** — 发布农资产品、管理店铺
+
+平台通过微信小程序提供移动端服务,后台管理系统供政府管理部门运营使用。
+
+## 核心功能模块
+
+| 模块 | 功能点数 | 优先级 |
+|------|---------|--------|
+| 用户体系(注册/登录/认证) | 8 | P0 |
+| 果农功能(档案/招工/视频/照片) | 14 | P0 |
+| 工人功能(档案/报名/状态) | 6 | P0 |
+| 客商功能(货源/联系/授权) | 5 | P0 |
+| 农资商功能(店铺/商品) | 2 | P1 |
+| 行情与数据大屏 | 6 | P1 |
+| 审核与运营管理 | 8 | P1 |
+| 系统管理(角色/权限/字典) | 6 | P0 |
+| 投诉与信用机制 | 3 | P1 |
+| 导出与报表 | 3 | P2 |
+
+**总计**: 61 个功能点
+
+## 技术架构
+
+- **后端**: Java 8 / Spring Boot 1.5.9 / Maven 单体项目
+- **数据库**: MySQL(`crrc` 库)
+- **ORM**: MyBatis(XML 映射)
+- **缓存**: Redis
+- **小程序**: 微信原生开发
+- **后台管理**: Vue 2 + Element UI + ECharts
+- **视频存储**: 阿里云 OSS(前端直传)
+- **短信服务**: 阿里云短信 API
+
+## 四阶段里程碑
+
+| 阶段 | 名称 | 工期 | 功能点 |
+|------|------|------|--------|
+| 阶段零 | 环境准备 | 0.5 周 | 项目骨架、数据库、外部服务 |
+| 阶段一 | 基础设施与用户体系 | 3-4 周 | 20 个功能点 |
+| 阶段二a | 果农核心功能 | 3 周 | 14 个功能点 |
+| 阶段二b | 工人+客商+农资 | 2 周 | 13 个功能点 |
+| 阶段三 | 运营功能与统计 | 2 周 | 14 个功能点 |
+
+## 验收标准
+
+详见 `docs/acceptance-criteria.md`
+
+## 约束条件
+
+1. 手机号 AES 加密存储,`phone_hash`(SHA256) 建唯一索引
+2. 所有业务表带 `user_identity_id` 字段,实现数据隔离
+3. MyBatis XML 中参数必须使用 `#{}` 语法,禁止 `${}`
+4. 视频上传:≤50MB/720p/2Mbps/≤5分钟
+5. 适老化:正文≥18px(rem)、按钮≥88×88px
+6. 审核 SLA:≤24小时提醒,48小时升级
+
+## 关键风险
+
+| 风险 | 影响 | 缓解措施 |
+|------|------|----------|
+| 阿里云短信审核延迟 | 阶段一阻塞 | 提前申请,备选方案 |
+| 微信小程序审核周期 | 上线延迟 | 提前准备材料 |
+| 视频上传性能 | 用户体验 | OSS 直传,前端压缩 |
+| 数据库性能 | 大屏响应 | Redis 缓存,索引优化 |
+
+## 参考文档
+
+- 功能清单:`docs/洒渔镇苹果产业供需对接平台功能清单-V1.0.docx`
+- 需求规格:`docs/requirements-specification.md`
+- 阶段规划:`docs/phase-planning.md`
+- 开发流程:`docs/multi-agent-git-workflow-v2.1.md`

+ 54 - 0
docs/environment-checklist.md

@@ -0,0 +1,54 @@
+# 环境就绪检查清单
+
+## 检查时间: 2026-05-30
+
+### 基础环境
+
+| 序号 | 检查项 | 状态 | 说明 |
+|------|--------|------|------|
+| 1 | JDK 8 安装 | ✓ | java version "1.8.0_291" |
+| 2 | Maven 3.6.3 安装 | ✓ | Apache Maven 3.6.3 |
+| 3 | `mvn compile` 零错误 | ✓ | BUILD SUCCESS |
+| 4 | Git 仓库可 push/pull | ✓ | 已推送到 Gogs |
+
+### 数据库
+
+| 序号 | 检查项 | 状态 | 说明 |
+|------|--------|------|------|
+| 5 | MySQL 连接正常 | □ | 需配置 application.properties |
+| 6 | 数据库 crrc 创建 | □ | 需执行 CREATE DATABASE |
+| 7 | 全量表结构创建 | □ | 15 张表,详见 phase-0-tasks.md T0.4 |
+| 8 | 初始数据导入 | □ | 字典数据、管理员账号 |
+
+### 外部服务
+
+| 序号 | 检查项 | 状态 | 说明 |
+|------|--------|------|------|
+| 9 | Redis 连接正常 | □ | 需配置 application.properties |
+| 10 | 阿里云 OSS Bucket | □ | 需创建 Bucket,配置 CORS |
+| 11 | 阿里云短信 | □ | 需申请签名、报备模板 |
+| 12 | 微信小程序 AppID | □ | 需申请小程序账号 |
+
+### 应用启动
+
+| 序号 | 检查项 | 状态 | 说明 |
+|------|--------|------|------|
+| 13 | `mvn spring-boot:run` 启动无报错 | □ | 需数据库就绪后验证 |
+| 14 | 启动日志无 ERROR | □ | 需数据库就绪后验证 |
+
+---
+
+## 阻塞项
+
+1. **数据库配置** — 需要用户提供 MySQL 连接信息(地址、端口、用户名、密码)
+2. **Redis 配置** — 需要用户提供 Redis 连接信息
+3. **阿里云配置** — 需要用户提供 OSS 和短信的 AccessKey
+4. **微信配置** — 需要用户提供小程序 AppID 和 AppSecret
+
+## 下一步
+
+1. 用户提供上述配置信息
+2. 更新 application.properties
+3. 执行数据库建表 SQL
+4. 验证应用启动
+5. 派单 Team A 开始阶段一需求分析

+ 75 - 0
docs/project-log.md

@@ -0,0 +1,75 @@
+# 项目生命周期日志
+
+## 项目基本信息
+- **项目名称**: 洒渔镇苹果产业供需对接平台
+- **启动时间**: 2026-05-30
+- **项目目标**: 为洒渔镇苹果产业构建供需对接平台,服务果农/工人/客商/农资商四类主体
+- **当前状态**: 进行中
+
+---
+
+## 日志记录
+
+### [2026-05-30 16:00] 项目启动
+- **动作**: 初始化项目仓库,定义项目章程
+- **产出**: 
+  - `docs/charter.md` — 项目章程
+  - `docs/acceptance-criteria.md` — 里程碑验收标准
+  - `docs/project-log.md` — 本日志
+
+### [2026-05-30 16:30] 阶段零 — 项目骨架初始化
+- **动作**: 创建 Maven 单体项目结构
+- **产出**:
+  - `service/pom.xml` — Maven 构建配置(Spring Boot 1.5.9)
+  - `service/src/main/java/com/fenzhitech/crrc/` — 标准包结构
+  - `service/src/main/resources/application.properties` — 应用配置
+  - `wxapp/` — 微信小程序骨架
+  - `wxbackstage/` — 后台管理前端骨架
+- **状态**: 完成
+
+### [2026-05-30 17:00] 阶段零 — Git 仓库初始化
+- **动作**: 初始化 Git 仓库,配置远程仓库
+- **产出**:
+  - 本地仓库初始化,main 分支
+  - 远程仓库:`https://gogs.wxapp.info/lio/sayu-app.git`
+  - 首次提交:`[init] 项目初始化`
+- **状态**: 完成
+
+### [2026-05-30 17:15] 阶段零 — 编译验证
+- **动作**: 验证 Maven 编译
+- **结果**: `mvn compile` BUILD SUCCESS
+- **状态**: 完成
+
+---
+
+## 过程改进数据
+
+### 阶段耗时统计
+
+| 阶段 | 派出时间 | 交付时间 | 总耗时 | 说明 |
+|------|---------|---------|--------|------|
+| 阶段零 | 2026-05-30 16:00 | 2026-05-30 17:15 | 1h 15m | 环境准备 |
+
+### 返工统计
+
+| 阶段 | 返工次数 | 团队 | 最常见原因 |
+|------|---------|------|-----------|
+| 阶段零 | 0 | - | - |
+
+### 一次通过率
+
+| 阶段 | 一次通过率 |
+|------|-----------|
+| 阶段零 | 100% |
+
+---
+
+## 待办事项
+
+- [ ] 数据库建表(T0.4)
+- [ ] Redis 配置(T0.5)
+- [ ] 阿里云 OSS 配置(T0.6)
+- [ ] 阿里云短信配置(T0.5)
+- [ ] 微信小程序配置(T0.6)
+- [ ] 启动冒烟测试(T0.7)
+- [ ] 派单 Team A — 阶段一需求分析