102 lines
3.5 KiB
Markdown
102 lines
3.5 KiB
Markdown
# 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数据统计扩展）*
|