提交 c99bc79a authored 作者: yujiejie's avatar yujiejie

实习生培训平台PM前置文件 细化版功能架构图

上级 85c78d78
差异被折叠。
差异被折叠。
# 0901 功能整合决策记录(原型图修改依据)
> 项目:0831InternTrainingPlatform
> 用途:记录"学生端任务大厅/项目大厅是否整合"与"管理员端项目管理/任务下发是否整合"两轮讨论的结论,作为后续修改原型图与页面交互表的依据
> 关联文档:《04_功能架构图》v4.2 已按本决策同步修改;《05_页面交互梳理表》后续需联动更新
---
## 1. 决策一:学生端「任务大厅」与「项目大厅」——不整合
### 1.1 差异对比
| 维度 | 任务大厅(阶段二) | 项目大厅(阶段三~五) |
| --- | --- | --- |
| 数据来源 | 管理员固定下发,全员一致 | AI 个性化推荐,每人不同 |
| 任务呈现 | 简单列表,无需推荐理由 | 需要展示缺陷分析、推荐理由、难度、匹配度 |
| 选择行为 | 不用"选",直接开始做 | 需要"挑选",涉及比较、查看详情、做决定 |
| 环境信息 | 需展示 AutoDL 真机部署信息 | 仅沙箱,无需额外环境说明 |
| 入口意义 | 通知型入口:告诉你"该做什么" | 决策型入口:帮你决定"做什么" |
### 1.2 结论:不整合
理由:
1. 数据源不同 → 合并后前端需要大量条件分支切换数据获取与渲染逻辑;
2. 选择行为不同 → 阶段二固定任务可直接进入学习,阶段三~五需要推荐卡片、缺陷依据、比较选择;
3. 业务心智不同 → 固定任务与个性化推荐是两种心智模型,混在一起反而让学生困惑。
### 1.3 替代方案
- 共享底层组件:卡片列表、筛选器、详情面板;
- 后台数据模型统一:任务/项目共用一张表,`source` 字段区分 `admin_fixed` / `ai_recommended`;
- 入口页面独立:`student-task-hall`、`student-project-hall` 保持独立。
### 1.4 对原型图的影响
- 保留两个独立入口页面;
- 原型中共享列表/卡片组件,前端复用组件而非复用页面;
- 阶段二任务大厅可直接用简单列表呈现(无需推荐卡片);
- 阶段三~五项目大厅需展示推荐理由、难度匹配度等信息。
---
## 2. 决策二:管理员端「项目管理」与「任务下发」——整合
### 2.1 差异对比
| 维度 | 项目管理 | 任务下发 |
| --- | --- | --- |
| 内容 | 全量项目库(所有阶段) | 阶段二固定部署任务 |
| 核心操作 | CRUD、难度校准 | 内容配置、草稿、统一发布/覆盖 |
| 特有行为 | 无发布行为 | "发布后覆盖学生端默认任务"广播动作 |
| 元数据 | 标准项目字段 | 额外 AutoDL 配置、SSH 信息、部署脚本路径 |
| 业务含义 | 管"项目"本身 | 管"下发到学生端"的分发动作 |
### 2.2 结论:整合
理由:管理员面对的是同一批内容(项目库),部署任务只是项目的一个特殊子类型;拆分两个页面增加管理员的切换成本,与"学生端两个入口源于不同心智模型"的情况不同。
### 2.3 整合方案
1. `admin-projects` 增加「项目类型」字段(`普通项目` / `部署任务`);
2. 类型为"部署任务"时展开额外字段(环境配置、SSH 信息、部署脚本路径);
3. 列表页对部署任务显示「发布」按钮与「已发布/未发布」状态;
4. 点击「发布」执行统一下发(覆盖学生端默认任务)。
### 2.4 保留点
- 若后续阶段二任务类型变复杂(多种固定任务类型)或发布需要审批流,再考虑拆回独立页面;
- 发布动作仍可复用 `admin-deploy-task` 编辑子页路由,但不再作为顶层独立入口。
### 2.5 对原型图的影响
- 管理员端顶层导航移除"任务下发"入口,合并到"项目管理";
- 项目列表页增加类型筛选与发布操作;
- 新建/编辑项目时按类型切换字段表单。
---
## 3. 关联文档联动清单
| 文档 | 联动内容 | 状态 |
| --- | --- | --- |
| 《04_功能架构图》 | 页面命名收口、进阶推荐闭环改差异入口、架构分层图、支撑层拆分、企业级配置中心、数据实体占位、总览图瘦身、管理员端整合 | 已同步(v4.2) |
| 《05_页面交互梳理表》 | 管理员端 `admin-deploy-task` 入口行需改为从 `admin-projects` 进入;学生端任务大厅/项目大厅入口行保留 | 待后续原型修改时同步 |
| 原型图 | 按决策一、决策二调整管理员端导航与学生端入口 | 待修改 |
---
## 4. 结论
- **学生端**:任务大厅与项目大厅保留独立页面,共享组件降低维护成本;
- **管理员端**:项目管理与任务下发合并为一个页面,以"项目类型"字段与"发布"动作区分能力层次。
\ No newline at end of file
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑!
请 注册 或者 后发表评论