sayu-app/deliveries/team-a-requirement/constraints.md

阶段2a约束条件 — 果农核心功能

继承阶段一全部约束 + 阶段2a新增约束

---

一、技术约束（继承阶段一）

1.1 开发环境

• JDK: 1.8.0_291
• Maven: 3.6.3
• Spring Boot: 1.5.9.RELEASE
• 数据库: MySQL 5.7+（sayu 库）
• 缓存: Redis 3.0+（可选）
• ORM: MyBatis（XML 映射）

1.2 代码规范

• 包名: com.sayu
• Controller 路径:
  • 小程序端: /api/wx/*
  • 后台管理端: /api/admin/*
• MyBatis XML: 必须使用 #{} 语法，禁止 ${}
• 文件行数: ≤ 500 行/文件

1.3 构建与部署

• 构建工具: Maven
• 编译命令: mvn compile
• 测试命令: mvn test
• 启动命令: mvn spring-boot:run

---

二、安全约束（继承阶段一 + 新增）

2.1 数据安全（继承）

• 手机号: AES 加密存储，phone_hash (SHA256) 唯一索引
• Token: JWT，payload 包含 userId, identityId, identityType, exp
• 密钥管理: 配置在 application.properties，禁止硬编码

2.2 接口安全（继承）

• 认证: JWT Token 认证
• 授权: RBAC 权限控制，默认拒绝，显式授权
• 防注入: MyBatis #{} 参数化
• 敏感数据: 接口返回脱敏（手机号 138****8888）

2.3 文件上传安全（新增）

• 格式白名单: 图片（jpg,jpeg,png,gif）、视频（mp4,mov,avi）
• 大小限制: 图片≤5MB/张，视频≤50MB
• EXIF清除: 前端必须清除EXIF元数据（防止位置泄露）
• 文件存储: 本地存储目录 ./uploads/，禁止路径穿越

2.4 内容安全（新增）

• 敏感词检测: 正则匹配，色情/赌博/政治等明确违规词
• 不阻塞发布: keyword_flag=1 进入待复核，招工仍可见
• 人工复核: 审核员定时处理待复核列表

---

三、业务约束（继承阶段一 + 新增）

3.1 用户体系（继承）

• 一人多职: 一个用户可绑定多个身份
• 数据隔离: 所有业务表带 user_identity_id 字段
• 身份路由: 0个→提示联系村委会，1个→直接进入，N个→选择页

3.2 审核机制（继承 + 扩展）

• 审核对象: 果农名片（阶段2a新增）
• 审核状态: 待审(0)、已通过(1)、被驳回(2)
• 审核 SLA: ≤24小时提醒，48小时升级给超级管理员
• 驳回要求: 必须填写驳回原因
• 待复核: 敏感关键词标记的招工信息

3.3 招工发布规则（新增）

• 免审核直接发布: recruit_info.status=1
• 敏感词标记: keyword_flag=1 不阻塞发布
• 下架: 逻辑删除（status=0）
• 编辑: 可编辑价格、人数、天数、备注

3.4 文件上传规则（新增）

• 视频: 仅限1个，≤50MB，MP4/MOV，异步压缩720p/2Mbps
• 照片: ≤9张，单张≤5MB，JPG/JPEG/PNG/GIF
• 存储: 本地文件存储，数据库存URL

---

四、性能约束（继承阶段一 + 新增）

4.1 响应时间（继承）

• 接口响应: ≤500ms（95%请求）
• 页面加载: ≤3s

4.2 文件上传性能（新增）

• 上传时间: ≤50MB文件，局域网环境≤30s
• 视频压缩: 异步处理，不影响用户操作
• 压缩重试: 失败自动重试3次

4.3 距离计算性能（新增）

• Haversine公式: 实时计算，不缓存
• 经纬度精度: DECIMAL(10,7)
• 排序: 按距离升序，分页查询

---

五、兼容性约束（继承阶段一）

5.1 小程序端

• 微信基础库: ≥2.0
• 适老化:
  • 正文≥18px(rem)
  • 按钮≥88×88px
  • 高对比度
  • 语音输入支持

5.2 后台管理端

• 浏览器: Chrome/Firefox/Edge 最新版
• 分辨率: ≥1280×720

---

六、数据约束（继承阶段一 + 新增）

6.1 数据库设计（继承）

• 字符集: utf8mb4
• 排序规则: utf8mb4_unicode_ci
• 表引擎: InnoDB
• 主键: 自增ID

6.2 索引设计（新增）

• grower_profile: latitude+longitude 复合索引（距离查询）
• recruit_info: latitude+longitude 复合索引
• recruit_info: keyword_flag INDEX（待复核查询）
• call_log: caller_identity_id INDEX, callee_identity_id INDEX

6.3 JSON字段规范（新增）

• varieties: JSON数组，如 ["红富士","嘎啦"]
• work_types: JSON数组，如 ["采摘工","分拣工"]
• photos: JSON数组，如 ["http://localhost:8080/files/image/xxx.jpg"]
• skills: JSON数组，如 ["采摘","套袋"]

---

七、接口约束（继承阶段一）

7.1 接口格式（继承）

• 请求格式: JSON
• 响应格式: JSON

• 响应结构:

  {
  "code": 200,
  "message": "success",
  "data": {}
  }
  

7.2 错误码规范（继承）

• 200: 成功
• 400: 请求参数错误
• 401: 未认证
• 403: 无权限
• 404: 资源不存在
• 500: 服务器内部错误

7.3 分页规范（继承）

• 请求参数: page（页码，从1开始）、pageSize（每页数量，默认20）

• 响应参数:

  {
  "total": 100,
  "page": 1,
  "pageSize": 20,
  "list": []
  }
  

---

八、测试约束（继承阶段一 + 新增）

8.1 测试框架（继承）

• 单元测试: JUnit 4
• 集成测试: Spring Boot Test
• 测试目录: src/test/java/

8.2 测试覆盖（继承）

• 核心接口: 测试覆盖率 ≥80%
• 测试独立性: 每个测试方法独立运行
• 测试可重复: 同一测试多次运行结果一致

8.3 阶段2a测试重点（新增）

• 文件上传: 50MB边界、格式异常、EXIF清除验证
• 招工发布: 敏感词标记、免审核发布、下架/编辑
• 找工人: 工种筛选、距离排序准确性、拨号日志
• 审核: 名片通过/驳回、待复核处理、SLA提醒

---

九、约束继承清单

约束类别	阶段一约束	阶段2a新增
技术约束	全部继承	无新增
安全约束	全部继承	文件上传安全、内容安全
业务约束	全部继承	招工发布规则、文件上传规则
性能约束	全部继承	文件上传性能、距离计算性能
兼容性约束	全部继承	无新增
数据约束	全部继承	索引设计、JSON字段规范
接口约束	全部继承	无新增
测试约束	全部继承	阶段2a测试重点