0 Fork 0

Files

T

2026-07-17 21:59:47 +08:00

13 KiB

Raw Blame History

山峡小程序 · 四模块开发清单

用途：明确移动端开发范围、分期节奏与进度。阶段性完成后请把对应项从 [ ] 改为 [x]，并更新文首「进度总览」。
权威 UI：mobile-ui/shanxia-mp-*.html + docs/miniprogram-ui-spec-sanqiang.md + Pattern 四页。
附件基线：仅拍照凭证 → OpenSpec zkxw-engineering-standards（ui/api/architecture「小程序拍照凭证上传」）。
更新日期：2026-07-16

进度总览

阶段	说明	状态
P0 基础设施	登录、Tab 壳、工作台、我的、上传工具、`/api/mini` 约定	基本完成（见 §2；Pattern 组件随 P1 抽取）
P1 CRM	线索 / 商机 / 客户 / 公海 / 报价 / 合同	基本完成（列表/详情已接 `/web/crm/*`；联调冒烟待做）
P2 报销	待办、报销/借款申请与审批、我的单据	基本完成（已接 `/reimburses` `/advances`；联调冒烟待做）
P3 地磅	仪表盘、计划、地磅单、出入库	基本完成（已接 `/dashboard` `/plans` `/weighing` `/inventory`；联调冒烟待做）
P4 运输	计划、归档、购买证、运费结算/审批	基本完成（已接 `/transport/*`；联调冒烟待做）
P5 收尾	联调、合法域名、发版检查、文档回写	接口冒烟完成；真机 UI / 域名待做

图例：[ ] 未开始 · [~] 进行中 · [x] 已完成 · [-] 本期不做（灰卡/明确排除）

1. 范围边界

1.1 本期要做（Web 一级菜单 → 小程序）

模块	Web 路径	小程序入口	Demo
CRM 管理	`/crm`	工作台 → CRM 区块	`shanxia-mp-crm-demo.html`
报销管理	`/bx`	工作台 → 报销区块	`shanxia-mp-bx-demo.html`
地磅管理	`/db`	工作台 → 地磅区块	`shanxia-mp-db-demo.html`
运输管理	`/pl`	工作台 → 运输区块	`shanxia-mp-pl-demo.html`

1.2 明确不做

项	说明
工作流管理 `/workflow`	不单独做一级模块；报销审批走 BX 业务接口
系统管理 `/system`	租户/菜单/角色等仅 Web
Tab「首页」「待办」业务内容	Demo 标 Phase 2：壳可占位，本期不开发实质功能
Web 专属配置页	如 BX 费用项目/工作流配置、CRM 产品主数据维护等（见各模块灰卡）
小程序文档类附件	PDF/Word 等；仅拍照凭证（见 OpenSpec）

1.3 信息架构（与 Demo 一致）

登录 → 默认「工作台」Tab
Tab：首页(占位) | 待办(占位) | 工作台★ | 我的
工作台：四大模块菜单卡片 → 业务列表/详情/表单（无 TabBar，返回工作台）

2. P0 基础设施

目标：四模块可挂载的统一壳 + 鉴权 + 上传 + 列表/详情模式对齐 Pattern。

2.1 工程与壳

uni-app 工程存在（miniprogram/，自 sqxp 精简）
登录页 + 协议/隐私 + RSA 登录对接 Web 公共鉴权
占位首页 pages/home
TabBar：首页 / 待办 / 工作台 / 我的（登录默认进工作台）
工作台页：四模块 + 菜单卡片（对齐 shanxia-mp-workbench-demo.html；灰卡禁用）
「我的」：展示用户信息、退出登录（对齐 shanxia-mp-mine-demo.html）
首页 / 待办：占位页即可（本期不做业务）
全局样式 Token 对齐 shanxia-mp-base.css / UI 规范（styles/mp-shell.scss）
[~] Pattern 落地：列表 / 查看 / 表单 / 反馈 — Demo 已有；可复用组件随 P1 首业务页抽取（见 pages/common/patterns-readme.md）

2.2 网络与上传

config/api.js：区分环境基址；真机局域网说明（注释）
业务 API 路径约定：P0 认证复用 /web/auth/*；上传复用 /web/admin/attachment/upload；业务 /api/mini/* 随模块补充
utils/upload.js：chooseImage + uploadFile + URL 收集（OpenSpec 基线）
上传路径已在服务端 API_ENCRYPT_EXCLUDE_PATHS（/api/web/admin/attachment/upload）
微信合法域名（request / uploadFile）清单与发版脚本核对（发版前 / P5）

2.3 菜单与权限

工作台菜单前端写死四模块（config/workbench-menus.js，与 Demo 灰卡一致）
按角色权限过滤/置灰（有菜单权限接口后再接；P0 全量展示启用卡）

3. P1 CRM 管理

Demo 启用菜单 = 本期范围；灰卡 = 本期不做。

菜单	本期	建议能力	进度
线索管理	要做	列表/筛选 Tab、详情、新增/跟进、分配、转商机	[x] 列表/详情/新增/跟进/转客户/无效；分配待 Web
商机管理	要做	列表、详情、跟进/阶段（看板可二期）	[x] 列表/详情/跟进；阶段变更二期
客户管理	要做	列表、详情、跟进入口	[x]
公海池	要做	列表、领取/分配	[x] 列表+领取；分配待 Web 选人
报价管理	要做	列表、详情、关键状态操作	[x] 列表/详情（审批在 Web）
合同管理	要做	列表、详情、关键状态（无审批流复杂页可简化）	[x] 列表/详情（审批在 Web）
产品分类	不做	Web 主数据	[-]
产品管理	不做	Web 主数据	[-]
合同审批	不做	Demo 灰卡	[-]
线索/商机统计、看板、漏斗	不做	Web 分析页，除非产品加开	[-]

P1 任务拆解

工作台 CRM 菜单卡片接线（WORKBENCH_ROUTE_MAP）
线索：列表 + 详情 + 表单/跟进（mobile-ui Pattern：Header/Tabs/Card/Tag/BottomBar）
商机：列表 + 详情 + 跟进
客户：列表 + 详情 + 跟进
公海池：列表 + 领取（分配需选人，留 Web）
报价：列表 + 详情
合同：列表 + 详情
接口联调与租户/数据权限冒烟（需 admin 账号 + 后端）
阶段验收：销售角色可完成「线索→商机→客户」主路径

4. P2 报销管理

菜单	本期	建议能力	进度
待办任务	要做	待审批/我的申请/已办 Tab；通过/驳回	[x]
报销申请	要做	新建/编辑、明细、提交（票据以拍照凭证为主）	[x] 新建+拍照+草稿/提交
报销审批	要做	列表 + 审批动作（可与待办合并入口）	[x]
借款申请	要做	备用金申请	[x]
借款审批	要做	备用金审批	[x]
我的单据	要做	我的申请单列表/详情	[x]
借款发放	不做	Demo 灰卡（偏财务后台）	[-]
全部单据	不做	Demo 灰卡（总经理 Web）	[-]
付款记录	不做	Demo 灰卡	[-]
费用项目/工作流配置	不做	Web 基础配置	[-]
支付发放冲抵	不做	本期不进工作台	[-]

P2 任务拆解

工作台报销菜单卡片接线
待办任务列表（对齐 bx-demo：大麦黄 Header + Tabs + 卡片审批）
报销申请（表单 + 拍照凭证 /attachments/upload + bind）
报销审批动作
借款（备用金）申请 / 审批
我的单据
接口联调与审批状态机冒烟
阶段验收：申请人提交 → 审批人通过/驳回闭环

5. P3 地磅管理

菜单	本期	建议能力	进度
仪表盘	要做	关键统计卡片（只读）	[x]
地磅计划	要做	列表、详情、必要办理动作	[x] 列表/详情/生成出入库关联
地磅单管理	要做	列表、详情、二次过磅等现场动作	[x] 二次过磅 + 当天作废
地磅出入库	要做	列表、详情	[x]

P3 任务拆解

工作台地磅菜单卡片接线
仪表盘（对齐 db-demo 青绿 Header + 统计卡）
地磅计划列表/详情
地磅单列表/详情/二次过磅/作废
出入库列表/详情
接口联调（注意与地磅系统边界，见 ecosystem-landscape）
阶段验收：查计划 → 看待过磅单 → 完成一次现场办理路径

6. P4 运输管理

菜单	本期	建议能力	进度
运输计划	要做	列表 Tab、详情、安排运输等	[x] 待发运/在途/已完成 + 安排运输
计划归档	要做	只读列表/详情	[x]
购买证上传	要做	列表 + 拍照凭证上传（OpenSpec）	[x] 拍照 + 证书齐备
运费结算	要做	列表、详情、提交	[x] 结算单/待结算生成 + 提交审批
运费审批	要做	列表、审批	[x]
财务发放	不做	Demo 灰卡	[-]
车辆充值	不做	Demo 灰卡（ETC 等）	[-]
车辆维修	不做	Demo 灰卡	[-]
运输地址库	不做	Demo 灰卡（主数据）	[-]
基础信息库其余页	不做	车辆/承运商/驾押等主数据偏 Web	[-]
证件提醒 / 尿素等	不做	未进工作台启用卡	[-]

P4 任务拆解

工作台运输菜单卡片接线
运输计划列表/详情/办理（对齐 pl-demo）
计划归档
购买证上传（拍照凭证）
运费结算 + 运费审批（含选人提交审批）
接口联调
阶段验收：计划办理 → 购买证上传 → 运费提交/审批主路径

7. P5 收尾与发版

四模块冒烟清单（角色 × 主路径）— 接口级已跑通，见 §7.1
真机：登录、列表、上传、审批/办理
npm run release:check-api（或等价）通过
微信后台域名与上传域名配置完成
README / 本清单进度回写（接口冒烟结论已写入）
可选：OpenSpec 归档或增补「小程序四模块」变更说明

7.1 四模块冒烟清单（联调时勾选）

账号：具备对应模块权限的 admin / 业务角色；基址见 miniprogram/config/api.js。
接口冒烟执行：2026-07-17，admin / 本机 http://127.0.0.1:8000/api，脚本 miniprogram/scripts/mp_api_smoke.py（结果见 mp_api_smoke_last.json）。
图例：[x] 接口可达且读通；写操作因缺样本/字段校验未闭环的在备注中说明。

#	模块	路径	预期	结果
S1	公共	登录 → current-user	Token 可用	[x] 登录+current-user ok
S2	CRM	线索列表 → 详情 → 跟进	列表/详情正常	[x] 列表+详情 ok；跟进 body 422（字段待对齐）
S3	CRM	公海列表/领取	列表正常	[x] 列表空态 ok（无领取样本）
S4	报销	我的报销 / 新建	列表可读	[x] my 列表 ok；新建缺 `details` 字段 422（小程序 payload 待对齐）
S5	报销	待审批列表	列表正常	[x] 空态 ok（无待审样本）
S6	地磅	仪表盘 + 地磅单列表	数字/列表可读	[x] stats+列表 ok；无二次过磅样本
S7	运输	计划列表 / 安排	列表正常	[x] 列表 ok；安排因证书未齐备业务拒绝（接口可达）
S8	运输	购买证相关计划列表	列表正常	[x] 列表空态 ok
S9	运输	运费结算 + 用户选项	列表/选人接口正常	[x] freight 列表 + users/options ok；无待结算
S10	运输	运费待审批列表	列表正常	[x] 列表空态 ok

接口冒烟结论：S1–S10 读路径全部通（0 FAIL）。写路径有 3 处需跟进：① 线索跟进字段；② 报销创建体应用 details 而非 items；③ 安排运输依赖证书齐备业务数据。
前端 UI：仍由人工在微信开发者工具/真机验收。

8. 推荐开发顺序

P0 壳与工作台（否则业务页无处挂）
P2 报销 或 P1 CRM（审批/跟进闭环短，易验证上传与列表模式）
P3 地磅（现场办理，偏读+少量动作）
P4 运输（计划+运费+购买证，依赖上传基线）
P5 联调发版

顺序可按业务优先级调整；调整时只改本节与文首总览，子清单保持勾选状态。

9. 进度记录（追加）

日期	阶段	说明
2026-07-16	范围	确认仅 CRM / 地磅 / 运输 / 报销四模块；本清单建立
2026-07-16	规范	拍照凭证上传写入 OpenSpec engineering-standards
2026-07-16	P0	TabBar + 工作台/我的/占位页 + upload.js + mp-shell；清单回写
2026-07-16	P1–P4	CRM / 报销 / 地磅 / 运输业务页落地并接线工作台
2026-07-16	P4+	运费提交审批改为用户选项选人 Sheet；P5 冒烟表写入 §7.1
2026-07-17	P5	接口冒烟 S1–S10 读路径全通（脚本 `mp_api_smoke.py`）；写路径 3 处待对齐见 §7.1

13 KiB Raw Blame History Unescape Escape