sayu-app/docs/charter.md

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

项目基本信息

• 项目名称: 洒渔镇苹果产业供需对接平台
• 项目代号: 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