Преглед изворни кода

📝 docs(prd): update travel service core epic documentation

- add version 1.3 with admin backend story US005-01
- add admin backend user story for basic data management
- adjust user story numbering (US005-01 to US005-07)
- add admin backend API endpoints for activities, routes and schedules
- update frontend page migration strategy with admin backend pages
- rename story file from 005.001.story.md to 005.002.story.md
yourname пре 4 месеци
родитељ
комит
5d242ce305
2 измењених фајлова са 47 додато и 12 уклоњено
  1. 46 11
      docs/prd/epic-005-travel-service-core.md
  2. 1 1
      docs/stories/005.002.story.md

+ 46 - 11
docs/prd/epic-005-travel-service-core.md

@@ -3,6 +3,7 @@
 ## 版本信息
 | 版本 | 日期 | 描述 | 作者 |
 |------|------|------|------|
+| 1.3 | 2025-10-16 | 添加管理后台故事US005-01,确保故事闭环 | John (PM) |
 | 1.2 | 2025-10-15 | 添加我的页面到MVP迁移范围 | John (PM) |
 | 1.1 | 2025-10-15 | 重构页面迁移为用户故事任务 | John (PM) |
 | 1.0 | 2025-10-15 | 基于实际项目状态创建Epic 005 | John (PM) |
@@ -35,7 +36,24 @@ mini-demo包含14个页面,Epic 005将页面迁移作为用户故事的具体
 
 ## 用户故事
 
-### US005-01: 路线查询和活动筛选
+### US005-01: 基础数据管理(管理后台)
+**作为** 系统管理员
+**我希望** 能够配置活动、路线、班次等基础数据
+**以便** 用户能够查询和使用出行服务
+
+**验收标准**:
+- [ ] 支持创建和管理活动类型(去程活动、返程活动)
+- [ ] 支持配置路线信息(出发地、目的地、上车点、下车点)
+- [ ] 支持管理班次(出发时间、车型、价格、座位数)
+- [ ] 支持设置活动关联的路线
+- [ ] 支持启用/禁用活动、路线和班次
+
+**管理后台页面任务**:
+- [ ] 活动管理页面 - 活动类型配置和管理
+- [ ] 路线管理页面 - 路线信息配置和管理
+- [ ] 班次管理页面 - 班次时间、车型、价格管理
+
+### US005-02: 路线查询和活动筛选
 **作为** 出行用户
 **我希望** 能够查询出行路线和筛选活动类型
 **以便** 快速找到适合的出行方案
@@ -51,7 +69,7 @@ mini-demo包含14个页面,Epic 005将页面迁移作为用户故事的具体
 - [ ] 迁移活动选择页面 (select-activity/select-activity) - 活动筛选页面
 - [ ] 迁移班次列表页面 (schedule-list/schedule-list) - 路线列表展示
 
-### US005-02: 乘客信息管理
+### US005-03: 乘客信息管理
 **作为** 出行用户
 **我希望** 能够管理我的乘客信息
 **以便** 快速选择乘车人
@@ -65,7 +83,7 @@ mini-demo包含14个页面,Epic 005将页面迁移作为用户故事的具体
 **页面迁移任务**:
 - [ ] 迁移添加乘客页面 (add-passenger/add-passenger) - 乘客信息管理页面
 
-### US005-03: 订单创建和支付
+### US005-04: 订单创建和支付
 **作为** 出行用户
 **我希望** 能够创建订单并完成支付
 **以便** 确认出行安排
@@ -81,7 +99,7 @@ mini-demo包含14个页面,Epic 005将页面迁移作为用户故事的具体
 - [ ] 迁移下单页面 (order/order) - 订单创建页面
 - [ ] 迁移支付成功页面 (pay-success/pay-success) - 支付结果页面
 
-### US005-04: 订单状态管理
+### US005-05: 订单状态管理
 **作为** 出行用户
 **我希望** 能够查看和管理我的订单状态
 **以便** 了解出行安排进度
@@ -96,7 +114,7 @@ mini-demo包含14个页面,Epic 005将页面迁移作为用户故事的具体
 - [ ] 迁移订单列表页面 (orders/orders) - 订单管理页面
 - [ ] 迁移订单详情页面 (order-detail/order-detail) - 订单详情查看页面
 
-### US005-05: 个人中心管理
+### US005-06: 个人中心管理
 **作为** 出行用户
 **我希望** 能够查看和管理我的个人信息和出行记录
 **以便** 方便地管理我的出行服务
@@ -110,7 +128,7 @@ mini-demo包含14个页面,Epic 005将页面迁移作为用户故事的具体
 **页面迁移任务**:
 - [ ] 迁移我的页面 (mine/mine) - 个人中心入口页面
 
-### US005-06: 支付集成
+### US005-07: 支付集成
 **作为** 系统
 **我希望** 集成微信支付功能
 **以便** 支持用户完成订单支付
@@ -132,6 +150,22 @@ mini-demo包含14个页面,Epic 005将页面迁移作为用户故事的具体
 
 ### API接口设计
 需要新增以下API端点:
+
+**管理后台API**:
+- `GET /api/v1/admin/activities` - 活动管理列表
+- `POST /api/v1/admin/activities` - 创建活动
+- `PUT /api/v1/admin/activities/:id` - 更新活动
+- `DELETE /api/v1/admin/activities/:id` - 删除活动
+- `GET /api/v1/admin/routes` - 路线管理列表
+- `POST /api/v1/admin/routes` - 创建路线
+- `PUT /api/v1/admin/routes/:id` - 更新路线
+- `DELETE /api/v1/admin/routes/:id` - 删除路线
+- `GET /api/v1/admin/schedules` - 班次管理列表
+- `POST /api/v1/admin/schedules` - 创建班次
+- `PUT /api/v1/admin/schedules/:id` - 更新班次
+- `DELETE /api/v1/admin/schedules/:id` - 删除班次
+
+**用户端API**:
 - `GET /api/v1/routes` - 路线查询
 - `GET /api/v1/activities` - 活动查询
 - `POST /api/v1/orders` - 创建订单
@@ -145,11 +179,12 @@ mini-demo包含14个页面,Epic 005将页面迁移作为用户故事的具体
 
 ### 前端页面迁移策略
 页面迁移任务已分配到各个用户故事中,确保每个页面迁移与对应的业务功能同步开发:
-- **US005-01**: 首页、活动选择、班次列表页面
-- **US005-02**: 添加乘客页面
-- **US005-03**: 下单页面、支付成功页面
-- **US005-04**: 订单列表、订单详情页面
-- **US005-05**: 我的页面
+- **US005-01**: 活动管理页面、路线管理页面、班次管理页面(管理后台)
+- **US005-02**: 首页、活动选择、班次列表页面
+- **US005-03**: 添加乘客页面
+- **US005-04**: 下单页面、支付成功页面
+- **US005-05**: 订单列表、订单详情页面
+- **US005-06**: 我的页面
 
 ## 依赖关系
 

+ 1 - 1
docs/stories/005.001.story.md → docs/stories/005.002.story.md

@@ -1,4 +1,4 @@
-# Story 5.1: 路线查询和活动筛选
+# Story 5.2: 路线查询和活动筛选
 
 ## Status
 Draft