# 阶段2b 约束条件

> 版本：v1.0
> 日期：2026-05-30

---

## 1. 技术约束

### 1.1 框架版本
| 技术 | 版本 | 约束 |
|------|------|------|
| Java | 8 | 不使用 Java 9+ 特性 |
| Spring Boot | 1.5.9 | 不使用 2.x 特性 |
| MyBatis | 3.x | XML 映射，禁用 ${} |
| MySQL | 5.7+ | 不使用 8.0 特性 |

### 1.2 编码规范
- 实体类手动 getter/setter（不使用 Lombok）
- 控制器返回 Map<String, Object>
- 工具类返回 ResultUtil.success()/error()
- 所有 SQL 使用 #{} 参数化

### 1.3 数据库约束
- 表名：snake_case
- 字段名：snake_case
- 主键：BIGINT AUTO_INCREMENT
- 时间字段：DATETIME DEFAULT CURRENT_TIMESTAMP

---

## 2. 业务约束

### 2.1 短信服务
| 约束 | 说明 |
|------|------|
| 服务商 | 阿里云短信 |
| 每日限额 | 同一工人对同一果农≤1条 |
| 内容模板 | 固定格式，签名"洒渔用工" |
| 发送方式 | 异步发送，不阻断主流程 |
| 失败处理 | 记录日志，不影响报名 |

### 2.2 联系授权
| 约束 | 说明 |
|------|------|
| 有效期 | 7天 |
| 存储 | phone_unlock_record 表 |
| 唯一性 | buyer_identity_id + grower_identity_id |
| 过期处理 | 过期后重新解锁 |

### 2.3 信用机制
| 约束 | 说明 |
|------|------|
| 投诉1次 | 警告（可继续使用） |
| 投诉2次 | 限制24小时 |
| 投诉3次 | 锁定，需管理员解除 |
| 自动恢复 | 凌晨2:00，3天无操作 |

### 2.4 工人状态
| 约束 | 说明 |
|------|------|
| 状态值 | 0忙碌/1空闲 |
| 自动切换 | 报名时自动忙碌 |
| 手动切换 | 工人可手动切换 |
| 自动恢复 | 3天无操作恢复空闲 |

---

## 3. 数据约束

### 3.1 数据隔离
- 所有查询带 user_identity_id 过滤
- 工人只能看自己的报名
- 客商只能解锁自己的联系记录

### 3.2 数据一致性
- 报名时同时更新 worker_apply 和 worker_profile
- 解锁时同时检查和创建 phone_unlock_record
- 使用事务保证原子性

### 3.3 数据验证
| 数据 | 验证规则 |
|------|----------|
| 手机号 | 11位数字 |
| 价格 | 正数，最多2位小数 |
| 产量 | 正数 |
| 技能 | JSON数组格式 |

---

## 4. 性能约束

### 4.1 响应时间
| 接口 | 目标 |
|------|------|
| 推荐列表 | < 500ms |
| 货源列表 | < 500ms |
| 档案查询 | < 200ms |
| 报名操作 | < 1s |

### 4.2 并发处理
- 短信发送异步化
- 报名操作防重复提交
- 数据库连接池配置

---

## 5. 安全约束

### 5.1 认证授权
- JWT Token 认证
- 小程序端 24h 有效期
- 后台端 8h 有效期

### 5.2 数据安全
- 手机号 AES 加密存储
- 手机号 SHA256 哈希查询
- 电话通过拨号接口获取（记录日志）

### 5.3 接口安全
- 敏感操作记录日志
- 短信限流防骚扰
- 联系授权 7 天过期

---

## 6. 集成约束

### 6.1 外部服务
| 服务 | 状态 | 约束 |
|------|------|------|
| 阿里云短信 | 可选 | 未配置时跳过发送 |
| Redis | 可选 | 未配置时使用内存 |
| 微信API | 已配置 | 小程序登录 |

### 6.2 内部依赖
- Phase 2a 已完成模块（果农、招工、拨号）
- 字典表数据（苹果品种、工种、农资种类）
- 用户认证体系（JWT、RBAC）

---

## 7. 测试约束

### 7.1 测试覆盖
- 单元测试覆盖率 ≥ 80%
- 核心接口必须测试
- 异常流程必须覆盖

### 7.2 测试环境
- 使用 MockMvc 测试控制器
- 使用 Mockito 测试服务层
- 使用内存数据库测试数据层

---

## 8. 部署约束

### 8.1 环境要求
| 环境 | 配置 |
|------|------|
| JDK | 1.8 |
| Maven | 3.x |
| MySQL | 5.7+ |
| 内存 | ≥ 512MB |

### 8.2 配置管理
- 敏感配置使用环境变量
- 短信配置可动态修改
- 日志级别可配置