|
@@ -0,0 +1,313 @@
|
|
|
|
|
+# 2026-10-31 小程序页面拆分实施计划(U8)
|
|
|
|
|
+
|
|
|
|
|
+**来源**:`docs/2026-10-25-后台与小程序UI审查报告.md` P2-1「16 个文件 >800 行」;cfclub 基线:53 个 .vue 文件 >800 行,具名 10 个仍为核心目标。
|
|
|
|
|
+**状态**:blocked → 交付「组件抽取清单 + 拆分顺序 + 每步回归范围」方案;主理人确认后按页面逐个拆,禁止一次性批量拆分。
|
|
|
|
|
+**验证门禁**:前端仅。后端无迁移,不新增 DB 变更。
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+## 1 背景与任务定位
|
|
|
|
|
+
|
|
|
|
|
+| 项目 | 说明 |
|
|
|
|
|
+|------|------|
|
|
|
|
|
+| 规格快照 | `docs/2026-10-25-后台与小程序UI审查报告.md` P2-1 列出 10 具名页面(index-home 3057 行、mind-detail 2600 行等)+ 额外 6 个未逐行列举的 >800 行文件 |
|
|
|
|
|
+| cfclub 基线 | 53 个 .vue 文件 >800 行(`find . -name '*.vue' -not -node_modules -not -dist -not -unpackage | wc -l` 统计) |
|
|
|
|
|
+| 当前改动 | 无 — 仅产出方案文档,主理人确认后按页拆 |
|
|
|
|
|
+| 核心原则 | 按页面逐个拆,**绝不**一次性批量 `git add .` / 全库搜索替换。每完成一页,跑一次 `verify-vue-compile` + `audit-mp-antipatterns` + `audit-duplicate-api-calls`,人工用 HBuilderX 重打包到微信开发者工具做关键交互目检。 |
|
|
|
|
|
+
|
|
|
|
|
+## 2 基线快照(10 具名文件 + 当前行数)
|
|
|
|
|
+
|
|
|
|
|
+| # | 文件 | 当前行数 | 备注 |
|
|
|
|
|
+|---|------|----------|------|
|
|
|
|
|
+| 1 | `pages/index-home/index.vue` | **3306** | 首屏最大,已内嵌 splash/登录浮层/新手引导/自测卡等模块 |
|
|
|
|
|
+| 2 | `pages/health/report-detail.vue` | **2668** | 典型 draft/编辑态报告页,内含完整指标块 |
|
|
|
|
|
+| 3 | `pages/mind-detail/index.vue` | **2600** | 心维度首页,已内嵌家庭天盘 + 五维能量 + 心理报告卡 |
|
|
|
|
|
+| 4 | `pages/home-pages/parent-index.vue` | **2293** | 家长端首页,含五维自检/健康圈/成员关系图 |
|
|
|
|
|
+| 5 | `pages/shop/checkout/checkout.vue` | **2048** | 商城结算(支付链路,最高风险) |
|
|
|
|
|
+| 6 | `pages/health/health-plan-summary.vue` | **1929** | 方案生成向导(4 步) |
|
|
|
|
|
+| 7 | `pages/health/report-confirm.vue` | **1840** | 报告确认态(草稿 → 入库) |
|
|
|
|
|
+| 8 | `pages/activity/activity-detail/activity-detail.vue` | **1767** | 活动报名页(报名/评价/能量扣减) |
|
|
|
|
|
+| 9 | `pages/health/gut-flora-detail.vue` | **1557** | 菌群详情(风险/功能/营养分组) |
|
|
|
|
|
+| 10 | `pages/home-pages/child-index.vue` | **1485** | 孩子端首页(相对轻量,脚本逻辑密集) |
|
|
|
|
|
+
|
|
|
|
|
+> 其余 43 文件 >800 行属后续批次(健康簇、维度簇、商城簇等),本阶段聚焦上表 10 个。
|
|
|
|
|
+
|
|
|
|
|
+## 3 抽取原则与工程约定
|
|
|
|
|
+
|
|
|
|
|
+| 约定 | 细则 |
|
|
|
|
|
+|------|------|
|
|
|
|
|
+| **组件放置** | `pages/<page>/components/<Name>.vue`(已有项目习惯,见 `pages/health/components/`、`pages/mind-detail/components/`、`pages/activity/components/` 等)。共享组件极少,优先 page-local,慎用根 `components/`。 |
|
|
|
|
|
+| **模块边界** | `<template>` 内每个 `<!-- xxx -->` 评论块 → 独立组件。若同一模块在多页出现(如 `MemberBindPanel` 在 report-detail/report-confirm/gut-flora-detail 复用),提取一次、引入多处。 |
|
|
|
|
|
+| **数据/方法** | 父组件保留 `onLoad`/`onShow` 与 `uni.request` 调用;子组件仅通过 `props` + `$emit` 交互。组件内**不得**重复调用父页面已调用的接口(防止 `audit-duplicate-api-calls` ERROR)。 |
|
|
|
|
|
+| **页面路由** | `pages.json` 目录不变。抽取出的组件**不是**新页面,不得在 `pages.json` 中注册新 `path`。 |
|
|
|
|
|
+| **视觉不变** | 纯重构。template 布局、class、rpx 单位、color 值均不改。`uni.scss`、`admin-tokens.css` 均不动。 |
|
|
|
|
|
+| **iOS 安全** | 日期解析全面改用 `utils/format.js` 的 `parseDate()`;禁止 `new Date(string).toLocaleString()`。 |
|
|
|
|
|
+| **可选链/key规范** | WXML 中禁止 `?.` → 用 `&&`;`:key` 禁止运算符表达式 → 用方法绑定 `:key="getItemKey(item)"`;`:class/:style` 内禁止带参方法调用。 |
|
|
|
|
|
+
|
|
|
|
|
+## 4 组件抽取清单(核心交付物)
|
|
|
|
|
+
|
|
|
|
|
+> 表中 `模块` 对应 `<!-- xxx -->` 评论块或逻辑独立区块;`目标组件` 为拟生成的 `.vue` 文件;`归属` 说明数据/方法归谁掌握。
|
|
|
|
|
+
|
|
|
|
|
+### 4.1 pages/index-home/index.vue(3306 行)
|
|
|
|
|
+
|
|
|
|
|
+| # | 模块 | 目标组件 | 归属数据/方法 |
|
|
|
|
|
+|---|------|----------|--------------|
|
|
|
|
|
+| 1 | 冷启动 splash overlay(L5-L47) | `components/SplashOverlay.vue` | parent 保留 `_splashReady` / `_tryHideSplash`,组件仅渲染 `view` + `transition` |
|
|
|
|
|
+| 2 | 新手成长礼包进度条(L51) | `components/OnboardingProgress.vue` | props: `showOnboardingGuide` / `selfCheckScore`;emit `close` |
|
|
|
|
|
+| 3 | 问候条(L54) | `components/GreetingBar.vue` | prop: `familyMembersVisible` / `childrenChecked` |
|
|
|
|
|
+| 4 | 自测大卡 ①(L84) | `components/SelfCheckCard.vue` | props: `selfCheckScore / selfCheckLoading`;emit `result-selected` |
|
|
|
|
|
+| 5 | 行动引导条 NBA(L97) | `components/NbaGuideBar.vue` | props from parent state; emit `action-selected` |
|
|
|
|
|
+| 6 | 能量沙盘 Canvas 五行星图(L111) | `components/EnergySandboxCard.vue` | receives `sandboxData` via prop;内部 canvas 绘制逻辑;emit `sandbox-view-change` |
|
|
|
|
|
+| 7 | 上传报告入口(L131) | `components/ReportUploadEntry.vue` | emits `upload` → parent handles `uni.chooseImage` |
|
|
|
|
|
+| 8 | 推荐文章(L139-L154) | `components/RecommendedArticles.vue` | prop: `articles` list; each item click emit `article-selected` |
|
|
|
|
|
+| 9 | 快捷功能入口(L154, 动态渲染) | `components/QuickActions.vue` | prop: `quickApps`数组;item click emit |
|
|
|
|
|
+| 10 | 家庭动态(L173) | `components/FamilyFeedList.vue` | prop: `familyFeed` list; each row click → navigate |
|
|
|
|
|
+| 11 | 家庭挑战任务(L201) | `components/ChallengeSection.vue` | prop: `familyTasks` / `pendingTasks` |
|
|
|
|
|
+| 12 | 会员入口(L223-L227) | `components/MemberEntrance.vue` | prop: `isMember / isLifetime`; click → navigate to membership |
|
|
|
|
|
+| 13 | 我的任务 / 今日任务(L227-L237) | `components/TodayTasks.vue` | prop: `familyTasks` |
|
|
|
|
|
+| 14 | 推荐商品(L249-L268) | `components/RecommendedProducts.vue` | prop: 商品列表;click → navigate to detail |
|
|
|
|
|
+| 15 | 首次登录引导浮层(L268-L280) | `components/FirstLaunchGuide.vue` | 仅在 `!loggedInInitDone` 时渲染 |
|
|
|
|
|
+| 16 | 配置驱动弹窗 guide_popup(L274-L280) | `components/GuidePopup.vue` | prop: 弹窗配置表;管理端可配置 |
|
|
|
|
|
+| 17 | 未登录态 Hero 区(L283-L304) | `components/LandingHero.vue` | 包含平台作用/价值主张;点击 → 跳转登录/注册 |
|
|
|
|
|
+| 18 | 三步上手(L339-L363) | `components/LandingSteps.vue` | 步骤可视条 + 热点标记 |
|
|
|
|
|
+| 19 | 五行沙盘预览(L363-L366) | `components/LandingSandboxPreview.vue` | readonly canvas 预览 |
|
|
|
|
|
+| 20 | 热门活动/推荐阅读(L366-L393) | `components/LandingHotActivities.vue` / `LandingArticles.vue` |
|
|
|
|
|
+
|
|
|
|
|
+**数据/方法归属**:parent.vue 保留 `data()` 中 gradientColors, sandbox*, family*, articles, children, currentChildId, activeChallenges, pendingTasks, familyTasks, familyFeed, notices, loggedInInitDone, isMember, isLifetime, referralCode, quickApps, myShortcuts, appUsage, quickLoaded, energyMessages, pointsMessages, cfMessages。computed: isFamilyAdmin, sandboxScores, familySandboxScores/familySandboxOverall, familySandboxMembers。methods: loadData in onLoad,各模块事件处理程序保留在 parent 并透过 `emit` 传给子组件。
|
|
|
|
|
+
|
|
|
|
|
+### 4.2 pages/health/report-detail.vue(2668 行)+ report-confirm(1840)+ gut-flora-detail(1557)
|
|
|
|
|
+
|
|
|
|
|
+**共享组件**(优先提取,三文件复用):
|
|
|
|
|
+
|
|
|
|
|
+| 组件 | 用在页面 | 说明 |
|
|
|
|
|
+|------|----------|------|
|
|
|
|
|
+| `components/MemberBindPanel.vue` | report-detail, report-confirm, gut-flora-detail | 被检测人选择面板 + 候选匹配列表 + 新建成员表单。提取一次,三处引用。 |
|
|
|
|
|
+| `components/GutFloraSection.vue` | gut-flora-detail | 菌群功能分析/风险分组/PB比值/饮食模式推断 |
|
|
|
|
|
+| `components/DiseaseRiskSection.vue` | report-detail, gut-flora-detail | 疾病风险卡片 |
|
|
|
|
|
+| `components/TaxonomySection.vue` | all three | Taxonomy 分类(纲/目/科/属/种) |
|
|
|
|
|
+| `components/PathogenSection.vue` | all three | 病原菌 |
|
|
|
|
|
+| `components/ProbioticsSection.vue` | gut-flora-detail | 益生菌指导/种 |
|
|
|
|
|
+| `components/IndicatorGroupSection.vue` | report-detail | 指标分组折叠 + 变化对照行 + 趋势入口 |
|
|
|
|
|
+| `components/ReportHeader.vue` | all three | 报告头 + 日期编行入口 |
|
|
|
|
|
+| `components/ReportDateEditRow.vue` | report-detail, report-confirm | 仅查看态日期编辑入口(复用 /report/edit) |
|
|
|
|
|
+
|
|
|
|
|
+**report-detail 专属抽取**:
|
|
|
|
|
+
|
|
|
|
|
+| # | 模块 | 目标组件 |
|
|
|
|
|
+|---|------|----------|
|
|
|
|
|
+| 1 | 基本信息 + 被检测人选择面板(已由 MemberBindPanel 覆盖) | — |
|
|
|
|
|
+| 2 | 舌诊指标 + 健康指标分组/折叠 + 趋势卡片 + 变化对照开关 | `components/IndicatorGroupSection.vue`(已上表) |
|
|
|
|
|
+| 3 | 「N 期 ›」趋势入口 + 第二行变化对照渲染 | `components/TrendEntry.vue`(新) |
|
|
|
|
|
+| 4 | 肠道菌群(表格/列表渲染) | `components/GutFloraSection.vue`(已上表) |
|
|
|
|
|
+| 5 | 疾病风险 | `components/DiseaseRiskSection.vue`(已上表) |
|
|
|
|
|
+| 6 | 益生菌种 + Taxonomy 分类 | `components/ProbioticsAndTaxonomy.vue`(合并) |
|
|
|
|
|
+| 7 | 病原菌 | `components/PathogenSection.vue`(已上表) |
|
|
|
|
|
+| 8 | 操作按钮(draft: 放弃/确认; edit: 取消/保存) | `components/ReportActionButtons.vue` |
|
|
|
|
|
+
|
|
|
|
|
+**report-confirm 专属**(大量与 report-detail 相同模块,共享上表组件):
|
|
|
|
|
+
|
|
|
|
|
+| 模块 | 说明 |
|
|
|
|
|
+|------|------|
|
|
|
|
|
+| 解析中状态 / 匹配可信度 | parent 保留 `parsing`/`parsingStep`/`parsingTimer` 状态;组件仅渲染 |
|
|
|
|
|
+| 指标帮助弹窗 | `components/IndicatorHelpPopup.vue`(复用) |
|
|
|
|
|
+| 肠道菌群 / 疾病风险 / 饮食推荐 / 益生菌种 / Taxonomy / 病原菌 | 共享上表组件 |
|
|
|
|
|
+| 操作按钮(draft: 放弃/确认入库; edit: 取消/保存) | `components/ReportConfirmActionButtons.vue`(微调版) |
|
|
|
|
|
+| 报告反馈入口 | `components/ReportFeedbackEntry.vue`(新) |
|
|
|
|
|
+
|
|
|
|
|
+**gut-flora-detail 专属**(其余模块未复用):
|
|
|
|
|
+
|
|
|
|
|
+| # | 模块 | 目标组件 |
|
|
|
|
|
+|---|------|----------|
|
|
|
|
|
+| 1 | 报告头部 + 解读/AI解读 + 总结描述 | `components/GutFloraHeader.vue` |
|
|
|
|
|
+| 2 | 评分圆环(折行显示) | `components/GutFloraScoreRing.vue` |
|
|
|
|
|
+| 3 | 快速跳转 | `components/QuickNav.vue` |
|
|
|
|
|
+| 4 | 指标变化(最近两次报告) | `components/IndicatorChangeSection.vue`(引用 indicator-change-curve 组件) |
|
|
|
|
|
+| 5 | 菌群功能分析 + P/B比值 + 饮食模式推断 | `components/FloraFunctionAnalysis.vue` |
|
|
|
|
|
+| 6 | 菌群风险分组手风琴 | `components/RiskAccordion.vue` |
|
|
|
|
|
+| 7 | 益生菌指导 | `components/ProbioticGuide.vue`(复用自 gut-flora-detail 提取) |
|
|
|
|
|
+| 8 | 肠道功能手风琴 | `components/IntestineFunctionAccordion.vue` |
|
|
|
|
|
+
|
|
|
|
|
+### 4.3 pages/mind-detail/index.vue(2600 行)
|
|
|
|
|
+
|
|
|
|
|
+| # | 模块 | 目标组件 |
|
|
|
|
|
+|---|------|----------|
|
|
|
|
|
+| 1 | 通用登录浮层 | `components/CommonLoginPopup.vue`(已存在通用组件) |
|
|
|
|
|
+| 2 | Tabbar 切换过渡页 | `components/TabTransition.vue`(轻量) |
|
|
|
|
|
+| 3 | 品牌头部 + 定位语 | `components/BrandHeader.vue` |
|
|
|
|
|
+| 4 | 家庭天盘模块(今日运势/心情/吉位) | 天盘相关组件已在 `pages/mind-detail/components/FamilyTianpanCard.vue`(922 行已存在),直接引用 |
|
|
|
|
|
+| 5 | 家庭成员选择条 | `components/DimensionMemberSelector.vue`(新) |
|
|
|
|
|
+| 6 | 游客引导语 + 游客价值卡 | `components/GuestGuideCard.vue` |
|
|
|
|
|
+| 7 | 五维能量条 | `components/EnergyBars.vue`(复用自其他维度页) |
|
|
|
|
|
+| 8 | 心理指标卡片 + 心理报告卡片 | `components/PsychIndicatorCards.vue` / `PsychReportCard.vue` |
|
|
|
|
|
+| 9 | 心维度画像总体说明 | `components/PsychOverall.vue` |
|
|
|
|
|
+| 10 | DAN 报告(登录后) | `components/DanReportCard.vue` |
|
|
|
|
|
+| 11 | 肠脑轴情绪卡片 | `components/GutBrainEmotionCard.vue` |
|
|
|
|
|
+| 12 | 心理告警横幅 | `components/PsychAlertBanner.vue` |
|
|
|
|
|
+| 13 | 功能入口 Grid(两行) | `components/FeatureEntryGrid.vue`(在 parent-index 等页复用) |
|
|
|
|
|
+| 14 | 心13维雷达图 | `components/DimensionRadar.vue` |
|
|
|
|
|
+| 15 | 心维度介绍卡片 | `components/DimensionIntroCard.vue` |
|
|
|
|
|
+
|
|
|
|
|
+> 注:`FamilyTianpanCard.vue` 已在 mind-detail/components 中,无需再次提取。其余为新增 page-local 组件。
|
|
|
|
|
+
|
|
|
|
|
+### 4.4 pages/home-pages/parent-index.vue(2293 行)
|
|
|
|
|
+
|
|
|
|
|
+| # | 模块 | 目标组件 |
|
|
|
|
|
+|---|------|----------|
|
|
|
|
|
+| 1 | 加载状态 | `components/LoadingState.vue` |
|
|
|
|
|
+| 2 | 顶部 Banner | `components/BannerCarousel.vue` |
|
|
|
|
|
+| 3 | 新手任务进度条 | `components/OnboardingTaskProgress.vue` |
|
|
|
|
|
+| 4 | 家庭成员选择条 | `components/MemberSelectorBar.vue`(与 mind-detail 的 DimensionMemberSelector 相同语义) |
|
|
|
|
|
+| 5 | 无家庭成员空状态引导卡 | `components/EmptyStateGuide.vue` |
|
|
|
|
|
+| 6 | 微行动卡片 | `components/MicroActionCard.vue` |
|
|
|
|
|
+| 7 | 健康预警横幅 | `components/HealthAlertBanner.vue` |
|
|
|
|
|
+| 8 | 家庭健康排行榜(P2-2) | `components/FamilyRanking.vue` |
|
|
|
|
|
+| 9 | 家庭挑战区域 | `components/FamilyChallenge.vue` |
|
|
|
|
|
+| 10 | 健康圈入口(社区扩散) | `components/HealthCircle.vue` |
|
|
|
|
|
+| 11 | 五维家庭自检入口 | `components/SelfCheckEntry.vue` |
|
|
|
|
|
+| 12 | 家庭成员关系图谱 | `components/RelationGraphCard.vue`(已存在全局 `FamilyRelationGraph.vue` 组件) |
|
|
|
|
|
+| 13 | 首页广告栏 | `components/AdBanner.vue` |
|
|
|
|
|
+| 14 | 能量沙盘 | `components/EnergySandBox.vue`(复用 index-home 的 EnergySandboxCard 逻辑) |
|
|
|
|
|
+| 15 | 成长数据(任务完成率/成长积分) | `components/GrowthDataSection.vue` |
|
|
|
|
|
+| 16 | 今日重点 | `components/TodayFocusSection.vue` |
|
|
|
|
|
+
|
|
|
|
|
+### 4.5 pages/shop/checkout/checkout.vue(2048 行)
|
|
|
|
|
+
|
|
|
|
|
+| # | 模块 | 目标组件 |
|
|
|
|
|
+|---|------|----------|
|
|
|
|
|
+| 1 | 地址段 + 自取地点/时间段选择器 | `components/CheckoutAddress.vue` |
|
|
|
|
|
+| 2 | 配送方式选择 | `components/CheckoutDeliveryMethod.vue` |
|
|
|
|
|
+| 3 | 订单条目列表 | `components/OrderItemsList.vue` |
|
|
|
|
|
+| 4 | 赠会员提示/累计进度 | `components/GiftMemberProgress.vue` |
|
|
|
|
|
+| 5 | 限时特价区块 | `components/SpecialDealSection.vue` |
|
|
|
|
|
+| 6 | 价格汇总(运费 + 合计) | `components/PriceSummary.vue` |
|
|
|
|
|
+| 7 | 优惠券选择器 + 已拥有/可兑换 | `components/CouponSection.vue` + `CouponPicker.vue` |
|
|
|
|
|
+| 8 | 积分抵扣 | `components/PointsDeduction.vue` |
|
|
|
|
|
+| 9 | 备注输入 | `components/RemarkInput.vue` |
|
|
|
|
|
+| 10 | 服务者选择器 | `components/ServicePicker.vue` |
|
|
|
|
|
+
|
|
|
|
|
+### 4.6 pages/health/health-plan-summary.vue(1929 行)
|
|
|
|
|
+
|
|
|
|
|
+| # | 模块 | 目标组件 |
|
|
|
|
|
+|---|------|----------|
|
|
|
|
|
+| 1 | 步骤指示器 | `components/PlanStepsIndicator.vue` |
|
|
|
|
|
+| 2 | Step1:选人 + 目标 | `components/planSteps/PersonTarget.vue` |
|
|
|
|
|
+| 3 | Step2:嵌入健康问卷 | 已复用 `pages/health/components/ComprehensiveSurvey.vue`(1176 行) |
|
|
|
|
|
+| 4 | Step3:问卷确认 + 手签名 | `components/planSteps/ConfirmSign.vue`(props: surveyData;emit `signature-done`) |
|
|
|
|
|
+| 5 | Step4:生成方案 + 预览 | `components/planSteps/GeneratePreview.vue` |
|
|
|
|
|
+| 6 | 手写签名板 | 复用 `components/SignaturePad.vue`(在 checkout/health-plan-summary 间共享) |
|
|
|
|
|
+| 7 | 最终确认保存遮罩 | `components/PlanConfirmMask.vue` |
|
|
|
|
|
+| 8 | 查看模式方案预览 | `components/PlanViewer.vue` |
|
|
|
|
|
+
|
|
|
|
|
+### 4.7 pages/home-pages/child-index.vue(1485 行,脚本密集)
|
|
|
|
|
+
|
|
|
|
|
+该页模板仅 32 行,主要是 script(604 行)+ style(285 行)。提取重点在 **data/methods 归属**:
|
|
|
|
|
+
|
|
|
|
|
+| # | 模块/关注点 | 归属方案 |
|
|
|
|
|
+|---|------|----------|
|
|
|
|
|
+| 1 | 撒花庆祝 / 首次登录引导浮层 / 配置驱动弹窗 | template 中提取为 `components/CelebrationGuide.vue`(3 个 `<!--` 块) |
|
|
|
|
|
+| 2 | API 调用去重与生命周期 | script 中 `_onLoadFired` 标志位 + `onShow` 条件跳过模式(AGENTS.md rule 1 实现)。父页保持 `onLoad` 发起请求,`onShow` 检查标志后跳过。 |
|
|
|
|
|
+| 3 | 任务列表/状态管理 | 移除重复 API 封装:合并 `loadFamilyMembers` + `loadChildren` 为一次请求 + 响应中 `filter(m => m.effectiveRole === 'child')` 派生。 |
|
|
|
|
|
+| 4 | 组件引用 | 16 处 `import` 的现有组件保持不变;仅内部逻辑重组为 mixin `mixins/child-tasks.js`。 |
|
|
|
|
|
+
|
|
|
|
|
+> **说明**:child-index 为「脚本逻辑密集型」页面,提取方向是 mixin/工具函数,而非组件拆解。这正是任务提示所强调的「模板/数据/方法拆分」异域。
|
|
|
|
|
+
|
|
|
|
|
+## 5 拆分顺序
|
|
|
|
|
+
|
|
|
|
|
+**目标**:按依赖最少 → 复用最大 → 风险最高 的顺序,分 3 个阶段完成上表 10 个页面。
|
|
|
|
|
+
|
|
|
|
|
+| 阶段 | 页面顺序 | 依据 |
|
|
|
|
|
+|------|----------|------|
|
|
|
|
|
+| **第一阶段(基线,4–5 天)** | 1. `index-home` → 2. `MemberBindPanel`(共享) → 3. `report-detail` → 4. `report-confirm` → 5. `gut-flora-detail` | index-home 最大且首屏体验最关键;健康簇模块高度重叠,先抽共享组件再拆单页; |
|
|
|
|
|
+| **第二阶段(2–3 天)** | 6. `mind-detail` → 7. `parent-index` → 8. `child-index` | mind-detail 已有 `FamilyTianpanCard` 组件,拆分相对顺畅;parent-index 与 child-index 为 home-pages 簇,共享 MemberSelectorBar/Banner 可并行验证;child-index 为脚本逻辑重组,风险相对较低(不改 template 布局) |
|
|
|
|
|
+| **第三阶段(2–3 天)** | 9. `activity-detail` → 10. `shop/checkout` | activity-detail 相对独立,无强跨页依赖;checkout 为支付链路,**必须最后完成**,且需要人工在 HBuilderX 微信模拟器中完成全链路冒烟(地址→配送→券→积分→特价→手签→服务者→支付成功/失败兜底)。 |
|
|
|
|
|
+
|
|
|
|
|
+> **每一页完成后**:必须跑 `verify-vue-compile`、`audit-mp-antipatterns`、`audit-duplicate-api-calls` 三项;人工 HBuilderX 重打包至微信开发者工具,检查页面加载、TabBar 切换、关键流程(如报告生成/支付)无报错、无控制台红字。
|
|
|
|
|
+
|
|
|
|
|
+## 6 每步回归范围
|
|
|
|
|
+
|
|
|
|
|
+### 6.1 index-home(第一步)
|
|
|
|
|
+
|
|
|
|
|
+- **模板回归**:冷启动 splash 1) 闪现后消失 2) 切 Tab 返回不再显示;未登录态首次进入显示 Hero 区;已登录态隐藏 Hero。
|
|
|
|
|
+- **数据回归**:`onLoad` 只请求一次(`_onLoadFired` 标志),`onShow` 首次跳过;切 Tab 返回时刷新数据。
|
|
|
|
|
+- **API 审计**:`audit-duplicate-api-calls.js` exit 0(同一 URL 只打一次)。
|
|
|
|
|
+- **命中检查**:`verify-vue-compile.js` 对 `pages/index-home/index.vue` 输出 `PASS`(模板/样式/脚本三项均 PASS)。
|
|
|
|
|
+- **人工目检**:HBuilderX 重打包 → 微信开发者工具:
|
|
|
|
|
+ - 启动页 splash 1.5s 后自动消失
|
|
|
|
|
+ - 登录/注册流程正常
|
|
|
|
|
+ - TabBar 任意 Tab 切换无白屏
|
|
|
|
|
+ - 切回首页从其他 Tab 返回,左侧能量沙盘重新计算
|
|
|
|
|
+ - 未登录态下点击「开始体验」正向跳转登录页
|
|
|
|
|
+
|
|
|
|
|
+### 6.2 health 簇(report-detail / report-confirm / gut-flora-detail)
|
|
|
|
|
+
|
|
|
|
|
+- **共享组件回归**:`MemberBindPanel.vue`、 `IndicatorGroupSection.vue` 等在三处引用皆无差异;`audit-duplicate-api-calls` 检查三页 API 调用次数不增加。
|
|
|
|
|
+- ** draft/编辑态切换**:report-detail 与 report-confirm 间 date/parsing 状态转换正确。
|
|
|
|
|
+- **菌群/风险/分类模块**:三页渲染结果一致(以 report-detail 为 baseline,确认 gut-flora-detail / report-confirm 显示一致)。
|
|
|
|
|
+- **人工目检**:关键流程:① 从列表进入报告详情 → ② 切换「查看/编辑/确认」态 → ③ 修改日期(仅查看态)→ ④ 点击「确认入库」/「放弃」 → ⑤ 菌群区域数据正确。
|
|
|
|
|
+
|
|
|
|
|
+### 6.3 mind-detail / parent-index / child-index
|
|
|
|
|
+
|
|
|
|
|
+- **mind-detail**:品牌头部、天盘卡片、功能入口 Grid 三大模块均可点击导航无报错;TabBar 切换 remembered 状态。
|
|
|
|
|
+- **parent-index**:健康预警横幅颜色正确;五维自检入口跳转至自测页;家庭成员关系图谱可展开/折叠。
|
|
|
|
|
+- **child-index**:脚本逻辑重组后,`onLoad` 发起一次请求,`onShow` 检查 `_onLoadFired` 标志跳过;切 Tab 返回正确刷新任务列表;未登录态下空状态正常展示。
|
|
|
|
|
+
|
|
|
|
|
+### 6.4 activity-detail
|
|
|
|
|
+
|
|
|
|
|
+- **活动报名流程**:① 封面/元信息加载 → ② 报名按钮点击 → ③ 报名表单弹窗 → ④ 家庭成员选择 → ⑤ 合计/操作按钮 → ⑥ 分享海报生成;全程不报错。
|
|
|
|
|
+- **能量扣减弹窗**:必须与 scroll-view 平级(AGENTS.md antipattern 检查),弹窗在最顶层不被 scroll-view 截断。
|
|
|
|
|
+
|
|
|
|
|
+### 6.5 shop/checkout
|
|
|
|
|
+
|
|
|
|
|
+- **全链路冒烟**(人工 HBuilderX + 真机/模拟器):
|
|
|
|
|
+ 1. 地址选择/自取地点/时间段均可选
|
|
|
|
|
+ 2. 配送方式(快递/同城/自提)切换不丢数据
|
|
|
|
|
+ 3. 优惠券:已拥有/可兑换(足够 CF 值)状态正确
|
|
|
|
|
+ 4. 积分抵扣:余额足够时扣除,不足时提示
|
|
|
|
|
+ 5. 限时特价:命中特价规则后显示,未命中隐藏
|
|
|
|
|
+ 6. 手写签名:base64 存入 purchaseForm,导出正确
|
|
|
|
|
+ 7. 服务者选择器:列出可用服务者,选中后固定
|
|
|
|
|
+ 8. 支付成功/失败兜底:模拟支付成功后订单状态变更;失败后返回购物车/列表且未扣费。
|
|
|
|
|
+
|
|
|
|
|
+## 7 验证门禁
|
|
|
|
|
+
|
|
|
|
|
+| 检查 | 命令 | 通过标准 |
|
|
|
|
|
+|------|------|----------|
|
|
|
|
|
+| **模板/样式/脚本编译** | `node scripts/verify-vue-compile.js pages/<page>/index.vue` | 三项全部 `PASS`(退出码 0) |
|
|
|
|
|
+| **小程序 antipattern** | `node scripts/audit-mp-antipatterns.js` | ERROR 级计数为 0(退出码 0) |
|
|
|
|
|
+| **API 调用去重** | `node scripts/audit-duplicate-api-calls.js` | exit code 0(无未解决的 ERROR 级违规) |
|
|
|
|
|
+| **人工 HBuilderX 重打包** | HBuilderX → “运行到微信开发者工具” | 页面加载无白板;关键流程(如上述每步回归范围)全部通过;控制台无红字 |
|
|
|
|
|
+| **pages.json 完整性** | `grep -n '\"path\"' pages.json` | 确认无新增/删除路由注册 |
|
|
|
|
|
+
|
|
|
|
|
+> **关键**:每完成一个页面的拆分,必须上述 5 项全过后方可进入下一页。若出现 `audit-mp-antipatterns` ERROR,需立即回退该页面的组件修改,定位具体哪个 `?.` / `:key` 运算符 / 中文 class 导致。
|
|
|
|
|
+
|
|
|
|
|
+## 8 禁止事项与风险提示
|
|
|
|
|
+
|
|
|
|
|
+1. **禁批量拆分**:绝对禁止 `git add .`、`find ... -exec sed -i` 等一次性批量修改所有 >800 行文件的做法。每个页面是一个独立的拆分单元。
|
|
|
|
|
+2. **不得新增/pages.json 路由**:抽取的组件不是页面,不得在 `pages.json` 的 `pages`/`subPackages` 中注册新 `path`。路由变更需要产品/设计确认,本任务仅重构。
|
|
|
|
|
+3. **禁改动色彩/间距令牌**:`uni.scss`、`admin-tokens.css` 均保持不变。若有配色需求,需另行提 UED task,本任务仅处理文件体积/结构。
|
|
|
|
|
+4. **禁新增 DB 迁移**:后端无表结构变更,不涉及 migration。如有字段变更,须单独申请。
|
|
|
|
|
+5. **组件内禁止重复调父接口**:AGENTS.md 规则 4a/4c 严格执行。子组件通过 `props` + `$emit` 与父交互;若涉及 API 调用,父组件统一发起,结果通过 `emit` 传下。
|
|
|
|
|
+6. **iOS 日期安全**:所有日期解析改用 `utils/format.js` 的 `parseDate()`;禁止使用 `new Date(string).toLocaleString()`。
|
|
|
|
|
+7. **WXML 语法洁癖**:
|
|
|
|
|
+ - 禁止可选链 `?.` → 用 `&&` 代替
|
|
|
|
|
+ - `:key` 禁止运算符表达式 → 用方法绑定 `:key="getItemKey(item)"`,methods 中 `getItemKey(item) { return item.id || item.circleId }`
|
|
|
|
|
+ - `:class/:style` 内禁止带参方法调用 → 改用 `:class="'status-' + item._cssClass"` 等纯内联表达式
|
|
|
|
|
+ - 禁止 CSS 中文选择器/属性(如 `.val-偏高`),改用英文 `.val-high` 并通过数据 `_cssClass` 映射
|
|
|
|
|
+8. **禁止 `new Date(string)` 解析非标准格式**:后端常见 `"2026-08-22 14:00"` 空格格式在 iOS JavaScriptCore 下会返回 `Invalid Date`,全部改用 `parseDate()`。
|
|
|
|
|
+
|
|
|
|
|
+## 9 完成后的回报格式(本次交付)
|
|
|
|
|
+
|
|
|
|
|
+每个会话按以下格式回报:
|
|
|
|
|
+1. 改前基线(grep 计数)→ 改后计数
|
|
|
|
|
+2. 每项替换的命中清单摘要(Top 文件)
|
|
|
|
|
+3. 跳过清单及原因(每条)
|
|
|
|
|
+4. 目检风险提示(哪些替换可能引起视觉回退,建议真机/浏览器抽查哪些页面)
|
|
|
|
|
+5. commit hash + 分支名
|
|
|
|
|
+
|
|
|
|
|
+> 本次交付(blocked → 方案文档)仅完成要点 1(基线)与方案文档的编写与 git commit/push。实际页面拆分将在主理人确认后依据此方案按页面逐个执行,每完成一页按上述格式回报。
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+**分支**:feature/u8-page-split-plan(基于 origin/cfclub)
|
|
|
|
|
+**计划文档**:`docs/superpowers/plans/2026-10-31-page-split-plan.md`
|
|
|
|
|
+**下一步**:主理人确认本方案后,基于 `feature/u8-page-split-plan` 分支按页面逐个拆分,每完成一页提交 commit 并回报。
|