[milestone-2] 阶段2a Team B 架构设计交付

- design.md: 5模块架构+20个新增文件+距离计算/敏感词/视频压缩方案
- api-definition.md: 13个新增接口+4个已有接口覆盖14功能点
- tech-stack.md: 继承阶段一+Haversine/正则匹配/FFmpeg技术选型
- DELIVERY-MANIFEST.md: 交付清单含关键决策和待确认事项

deliveries/team-b-architecture/DELIVERY-MANIFEST.md

@@ -1,84 +1,110 @@
 # 交付清单 — Team B 架构师
 
 ## 里程碑信息
-- **阶段**: 架构设计
-- **里程碑编号**: milestone-2
-- **提交时间**: 2026-05-30 18:00
+- **阶段**: 阶段2a 果农核心功能
+- **里程碑编号**: milestone-2（架构设计）
+- **提交时间**: 2026-05-30
 - **负责团队**: Team B
 
 ## 交付产物
 
 | 序号 | 文件路径 | 说明 | 覆盖度检查 | 核心内容摘要 |
 |------|----------|------|------------|--------------|
-| 1 | deliveries/team-b-architecture/design.md | 架构设计文档 | 模块数: 5/5, 架构层: 4/4 | 系统架构、数据库设计、接口设计、安全设计、技术选型 |
-| 2 | deliveries/team-b-architecture/api-definition.md | 接口定义文档 | 接口数: 25/25, 模块数: 5/5 | 认证5接口、用户4接口、系统8接口、审核3接口、首页5接口 |
-| 3 | deliveries/team-b-architecture/tech-stack.md | 技术选型文档 | 类别: 8/8 | 后端技术栈、前端技术栈、开发工具、部署环境、设计规范 |
+| 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 | 新增 | 架构设计文档 |
-| 2 | deliveries/team-b-architecture/api-definition.md | 新增 | 接口定义文档 |
-| 3 | deliveries/team-b-architecture/tech-stack.md | 新增 | 技术选型文档 |
-| 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 | 覆盖更新 | 本交付清单 |
 
 ## 交付说明
 
-本次交付为阶段一（基础设施与用户体系）的架构设计成果，基于 Team A 的需求规格（spec.md）进行设计。
+本次交付为阶段2a（果农核心功能）的架构设计成果，基于 Team A 的需求规格（阶段2a spec.md）进行设计。
 
 ### 核心内容
 
-1. **系统架构设计**
-   - 四层架构：客户端层 → API网关层 → 业务逻辑层 → 数据存储层
-   - 模块划分：用户模块、系统模块、审核模块、首页模块、通用模块
-   - 分层职责：Controller（API入口）→ Service（业务逻辑）→ Mapper（数据访问）
+1. **架构扩展**
+   - 新增5个业务模块：果农模块、招工模块、搜索模块、文件模块、审核扩展
+   - 新增20个Java源文件
+   - 继承阶段一四层架构
 
 2. **数据库设计**
-   - 核心表：sys_user、user_identity、sys_role、sys_permission、sys_dict、audit_log、operation_log
-   - 索引设计：phone_hash唯一索引、openid唯一索引、user_id索引、identity_type索引
-   - 加密方案：手机号AES加密存储，SHA256哈希用于查询
+   - 核心表：grower_profile、recruit_info、call_log
+   - 索引设计：经纬度复合索引（距离查询）、keyword_flag索引（待复核查询）
+   - JSON字段规范：varieties、photos、work_types、skills
 
 3. **接口设计**
-   - 接口总数：25个
-   - 模块分布：认证5个、用户4个、系统8个、审核3个、首页5个
-   - 接口规范：RESTful风格，统一响应格式，错误码规范
+   - 新增接口：13个
+   - 已有接口复用：4个（文件上传）
+   - 覆盖14个功能点
 
-4. **安全设计**
-   - 认证流程：JWT Token认证，拦截器校验，RBAC权限控制
-   - 数据安全：手机号加密、密码BCrypt、敏感数据脱敏
-   - 接口安全：参数校验、SQL注入防护、防重放攻击
+4. **关键技术方案**
+   - 距离计算：Haversine公式，纯Java实现
+   - 敏感词检测：正则匹配，keyword_flag标记
+   - 视频压缩：FFmpeg异步压缩，720p/2Mbps
+   - 文件存储：本地存储，UUID文件名
 
-5. **技术选型**
-   - 后端：Java 8 + Spring Boot 1.5.9 + MyBatis + MySQL + Redis
-   - 前端：微信小程序 + Vue 2 + Element UI + ECharts
-   - 工具：Maven + Git + Gogs
+5. **安全设计**
+   - 文件上传：格式白名单+大小限制
+   - 内容安全：敏感词检测+待复核
+   - 拨号安全：日志记录+数据脱敏
 
 ## 给下游团队的关键信息
 
 ### 关键决策
 
-1. **分层架构**: Controller → Service → Mapper，职责清晰，便于测试
-2. **接口设计**: 25个接口覆盖20个功能点，部分功能合并为单个接口
-3. **数据库设计**: 7张核心表，索引设计覆盖高频查询场景
-4. **安全方案**: JWT认证 + RBAC权限 + 手机号加密，满足安全要求
-5. **技术栈**: 固定版本，避免兼容性问题
+1. **距离计算**: Haversine公式实时计算，经纬度DECIMAL(10,7)精度
+2. **敏感词机制**: 不阻塞发布，keyword_flag标记进入待复核
+3. **视频压缩**: FFmpeg异步执行，失败重试3次
+4. **文件命名**: UUID重命名，防止路径穿越
+5. **拨号机制**: 单独接口获取手机号，记录拨号日志
 
 ### 隐含约束
 
-1. **Controller 必须参数校验**: 使用 @Valid 或手动校验
-2. **Service 必须事务管理**: 使用 @Transactional 注解
-3. **Mapper 必须 #{} 参数化**: 禁止使用 ${}
-4. **接口响应必须统一格式**: 使用 ApiResult 包装
-5. **敏感数据必须脱敏**: 手机号、密码等
+1. **JSON字段查询**: MySQL 5.7不支持JSON索引，使用LIKE查询（性能可接受）
+2. **距离计算优化**: 可先用矩形范围筛选（经纬度差值），再精确计算
+3. **视频压缩依赖FFmpeg**: 需要系统安装FFmpeg，否则使用备选方案
+4. **文件大小限制**: application.properties配置，前端和后端双重校验
+5. **审核SLA**: 需要定时任务支持（ScheduledExecutorService）
 
 ### 特别注意
 
-1. **身份路由逻辑**: 0个身份→提示联系村委会，1个身份→直接进入，N个身份→选择页
-2. **密码锁定机制**: 连续5次错误锁定30分钟，需记录锁定时间
-3. **审核SLA**: ≤24小时提醒，48小时升级，需定时任务支持
-4. **Token黑名单**: 退出登录时将Token加入Redis黑名单
+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 | 视频压缩 | - |
 
 ## 对上团队的问题
 
@@ -86,6 +112,8 @@
 
 ## 待确认事项
 
-1. **数据库连接池**: 建议使用 HikariCP（Spring Boot 1.5.x 默认），是否需要调整？
-2. **日志框架**: 建议使用 Logback（Spring Boot 默认），是否需要切换？
-3. **缓存策略**: Token黑名单和验证码使用Redis，是否需要其他缓存？
+1. **FFmpeg安装**: 服务器是否已安装FFmpeg？如未安装，视频压缩需要备选方案
+2. **地理编码**: 地址→经纬度转换由前端还是后端完成？建议前端处理
+3. **敏感词库**: 初始词库范围需要业务方确认
+4. **语音输入**: 小程序端语音识别使用微信原生API还是第三方服务？
+5. **审核SLA**: 定时任务使用ScheduledExecutorService还是Quartz？

deliveries/team-b-architecture/api-definition.md

@@ -1,78 +1,40 @@
-# 阶段一接口定义 — 基础设施与用户体系
+# 阶段2a接口定义 — 果农核心功能
 
-> 接口总数：25 个
-> 覆盖功能点：20/20
+> 新增接口总数：13 个
+> 已有接口（复用）：4 个
+> 覆盖功能点：14/14
 
 ---
 
 ## 一、接口总览
 
+### 阶段2a新增接口
+
 | 模块 | 接口数 | 说明 |
 |------|--------|------|
-| 认证模块 | 5 | 登录、登出、身份选择、Token刷新、密码修改 |
-| 用户模块 | 4 | 用户信息、状态管理、身份绑定、创建用户 |
-| 系统管理 | 8 | 角色、账号、字典、权限、操作日志 |
-| 审核模块 | 3 | 审核列表、审核操作、审核详情 |
-| 首页模块 | 5 | 果农/工人/客商/农资商首页、行情数据 |
-
-**总计**: 25 个接口
-
----
-
-## 二、认证模块接口
+| 果农名片 | 2 | 档案查询、档案更新 |
+| 招工管理 | 4 | 发布、列表、编辑、下架 |
+| 找工人/客商 | 2 | 工人列表、客商列表 |
+| 拨号 | 1 | 获取手机号+记录日志 |
+| 后台审核 | 4 | 名片审核列表/操作、待复核列表/操作 |
 
-### 2.1 POST /api/wx/auth/login — 微信登录
+**新增总计**: 13 个接口
 
-**描述**: 小程序用户通过微信 code 登录
-
-**请求头**:
-```
-Content-Type: application/json
-```
-
-**请求参数**:
-```json
-{
-  "code": "string" // 必填，微信 wx.login() 获取的 code
-}
-```
+### 已有接口（阶段2a复用）
 
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": {
-    "token": "string", // JWT Token
-    "userId": "long", // 用户ID
-    "identities": [ // 身份列表
-      {
-        "identityId": "long",
-        "identityType": "string", // GROWER/WORKER/BUYER/SUPPLIER
-        "identityName": "string"
-      }
-    ]
-  }
-}
-```
-
-**错误码**:
-- 1001: 未找到用户信息，请联系村委会
-- 1002: 微信接口调用失败
+| 模块 | 接口数 | 说明 |
+|------|--------|------|
+| 文件上传 | 4 | 图片上传、视频上传、文件访问、文件删除 |
 
 ---
 
-### 2.2 POST /api/admin/auth/login — 后台登录
+## 二、果农名片接口
 
-**描述**: 后台管理员通过用户名密码登录
+### 2.1 GET /api/wx/grower/profile — 获取果农档案
 
-**请求参数**:
-```json
-{
-  "username": "string", // 必填，用户名
-  "password": "string"  // 必填，密码
-}
-```
+**描述**: 获取当前果农的名片信息
+
+**请求头**: `Authorization: Bearer {token}`
 
 **响应参数**:
 ```json
@@ -80,36 +42,50 @@ Content-Type: application/json
   "code": 200,
   "message": "success",
   "data": {
-    "token": "string",
-    "userId": "long",
-    "username": "string",
-    "realName": "string",
-    "roleId": "long",
-    "roleName": "string"
+    "id": 1,
+    "name": "张三",
+    "varieties": ["红富士", "嘎啦"],
+    "yieldAmount": 50000.00,
+    "expectedPrice": 4.00,
+    "address": "洒渔镇黄兴村",
+    "latitude": 27.3331000,
+    "longitude": 103.7168000,
+    "videoUrl": "http://localhost:8080/files/video/abc.mp4",
+    "photos": [
+      "http://localhost:8080/files/image/1.jpg",
+      "http://localhost:8080/files/image/2.jpg"
+    ],
+    "auditStatus": 0,
+    "auditRemark": null
   }
 }
 ```
 
 **错误码**:
-- 1003: 用户名或密码错误
-- 1004: 账号已禁用
-- 1005: 账号已锁定，请30分钟后重试
+- 2001: 果农档案不存在
 
 ---
 
-### 2.3 POST /api/wx/auth/select-identity — 选择身份
+### 2.2 PUT /api/wx/grower/profile — 更新果农档案
 
-**描述**: 多身份用户选择当前使用的身份
+**描述**: 更新果农名片信息，审核状态重置为待审
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**请求头**: `Authorization: Bearer {token}`
 
 **请求参数**:
 ```json
 {
-  "identityId": "long" // 必填，身份ID
+  "name": "张三",                    // 必填，姓名
+  "varieties": ["红富士", "嘎啦"],    // 必填，品种（JSON数组）
+  "yieldAmount": 50000.00,           // 产量（斤）
+  "expectedPrice": 4.00,             // 预期价格（元/斤）
+  "address": "洒渔镇黄兴村",          // 必填，果园地址
+  "latitude": 27.3331000,            // 纬度
+  "longitude": 103.7168000,          // 经度
+  "videoUrl": "http://localhost:8080/files/video/abc.mp4",
+  "photos": [
+    "http://localhost:8080/files/image/1.jpg"
+  ]
 }
 ```
 
@@ -118,53 +94,40 @@ Authorization: Bearer {token}
 {
   "code": 200,
   "message": "success",
-  "data": {
-    "token": "string" // 包含新身份信息的 Token
-  }
+  "data": null
 }
 ```
 
+**业务逻辑**:
+1. 验证必填字段（name、varieties、address）
+2. 更新 grower_profile
+3. 重置 audit_status=0，清空 audit_remark
+
 **错误码**:
-- 1006: 身份不存在
+- 2002: 必填字段不能为空
 
 ---
 
-### 2.4 POST /api/wx/auth/refresh — 刷新Token
-
-**描述**: 刷新当前 Token 有效期
-
-**请求头**:
-```
-Authorization: Bearer {token}
-```
-
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": {
-    "token": "string"
-  }
-}
-```
-
----
+## 三、招工管理接口
 
-### 2.5 PUT /api/admin/auth/password — 修改密码
+### 3.1 POST /api/wx/grower/recruit — 发布招工
 
-**描述**: 后台管理员修改密码
+**描述**: 发布招工信息，免审核直接发布
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**请求头**: `Authorization: Bearer {token}`
 
 **请求参数**:
 ```json
 {
-  "oldPassword": "string", // 必填，旧密码
-  "newPassword": "string"  // 必填，新密码
+  "workTypes": ["采摘工", "分拣工"],   // 必填，工种（JSON数组）
+  "price": 150.00,                    // 必填，价格
+  "priceUnit": "DAY",                 // 必填，价格单位：DAY/PIECE
+  "workerCount": 3,                   // 必填，需要人数
+  "days": 5,                          // 天数
+  "location": "洒渔镇黄兴村",          // 必填，工作地点
+  "latitude": 27.3331000,             // 纬度
+  "longitude": 103.7168000,           // 经度
+  "remark": "需要有经验的采摘工"       // 备注
 }
 ```
 
@@ -173,25 +136,35 @@ Authorization: Bearer {token}
 {
   "code": 200,
   "message": "success",
-  "data": null
+  "data": {
+    "recruitId": 1
+  }
 }
 ```
 
+**业务逻辑**:
+1. 验证必填字段
+2. 敏感词检测（remark字段）
+3. keyword_flag=0 或 1
+4. 创建 recruit_info（status=1）
+
 **错误码**:
-- 1007: 旧密码错误
-- 1008: 新密码强度不足
+- 2003: 工种不能为空
+- 2004: 价格必须大于0
+- 2005: 人数必须大于0
+- 2006: 工作地点不能为空
 
 ---
 
-## 三、用户模块接口
+### 3.2 GET /api/wx/grower/recruit — 我的招工列表
 
-### 3.1 GET /api/wx/user/info — 获取用户信息
+**描述**: 获取当前果农发布的招工历史
 
-**描述**: 获取当前登录用户的基本信息
+**请求头**: `Authorization: Bearer {token}`
 
-**请求头**:
+**请求参数**:
 ```
-Authorization: Bearer {token}
+?page=1&pageSize=20
 ```
 
 **响应参数**:
@@ -200,41 +173,43 @@ Authorization: Bearer {token}
   "code": 200,
   "message": "success",
   "data": {
-    "userId": "long",
-    "realName": "string",
-    "phone": "string", // 脱敏显示：138****8888
-    "identities": [
+    "total": 5,
+    "page": 1,
+    "pageSize": 20,
+    "list": [
       {
-        "identityId": "long",
-        "identityType": "string",
-        "identityName": "string"
+        "id": 1,
+        "workTypes": ["采摘工", "分拣工"],
+        "price": 150.00,
+        "priceUnit": "DAY",
+        "workerCount": 3,
+        "days": 5,
+        "location": "洒渔镇黄兴村",
+        "status": 1,
+        "keywordFlag": 0,
+        "applyCount": 2,
+        "createdAt": "2026-05-30 10:00:00"
       }
-    ],
-    "currentIdentity": {
-      "identityId": "long",
-      "identityType": "string"
-    }
+    ]
   }
 }
 ```
 
 ---
 
-### 3.2 PUT /api/admin/user/status — 修改用户状态
+### 3.3 PUT /api/wx/grower/recruit/{id} — 编辑招工
 
-**描述**: 管理员修改用户账号状态
+**描述**: 编辑已发布的招工信息
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**请求头**: `Authorization: Bearer {token}`
 
 **请求参数**:
 ```json
 {
-  "userId": "long",    // 必填，用户ID
-  "status": "int",     // 必填，状态：0正常 1禁用 2锁定
-  "lockReason": "string" // 锁定时必填
+  "price": 180.00,
+  "workerCount": 5,
+  "days": 7,
+  "remark": "价格上调，急招"
 }
 ```
 
@@ -247,180 +222,53 @@ Authorization: Bearer {token}
 }
 ```
 
-**错误码**:
-- 1009: 用户不存在
-- 1010: 不可禁用超级管理员
-- 1011: 锁定原因不能为空
-
----
-
-### 3.3 POST /api/admin/user/bind-identity — 绑定身份
-
-**描述**: 管理员为用户绑定新身份
-
-**请求头**:
-```
-Authorization: Bearer {token}
-```
-
-**请求参数**:
-```json
-{
-  "userId": "long",        // 必填，用户ID
-  "identityType": "string", // 必填，身份类型
-  "profileData": {}         // 身份详细信息（JSON）
-}
-```
-
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": {
-    "identityId": "long"
-  }
-}
-```
+**业务逻辑**:
+1. 验证招工存在且属于当前用户
+2. 更新可编辑字段（price、workerCount、days、remark）
+3. 重新触发敏感词检测
 
 **错误码**:
-- 1012: 用户已有该身份
+- 2007: 招工不存在
+- 2008: 无权编辑此招工
 
 ---
 
-### 3.4 POST /api/admin/user — 创建用户
+### 3.4 DELETE /api/wx/grower/recruit/{id} — 下架招工
 
-**描述**: 管理员创建新用户
+**描述**: 下架已发布的招工（逻辑删除）
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
-
-**请求参数**:
-```json
-{
-  "realName": "string",    // 必填，真实姓名
-  "phone": "string",       // 必填，手机号
-  "identityType": "string", // 必填，身份类型
-  "profileData": {}         // 身份详细信息
-}
-```
+**请求头**: `Authorization: Bearer {token}`
 
 **响应参数**:
 ```json
 {
   "code": 200,
   "message": "success",
-  "data": {
-    "userId": "long"
-  }
+  "data": null
 }
 ```
 
-**错误码**:
-- 1013: 手机号已注册
-
----
-
-## 四、系统管理接口
-
-### 4.1 GET /api/admin/role/list — 角色列表
-
-**描述**: 获取系统角色列表
-
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**业务逻辑**:
+1. 验证招工存在且属于当前用户
+2. 更新 status=0
 
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": [
-    {
-      "id": "long",
-      "roleName": "string",
-      "roleCode": "string",
-      "description": "string",
-      "status": "int",
-      "isSystem": "int"
-    }
-  ]
-}
-```
+**错误码**:
+- 2007: 招工不存在
+- 2008: 无权操作此招工
 
 ---
 
-### 4.2 GET /api/admin/role/{id}/permissions — 角色权限
-
-**描述**: 获取指定角色的权限列表
-
-**请求头**:
-```
-Authorization: Bearer {token}
-```
-
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": [
-    {
-      "id": "long",
-      "permName": "string",
-      "permCode": "string",
-      "permType": "string",
-      "path": "string"
-    }
-  ]
-}
-```
-
----
+## 四、找工人/客商接口
 
-### 4.3 PUT /api/admin/role/{id}/permissions — 分配权限
+### 4.1 GET /api/wx/grower/workers — 工人列表
 
-**描述**: 为角色分配权限
+**描述**: 查找附近空闲工人
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**请求头**: `Authorization: Bearer {token}`
 
 **请求参数**:
-```json
-{
-  "permissionIds": ["long"] // 权限ID列表
-}
 ```
-
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": null
-}
-```
-
----
-
-### 4.4 GET /api/admin/account/list — 账号列表
-
-**描述**: 获取管理员账号列表（分页）
-
-**请求头**:
-```
-Authorization: Bearer {token}
-```
-
-**请求参数**:
-```
-?page=1&pageSize=10&keyword=string
+?workType=采摘工&page=1&pageSize=20
 ```
 
 **响应参数**:
@@ -429,44 +277,42 @@ Authorization: Bearer {token}
   "code": 200,
   "message": "success",
   "data": {
-    "total": "long",
-    "page": "int",
-    "pageSize": "int",
+    "total": 10,
+    "page": 1,
+    "pageSize": 20,
     "list": [
       {
-        "id": "long",
-        "username": "string",
-        "realName": "string",
-        "phone": "string", // 脱敏
-        "roleName": "string",
-        "status": "int",
-        "createdAt": "string"
+        "identityId": 5,
+        "name": "李四",
+        "skills": ["采摘工", "分拣工"],
+        "price": 150.00,
+        "priceUnit": "DAY",
+        "status": 1,
+        "distance": 2.5
       }
     ]
   }
 }
 ```
 
+**业务逻辑**:
+1. 查询 worker_profile.status=1（空闲）
+2. 可选按工种筛选
+3. 计算距离（Haversine公式）
+4. 按距离升序排序
+5. 分页返回
+
 ---
 
-### 4.5 POST /api/admin/account — 创建账号
+### 4.2 GET /api/wx/grower/buyers — 客商列表
 
-**描述**: 创建管理员账号
+**描述**: 查找收购客商
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**请求头**: `Authorization: Bearer {token}`
 
 **请求参数**:
-```json
-{
-  "username": "string", // 必填，用户名
-  "password": "string", // 必填，密码
-  "realName": "string", // 必填，真实姓名
-  "phone": "string",    // 必填，手机号
-  "roleId": "long"      // 必填，角色ID
-}
+```
+?page=1&pageSize=20
 ```
 
 **响应参数**:
@@ -475,67 +321,38 @@ Authorization: Bearer {token}
   "code": 200,
   "message": "success",
   "data": {
-    "accountId": "long"
+    "total": 5,
+    "page": 1,
+    "pageSize": 20,
+    "list": [
+      {
+        "identityId": 10,
+        "name": "王五果业",
+        "varieties": ["红富士", "嘎啦"],
+        "priceRange": "3.5-4.5",
+        "totalAmount": 100000.00,
+        "standards": "果径≥80mm",
+        "address": "昭通市水果批发市场"
+      }
+    ]
   }
 }
 ```
 
-**错误码**:
-- 1014: 用户名已存在
-- 1015: 手机号已注册
-- 1016: 密码强度不足
-
 ---
 
-### 4.6 GET /api/admin/dict/list — 字典列表
+## 五、拨号接口
 
-**描述**: 获取指定类型的字典列表
-
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+### 5.1 POST /api/wx/call/phone — 拨号接口
 
-**请求参数**:
-```
-?dictType=string
-```
+**描述**: 获取对方手机号并记录拨号日志
 
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": [
-    {
-      "id": "long",
-      "dictType": "string",
-      "dictCode": "string",
-      "dictName": "string",
-      "sortOrder": "int"
-    }
-  ]
-}
-```
-
----
-
-### 4.7 POST /api/admin/dict — 新增字典项
-
-**描述**: 新增字典项
-
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**请求头**: `Authorization: Bearer {token}`
 
 **请求参数**:
 ```json
 {
-  "dictType": "string",  // 必填，字典类型
-  "dictCode": "string",  // 必填，字典编码
-  "dictName": "string",  // 必填，字典名称
-  "sortOrder": "int"     // 排序号
+  "calleeIdentityId": 5    // 必填，被拨方身份ID
 }
 ```
 
@@ -545,72 +362,33 @@ Authorization: Bearer {token}
   "code": 200,
   "message": "success",
   "data": {
-    "dictId": "long"
+    "phone": "138****8888",      // 脱敏手机号（前端显示）
+    "realPhone": "13800138000"   // 真实手机号（用于拨号）
   }
 }
 ```
 
-**错误码**:
-- 1017: 字典编码已存在
-- 1018: 系统内置字典不可删除
-
----
-
-### 4.8 GET /api/admin/operation-log/list — 操作日志列表
-
-**描述**: 获取操作日志列表（分页）
+**业务逻辑**:
+1. 验证被拨方存在
+2. 记录拨号日志（call_log）
+3. 返回手机号
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
-
-**请求参数**:
-```
-?page=1&pageSize=10&operatorId=long&startTime=string&endTime=string
-```
-
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": {
-    "total": "long",
-    "page": "int",
-    "pageSize": "int",
-    "list": [
-      {
-        "id": "long",
-        "operatorName": "string",
-        "operationType": "string",
-        "operationModule": "string",
-        "operationContent": "string",
-        "ipAddress": "string",
-        "result": "int",
-        "createdAt": "string"
-      }
-    ]
-  }
-}
-```
+**错误码**:
+- 2009: 被拨方不存在
 
 ---
 
-## 五、审核模块接口
+## 六、后台审核接口
 
-### 5.1 GET /api/admin/audit/list — 审核列表
+### 6.1 GET /api/admin/audit/grower-profile — 名片审核列表
 
-**描述**: 获取审核列表（分页）
+**描述**: 获取待审核的果农名片列表
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**请求头**: `Authorization: Bearer {token}`
 
 **请求参数**:
 ```
-?page=1&pageSize=10&targetType=string&status=string
+?page=1&pageSize=10&status=0
 ```
 
 **响应参数**:
@@ -619,17 +397,20 @@ Authorization: Bearer {token}
   "code": 200,
   "message": "success",
   "data": {
-    "total": "long",
-    "page": "int",
-    "pageSize": "int",
+    "total": 3,
+    "page": 1,
+    "pageSize": 10,
     "list": [
       {
-        "id": "long",
-        "targetType": "string",
-        "targetId": "long",
-        "submitterName": "string",
-        "status": "string",
-        "createdAt": "string"
+        "id": 1,
+        "growerName": "张三",
+        "varieties": ["红富士"],
+        "yieldAmount": 50000.00,
+        "address": "洒渔镇黄兴村",
+        "videoUrl": "http://localhost:8080/files/video/abc.mp4",
+        "photos": ["http://localhost:8080/files/image/1.jpg"],
+        "auditStatus": 0,
+        "createdAt": "2026-05-30 10:00:00"
       }
     ]
   }
@@ -638,20 +419,17 @@ Authorization: Bearer {token}
 
 ---
 
-### 5.2 PUT /api/admin/audit/{id} — 审核操作
+### 6.2 PUT /api/admin/audit/grower-profile/{id} — 名片审核操作
 
-**描述**: 执行审核操作（通过/驳回）
+**描述**: 对果农名片执行审核操作
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**请求头**: `Authorization: Bearer {token}`
 
 **请求参数**:
 ```json
 {
-  "action": "string", // 必填，APPROVE/REJECT
-  "reason": "string"  // 驳回时必填
+  "action": "APPROVE",    // 必填，APPROVE/REJECT
+  "reason": ""            // 驳回时必填
 }
 ```
 
@@ -664,49 +442,27 @@ Authorization: Bearer {token}
 }
 ```
 
-**错误码**:
-- 1019: 审核记录不存在
-- 1020: 驳回原因不能为空
-
----
+**业务逻辑**:
+1. 验证审核记录存在
+2. APPROVE → audit_status=1
+3. REJECT → audit_status=2，audit_remark=reason
+4. 记录审核日志
 
-### 5.3 GET /api/admin/audit/{id} — 审核详情
-
-**描述**: 获取审核详情
-
-**请求头**:
-```
-Authorization: Bearer {token}
-```
-
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": {
-    "id": "long",
-    "targetType": "string",
-    "targetId": "long",
-    "targetData": {}, // 审核对象的详细数据
-    "submitterName": "string",
-    "status": "string",
-    "createdAt": "string"
-  }
-}
-```
+**错误码**:
+- 2010: 审核记录不存在
+- 2011: 驳回原因不能为空
 
 ---
 
-## 六、首页模块接口
+### 6.3 GET /api/admin/audit/recruit-review — 待复核招工列表
 
-### 6.1 GET /api/wx/home/grower — 果农首页
+**描述**: 获取敏感关键词标记的招工列表
 
-**描述**: 获取果农首页数据
+**请求头**: `Authorization: Bearer {token}`
 
-**请求头**:
+**请求参数**:
 ```
-Authorization: Bearer {token}
+?page=1&pageSize=10
 ```
 
 **响应参数**:
@@ -715,21 +471,18 @@ Authorization: Bearer {token}
   "code": 200,
   "message": "success",
   "data": {
-    "greeting": "string", // 问候语
-    "marketPrices": [
-      {
-        "variety": "string",
-        "priceMin": "decimal",
-        "priceMax": "decimal",
-        "trend": "string", // up/down/stable
-        "updateTime": "string"
-      }
-    ],
-    "quickEntries": [
+    "total": 2,
+    "page": 1,
+    "pageSize": 10,
+    "list": [
       {
-        "name": "string",
-        "icon": "string",
-        "path": "string"
+        "id": 1,
+        "workTypes": ["采摘工"],
+        "price": 150.00,
+        "remark": "日薪300元...",
+        "keywordFlag": 1,
+        "publisherName": "张三",
+        "createdAt": "2026-05-30 10:00:00"
       }
     ]
   }
@@ -738,137 +491,83 @@ Authorization: Bearer {token}
 
 ---
 
-### 6.2 GET /api/wx/home/worker — 工人首页
+### 6.4 PUT /api/admin/audit/recruit-review/{id} — 待复核操作
 
-**描述**: 获取工人首页推荐招工
+**描述**: 处理待复核招工
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**请求头**: `Authorization: Bearer {token}`
 
-**响应参数**:
+**请求参数**:
 ```json
 {
-  "code": 200,
-  "message": "success",
-  "data": {
-    "recommendedRecruits": [
-      {
-        "id": "long",
-        "workType": "string",
-        "price": "decimal",
-        "priceUnit": "string",
-        "days": "int",
-        "peopleCount": "int",
-        "growerName": "string",
-        "distance": "decimal" // 公里
-      }
-    ]
-  }
+  "action": "NORMAL",      // 必填，NORMAL/FORCE_OFFLINE
+  "reason": ""             // 强制下架时必填
 }
 ```
 
----
-
-### 6.3 GET /api/wx/home/buyer — 客商首页
-
-**描述**: 获取客商首页数据
-
-**请求头**:
-```
-Authorization: Bearer {token}
-```
-
 **响应参数**:
 ```json
 {
   "code": 200,
   "message": "success",
-  "data": {
-    "marketPrices": [...],
-    "recommendedGrowers": [
-      {
-        "identityId": "long",
-        "variety": "string",
-        "production": "decimal", // 斤
-        "expectedPrice": "decimal",
-        "orchardAddress": "string",
-        "distance": "decimal"
-      }
-    ]
-  }
+  "data": null
 }
 ```
 
+**业务逻辑**:
+1. 验证招工存在
+2. NORMAL → keyword_flag=0
+3. FORCE_OFFLINE → status=0，记录原因
+
+**错误码**:
+- 2012: 招工不存在
+- 2013: 下架原因不能为空
+
 ---
 
-### 6.4 GET /api/wx/home/supplier — 农资商首页
+## 七、已有接口（阶段2a复用）
 
-**描述**: 获取农资商首页数据
+### 7.1 POST /api/wx/file/upload/image — 上传图片
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**描述**: 上传图片文件（已实现）
 
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": {
-    "shopInfo": {
-      "shopName": "string",
-      "mainProducts": "string",
-      "productCount": "int"
-    },
-    "quickEntries": [
-      {"name": "商品管理", "path": "/pages/product/list"},
-      {"name": "订单管理", "path": "/pages/order/list"},
-      {"name": "店铺设置", "path": "/pages/shop/setting"}
-    ]
-  }
-}
-```
+**请求**: multipart/form-data
 
----
+**限制**: ≤5MB/张，格式：jpg,jpeg,png,gif
 
-### 6.5 GET /api/wx/market-price — 行情数据
+### 7.2 POST /api/wx/file/upload/video — 上传视频
 
-**描述**: 获取今日行情数据
+**描述**: 上传视频文件（已实现）
 
-**请求头**:
-```
-Authorization: Bearer {token}
-```
+**请求**: multipart/form-data
 
-**响应参数**:
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": [
-    {
-      "variety": "string",
-      "priceMin": "decimal",
-      "priceMax": "decimal",
-      "trend": "string",
-      "updateTime": "string"
-    }
-  ]
-}
-```
+**限制**: ≤50MB，格式：mp4,mov,avi
 
----
+### 7.3 GET /api/wx/file/files/{category}/{filename} — 访问文件
 
-## 七、接口统计
+**描述**: 访问已上传的文件（已实现，免认证）
 
-| 模块 | 接口数 | 方法 |
-|------|--------|------|
-| 认证模块 | 5 | POST×3, PUT×1, GET×1 |
-| 用户模块 | 4 | GET×1, PUT×1, POST×2 |
-| 系统管理 | 8 | GET×5, POST×2, PUT×1 |
-| 审核模块 | 3 | GET×2, PUT×1 |
-| 首页模块 | 5 | GET×5 |
-| **总计** | **25** | GET×16, POST×7, PUT×2 |
+### 7.4 DELETE /api/wx/file/delete — 删除文件
+
+**描述**: 删除已上传的文件（已实现）
+
+---
+
+## 八、接口统计
+
+| 模块 | 新增接口 | 已有接口 | 总计 |
+|------|---------|---------|------|
+| 果农名片 | 2 | - | 2 |
+| 招工管理 | 4 | - | 4 |
+| 找工人/客商 | 2 | - | 2 |
+| 拨号 | 1 | - | 1 |
+| 后台审核 | 4 | - | 4 |
+| 文件上传 | - | 4 | 4 |
+| **总计** | **13** | **4** | **17** |
+
+| HTTP方法 | 数量 |
+|---------|------|
+| GET | 6 |
+| POST | 4 |
+| PUT | 5 |
+| DELETE | 2 |

deliveries/team-b-architecture/design.md

@@ -1,11 +1,11 @@
-# 阶段一架构设计 — 基础设施与用户体系
+# 阶段2a架构设计 — 果农核心功能
 
-> 基于 Team A 需求规格（spec.md）
-> 嵌入 Team A 关键信息
+> 基于 Team A 需求规格（阶段2a spec.md）
+> 新增模块：果农名片、招工发布、找工人、找客商、后台审核
 
 ---
 
-## 一、系统架构
+## 一、系统架构（继承阶段一 + 扩展）
 
 ### 1.1 整体架构
 
@@ -31,7 +31,11 @@
 │                      业务逻辑层                              │
 ├──────────┬──────────┬──────────┬──────────┬────────────────┤
 │ 用户模块 │ 系统模块 │ 审核模块 │ 首页模块 │  通用模块      │
-│ AuthService│ SysService│ AuditService│ HomeService│  CommonService│
+│AuthService│SysService│AuditService│HomeService│CommonService│
+├──────────┼──────────┼──────────┼──────────┼────────────────┤
+│ 果农模块 │ 招工模块 │ 搜索模块 │ 文件模块 │  工具模块      │
+│GrowerSvc │RecruitSvc│SearchSvc │FileService│ DistanceUtil  │
+│GrowerAudit│RecruitRev│CallLogSvc│           │ KeywordCheck  │
 └──────┬───┴──────┬───┴──────┬───┴──────┬───┴────────┬───────┘
        │          │          │          │            │
        ▼          ▼          ▼          ▼            ▼
@@ -45,24 +49,24 @@
 ┌─────────────────────────────────────────────────────────────┐
 │                      数据存储层                              │
 ├─────────────────────────┬───────────────────────────────────┤
-│   MySQL (crrc 库)       │   Redis (缓存)                    │
-│   - 15 张业务表          │   - Token 黑名单                  │
-│   - AES 加密字段         │   - 验证码缓存                    │
-│   - SHA256 哈希索引      │   - 数据大屏统计                  │
+│   MySQL (sayu 库)       │   本地文件存储                     │
+│   - 20 张业务表          │   - ./uploads/image/              │
+│   - AES 加密字段         │   - ./uploads/video/              │
+│   - SHA256 哈希索引      │                                   │
 └─────────────────────────┴───────────────────────────────────┘
 ```
 
-### 1.2 模块划分
+### 1.2 阶段2a新增模块
 
 | 模块 | 包名 | 职责 |
 |------|------|------|
-| 用户模块 | com.sayu.service | 用户认证、身份管理、权限控制 |
-| 系统模块 | com.sayu.service | 角色管理、账号管理、字典管理、操作日志 |
-| 审核模块 | com.sayu.service | 审核流程、审核列表、审核日志 |
-| 首页模块 | com.sayu.service | 首页数据、行情展示 |
-| 通用模块 | com.sayu.util | 工具类、常量、异常处理 |
+| 果农模块 | com.sayu.service | 果农档案CRUD、审核状态管理 |
+| 招工模块 | com.sayu.service | 招工发布、编辑、下架、敏感词检测 |
+| 搜索模块 | com.sayu.service | 工人列表、客商列表、距离计算 |
+| 文件模块 | com.sayu.service | 文件上传、存储、访问、删除 |
+| 审核模块（扩展） | com.sayu.service | 名片审核、待复核列表、SLA提醒 |
 
-### 1.3 分层架构
+### 1.3 分层架构（继承阶段一）
 
 ```
 Controller 层（API 入口）
@@ -74,243 +78,285 @@ Mapper 层（数据访问）
 Entity/DTO/VO 层（数据模型）
 ```
 
-**职责划分**:
-- **Controller**: 接收请求、参数校验、调用 Service、返回响应
-- **Service**: 业务逻辑、事务管理、异常处理
-- **Mapper**: 数据库操作、MyBatis XML 映射
-- **Entity**: 数据库实体，与表结构对应
-- **DTO**: 数据传输对象，Service 层间传递
-- **VO**: 视图对象，Controller 返回给前端
-
 ---
 
-## 二、数据库设计
+## 二、数据库设计（继承阶段一 + 扩展）
 
-### 2.1 ER 图
+### 2.1 ER 图（阶段2a涉及）
 
 ```
 sys_user (用户基础表)
     │
-    ├── 1:N ──→ user_identity (身份关联表)
-    │               │
-    │               ├── 1:1 ──→ grower_profile (果农档案)
-    │               ├── 1:1 ──→ worker_profile (工人档案)
-    │               ├── 1:1 ──→ buyer_profile (客商档案)
-    │               └── 1:1 ──→ supplier_shop (农资店铺)
-    │
-    └── 1:N ──→ operation_log (操作日志)
+    └── 1:N ──→ user_identity (身份关联表)
+                    │
+                    ├── 1:1 ──→ grower_profile (果农档案) ←── 阶段2a核心
+                    │               │
+                    │               └── 1:N ──→ recruit_info (招工信息) ←── 阶段2a核心
+                    │
+                    ├── 1:1 ──→ worker_profile (工人档案)
+                    │               │
+                    │               └── 1:N ──→ worker_apply (工人报名)
+                    │
+                    └── 1:1 ──→ buyer_profile (客商档案)
 
-audit_log (审核日志)
+call_log (拨号日志) ←── 阶段2a新增使用
     │
-    └── 关联 → user_identity
+    ├── caller_identity_id → user_identity
+    └── callee_identity_id → user_identity
 
-sys_role (角色表)
+audit_log (审核日志) ←── 阶段2a扩展使用
     │
-    └── N:M ──→ sys_permission (权限表)
+    └── target_type = 'GROWER_PROFILE' / 'RECRUIT_REVIEW'
 ```
 
-### 2.2 核心表设计
+### 2.2 阶段2a涉及的核心表
 
-#### sys_user（用户基础表）
+#### grower_profile（果农档案表）— 阶段2a核心
 
 | 字段 | 类型 | 约束 | 说明 |
 |------|------|------|------|
-| id | BIGINT | PK, AUTO_INCREMENT | 用户ID |
-| openid | VARCHAR(64) | UNIQUE, INDEX | 微信 openid |
-| username | VARCHAR(50) | UNIQUE | 后台登录用户名 |
-| password | VARCHAR(100) | | BCrypt 加密密码 |
-| phone | VARCHAR(100) | | AES 加密手机号 |
-| phone_hash | VARCHAR(64) | UNIQUE, INDEX | SHA256 手机号哈希 |
-| real_name | VARCHAR(50) | | 真实姓名 |
-| status | TINYINT | INDEX | 状态：0正常 1禁用 2锁定 |
-| lock_reason | VARCHAR(200) | | 锁定原因 |
-| login_fail_count | INT | | 连续登录失败次数 |
-| lock_time | DATETIME | | 锁定时间 |
-| created_at | DATETIME | | 创建时间 |
-| updated_at | DATETIME | | 更新时间 |
-
-#### user_identity（身份关联表）
+| id | BIGINT | PK, AUTO_INCREMENT | 主键 |
+| user_identity_id | BIGINT | INDEX | 关联user_identity.id |
+| name | VARCHAR(50) | | 姓名 |
+| varieties | VARCHAR(200) | | 苹果品种（JSON数组） |
+| yield_amount | DECIMAL(10,2) | | 产量（斤） |
+| expected_price | DECIMAL(8,2) | | 预期价格（元/斤） |
+| address | VARCHAR(200) | | 果园地址 |
+| latitude | DECIMAL(10,7) | INDEX | 纬度 |
+| longitude | DECIMAL(10,7) | INDEX | 经度 |
+| video_url | VARCHAR(255) | | 果园视频URL（本地存储） |
+| photos | TEXT | | 照片URL（JSON数组） |
+| audit_status | TINYINT | INDEX | 0待审 1通过 2驳回 |
+| audit_remark | VARCHAR(200) | | 驳回原因 |
+
+#### recruit_info（招工信息表）— 阶段2a核心
 
 | 字段 | 类型 | 约束 | 说明 |
 |------|------|------|------|
-| id | BIGINT | PK, AUTO_INCREMENT | 身份ID |
-| user_id | BIGINT | INDEX | 关联用户ID |
-| identity_type | VARCHAR(20) | INDEX | 身份类型：GROWER/WORKER/BUYER/SUPPLIER |
-| status | TINYINT | | 状态：0正常 1禁用 |
-| created_at | DATETIME | | 创建时间 |
-
-#### sys_role（角色表）
+| id | BIGINT | PK, AUTO_INCREMENT | 主键 |
+| user_identity_id | BIGINT | INDEX | 发布者身份ID |
+| work_types | VARCHAR(100) | | 工种（JSON数组） |
+| price | DECIMAL(8,2) | | 价格 |
+| price_unit | VARCHAR(10) | | DAY/PIECE |
+| worker_count | INT | | 需要人数 |
+| days | INT | | 天数 |
+| location | VARCHAR(200) | | 工作地点 |
+| latitude | DECIMAL(10,7) | INDEX | 纬度 |
+| longitude | DECIMAL(10,7) | INDEX | 经度 |
+| remark | VARCHAR(500) | | 备注 |
+| status | TINYINT | INDEX | 0下架 1发布中 |
+| keyword_flag | TINYINT | INDEX | 0正常 1待复核 |
+| created_at | DATETIME | | 发布时间 |
+
+#### call_log（拨号日志表）— 阶段2a新增使用
 
 | 字段 | 类型 | 约束 | 说明 |
 |------|------|------|------|
-| id | BIGINT | PK, AUTO_INCREMENT | 角色ID |
-| role_name | VARCHAR(50) | UNIQUE | 角色名称 |
-| role_code | VARCHAR(50) | UNIQUE | 角色编码 |
-| description | VARCHAR(200) | | 角色描述 |
-| status | TINYINT | | 状态：0正常 1禁用 |
-| is_system | TINYINT | | 是否系统预置：0否 1是 |
-| created_at | DATETIME | | 创建时间 |
+| id | BIGINT | PK, AUTO_INCREMENT | 主键 |
+| caller_identity_id | BIGINT | INDEX | 拨号方身份ID |
+| callee_identity_id | BIGINT | INDEX | 被拨方身份ID |
+| call_time | DATETIME | | 拨号时间 |
 
-#### sys_permission（权限表）
+### 2.3 索引设计（阶段2a新增）
 
-| 字段 | 类型 | 约束 | 说明 |
-|------|------|------|------|
-| id | BIGINT | PK, AUTO_INCREMENT | 权限ID |
-| parent_id | BIGINT | | 父权限ID |
-| perm_name | VARCHAR(50) | | 权限名称 |
-| perm_code | VARCHAR(100) | UNIQUE | 权限编码 |
-| perm_type | VARCHAR(20) | | 类型：MENU/BUTTON |
-| path | VARCHAR(200) | | 菜单路径 |
-| icon | VARCHAR(100) | | 菜单图标 |
-| sort_order | INT | | 排序号 |
-| status | TINYINT | | 状态：0正常 1禁用 |
-
-#### sys_role_permission（角色权限关联表）
+```sql
+-- grower_profile 表索引
+CREATE INDEX idx_user_identity_id ON grower_profile(user_identity_id);
+CREATE INDEX idx_audit_status ON grower_profile(audit_status);
+CREATE INDEX idx_lat_lng ON grower_profile(latitude, longitude);
 
-| 字段 | 类型 | 约束 | 说明 |
-|------|------|------|------|
-| id | BIGINT | PK, AUTO_INCREMENT | 主键 |
-| role_id | BIGINT | INDEX | 角色ID |
-| permission_id | BIGINT | INDEX | 权限ID |
+-- recruit_info 表索引
+CREATE INDEX idx_user_identity_id ON recruit_info(user_identity_id);
+CREATE INDEX idx_status ON recruit_info(status);
+CREATE INDEX idx_keyword_flag ON recruit_info(keyword_flag);
+CREATE INDEX idx_lat_lng ON recruit_info(latitude, longitude);
 
-#### sys_dict（字典表）
+-- call_log 表索引
+CREATE INDEX idx_caller ON call_log(caller_identity_id);
+CREATE INDEX idx_callee ON call_log(callee_identity_id);
+```
 
-| 字段 | 类型 | 约束 | 说明 |
-|------|------|------|------|
-| id | BIGINT | PK, AUTO_INCREMENT | 字典ID |
-| dict_type | VARCHAR(50) | INDEX | 字典类型 |
-| dict_code | VARCHAR(50) | UNIQUE | 字典编码 |
-| dict_name | VARCHAR(100) | | 字典名称 |
-| sort_order | INT | | 排序号 |
-| is_system | TINYINT | | 是否系统内置：0否 1是 |
-| status | TINYINT | | 状态：0正常 1禁用 |
+---
 
-#### audit_log（审核日志表）
+## 三、接口设计（阶段2a新增）
 
-| 字段 | 类型 | 约束 | 说明 |
-|------|------|------|------|
-| id | BIGINT | PK, AUTO_INCREMENT | 日志ID |
-| target_type | VARCHAR(50) | | 审核对象类型 |
-| target_id | BIGINT | | 审核对象ID |
-| operator_id | BIGINT | INDEX | 审核人ID |
-| action | VARCHAR(20) | | 审核动作：APPROVE/REJECT |
-| reason | VARCHAR(500) | | 审核原因 |
-| created_at | DATETIME | | 审核时间 |
+### 3.1 果农名片接口
 
-#### operation_log（操作日志表）
+#### GET /api/wx/grower/profile — 获取果农档案
 
-| 字段 | 类型 | 约束 | 说明 |
-|------|------|------|------|
-| id | BIGINT | PK, AUTO_INCREMENT | 日志ID |
-| operator_id | BIGINT | INDEX | 操作人ID |
-| operator_name | VARCHAR(50) | | 操作人姓名 |
-| operation_type | VARCHAR(50) | | 操作类型 |
-| operation_module | VARCHAR(50) | | 操作模块 |
-| operation_content | VARCHAR(500) | | 操作内容 |
-| ip_address | VARCHAR(50) | | IP地址 |
-| result | TINYINT | | 操作结果：0失败 1成功 |
-| created_at | DATETIME | | 操作时间 |
-
-### 2.3 索引设计
+**描述**: 获取当前果农的名片信息
 
-```sql
--- sys_user 表索引
-CREATE UNIQUE INDEX idx_phone_hash ON sys_user(phone_hash);
-CREATE UNIQUE INDEX idx_openid ON sys_user(openid);
-CREATE INDEX idx_status ON sys_user(status);
+**请求头**: `Authorization: Bearer {token}`
 
--- user_identity 表索引
-CREATE INDEX idx_user_id ON user_identity(user_id);
-CREATE INDEX idx_identity_type ON user_identity(identity_type);
+**响应参数**:
+```json
+{
+  "code": 200,
+  "message": "success",
+  "data": {
+    "id": 1,
+    "name": "张三",
+    "varieties": ["红富士", "嘎啦"],
+    "yieldAmount": 50000,
+    "expectedPrice": 4.0,
+    "address": "洒渔镇黄兴村",
+    "latitude": 27.3331,
+    "longitude": 103.7168,
+    "videoUrl": "http://localhost:8080/files/video/abc.mp4",
+    "photos": ["http://localhost:8080/files/image/1.jpg"],
+    "auditStatus": 0,
+    "auditRemark": null
+  }
+}
+```
 
--- audit_log 表索引
-CREATE INDEX idx_operator_id ON audit_log(operator_id);
+#### PUT /api/wx/grower/profile — 更新果农档案
 
--- operation_log 表索引
-CREATE INDEX idx_operator_id ON operation_log(operator_id);
+**描述**: 更新果农名片信息，审核状态重置为待审
+
+**请求参数**:
+```json
+{
+  "name": "张三",
+  "varieties": ["红富士", "嘎啦"],
+  "yieldAmount": 50000,
+  "expectedPrice": 4.0,
+  "address": "洒渔镇黄兴村",
+  "latitude": 27.3331,
+  "longitude": 103.7168,
+  "videoUrl": "http://localhost:8080/files/video/abc.mp4",
+  "photos": ["http://localhost:8080/files/image/1.jpg"]
+}
 ```
 
+**业务逻辑**:
+1. 验证必填字段
+2. 更新 grower_profile
+3. 重置 audit_status=0，清空 audit_remark
+
 ---
 
-## 三、接口设计
+### 3.2 招工接口
 
-### 3.1 认证接口
+#### POST /api/wx/grower/recruit — 发布招工
 
-#### POST /api/wx/auth/login — 微信登录
+**描述**: 发布招工信息，免审核直接发布
 
 **请求参数**:
 ```json
 {
-  "code": "wx_login_code"
+  "workTypes": ["采摘工", "分拣工"],
+  "price": 150,
+  "priceUnit": "DAY",
+  "workerCount": 3,
+  "days": 5,
+  "location": "洒渔镇黄兴村",
+  "latitude": 27.3331,
+  "longitude": 103.7168,
+  "remark": "需要有经验的采摘工"
 }
 ```
 
+**业务逻辑**:
+1. 验证必填字段（workTypes、price、priceUnit、workerCount、location）
+2. 敏感词检测（keyword_flag）
+3. 创建 recruit_info（status=1，免审核）
+
+#### GET /api/wx/grower/recruit — 我的招工列表
+
+**请求参数**: `?page=1&pageSize=20`
+
 **响应参数**:
 ```json
 {
   "code": 200,
   "message": "success",
   "data": {
-    "token": "jwt_token",
-    "userId": 1,
-    "identities": [
+    "total": 5,
+    "page": 1,
+    "pageSize": 20,
+    "list": [
       {
-        "identityId": 1,
-        "identityType": "GROWER",
-        "identityName": "果农"
+        "id": 1,
+        "workTypes": ["采摘工"],
+        "price": 150,
+        "priceUnit": "DAY",
+        "workerCount": 3,
+        "days": 5,
+        "location": "洒渔镇黄兴村",
+        "status": 1,
+        "keywordFlag": 0,
+        "applyCount": 2,
+        "createdAt": "2026-05-30 10:00"
       }
     ]
   }
 }
 ```
 
-**业务逻辑**:
-1. 用 code 调用微信接口换取 openid
-2. 查询 openid 是否已绑定用户
-3. 已绑定 → 签发 JWT token
-4. 未绑定 → 返回错误码 1001（提示联系村委会）
-
-#### POST /api/admin/auth/login — 后台登录
+#### PUT /api/wx/grower/recruit/{id} — 编辑招工
 
 **请求参数**:
 ```json
 {
-  "username": "admin",
-  "password": "admin123"
+  "price": 180,
+  "workerCount": 5,
+  "remark": "价格上调，急招"
 }
 ```
 
+**业务逻辑**:
+1. 验证招工存在且属于当前用户
+2. 更新可编辑字段
+3. 重新触发敏感词检测
+
+#### DELETE /api/wx/grower/recruit/{id} — 下架招工
+
+**业务逻辑**:
+1. 验证招工存在且属于当前用户
+2. 更新 status=0（逻辑删除）
+
+---
+
+### 3.3 找工人/客商接口
+
+#### GET /api/wx/grower/workers — 工人列表
+
+**请求参数**: `?workType=采摘工&page=1&pageSize=20`
+
 **响应参数**:
 ```json
 {
   "code": 200,
   "message": "success",
   "data": {
-    "token": "jwt_token",
-    "userId": 1,
-    "username": "admin",
-    "realName": "管理员",
-    "roleId": 1,
-    "roleName": "超级管理员"
+    "total": 10,
+    "page": 1,
+    "pageSize": 20,
+    "list": [
+      {
+        "identityId": 5,
+        "name": "李四",
+        "skills": ["采摘工", "分拣工"],
+        "price": 150,
+        "priceUnit": "DAY",
+        "status": 1,
+        "distance": 2.5
+      }
+    ]
   }
 }
 ```
 
 **业务逻辑**:
-1. 验证用户名存在
-2. 验证密码正确（BCrypt）
-3. 验证账号状态
-4. 签发 JWT token
-5. 记录登录日志
+1. 查询 status=1（空闲）的工人
+2. 可选按工种筛选（skills JSON字段 LIKE 查询）
+3. 计算距离（Haversine公式）
+4. 按距离升序排序
 
-#### POST /api/wx/auth/select-identity — 选择身份
+#### GET /api/wx/grower/buyers — 客商列表
 
-**请求参数**:
-```json
-{
-  "identityId": 1
-}
-```
+**请求参数**: `?page=1&pageSize=20`
 
 **响应参数**:
 ```json
@@ -318,14 +364,38 @@ CREATE INDEX idx_operator_id ON operation_log(operator_id);
   "code": 200,
   "message": "success",
   "data": {
-    "token": "new_jwt_token_with_identity"
+    "total": 5,
+    "page": 1,
+    "pageSize": 20,
+    "list": [
+      {
+        "identityId": 10,
+        "name": "王五果业",
+        "varieties": ["红富士", "嘎啦"],
+        "priceRange": "3.5-4.5",
+        "totalAmount": 100000,
+        "standards": "果径≥80mm",
+        "address": "昭通市水果批发市场"
+      }
+    ]
   }
 }
 ```
 
-### 3.2 用户接口
+---
+
+### 3.4 拨号接口
+
+#### POST /api/wx/call/phone — 拨号接口
 
-#### GET /api/wx/user/info — 获取用户信息
+**描述**: 获取对方手机号并记录拨号日志
+
+**请求参数**:
+```json
+{
+  "calleeIdentityId": 5
+}
+```
 
 **响应参数**:
 ```json
@@ -333,32 +403,24 @@ CREATE INDEX idx_operator_id ON operation_log(operator_id);
   "code": 200,
   "message": "success",
   "data": {
-    "userId": 1,
-    "realName": "张三",
     "phone": "138****8888",
-    "identities": [...],
-    "currentIdentity": {
-      "identityId": 1,
-      "identityType": "GROWER"
-    }
+    "realPhone": "13800138000"
   }
 }
 ```
 
-#### PUT /api/admin/user/status — 修改用户状态
+**业务逻辑**:
+1. 验证被拨方存在
+2. 记录拨号日志（call_log）
+3. 返回脱敏手机号给前端显示，真实手机号用于拨号
 
-**请求参数**:
-```json
-{
-  "userId": 1,
-  "status": 0,
-  "lockReason": "违规操作"
-}
-```
+---
+
+### 3.5 后台审核接口
 
-### 3.3 系统管理接口
+#### GET /api/admin/audit/grower-profile — 名片审核列表
 
-#### GET /api/admin/role/list — 角色列表
+**请求参数**: `?page=1&pageSize=10&status=0`
 
 **响应参数**:
 ```json
@@ -366,86 +428,52 @@ CREATE INDEX idx_operator_id ON operation_log(operator_id);
   "code": 200,
   "message": "success",
   "data": {
-    "total": 8,
+    "total": 3,
+    "page": 1,
+    "pageSize": 10,
     "list": [
       {
         "id": 1,
-        "roleName": "超级管理员",
-        "roleCode": "ADMIN",
-        "status": 0,
-        "isSystem": 1
+        "growerName": "张三",
+        "varieties": ["红富士"],
+        "yieldAmount": 50000,
+        "videoUrl": "...",
+        "photos": ["..."],
+        "auditStatus": 0,
+        "createdAt": "2026-05-30 10:00"
       }
     ]
   }
 }
 ```
 
-#### POST /api/admin/account — 创建账号
+#### PUT /api/admin/audit/grower-profile/{id} — 名片审核操作
 
 **请求参数**:
 ```json
 {
-  "username": "newadmin",
-  "password": "Admin123",
-  "realName": "新管理员",
-  "phone": "13800138000",
-  "roleId": 2
+  "action": "APPROVE",
+  "reason": ""
 }
 ```
 
-#### GET /api/admin/dict/list — 字典列表
-
-**请求参数**:
-```
-?dictType=apple_variety
-```
-
-**响应参数**:
+或驳回：
 ```json
 {
-  "code": 200,
-  "message": "success",
-  "data": [
-    {
-      "id": 1,
-      "dictType": "apple_variety",
-      "dictCode": "red_fuji",
-      "dictName": "红富士",
-      "sortOrder": 1
-    }
-  ]
+  "action": "REJECT",
+  "reason": "视频内容不清晰，请重新上传"
 }
 ```
 
-#### GET /api/admin/operation-log/list — 操作日志列表
-
-**请求参数**:
-```
-?page=1&pageSize=10&operatorId=1&startTime=2026-05-01&endTime=2026-05-30
-```
-
-### 3.4 审核接口
-
-#### GET /api/admin/audit/list — 审核列表
-
-**请求参数**:
-```
-?page=1&pageSize=10&targetType=GROWER_PROFILE&status=PENDING
-```
-
-#### PUT /api/admin/audit/{id} — 审核操作
-
-**请求参数**:
-```json
-{
-  "action": "APPROVE",
-  "reason": ""
-}
-```
+**业务逻辑**:
+1. 验证审核记录存在
+2. 驳回时 reason 不能为空
+3. 更新 grower_profile.audit_status
+4. 记录审核日志（audit_log）
 
-### 3.5 首页接口
+#### GET /api/admin/audit/recruit-review — 待复核招工列表
 
-#### GET /api/wx/home/grower — 果农首页
+**请求参数**: `?page=1&pageSize=10`
 
 **响应参数**:
 ```json
@@ -453,205 +481,171 @@ CREATE INDEX idx_operator_id ON operation_log(operator_id);
   "code": 200,
   "message": "success",
   "data": {
-    "greeting": "早安，张三！",
-    "marketPrices": [
+    "total": 2,
+    "list": [
       {
-        "variety": "红富士",
-        "priceMin": 3.5,
-        "priceMax": 4.2,
-        "trend": "up",
-        "updateTime": "2026-05-30 08:00"
+        "id": 1,
+        "workTypes": ["采摘工"],
+        "remark": "日薪300元，...",
+        "keywordFlag": 1,
+        "publisherName": "张三",
+        "createdAt": "2026-05-30 10:00"
       }
-    ],
-    "quickEntries": [
-      {"name": "找工人", "icon": "worker", "path": "/pages/worker/list"},
-      {"name": "找客商", "icon": "buyer", "path": "/pages/buyer/list"},
-      {"name": "买农资", "icon": "supplier", "path": "/pages/supplier/list"},
-      {"name": "发布需求", "icon": "publish", "path": "/pages/recruit/publish"}
     ]
   }
 }
 ```
 
-#### GET /api/wx/home/worker — 工人首页
+#### PUT /api/admin/audit/recruit-review/{id} — 待复核操作
 
-**响应参数**:
+**请求参数**:
 ```json
 {
-  "code": 200,
-  "message": "success",
-  "data": {
-    "recommendedRecruits": [
-      {
-        "id": 1,
-        "workType": "采摘",
-        "price": 150,
-        "priceUnit": "元/天",
-        "days": 5,
-        "peopleCount": 3,
-        "growerName": "李四",
-        "distance": 2.5
-      }
-    ]
-  }
+  "action": "NORMAL",
+  "reason": ""
 }
 ```
 
----
-
-## 四、安全设计
-
-### 4.1 认证流程
-
-```
-客户端请求
-    │
-    ▼
-拦截器检查 Token
-    │
-    ├── 无 Token → 401 未认证
-    │
-    ├── Token 无效 → 401 未认证
-    │
-    ├── Token 过期 → 401 未认证
-    │
-    └── Token 有效 → 解析用户信息
-                          │
-                          ▼
-                    检查权限（RBAC）
-                          │
-                          ├── 无权限 → 403 禁止访问
-                          │
-                          └── 有权限 → 执行业务逻辑
-```
-
-### 4.2 权限模型
-
-```
-用户 (sys_user)
-    │
-    └── N:M ──→ 角色 (sys_role)
-                    │
-                    └── N:M ──→ 权限 (sys_permission)
+或强制下架：
+```json
+{
+  "action": "FORCE_OFFLINE",
+  "reason": "内容违规"
+}
 ```
 
-**权限检查流程**:
-1. 从 Token 解析 userId 和 roleId
-2. 查询角色关联的权限列表
-3. 检查当前接口是否在权限列表中
-4. 无权限返回 403
-
-### 4.3 数据安全
-
-- **手机号**: AES 加密存储，SHA256 哈希索引
-- **密码**: BCrypt 加密
-- **Token**: JWT 签名，有效期控制
-- **接口**: 参数校验，SQL 注入防护
-- **日志**: 敏感操作记录
+**业务逻辑**:
+1. 验证招工存在
+2. NORMAL → keyword_flag=0
+3. FORCE_OFFLINE → status=0，记录原因
 
 ---
 
-## 五、技术选型
+## 四、安全设计（继承阶段一 + 扩展）
 
-### 5.1 后端技术栈
+### 4.1 文件上传安全
 
-| 技术 | 版本 | 用途 |
-|------|------|------|
-| Java | 1.8 | 开发语言 |
-| Spring Boot | 1.5.9 | 应用框架 |
-| MyBatis | 1.3.2 | ORM 框架 |
-| MySQL | 5.7+ | 数据库 |
-| Redis | 3.0+ | 缓存 |
-| JWT (jjwt) | 0.9.1 | Token 认证 |
-|阿里云 OSS | 3.15.1 | 文件存储 |
-| 阿里云短信 | 2.1.0 | 短信服务 |
-| Apache POI | 3.17 | Excel 处理 |
-
-### 5.2 前端技术栈
-
-| 技术 | 版本 | 用途 |
-|------|------|------|
-| 微信小程序 | 基础库 ≥2.0 | 移动端 |
-| Vue | 2.6.14 | 后台前端框架 |
-| Element UI | 2.15.9 | UI 组件库 |
-| ECharts | 5.4.3 | 数据可视化 |
-| Axios | 0.27.2 | HTTP 客户端 |
-
-### 5.3 开发工具
-
-| 工具 | 用途 |
-|------|------|
-| Maven | 构建工具 |
-| Git | 版本控制 |
-| Gogs | 代码仓库 |
-| Navicat/DBeaver | 数据库客户端 |
-| 微信开发者工具 | 小程序开发 |
-
----
+```
+前端上传 → 格式白名单校验 → 大小限制 → 存储到本地目录
+                                         │
+                                         ▼
+                                   返回文件URL
+```
 
-## 六、部署架构
+- **格式白名单**: 图片（jpg,jpeg,png,gif）、视频（mp4,mov,avi）
+- **大小限制**: 图片≤5MB，视频≤50MB
+- **EXIF清除**: 前端责任，后端不二次处理（性能考虑）
+- **路径安全**: 文件名使用UUID，防止路径穿越
 
-### 6.1 开发环境
+### 4.2 内容安全
 
 ```
-本地开发机
-├── JDK 1.8
-├── Maven 3.6.3
-├── MySQL 5.7
-├── Redis 3.0
-└── 微信开发者工具
+招工发布 → 敏感词检测 → keyword_flag 标记 → 不阻塞发布
+                                         │
+                                         ▼
+                                   待复核列表
 ```
 
-### 6.2 生产环境（规划）
+- **敏感词库**: 初始硬编码，仅含明确违规词
+- **检测方式**: 正则匹配
+- **处理方式**: keyword_flag=1 进入待复核，不阻塞发布
+
+### 4.3 拨号安全
 
 ```
-云服务器
-├── Nginx（反向代理）
-├── Spring Boot 应用（8080 端口）
-├── MySQL 数据库
-├── Redis 缓存
-└── 阿里云 OSS（文件存储）
+拨号请求 → 记录拨号日志 → 返回脱敏手机号 → 前端拨号
 ```
 
+- **日志记录**: 拨号方ID、被拨方ID、时间
+- **数据脱敏**: 列表不返回手机号，拨号接口单独获取
+
 ---
 
-## 七、关键决策记录
+## 五、关键技术方案
 
-### 7.1 认证方案选择
+### 5.1 距离计算（Haversine公式）
 
-**决策**: 采用 JWT Token 认证
+```java
+public class DistanceUtil {
+    private static final double EARTH_RADIUS = 6371; // 地球半径（km）
 
-**原因**:
-1. 无状态，适合分布式部署
-2. 小程序和后台可共用认证机制
-3. 支持自定义 payload（userId, identityId, identityType）
+    public static double calculate(double lat1, double lng1, double lat2, double lng2) {
+        double dLat = Math.toRadians(lat2 - lat1);
+        double dLng = Math.toRadians(lng2 - lng1);
+        double a = Math.sin(dLat / 2) * Math.sin(dLat / 2) +
+                   Math.cos(Math.toRadians(lat1)) * Math.cos(Math.toRadians(lat2)) *
+                   Math.sin(dLng / 2) * Math.sin(dLng / 2);
+        double c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+        return EARTH_RADIUS * c;
+    }
+}
+```
 
-**权衡**:
-- Token 无法主动失效 → 采用 Redis 黑名单机制
-- Token 有效期管理 → 小程序24h，后台8h
+**说明**:
+- 输入：两个经纬度点（DECIMAL(10,7)）
+- 输出：距离（km，保留1位小数）
+- 精度：小数点后7位，误差≤1米
 
-### 7.2 权限模型选择
+### 5.2 敏感词检测
 
-**决策**: 采用 RBAC（Role-Based Access Control）
+```java
+public class KeywordCheckService {
+    // 初始敏感词库（硬编码）
+    private static final List<String> KEYWORDS = Arrays.asList(
+        // 仅含明确违规词，不含正常业务词汇
+    );
 
-**原因**:
-1. 角色数量有限（8种），管理简单
-2. 权限变更通过角色控制，影响范围可控
-3. 支持细粒度权限（菜单+按钮）
+    public boolean containsSensitiveWord(String text) {
+        if (text == null) return false;
+        for (String keyword : KEYWORDS) {
+            if (text.contains(keyword)) return true;
+        }
+        return false;
+    }
+}
+```
 
-**权衡**:
-- 不支持数据级权限 → 后续可扩展
-- 权限变更需重新登录 → 可优化为实时生效
+### 5.3 视频压缩（异步）
 
-### 7.3 手机号存储方案
+```java
+@Service
+public class VideoCompressService {
+    @Async
+    public void compressVideo(String inputPath, String outputPath) {
+        // FFmpeg 命令：720p，码率2Mbps
+        // ffmpeg -i input.mp4 -vf scale=-1:720 -b:v 2M output.mp4
+    }
+}
+```
 
-**决策**: AES 加密存储 + SHA256 哈希索引
+**约束**:
+- 异步执行，不影响用户操作
+- 失败自动重试3次
+- 压缩后替换原文件
 
-**原因**:
-1. 满足隐私保护要求
-2. SHA256 哈希支持精确查询
-3. AES 加密支持解密显示（管理后台）
+---
 
-**权衡**:
-- 无法支持模糊查询 → 业务上不需要
-- 哈希碰撞风险 → SHA256 碰撞概率极低
+## 六、阶段2a新增文件清单
+
+| 文件 | 说明 |
+|------|------|
+| GrowerProfileController.java | 果农档案API |
+| GrowerProfileService.java | 果农档案业务逻辑 |
+| GrowerProfileMapper.xml | 果农档案MyBatis映射 |
+| RecruitController.java | 招工CRUD API |
+| RecruitService.java | 招工业务逻辑 |
+| RecruitMapper.xml | 招工MyBatis映射 |
+| WorkerSearchController.java | 工人列表API |
+| WorkerSearchService.java | 工人搜索业务逻辑 |
+| BuyerSearchController.java | 客商列表API |
+| BuyerSearchService.java | 客商搜索业务逻辑 |
+| CallPhoneController.java | 拨号API |
+| CallLogService.java | 拨号日志业务逻辑 |
+| CallLogMapper.xml | 拨号日志MyBatis映射 |
+| GrowerAuditController.java | 名片审核API |
+| GrowerAuditService.java | 名片审核业务逻辑 |
+| RecruitReviewController.java | 待复核API |
+| RecruitReviewService.java | 待复核业务逻辑 |
+| KeywordCheckService.java | 敏感词检测服务 |
+| DistanceUtil.java | 距离计算工具类 |
+| VideoCompressService.java | 视频压缩服务 |

deliveries/team-b-architecture/tech-stack.md

@@ -1,8 +1,10 @@
-# 阶段一技术选型 — 基础设施与用户体系
+# 阶段2a技术选型 — 果农核心功能
+
+> 继承阶段一技术选型 + 阶段2a新增
 
 ---
 
-## 一、后端技术栈
+## 一、后端技术栈（继承阶段一）
 
 ### 1.1 核心框架
 
@@ -12,9 +14,8 @@
 | Spring Boot | 1.5.9.RELEASE | 应用框架 | 成熟稳定，社区支持好 |
 | MyBatis | 1.3.2 | ORM 框架 | 灵活的 SQL 控制，XML 映射 |
 | MySQL | 5.7+ | 数据库 | 客户环境限制，性能稳定 |
-| Redis | 3.0+ | 缓存 | 高性能，支持多种数据结构 |
 
-### 1.2 认证与安全
+### 1.2 认证与安全（继承）
 
 | 技术 | 版本 | 用途 | 选型理由 |
 |------|------|------|----------|
@@ -23,15 +24,15 @@
 | AES | - | 手机号加密 | 对称加密，性能好 |
 | SHA256 | - | 手机号哈希 | 单向哈希，支持索引查询 |
 
-### 1.3 文件处理
+### 1.3 文件处理（变更）
 
-| 技术 | 版本 | 用途 | 选型理由 |
-|------|------|------|----------|
-| 阿里云 OSS SDK | 3.15.1 | 文件存储 | 云服务稳定，CDN 加速 |
-| 阿里云短信 SDK | 2.1.0 | 短信服务 | 国内服务稳定 |
-| Apache POI | 3.17 | Excel 处理 | 功能完整，社区活跃 |
+| 技术 | 版本 | 用途 | 选型理由 | 变更说明 |
+|------|------|------|----------|----------|
+| 本地文件存储 | - | 文件存储 | 简化开发，降低依赖 | 替换阿里云OSS |
+| 阿里云短信 SDK | 2.1.0 | 短信服务 | 国内服务稳定 | 保留 |
+| Apache POI | 3.17 | Excel 处理 | 功能完整，社区活跃 | 保留 |
 
-### 1.4 工具库
+### 1.4 工具库（继承）
 
 | 技术 | 版本 | 用途 | 选型理由 |
 |------|------|------|----------|
@@ -41,9 +42,63 @@
 
 ---
 
-## 二、前端技术栈
+## 二、阶段2a新增技术需求
+
+### 2.1 距离计算
+
+| 技术 | 用途 | 说明 |
+|------|------|------|
+| Haversine公式 | 距离计算 | 纯数学计算，无外部依赖 |
+
+**实现方式**: 自定义 `DistanceUtil` 工具类
+
+```java
+// 核心公式
+double a = sin²(Δlat/2) + cos(lat1) × cos(lat2) × sin²(Δlng/2)
+double c = 2 × atan2(√a, √(1-a))
+double distance = R × c  // R=6371km
+```
+
+**精度**: DECIMAL(10,7)，误差≤1米
+
+### 2.2 敏感词检测
+
+| 技术 | 用途 | 说明 |
+|------|------|------|
+| 正则表达式 | 敏感词匹配 | 纯Java实现，无外部依赖 |
+
+**实现方式**: 自定义 `KeywordCheckService`
+
+- 初始词库硬编码（仅含明确违规词）
+- 正则匹配，支持通配符
+- 后续可扩展为数据库词库
 
-### 2.1 小程序端
+### 2.3 视频压缩
+
+| 技术 | 版本 | 用途 | 选型理由 |
+|------|------|------|----------|
+| FFmpeg | 系统安装 | 视频压缩 | 功能强大，压缩效果好 |
+
+**实现方式**:
+- Spring `@Async` 异步执行
+- FFmpeg 命令行调用
+- 参数：720p分辨率，2Mbps码率
+
+**备选方案**: 如果FFmpeg不可用，使用Java原生压缩库（效果较差）
+
+### 2.4 地理编码（可选）
+
+| 技术 | 用途 | 说明 |
+|------|------|------|
+| 高德/百度地图API | 地址→经纬度 | 可选，前端可处理 |
+
+**说明**: 地址→经纬度转换可由前端完成，后端仅存储经纬度
+
+---
+
+## 三、前端技术栈（继承阶段一）
+
+### 3.1 小程序端
 
 | 技术 | 版本 | 用途 | 选型理由 |
 |------|------|------|----------|
@@ -52,133 +107,85 @@
 | WXSS | - | 样式语言 | 微信小程序原生 |
 | JavaScript | ES6 | 脚本语言 | 小程序支持 |
 
-### 2.2 后台管理端
+**阶段2a新增小程序能力**:
+- `wx.chooseImage()` — 选择图片
+- `wx.chooseVideo()` — 选择视频
+- `wx.makePhoneCall()` — 拨打电话
+- `wx.getRecorderManager()` — 语音输入（可选）
+
+### 3.2 后台管理端（继承）
 
 | 技术 | 版本 | 用途 | 选型理由 |
 |------|------|------|----------|
 | Vue | 2.6.14 | 前端框架 | 成熟稳定，学习成本低 |
-| Vue Router | 3.5.4 | 路由管理 | Vue 官方路由 |
-| Vuex | 3.6.2 | 状态管理 | Vue 官方状态管理 |
 | Element UI | 2.15.9 | UI 组件库 | 组件丰富，文档完善 |
 | Axios | 0.27.2 | HTTP 客户端 | 支持 Promise，拦截器 |
-| ECharts | 5.4.3 | 数据可视化 | 功能强大，图表丰富 |
 
 ---
 
-## 三、开发工具
-
-### 3.1 构建工具
-
-| 工具 | 版本 | 用途 |
-|------|------|------|
-| Maven | 3.6.3 | 后端构建 |
-| npm | - | 前端依赖管理 |
-| Vue CLI | 4.5.19 | 前端构建 |
-
-### 3.2 版本控制
+## 四、开发工具（继承阶段一）
 
 | 工具 | 用途 |
 |------|------|
+| Maven | 后端构建 |
 | Git | 版本控制 |
 | Gogs | 代码仓库（自托管） |
-
-### 3.3 开发环境
-
-| 工具 | 用途 |
-|------|------|
-| JDK 1.8 | Java 开发环境 |
-| IntelliJ IDEA | Java IDE |
-| VS Code | 前端 IDE |
 | 微信开发者工具 | 小程序开发调试 |
 | Navicat/DBeaver | 数据库客户端 |
-| Redis Desktop Manager | Redis 客户端 |
 
 ---
 
-## 四、部署环境
-
-### 4.1 服务器配置（规划）
-
-| 资源 | 配置 | 说明 |
-|------|------|------|
-| CPU | 2 核 | 足够支撑初期访问量 |
-| 内存 | 4 GB | Spring Boot + MySQL + Redis |
-| 磁盘 | 50 GB | 系统 + 数据 + 日志 |
-| 带宽 | 5 Mbps | 足够支撑初期访问量 |
-
-### 4.2 软件环境
-
-| 软件 | 版本 | 用途 |
-|------|------|------|
-| CentOS | 7.x | 操作系统 |
-| Nginx | 1.18+ | 反向代理 |
-| MySQL | 5.7 | 数据库 |
-| Redis | 3.0+ | 缓存 |
-| JDK | 1.8 | Java 运行环境 |
-
-### 4.3 云服务
-
-| 服务 | 用途 | 配置 |
-|------|------|------|
-| 阿里云 OSS | 文件存储 | 私有读写，CORS 配置 |
-| 阿里云 SMS | 短信服务 | 签名：洒渔用工 |
-| 微信小程序 | 移动端 | AppID 待申请 |
-
----
-
-## 五、数据库设计规范
+## 五、数据库设计规范（继承阶段一）
 
 ### 5.1 命名规范
 
-- **表名**: 小写字母 + 下划线，如 `sys_user`
-- **字段名**: 小写字母 + 下划线，如 `user_name`
+- **表名**: 小写字母 + 下划线，如 `grower_profile`
+- **字段名**: 小写字母 + 下划线，如 `user_identity_id`
 - **主键**: `id`，自增
-- **索引**: `idx_` 前缀，如 `idx_user_id`
-- **唯一索引**: `uk_` 前缀，如 `uk_phone_hash`
-
-### 5.2 字段规范
-
-- **字符串**: VARCHAR，长度按实际需求
-- **数字**: INT/BIGINT/DECIMAL
-- **时间**: DATETIME
-- **状态**: TINYINT，0/1/2
-- **布尔**: TINYINT，0 否 1 是
+- **索引**: `idx_` 前缀
+- **唯一索引**: `uk_` 前缀
 
-### 5.3 必备字段
+### 5.2 阶段2a JSON字段规范
 
-每个业务表必须包含：
-- `id` — 主键
-- `created_at` — 创建时间
-- `updated_at` — 更新时间
+| 字段 | 表 | 格式示例 |
+|------|-----|---------|
+| varieties | grower_profile | `["红富士","嘎啦"]` |
+| photos | grower_profile | `["http://...1.jpg","http://...2.jpg"]` |
+| work_types | recruit_info | `["采摘工","分拣工"]` |
+| skills | worker_profile | `["采摘","套袋"]` |
 
 ---
 
-## 六、接口设计规范
+## 六、接口设计规范（继承阶段一）
 
 ### 6.1 路径规范
 
 - **小程序端**: `/api/wx/{module}/{action}`
 - **后台管理端**: `/api/admin/{module}/{action}`
-- **模块**: 用户模块 `user`，系统模块 `system`，审核模块 `audit`，首页模块 `home`
 
-### 6.2 请求规范
+### 6.2 阶段2a新增模块路径
 
-- **GET**: 查询操作，参数通过 URL 传递
-- **POST**: 创建操作，参数通过 Body 传递
-- **PUT**: 更新操作，参数通过 Body 传递
-- **DELETE**: 删除操作
+| 模块 | 路径前缀 |
+|------|---------|
+| 果农名片 | /api/wx/grower/profile |
+| 招工管理 | /api/wx/grower/recruit |
+| 找工人 | /api/wx/grower/workers |
+| 找客商 | /api/wx/grower/buyers |
+| 拨号 | /api/wx/call/phone |
+| 名片审核 | /api/admin/audit/grower-profile |
+| 待复核 | /api/admin/audit/recruit-review |
 
-### 6.3 响应规范
+### 6.3 响应规范（继承）
 
 ```json
 {
-  "code": 200,       // 状态码
-  "message": "success", // 状态描述
-  "data": {}         // 业务数据
+  "code": 200,
+  "message": "success",
+  "data": {}
 }
 ```
 
-### 6.4 错误码规范
+### 6.4 错误码规范（继承 + 扩展）
 
 | 错误码 | 含义 | 说明 |
 |--------|------|------|
@@ -188,48 +195,52 @@
 | 403 | 禁止访问 | 无权限 |
 | 404 | 未找到 | 资源不存在 |
 | 500 | 服务器错误 | 内部异常 |
-| 1001-1099 | 业务错误 | 自定义业务错误码 |
+| 1001-1099 | 认证错误 | 阶段一业务错误码 |
+| 2001-2099 | 果农模块错误 | 阶段2a新增 |
+| 3001-3099 | 招工模块错误 | 阶段2a新增 |
+| 4001-4099 | 拨号模块错误 | 阶段2a新增 |
+| 5001-5099 | 审核模块错误 | 阶段2a新增 |
 
 ---
 
-## 七、安全设计规范
+## 七、安全设计规范（继承 + 扩展）
 
-### 7.1 认证安全
+### 7.1 文件上传安全（新增）
 
-- **Token**: JWT 签名，有效期控制
-- **密码**: BCrypt 加密，强度校验
-- **登录**: 失败次数限制，锁定机制
+- **格式白名单**: 图片（jpg,jpeg,png,gif）、视频（mp4,mov,avi）
+- **大小限制**: 图片≤5MB，视频≤50MB
+- **文件名**: UUID重命名，防止路径穿越
+- **EXIF清除**: 前端责任
 
-### 7.2 数据安全
+### 7.2 内容安全（新增）
 
-- **手机号**: AES 加密存储，SHA256 哈希索引
-- **敏感数据**: 接口返回脱敏
-- **SQL 注入**: MyBatis #{} 参数化
+- **敏感词检测**: 正则匹配
+- **处理方式**: keyword_flag标记，不阻塞发布
+- **人工复核**: 审核员处理待复核列表
 
-### 7.3 接口安全
+### 7.3 拨号安全（新增）
 
-- **权限控制**: RBAC 模型
-- **参数校验**: 必填校验、类型校验、范围校验
-- **防重放**: Token 过期机制
+- **日志记录**: 拨号方ID、被拨方ID、时间
+- **数据脱敏**: 列表不返回手机号
 
 ---
 
-## 八、性能设计规范
+## 八、性能设计规范（继承 + 扩展）
 
-### 8.1 数据库性能
+### 8.1 距离计算性能（新增）
 
-- **索引**: 高频查询字段建立索引
-- **连接池**: 最大连接数 20
-- **慢查询**: 开启慢查询日志
+- **计算方式**: 实时计算，不缓存
+- **优化**: 可先用矩形范围筛选，再精确计算
+- **精度**: DECIMAL(10,7)
 
-### 8.2 缓存策略
+### 8.2 文件上传性能（新增）
 
-- **Token 黑名单**: Redis 存储
-- **验证码**: Redis 存储，5 分钟过期
-- **数据大屏**: Redis 缓存，定时更新
+- **上传时间**: ≤50MB文件，局域网≤30s
+- **视频压缩**: 异步处理，不影响用户操作
+- **压缩重试**: 失败自动重试3次
 
-### 8.3 接口性能
+### 8.3 接口性能（继承）
 
 - **响应时间**: ≤500ms（95%请求）
 - **并发**: ≥100 用户
-- **分页**: 默认每页 10 条，最大 100 条
+- **分页**: 默认每页 20 条