docs: align aftersales README and AGENTS conventions

This commit is contained in:
Frudrax Cheng
2026-05-28 09:15:34 +08:00
parent 2262b39d04
commit aace7ef6e5
2 changed files with 14 additions and 2 deletions
+11 -1
View File
@@ -104,6 +104,16 @@ src/
- `PublicQuery` auto-redirects scanned `zjbf-sh-*` serials to `/aftersales/:serialNumber`
- Shared public-page chrome (logo + 备案 footer) lives in `components/PublicLayout.tsx`
### Aftersales Conventions
- Aftersales serial format is `zjbf-sh-YYMMDDNN` (daily sequence), e.g. `zjbf-sh-26052801`.
- Service type values must use `software` / `hardware` / `maintenance`:
- `software`: 软件故障
- `hardware`: 硬件故障
- `maintenance`: 售后维保
- Use label text `问题描述反馈` for `issueDescription` in create/detail/public-confirm views.
- In admin detail page, use `工单分配` as the UI label for reassign action.
- Signature display text should be `客户确认签名`.
### State Management
- Use React hooks (`useState`, `useEffect`) for local component state
- Authentication state persisted in localStorage via authApi
@@ -190,4 +200,4 @@ export default PageName;
### Add a new component
1. Create in `src/components/ComponentName.tsx`
2. Add styles in `src/components/styles/ComponentName.css` if needed
3. Import using `@/components/ComponentName`
3. Import using `@/components/ComponentName`
+3 -1
View File
@@ -108,7 +108,9 @@ VITE_API_BASE_URL=/api
- 员工管理(员工赋码生成与维护)
- 售后工单
- 技术员创建工单、填写处理结果、提交客户确认
- 管理员可重新分配技术员或强制关闭工单
- 服务类型:软件故障 / 硬件故障 / 售后维保
- 新建和详情字段使用“问题描述反馈”
- 管理员可进行工单分配(重新分配技术员)或强制关闭工单
- 工单状态机:待处理 → 待客户确认 → 已完成 / 已退回
- 用户管理(仅管理员可见)
- 创建技术员/管理员账号、修改角色、重置密码、删除用户