danyang-match/docs/Phase-19-V11-Completion-Report.md

Phase 19 完成报告：统一运营后台（后端API核心链路）

版本基线：v1.0.0-RC.2 → v1.1.0-dev | 日期：2026-09-08 对应 EPIC：EPIC-P19-V11

---

完成摘要

项目	内容
Phase	19
模块	善缘丹阳综合运营后台
状态	✅ 后端API核心链路已完成（V1.1 MVP）
Admin Web前端	⏳ 后续补充（Vue 3）

---

数据库变更（V026）

content_categories          -- 内容分类
content_articles            -- 文章内容（含状态机：draft→scheduled→published→offline）
service_programs            -- 专项公益服务项目
service_program_members     -- 项目成员申请与审批
organization_relationships  -- 组织间关系（partner/sponsor等）

---

新增 Java 模块

内容管理（content/）

文件	功能
ContentCategory.java	分类实体
ContentArticle.java	文章实体
ContentCategoryMapper.java	分类Mapper
ContentArticleMapper.java	文章Mapper（含published查询）
ContentService.java	分类+文章完整CRUD + publish/offline
ContentController.java	用户端API + 后台端API

专项项目（service_program/）

文件	功能
ServiceProgram.java	项目实体
ServiceProgramMember.java	成员实体
ServiceProgramMapper.java	项目Mapper
ServiceProgramMemberMapper.java	成员Mapper
ServiceProgramService.java	项目CRUD + 成员申请/审批
ServiceProgramController.java	用户端 + 后台端API

已有模块（V1.1新增但Phase 19之前已完成）

模块	完成阶段
Banner管理（home_banners）	Phase 07
服务站管理（service_locations）	Phase 07
服务预约管理（service_appointments）	Phase 13

---

API 新增汇总

方法	路径	说明
GET	/content/categories	获取内容分类列表
GET	/content/articles	获取已发布文章
GET	/content/articles/{id}	文章详情（含阅读量+1）
POST	/content/operator/categories	创建分类
PUT	/content/operator/categories/{id}	更新分类
POST	/content/operator/articles	创建文章
PUT	/content/operator/articles/{id}	编辑文章
POST	/content/operator/articles/{id}/publish	发布文章
POST	/content/operator/articles/{id}/offline	下架文章
GET	/service-programs	获取项目列表
GET	/service-programs/{id}	项目详情
POST	/service-programs/{id}/apply	申请加入项目
GET	/service-programs/my	我的申请
POST	/service-programs/operator	创建项目
PUT	/service-programs/operator/{id}	更新项目
POST	/service-programs/operator/{id}/activate	激活项目
GET	/service-programs/operator/{id}/members	项目成员列表
POST	/service-programs/operator/members/{id}/approve	审批通过
POST	/service-programs/operator/members/{id}/reject	审批拒绝

---

待Admin Web实现

任务	说明
Banner管理界面	可视化的Banner轮播管理
内容管理界面	富文本编辑器 + 预览
服务站管理界面	地址/营业时间/公告编辑
预约管理界面	确认/分配/完成操作
专项项目管理界面	CRUD + 成员审批
组织协同界面	关系管理

---

Phase 19 后端API核心链路完成。下一阶段：Phase 20（Analytics数据统计扩展）