跳到主要内容

前端分层与调用链路

两条典型链路​

读取：页面 / 组件 → view-model → repository / mapper → API facade → 统一客户端
写入：页面 → action → repository / API facade / BFF → 回读确认 → 刷新失效

页面负责交互与生命周期，view-model 提供稳定的显示结构；repository 组织数据读取与快照；action 处理业务写入、幂等、失败恢复和回读；API 层处理通道合同，bootstrap 客户端处理认证与网络协议。

新增功能的顺序​

  1. 搜索已有模块的读取、校验和写入入口，确定可以复用的部分。
  2. 明确业务输入和返回模型，避免把物理字段散落到页面。
  3. 在 repository 或 action 中完成请求、权限上下文和结果核对。
  4. 让 view-model 暴露页面需要的状态、错误与操作可用性。
  5. 页面只调用业务入口，并使用既有加载与错误组件。
  6. 增加必要的合同或状态测试，再做真实页面复核。

边界约束​

页面不得直接使用 uni.request、callV1/callV2 或拼装表单请求；基础组件不绑定真实表单 ID。共享能力放在现有层内，不为单个页面再建平行服务。

前端已有少量历史跨表协调，新增复杂事务应向 BFF 收敛。不要为了保持旧实现形式而继续扩大客户端事务，也不要无关重构已运行模块。