# 交付清单 — Team A 需求分析师

## 里程碑信息
- **阶段**: 阶段2a 果农核心功能
- **里程碑编号**: milestone-1（需求分析）
- **提交时间**: 2026-05-30
- **负责团队**: Team A

## 交付产物

| 序号 | 文件路径 | 说明 | 覆盖度检查 | 核心内容摘要 |
|------|----------|------|------------|--------------|
| 1 | deliveries/team-a-requirement/spec.md | 阶段2a需求规格 | 模块数: 5/5, 功能点: 14/14 | 果农名片、招工发布、找工人、找客商、后台审核 |
| 2 | deliveries/team-a-requirement/use-cases.md | 阶段2a用例文档 | 用例数: 32/32, 覆盖功能点: 14/14 | 名片7用例、招工6用例、找工人4用例、找客商3用例、审核7用例+2系统任务 |
| 3 | deliveries/team-a-requirement/constraints.md | 阶段2a约束条件 | 约束类别: 8/8 | 继承阶段一+新增文件上传/内容安全/招工规则/距离计算 |
| 4 | deliveries/team-a-requirement/DELIVERY-MANIFEST.md | 本交付清单 | - | 交付物清单、关键信息、问题反馈 |

## 修改文件清单

| 序号 | 文件路径 | 操作类型 | 说明 |
|------|----------|----------|------|
| 1 | deliveries/team-a-requirement/spec.md | 覆盖更新 | 从阶段一更新为阶段2a需求规格 |
| 2 | deliveries/team-a-requirement/use-cases.md | 覆盖更新 | 从阶段一更新为阶段2a用例文档 |
| 3 | deliveries/team-a-requirement/constraints.md | 覆盖更新 | 从阶段一更新为阶段2a约束条件 |
| 4 | deliveries/team-a-requirement/DELIVERY-MANIFEST.md | 覆盖更新 | 本交付清单 |

## 交付说明

本次交付为阶段2a（果农核心功能）的需求分析成果，基于需求规格说明书（requirements-specification.md）和阶段2a任务清单（phase-2a-tasks.md）提取和细化。

### 核心内容

1. **果农名片模块**（4个功能点）
   - 名片信息维护：品种、产量、价格、地址、经纬度
   - 视频上传：3步流程（前端预处理→后端存储→异步压缩）
   - 照片上传：≤9张，单张≤5MB，EXIF清除
   - 审核状态：待审/已通过/被驳回（驳回显示原因）

2. **招工发布与管理模块**（5个功能点）
   - 发布招工：免审核直接发布，表单字段完整
   - 敏感关键词检测：正则匹配，keyword_flag标记，不阻塞发布
   - 招工编辑：可编辑价格、人数、天数、备注
   - 招工下架：逻辑删除（status=0）
   - 我的招工列表：历史记录查看

3. **找工人模块**（2个功能点）
   - 工人列表：工种筛选、距离排序（Haversine公式）、状态展示
   - 一键拨号：调用拨号接口记录日志，唤起系统拨号

4. **找客商模块**（2个功能点）
   - 客商列表：基本信息展示
   - 一键拨号：同找工人拨号流程

5. **后台审核模块**（3个功能点）
   - 名片审核：通过/驳回（需填原因），审核日志
   - 待复核列表：敏感词标记招工处理，标记正常/强制下架
   - 审核SLA提醒：24小时提醒审核员，48小时升级超级管理员

## 给下游团队的关键信息

### 关键决策

1. **视频上传方案**: 本地文件存储（非OSS），3步流程：前端预处理→后端存储→异步压缩
2. **招工发布规则**: 免审核直接发布，敏感词标记不阻塞
3. **距离计算**: Haversine公式实时计算，经纬度DECIMAL(10,7)精度
4. **拨号机制**: 手机号通过单独接口获取（记录日志），列表不直接返回
5. **审核SLA**: 24小时提醒，48小时升级，定时任务实现

### 隐含约束

1. **视频仅限1个**，照片≤9张（数据库字段设计决定）
2. **招工编辑后重新触发敏感词检测**（防规避）
3. **距离计算需要果园地址→经纬度**（地理编码依赖）
4. **拨号日志是独立接口**，不在列表接口中返回手机号
5. **审核结果需通知果农**（短信或站内信）

### 特别注意

1. **视频压缩是异步操作**：上传后立即返回URL，压缩在后台进行
2. **敏感词不阻塞发布**：keyword_flag=1的招工仍然对工人可见
3. **驳回后可重新提交**：状态重置为待审，清除驳回原因
4. **EXIF清除是前端责任**：后端不做二次清除（性能考虑）

### 阶段2a新增接口清单

| 接口 | 方法 | 说明 | 状态 |
|------|------|------|------|
| /api/wx/grower/profile | GET | 获取果农档案 | 新增 |
| /api/wx/grower/profile | PUT | 更新果农档案 | 新增 |
| /api/wx/grower/recruit | POST | 发布招工 | 新增 |
| /api/wx/grower/recruit | GET | 我的招工列表 | 新增 |
| /api/wx/grower/recruit/{id} | PUT | 编辑招工 | 新增 |
| /api/wx/grower/recruit/{id} | DELETE | 下架招工 | 新增 |
| /api/wx/grower/workers | GET | 工人列表 | 新增 |
| /api/wx/grower/buyers | GET | 客商列表 | 新增 |
| /api/wx/call/phone | POST | 拨号接口 | 新增 |
| /api/admin/audit/grower-profile | GET | 名片审核列表 | 新增 |
| /api/admin/audit/grower-profile/{id} | PUT | 名片审核操作 | 新增 |
| /api/admin/audit/recruit-review | GET | 待复核列表 | 新增 |
| /api/admin/audit/recruit-review/{id} | PUT | 待复核操作 | 新增 |

**已有接口（阶段2a复用）**:
| 接口 | 方法 | 说明 | 状态 |
|------|------|------|------|
| /api/wx/file/upload/image | POST | 上传图片 | 已实现 |
| /api/wx/file/upload/video | POST | 上传视频 | 已实现 |
| /api/wx/file/files/{category}/{filename} | GET | 访问文件 | 已实现 |
| /api/wx/file/delete | DELETE | 删除文件 | 已实现 |

## 对上团队的问题

无。需求规格文档（requirements-specification.md）已完整覆盖阶段2a所有功能点。

## 待确认事项

1. **地理编码服务**: 果园地址→经纬度转换使用哪个服务？（高德/百度/腾讯地图API）
2. **语音输入**: 小程序端语音识别使用微信原生API还是第三方服务？
3. **敏感词库**: 初始词库范围需要业务方确认（当前仅含明确违规词）
4. **审核通知**: 审核结果通知方式（短信/站内信/小程序模板消息）
5. **视频压缩**: 是否需要部署FFmpeg？还是使用Java原生压缩库？