# 交付清单 — Team B 架构师

## 里程碑信息
- **阶段**: 阶段2a 果农核心功能
- **里程碑编号**: milestone-2（架构设计）
- **提交时间**: 2026-05-30
- **负责团队**: Team B

## 交付产物

| 序号 | 文件路径 | 说明 | 覆盖度检查 | 核心内容摘要 |
|------|----------|------|------------|--------------|
| 1 | deliveries/team-b-architecture/design.md | 架构设计文档 | 模块数: 5/5, 新增文件: 20个 | 果农名片、招工、搜索、文件、审核模块架构 |
| 2 | deliveries/team-b-architecture/api-definition.md | 接口定义文档 | 新增接口: 13/13, 已有接口: 4/4 | 果农名片2、招工4、搜索2、拨号1、审核4 |
| 3 | deliveries/team-b-architecture/tech-stack.md | 技术选型文档 | 类别: 8/8 | 继承阶段一+距离计算、敏感词检测、视频压缩 |
| 4 | deliveries/team-b-architecture/DELIVERY-MANIFEST.md | 本交付清单 | - | 交付物清单、关键信息、问题反馈 |

## 修改文件清单

| 序号 | 文件路径 | 操作类型 | 说明 |
|------|----------|----------|------|
| 1 | deliveries/team-b-architecture/design.md | 覆盖更新 | 从阶段一更新为阶段2a架构设计 |
| 2 | deliveries/team-b-architecture/api-definition.md | 覆盖更新 | 从阶段一更新为阶段2a接口定义 |
| 3 | deliveries/team-b-architecture/tech-stack.md | 覆盖更新 | 从阶段一更新为阶段2a技术选型 |
| 4 | deliveries/team-b-architecture/DELIVERY-MANIFEST.md | 覆盖更新 | 本交付清单 |

## 交付说明

本次交付为阶段2a（果农核心功能）的架构设计成果，基于 Team A 的需求规格（阶段2a spec.md）进行设计。

### 核心内容

1. **架构扩展**
   - 新增5个业务模块：果农模块、招工模块、搜索模块、文件模块、审核扩展
   - 新增20个Java源文件
   - 继承阶段一四层架构

2. **数据库设计**
   - 核心表：grower_profile、recruit_info、call_log
   - 索引设计：经纬度复合索引（距离查询）、keyword_flag索引（待复核查询）
   - JSON字段规范：varieties、photos、work_types、skills

3. **接口设计**
   - 新增接口：13个
   - 已有接口复用：4个（文件上传）
   - 覆盖14个功能点

4. **关键技术方案**
   - 距离计算：Haversine公式，纯Java实现
   - 敏感词检测：正则匹配，keyword_flag标记
   - 视频压缩：FFmpeg异步压缩，720p/2Mbps
   - 文件存储：本地存储，UUID文件名

5. **安全设计**
   - 文件上传：格式白名单+大小限制
   - 内容安全：敏感词检测+待复核
   - 拨号安全：日志记录+数据脱敏

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

### 关键决策

1. **距离计算**: Haversine公式实时计算，经纬度DECIMAL(10,7)精度
2. **敏感词机制**: 不阻塞发布，keyword_flag标记进入待复核
3. **视频压缩**: FFmpeg异步执行，失败重试3次
4. **文件命名**: UUID重命名，防止路径穿越
5. **拨号机制**: 单独接口获取手机号，记录拨号日志

### 隐含约束

1. **JSON字段查询**: MySQL 5.7不支持JSON索引，使用LIKE查询（性能可接受）
2. **距离计算优化**: 可先用矩形范围筛选（经纬度差值），再精确计算
3. **视频压缩依赖FFmpeg**: 需要系统安装FFmpeg，否则使用备选方案
4. **文件大小限制**: application.properties配置，前端和后端双重校验
5. **审核SLA**: 需要定时任务支持（ScheduledExecutorService）

### 特别注意

1. **招工编辑后重新检测敏感词**: 防止通过编辑规避检测
2. **名片更新重置审核状态**: 修改后需重新审核
3. **拨号日志是独立接口**: 不在列表接口中返回手机号
4. **文件访问免认证**: /api/wx/file/files/** 路径排除在JWT拦截器外

### 阶段2a新增文件清单

| 文件 | 说明 | 依赖 |
|------|------|------|
| GrowerProfileController.java | 果农档案API | GrowerProfileService |
| GrowerProfileService.java | 果农档案业务 | GrowerProfileMapper |
| GrowerProfileMapper.xml | 果农档案映射 | - |
| RecruitController.java | 招工CRUD API | RecruitService, KeywordCheckService |
| RecruitService.java | 招工业务 | RecruitMapper, KeywordCheckService |
| RecruitMapper.xml | 招工映射 | - |
| WorkerSearchController.java | 工人列表API | WorkerSearchService |
| WorkerSearchService.java | 工人搜索 | WorkerProfileMapper, DistanceUtil |
| BuyerSearchController.java | 客商列表API | BuyerSearchService |
| BuyerSearchService.java | 客商搜索 | BuyerProfileMapper |
| CallPhoneController.java | 拨号API | CallLogService |
| CallLogService.java | 拨号日志 | CallLogMapper |
| CallLogMapper.xml | 拨号日志映射 | - |
| GrowerAuditController.java | 名片审核API | GrowerAuditService |
| GrowerAuditService.java | 名片审核 | GrowerProfileMapper, AuditLogService |
| RecruitReviewController.java | 待复核API | RecruitReviewService |
| RecruitReviewService.java | 待复核 | RecruitMapper, AuditLogService |
| KeywordCheckService.java | 敏感词检测 | - |
| DistanceUtil.java | 距离计算 | - |
| VideoCompressService.java | 视频压缩 | - |

## 对上团队的问题

无。Team A 的需求规格清晰完整，架构设计无歧义。

## 待确认事项

1. **FFmpeg安装**: 服务器是否已安装FFmpeg？如未安装，视频压缩需要备选方案
2. **地理编码**: 地址→经纬度转换由前端还是后端完成？建议前端处理
3. **敏感词库**: 初始词库范围需要业务方确认
4. **语音输入**: 小程序端语音识别使用微信原生API还是第三方服务？
5. **审核SLA**: 定时任务使用ScheduledExecutorService还是Quartz？