wechat-miniprogram/AGENTS.md

WeChat Mini Program Instructions

项目定位

• 本项目面向企业客户和业务人员，运行于微信小程序环境。
• 现有原型范围包括登录注册、首页、头程下单、订单、审批、结算、海外仓服务和个人中心。
• 与 client-web 共享业务契约，但小程序只承载适合微信内高频、轻量和即时触达的流程。

当前阶段门禁

• 订单与客户范围、原生小程序或跨端方案、基础库版本、分包策略、登录绑定和发布流程尚未确认。
• 决策前不创建正式脚手架、不引入框架和锁文件，也不假设可以照搬 Web DOM、浏览器存储或客户工作台组件。
• 选型必须评估包体限制、启动性能、平台 API、隐私合规、可访问性、自动化测试、预览和审核发布成本。
• 方案确定后先更新 README.md、依赖清单和本文件，写明真实的开发者工具、安装、检查、测试和构建步骤。

平台与业务约束

• 微信登录只能建立平台身份凭据，企业租户、角色和业务权限必须由服务端确认；不得信任前端传入的租户或角色。
• 用户绑定、手机号、订阅消息、相册、相机和位置等能力遵循最小授权、按需请求和拒绝可恢复原则。
• 页面、分包、领域状态、API 适配和微信平台能力保持分层，业务代码不得散落直接调用平台 API。
• 与 baiyue-firstleg 的 Controller/OpenAPI 对齐认证、企业、订单、审批和结算契约；小程序特有字段通过适配层转换。
• 创建订单、审批和结算请求必须防重复提交并具备幂等策略；会话过期时保存可安全恢复的输入并引导重新认证。
• 订阅消息需由用户动作触发并清楚说明用途，不把通知授权作为使用核心功能的强制前置条件。

体验、安全与质量

• 优先短流程、拇指可达和清晰反馈；覆盖加载、空数据、弱网、离线、授权拒绝、接口失败和重复操作。
• 控制主包与分包体积，按页面或业务域懒加载非核心能力；避免在启动阶段请求无关接口。
• 不在日志、缓存或埋点中保存完整令牌、身份证明、结算凭据或客户隐私；退出与账号切换时清理租户敏感缓存。
• 使用清晰文本、足够触控区域和对比度，不只用颜色表达状态；兼容字体缩放和常见机型安全区域。
• 技术设施建立后测试身份绑定、租户隔离、订单幂等、授权拒绝、弱网恢复和分包加载，并在真实开发者工具及代表性设备上验证。
• 当前只有原型说明，不得声称构建或测试通过；脚手架完成后把实际质量命令和最低基础库版本写入本文件。