pangu-user-platform/docs/05-模块技术方案/应用管理-开发计划_Plan模式.md

# 应用管理模块 - 开发计划（Plan 模式）

---

| 文档信息 | 内容 |
|---------|------|
| **文档版本** | V1.0 |
| **模块名称** | 应用管理 |
| **编写团队** | pangu |
| **创建日期** | 2026-01-31 |

---

## 一、当前完成情况结论

**应用管理菜单中的全部页面目前并非前后端一起完成。**

| 端 | 状态 | 说明 |
|----|:----:|------|
| **前端** | ✅ 已完成 | 列表页、新增/编辑弹窗、密钥弹窗、API 封装、Mock 数据均已实现，可与 Mock 联调使用 |
| **后端** | ❌ 未开发 | 无 ApplicationController、无应用相关 Service/Mapper/实体，需从零开发 |

---

## 二、Plan 模式开发计划总览

```
┌─────────────────────────────────────────────────────────────────────────┐
│                    应用管理模块 - 开发计划（Plan）                          │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  [阶段一] 技术方案与文档     ✅ 已完成                                      │
│  [阶段二] 前端开发           ✅ 已完成                                      │
│  [阶段三] 后端开发           ⬜ 待开始  ← 当前缺口                           │
│  [阶段四] 联调与测试         ⬜ 待开始                                      │
│  [阶段五] 验收上线           ⬜ 待开始                                      │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘
```

---

## 三、分阶段任务清单（Plan）

### 阶段一：技术方案与文档 ✅ 已完成

| 序号 | 任务项 | 状态 | 产出/路径 |
|:----:|-------|:----:|----------|
| 1.1 | 应用管理模块技术方案 | ✅ | docs/05-模块技术方案/应用管理模块技术方案_v1.0.md |
| 1.2 | 前端技术方案 | ✅ | docs/05-模块技术方案/应用管理-前端技术方案.md |
| 1.3 | 后端技术方案 | ✅ | docs/05-模块技术方案/应用管理-后端技术方案.md |
| 1.4 | 开发检查清单 | ✅ | docs/05-模块技术方案/应用管理-开发检查清单.md |
| 1.5 | 测试用例 | ✅ | docs/05-模块技术方案/应用管理-测试用例.md |

---

### 阶段二：前端开发 ✅ 已完成

| 序号 | 任务项 | 状态 | 产出/路径 |
|:----:|-------|:----:|----------|
| 2.1 | 应用列表页 | ✅ | frontend/src/views/application/index.vue |
| 2.2 | 新增/编辑弹窗 | ✅ | frontend/src/views/application/components/AppDialog.vue |
| 2.3 | 密钥展示弹窗（重置后复制） | ✅ | frontend/src/views/application/components/SecretDialog.vue |
| 2.4 | 应用管理 API 封装 | ✅ | frontend/src/api/application.js |
| 2.5 | 应用管理 Mock 数据 | ✅ | frontend/src/mock/application.js |
| 2.6 | 路由与菜单配置 | ✅ | 已挂载应用管理菜单，可 Mock 联调 |

**前端已实现能力：**

- 列表查询（应用名称、编码、状态筛选 + 分页）
- 新增应用（应用名称、描述、联系人、电话、状态、接口授权勾选）
- 编辑应用（拉取详情回填 + 提交更新）
- 删除应用（Popconfirm 二次确认）
- 重置密钥（确认后弹窗显示新密钥并支持复制）
- 接口授权选项来自 `GET /api/application/apiList`，与接口文档一致

---

### 阶段三：后端开发 ⬜ 待开始

| 序号 | 任务项 | 状态 | 说明 |
|:----:|-------|:----:|------|
| **3.1 数据库** | | | |
| 3.1.1 | 创建 pg_application 表 | ⬜ | 按《数据库设计文档》建表 |
| 3.1.2 | 创建 pg_app_api 表 | ⬜ | 应用接口授权表 |
| 3.1.3 | 创建 pg_api_dict 表 | ⬜ | API 接口字典表 |
| 3.1.4 | 插入 pg_api_dict 初始数据 | ⬜ | 6 条（STUDENT_LIST 等） |
| 3.1.5 | 插入应用管理菜单数据 | ⬜ | sql/pangu_menu.sql 或等价脚本 |
| **3.2 实体层** | | | |
| 3.2.1 | Application 实体 | ⬜ | app_id, app_code, app_name, app_secret 等 |
| 3.2.2 | AppApi 实体 | ⬜ | 应用接口授权 |
| 3.2.3 | ApiDict 实体 | ⬜ | 接口字典（或复用已有） |
| 3.2.4 | VO/DTO（可选） | ⬜ | 列表/详情/新增修改用 |
| **3.3 Mapper 层** | | | |
| 3.3.1 | ApplicationMapper + XML | ⬜ | 分页列表、详情、增删改 |
| 3.3.2 | AppApiMapper + XML | ⬜ | 按 app_id 查/删/批量插入 |
| 3.3.3 | ApiDictMapper + XML | ⬜ | 查全部接口列表（apiList） |
| **3.4 Service 层** | | | |
| 3.4.1 | IApplicationService | ⬜ | 列表、详情、新增、修改、删除、重置密钥、apiList |
| 3.4.2 | ApplicationServiceImpl | ⬜ | 应用编码 YY+6 位、密钥 32 位、事务与授权表联动 |
| **3.5 Controller 层** | | | |
| 3.5.1 | ApplicationController | ⬜ | 实现《接口设计文档》第 6 章全部接口 |
| **3.6 接口清单（与前端对齐）** | | | |
| 3.6.1 | GET /api/application/list | ⬜ | 分页列表，支持 appName、appCode、status |
| 3.6.2 | GET /api/application/{appId} | ⬜ | 详情，含 apis 列表 |
| 3.6.3 | POST /api/application | ⬜ | 新增，body: appName, appDesc, contactPerson, contactPhone, status, apiCodes |
| 3.6.4 | PUT /api/application | ⬜ | 修改，body: appId + 同上 |
| 3.6.5 | DELETE /api/application/{appId} | ⬜ | 删除（含授权表） |
| 3.6.6 | PUT /api/application/resetSecret/{appId} | ⬜ | 重置密钥，返回 data.appSecret |
| 3.6.7 | GET /api/application/apiList | ⬜ | 返回可授权接口列表，供前端勾选 |

---

### 阶段四：联调与测试 ⬜ 待开始

| 序号 | 任务项 | 状态 | 说明 |
|:----:|-------|:----:|------|
| 4.1 | 前端关闭 Mock，对接真实后端 | ⬜ | 修改 request baseURL 或环境变量 |
| 4.2 | 接口联调（列表、详情、新增、编辑、删除、重置密钥、apiList） | ⬜ | 按接口文档校验请求/响应 |
| 4.3 | 业务规则校验 | ⬜ | 编码 YY+6 位、密钥 32 位、删除确认、重置后弹窗复制 |
| 4.4 | 执行《应用管理-测试用例》 | ⬜ | 功能 + 边界 + 权限（如需要） |

---

### 阶段五：验收上线 ⬜ 待开始

| 序号 | 任务项 | 状态 | 说明 |
|:----:|-------|:----:|------|
| 5.1 | 产品/业务验收 | ⬜ | 按需求规格说明书应用管理章节 |
| 5.2 | 部署与发布 | ⬜ | 后端部署、前端打包部署 |
| 5.3 | 上线检查与回滚预案 | ⬜ | 配置、权限、数据初始化 |

---

## 四、后端开发建议顺序（Plan 执行顺序）

按依赖关系，建议按以下顺序实施**阶段三**：

```
1. 数据库
   └─ 建表 + 初始数据 + 菜单 SQL

2. 实体 + Mapper
   └─ Application, AppApi, ApiDict 实体
   └─ ApplicationMapper, AppApiMapper, ApiDictMapper（含 XML）

3. Service
   └─ IApplicationService + ApplicationServiceImpl
   └─ 编码生成、密钥生成、重置密钥、授权表增删

4. Controller
   └─ ApplicationController
   └─ 7 个接口与接口文档、前端入参出参完全对齐

5. 单测与自测
   └─ Service 单测（可选）
   └─ Postman/浏览器自测 7 个接口
```

---

## 五、前后端对接要点（联调时核对）

| 项目 | 前端约定 | 后端需满足 |
|------|----------|------------|
| 主键字段名 | 兼容 `appId` 与 `id` | 统一返回 `appId` 或与前端约定一致 |
| 列表行数据 | 含 `apis: [{ apiCode, apiName, apiPath }]` | 列表接口返回每行带 apis（或至少 apiCodes） |
| 详情接口 | 返回 `data.apis` | GET /api/application/{appId} 返回 apis 数组 |
| 新增/修改 body | appName, appDesc, contactPerson, contactPhone, status, apiCodes | 接收 apiCodes 数组，落库到 pg_app_api |
| 重置密钥 | PUT /api/application/resetSecret/{appId}，响应 data.appSecret | 同上，返回明文新密钥 |
| apiList | GET /api/application/apiList，data 为数组 | 返回 pg_api_dict 中启用接口列表 |

---

## 六、总结

| 问题 | 结论 |
|------|------|
| 应用管理菜单中的全部页面是否前后端一起完成？ | **否。** 仅前端（含 Mock）完成，后端未开发。 |
| 下一步建议 | 按本文「阶段三」与「后端开发建议顺序」实施后端开发，再进行阶段四联调与测试。 |

---

*文档结束*