miniapplisted

# MiniApp Standards（微信小程序专项规范） > 适用对象：`uiux-designer`（在 MiniApp Mode 下）/ `miniapp-dev` / `miniapp-code-reviewer` / `miniapp-qa-engineer`。 > 与 `coding.md` / `security.md` / `testing.md` 并列；通用规则仍在原文件，不重复。 ## 1. 目录结构约定 ``` miniapp/ src/ # Taro 源码（仅触发 Taro 场景时使用） pages/ components/ services/ native/ # 原生 WXML/WXSS/JS（默认主体） pages/ components/ utils/ config/ # project.config.json + sitemap.json dist/ # 构建产物（gitignore） ``` ## 2. 框架选型决策树（默认原生） 默认原生 WXML/WXSS/JS；以下少数场景触发 Taro： 1. 该页面 80% 以上业务逻辑已存在于 Web React 组件，需复用 2. 团队需在 Web 与小程序间快速同步同一功能（双端发布） 3. 选型分歧时由 `tech-lead` 仲裁 ## 3. WeUI 设计规范要点 - 安全区：iOS 顶部 44px + 状态栏；底部 34px（iPhone X+） - 胶囊按钮：右上 87×32px，禁止覆盖 - tabBar：最多 5 项，图标 81×81px - 字体：苹方 / 思源黑体；正文 14sp / 标题 17sp ## 4. 微信审核红线 - **禁止**：诱导分享 / 强制关注 / 跳转非备案外链 / 未声明的数据收集 - **必备**：隐私协议弹窗、用户协议链接、`getUserProfile` 触发时机合规 - **包体积**：主包 ≤ 2MB、总包 ≤ 20MB（超限走分包加载） ## 5. 性能预算 - 首屏白屏 ≤ 2s（4G 网络） - setData 单次 payload ≤ 256KB - 长列表强制虚拟滚动（>100 项） ## 6. 测试矩阵 | 阶段 | 工具 | 通过门槛 | 责任角色 | |---|---|---|---| | **SIT** | DevTools 模拟器 + 自动化脚本 | 全部 AC 通过率 100% | **miniapp-dev 自跑**，证据进 `progress/miniapp-dev.md` 的 `**SIT 证据**` 段，由 `miniapp-code-reviewer` 在 code review 时 audit | | **E2E** | 体验版二维码 + 真机 | iOS 最新版 + Android 主流厂商任一台均通过 | `miniapp-qa-engineer` | | **UAT** | 体验版二维码 + 真实用户 | 业务 AC 逐条签字 | `miniapp-qa-engineer` 执行 + `product-lead` 业务签字 | ### 自动化技术栈（标准方案） 为避免依赖第三方 MCP（如 `@creatoria/miniapp-mcp` / `roy2an