feat: batch update - gift card breakdown spec, backend APIs, miniprogram pages, ETL finance recharge, docs & migrations

This commit is contained in:
Neo
2026-03-20 01:43:48 +08:00
parent 075caf067f
commit 79f9a0e1da
437 changed files with 118603 additions and 976 deletions

View File

@@ -0,0 +1,57 @@
# 无权限页面no-permission— 接口对接审计
> 审计时间2026-03-18
> 页面路径:`apps/miniprogram/miniprogram/pages/no-permission/`
> 文件清单:`no-permission.ts` / `.wxml` / `.wxss` / `.json`
---
## 一、总览
| 指标 | 值 |
|------|-----|
| 已对接 API 数量 | 1 |
| Mock 数据引用 | 0 |
| 硬编码字段数 | 4 |
| 对接就绪度 | ✅ 已对接 |
本页面功能简单:展示"无访问权限"提示,`onShow` 时调用 `/api/xcx/me` 查询最新用户状态,状态变化时自动跳转对应页面。核心逻辑已完成 API 对接。
---
## 二、已对接 API
| # | 接口 | 方法 | 用途 | 调用位置 |
|---|------|------|------|----------|
| 1 | `/api/xcx/me` | GET | 查询用户最新状态status根据状态路由跳转 | `_checkStatus()` |
---
## 三、Mock 数据
无。本页面未引用任何 mock 数据。
---
## 四、硬编码字段清单
| # | 位置 | 硬编码内容 | 类型 | 建议处理方式 |
|---|------|-----------|------|-------------|
| 1 | wxml `.reason-footer-value` | `厉超`(管理员姓名) | 文案 | 应从后端获取门店管理员信息,或写入配置 |
| 2 | wxml `.reason-item` × 3 | 三条原因说明文案 | 文案 | 可保留前端硬编码(纯展示文案,无业务逻辑) |
| 3 | wxml `.main-title` | `无访问权限` | 文案 | 可保留(固定标题) |
| 4 | wxml `.sub-title` | 副标题说明文案 | 文案 | 可保留(固定说明) |
---
## 五、对接建议
1. **管理员姓名硬编码**`厉超` 写死在 wxml 中,建议后端 `/api/xcx/me` 返回门店管理员联系信息,或新增配置接口
2. **状态路由映射**`_checkStatus()``approved` 状态跳转 `/pages/mvp/mvp`,该路径在当前页面目录中不存在,需确认是否为 tabBar 页面或后续新增页面
3. **其余文案**:原因说明、标题等为纯展示文案,无需接口化,保留硬编码即可
---
## 六、结论
本页面已完成核心 API 对接,唯一需要关注的是管理员姓名硬编码问题。整体对接就绪度高,无需大幅改动。