33 lines
2.7 KiB
Markdown
33 lines
2.7 KiB
Markdown
# WeChat Mini Program Instructions
|
|
|
|
## 项目定位
|
|
|
|
- 本项目面向企业客户和业务人员，运行于微信小程序环境。
|
|
- 现有原型范围包括登录注册、首页、头程下单、订单、审批、结算、海外仓服务和个人中心。
|
|
- 与 `client-web` 共享业务契约，但小程序只承载适合微信内高频、轻量和即时触达的流程。
|
|
|
|
## 当前阶段门禁
|
|
|
|
- 一期范围、原生小程序或跨端方案、基础库版本、分包策略、登录绑定和发布流程尚未确认。
|
|
- 决策前不创建正式脚手架、不引入框架和锁文件，也不假设可以照搬 Web DOM、浏览器存储或客户工作台组件。
|
|
- 选型必须评估包体限制、启动性能、平台 API、隐私合规、可访问性、自动化测试、预览和审核发布成本。
|
|
- 方案确定后先更新 `README.md`、依赖清单和本文件，写明真实的开发者工具、安装、检查、测试和构建步骤。
|
|
|
|
## 平台与业务约束
|
|
|
|
- 微信登录只能建立平台身份凭据，企业租户、角色和业务权限必须由服务端确认；不得信任前端传入的租户或角色。
|
|
- 用户绑定、手机号、订阅消息、相册、相机和位置等能力遵循最小授权、按需请求和拒绝可恢复原则。
|
|
- 页面、分包、领域状态、API 适配和微信平台能力保持分层，业务代码不得散落直接调用平台 API。
|
|
- 与 `services/api` 和 `packages/shared` 对齐认证、企业、订单、审批和结算契约；小程序特有字段通过适配层转换。
|
|
- 创建订单、审批和结算请求必须防重复提交并具备幂等策略；会话过期时保存可安全恢复的输入并引导重新认证。
|
|
- 订阅消息需由用户动作触发并清楚说明用途，不把通知授权作为使用核心功能的强制前置条件。
|
|
|
|
## 体验、安全与质量
|
|
|
|
- 优先短流程、拇指可达和清晰反馈；覆盖加载、空数据、弱网、离线、授权拒绝、接口失败和重复操作。
|
|
- 控制主包与分包体积，按页面或业务域懒加载非核心能力；避免在启动阶段请求无关接口。
|
|
- 不在日志、缓存或埋点中保存完整令牌、身份证明、结算凭据或客户隐私；退出与账号切换时清理租户敏感缓存。
|
|
- 使用清晰文本、足够触控区域和对比度，不只用颜色表达状态；兼容字体缩放和常见机型安全区域。
|
|
- 技术设施建立后测试身份绑定、租户隔离、订单幂等、授权拒绝、弱网恢复和分包加载，并在真实开发者工具及代表性设备上验证。
|
|
- 当前只有原型说明，不得声称构建或测试通过；脚手架完成后把实际质量命令和最低基础库版本写入本文件。
|