# 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）

```sql
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数据统计扩展）*