63 lines
2.2 KiB
Markdown
63 lines
2.2 KiB
Markdown
|
# Council Plan — BackendReviewer
|
|||
|
|
|
|||
|
|
## Task
|
|||
|
|
Review `vr-ticket-uniapp-supplement.md` from backend perspective: check API specs consistency with actual vr-shopxo-plugin implementation, identify missing details, and propose fixes.
|
|||
|
|
|
|||
|
|
## Files to Review
|
|||
|
|
- `/Users/bigemon/WorkSpace/vr-shopxo-uniapp/docs/vr-ticket-uniapp-supplement.md`
|
|||
|
|
- Backend code: `/Users/bigemon/WorkSpace/vr-shopxo-plugin/shopxo/app/plugins/vr_ticket/`
|
|||
|
|
|
|||
|
|
## Backend Review Checklist
|
|||
|
|
|
|||
|
|
- [ ] 1. Compare API spec (Section 2) with actual backend implementations
|
|||
|
|
- [ ] 2.1 商品详情 API — seatSpecMap 返回方式
|
|||
|
|
- [ ] 2.2 购物车提交 API — extension_data 传递链路
|
|||
|
|
- [ ] 2.3 票夹 API — 响应字段对照
|
|||
|
|
- [ ] 2. Check QR payload structure (Section 6.1)
|
|||
|
|
- [ ] 3. Verify short_code format documentation
|
|||
|
|
- [ ] 4. Document missing backend details:
|
|||
|
|
- [ ] extension_data 在 order_detail 中的存储格式
|
|||
|
|
- [ ] Auth 机制（X-Token vs cookie）
|
|||
|
|
- [ ] 核销 API 完整响应码
|
|||
|
|
- [ ] 5. Identify top 3 API gaps (must resolve before frontend dev)
|
|||
|
|
|
|||
|
|
## Phase Breakdown
|
|||
|
|
|
|||
|
|
### Phase 1: Analysis (current)
|
|||
|
|
Read supplement doc + backend code, compare, identify gaps
|
|||
|
|
|
|||
|
|
### Phase 2: Report
|
|||
|
|
Output detailed review report with:
|
|||
|
|
- Document score (1-10)
|
|||
|
|
- Found issues (specific)
|
|||
|
|
- Key gaps (must-fix before dev)
|
|||
|
|
- Improvement suggestions (actionable)
|
|||
|
|
- 3 recommendations for frontend devs
|
|||
|
|
|
|||
|
|
### Phase 3: Finalize
|
|||
|
|
Merge findings into main, coordinate with FrontendReviewer
|
|||
|
|
|
|||
|
|
## Status
|
|||
|
|
|
|||
|
|
| Task | Status |
|
|||
|
|
|------|--------|
|
|||
|
|
| Read supplement doc | Done |
|
|||
|
|
| Analyze backend code | Done |
|
|||
|
|
| Identify API gaps | Done |
|
|||
|
|
| Write review report | Done |
|
|||
|
|
| Merge to main | In Progress |
|
|||
|
|
|
|||
|
|
## Coordination
|
|||
|
|
- FrontendReviewer: reviewing frontend implementation (goods-vr-ticket.vue, components)
|
|||
|
|
- Need to sync on: seatSpecMap acquisition, extension_data format
|
|||
|
|
|
|||
|
|
## Key Findings (Top 3 API Gaps)
|
|||
|
|
|
|||
|
|
1. **Gap 1: seatSpecMap 返回方式（P0）** — 前端无法获取座位规格映射表
|
|||
|
|
2. **Gap 2: CartSave extension_data 传递链路（P0）** — 多座位场景下 attendee 信息存储
|
|||
|
|
3. **Gap 3: QR payload 结构错误（P1）** — 缺少 `code` 字段
|
|||
|
|
|
|||
|
|
## Review Report
|
|||
|
|
- Document score: 7/10
|
|||
|
|
- Critical issues: 5
|
|||
|
|
- Must-fix before Phase 2: 2 (seatSpecMap, extension_data)
|