# 项目章程 — 洒渔镇苹果产业供需对接平台

## 项目基本信息

- **项目名称**: 洒渔镇苹果产业供需对接平台
- **项目代号**: SAYU-APP
- **启动时间**: 2026-05-30
- **项目负责**: 业务领导

## 项目目标

为云南昭通洒渔镇苹果产业构建一个供需对接平台，服务于四类主体：

1. **果农** — 发布果园信息、招工需求、查看行情
2. **工人** — 查看招工信息、报名务工、管理个人档案
3. **客商** — 查看货源信息、联系果农、批量采购
4. **农资商** — 发布农资产品、管理店铺

平台通过微信小程序提供移动端服务，后台管理系统供政府管理部门运营使用。

## 核心功能模块

| 模块 | 功能点数 | 优先级 |
|------|---------|--------|
| 用户体系（注册/登录/认证） | 8 | P0 |
| 果农功能（档案/招工/视频/照片） | 14 | P0 |
| 工人功能（档案/报名/状态） | 6 | P0 |
| 客商功能（货源/联系/授权） | 5 | P0 |
| 农资商功能（店铺/商品） | 2 | P1 |
| 行情与数据大屏 | 6 | P1 |
| 审核与运营管理 | 8 | P1 |
| 系统管理（角色/权限/字典） | 6 | P0 |
| 投诉与信用机制 | 3 | P1 |
| 导出与报表 | 3 | P2 |

**总计**: 61 个功能点

## 技术架构

- **后端**: Java 8 / Spring Boot 1.5.9 / Maven 单体项目
- **数据库**: MySQL（`crrc` 库）
- **ORM**: MyBatis（XML 映射）
- **缓存**: Redis
- **小程序**: 微信原生开发
- **后台管理**: Vue 2 + Element UI + ECharts
- **视频存储**: 阿里云 OSS（前端直传）
- **短信服务**: 阿里云短信 API

## 四阶段里程碑

| 阶段 | 名称 | 工期 | 功能点 |
|------|------|------|--------|
| 阶段零 | 环境准备 | 0.5 周 | 项目骨架、数据库、外部服务 |
| 阶段一 | 基础设施与用户体系 | 3-4 周 | 20 个功能点 |
| 阶段二a | 果农核心功能 | 3 周 | 14 个功能点 |
| 阶段二b | 工人+客商+农资 | 2 周 | 13 个功能点 |
| 阶段三 | 运营功能与统计 | 2 周 | 14 个功能点 |

## 验收标准

详见 `docs/acceptance-criteria.md`

## 约束条件

1. 手机号 AES 加密存储，`phone_hash`(SHA256) 建唯一索引
2. 所有业务表带 `user_identity_id` 字段，实现数据隔离
3. MyBatis XML 中参数必须使用 `#{}` 语法，禁止 `${}`
4. 视频上传：≤50MB/720p/2Mbps/≤5分钟
5. 适老化：正文≥18px(rem)、按钮≥88×88px
6. 审核 SLA：≤24小时提醒，48小时升级

## 关键风险

| 风险 | 影响 | 缓解措施 |
|------|------|----------|
| 阿里云短信审核延迟 | 阶段一阻塞 | 提前申请，备选方案 |
| 微信小程序审核周期 | 上线延迟 | 提前准备材料 |
| 视频上传性能 | 用户体验 | OSS 直传，前端压缩 |
| 数据库性能 | 大屏响应 | Redis 缓存，索引优化 |

## 参考文档

- 功能清单：`docs/洒渔镇苹果产业供需对接平台功能清单-V1.0.docx`
- 需求规格：`docs/requirements-specification.md`
- 阶段规划：`docs/phase-planning.md`
- 开发流程：`docs/multi-agent-git-workflow-v2.1.md`