diff --git a/App.vue b/App.vue index 99f6e28..befa97a 100644 --- a/App.vue +++ b/App.vue @@ -1,17 +1,228 @@ - - - diff --git a/components/bloom-calendar/bloom-calendar.vue b/components/bloom-calendar/bloom-calendar.vue new file mode 100644 index 0000000..65ac7ec --- /dev/null +++ b/components/bloom-calendar/bloom-calendar.vue @@ -0,0 +1,201 @@ + + + + + diff --git a/components/hq-tabbar/hq-tabbar.vue b/components/hq-tabbar/hq-tabbar.vue new file mode 100644 index 0000000..1791b05 --- /dev/null +++ b/components/hq-tabbar/hq-tabbar.vue @@ -0,0 +1,101 @@ + + + + + diff --git a/docs/04-前端设计系统与联调验证.md b/docs/04-前端设计系统与联调验证.md new file mode 100644 index 0000000..bd75d8d --- /dev/null +++ b/docs/04-前端设计系统与联调验证.md @@ -0,0 +1,247 @@ +# 花期 APP · 前端设计系统与联调验证 + +> 版本 v1.0 | 覆盖 V1.0 纵向切片:M1 周期管理、M2 情绪疗愈、M6 个人中心/会员、M5 健康建议(内容) +> 关联文档:[01-产品功能模块清单](./01-产品功能模块清单.md)、[02-开发文档](./02-开发文档.md)、[03-数据模型与接口设计](./03-数据模型与接口设计.md) + +--- + +## 1. 设计定位 + +| 维度 | 定义 | +|---|---| +| 品牌 | 花期(Huāqī)—— 温柔记录,静待花开 | +| 气质 | 暖、静、克制;像被阳光晒过的棉布,而不是糖果色 | +| 原则 | 一屏一件事;重要信息放大、次要信息收敛;不用广告打扰 | +| 视觉母题 | 「花瓣 + 光」:四阶段用花瓣色阶表达,不用刺眼的红/紫 | + +**三条硬规则** +1. **暖而不腻**:主色饱和度高但只用于强调(按钮、数字、进度),大面积用暖米白。 +2. **留白优先**:卡片间距 24rpx 起,一屏不超过 3 个信息层级。 +3. **情绪友好**:不用「警告红」表达生理期,改用花红色系;文案避免「异常」「失败」等词。 + +--- + +## 2. 设计令牌(Design Tokens) + +统一维护在 `uni.scss`,页面通过 SCSS 变量引用,保证全站一致。 + +### 2.1 色板 + +| 令牌 | 色值 | 用途 | +|---|---|---| +| `$brand-primary` | `#E8604C` 花红 | 主按钮、关键数字、选中态 | +| `$brand-primary-light` | `#F58C7C` | 渐变起点、hover | +| `$brand-primary-dark` | `#C9482F` | 深色文字强调 | +| `$brand-peach` | `#F5A65B` 蜜橙 | 次强调、进度渐变、点缀 | +| `$brand-brown` | `#C79A7B` 暖棕 | 黄体期、辅助图形 | +| `$brand-cream` | `#FFF9F5` 暖米白 | 页面底色 | +| `$brand-cream-deep` | `#FFF1E9` | 卡片内嵌色块、胶囊底 | +| `$text-primary` | `#3E2C27` 暖棕黑 | 主文字 | +| `$text-secondary` | `#8C7367` | 次要文字 | +| `$text-muted` | `#B9A79E` | 弱提示 | +| `$line-color` | `#F5E7DF` | 分割线、描边 | + +**四阶段色**(与后端 `CycleService::$phaseColor` 完全一致):经期 `#E8604C`|卵泡期 `#F5A65B`|排卵期 `#F0796A`|黄体期 `#C79A7B` + +### 2.2 形状与阴影 + +| 令牌 | 值 | 用途 | +|---|---|---| +| `$radius-lg` | 32rpx | 卡片、主视觉 | +| `$radius-md` | 24rpx | 输入框、小卡片 | +| `$radius-sm` | 16rpx | 标签 | +| `$shadow-card` | `0 12rpx 36rpx rgba(232,96,76,.08)` | 常规卡片 | +| `$shadow-float` | `0 16rpx 48rpx rgba(232,96,76,.16)` | 主视觉/浮层 | + +### 2.3 字体与字号 + +| 层级 | 字号 | 字重 | 用途 | +|---|---|---|---| +| 主视觉数字 | 88rpx | 600 | 首页「周期第 N 天」 | +| 页面标题 | 44rpx | 600 | 问候语、内容标题 | +| 区块标题 | 32rpx | 600 | 各 section | +| 正文 | 28–30rpx | 400 | 卡片正文 | +| 辅助 | 22–24rpx | 400 | 说明、时间 | +| 弱提示 | 20rpx | 400 | 免责声明 | + +--- + +## 3. 组件规范 + +| 组件 | 文件 | 说明 | +|---|---|---| +| 底部导航 | `components/hq-tabbar/hq-tabbar.vue` | 自定义 TabBar,4 个入口,选中态为暖色胶囊;使用 `reLaunch` 避免页面栈堆积 | +| 花瓣日历 | `components/bloom-calendar/bloom-calendar.vue` | 7 列网格;阶段圆点 + 预测空心圈 + 记录小点;今天浅底、选中态渐变填充 | +| 通用样式 | `App.vue` | `.hq-card` `.hq-btn` `.hq-chip` `.hq-cell` `.hq-empty` `.hq-progress` 等 12 个原子类 | + +**按钮三态**:主按钮(暖色渐变 + 投影)、幽灵按钮(`#FFF1E9` 底 + 主色字)、朴素按钮(白底 + 细边框)。 +**胶囊标签**:未选中 `#FFF4EE` 底 → 选中渐变底白字,用于症状、触发事件、强度等轻量多选。 + +--- + +## 4. 信息架构与页面地图 + +``` +登录 pages/login/index + │ + └─▶ 首页 pages/index/index(Tab:首页) + ├─ 周期状态主卡(阶段/天数/下次经期/进度) + ├─ 快捷入口(记录身体 / 情绪日记 / 健康报告 / 会员) + ├─ 阶段建议 / 今日心语 / 今日提醒 / 情绪 7 日 / 会员引导 + │ + ├─▶ 周期 pages/cycle/index(Tab:周期) + │ ├─ 花瓣日历(真实周期 + 预测) + │ ├─ 当日记录(经血量/痛经/症状/心情/睡眠/备注) + │ ├─ 记录经期(开始/结束日期) + │ ├─ 周期概览(平均周期/经期/规律性) + │ ├─ 未来 3 个月预测 + │ └─▶ 健康报告 pages/cycle/report(指标/症状/建议/深度报告锁) + │ + ├─▶ 情绪 pages/mood/index(Tab:情绪) + │ ├─ 今日情绪(5 情绪 + 强度 1-5 + 触发事件 + 文字) + │ ├─ 情绪趋势(7/30 天切换,柱状) + │ ├─ 情绪日记列表(可删除) + │ └─ 温柔疗愈(冥想/心语内容,会员内容带锁标) + │ + ├─▶ 我的 pages/mine/index(Tab:我的) + │ ├─ 资料卡 + 会员状态 + │ ├─ 数据概览(平均周期/记录数/情绪数/规律性) + │ ├─ 隐私与安全(应用锁、仅本地存储) + │ ├─ 提醒(4 个开关 + 时间) + │ └─ 关于 / 退出登录 + │ + ├─▶ 会员 pages/member/index(3 档套餐 + 权益 + 下单) + └─▶ 内容详情 pages/content/detail(正文/锁态/免责声明) +``` + +--- + +## 5. 前后端接口契约(24 个) + +后端:`server/application/api/controller/{Controller}.php`,前端:`utils/api.js`,一一对应。 + +| 前端方法 | 接口 | 方法 | 使用页面 | +|---|---|---|---| +| `api.login` | `/api/user/login` | POST | 登录 | +| `api.detail` | `/api/user/detail` | GET | 我的 | +| `api.updateProfile` | `/api/user/updateprofile` | POST | 我的(预留) | +| `api.home` | `/api/home/index` | GET | 首页 | +| `api.cycleCalendar` | `/api/cycle/index` | GET | 周期 | +| `api.cycleCurrent` | `/api/cycle/current` | GET | 预留 | +| `api.cyclePredict` | `/api/cycle/predict` | GET | 周期 | +| `api.cycleSave` | `/api/cycle/save` | POST | 周期 | +| `api.cycleLog` | `/api/cycle/log` | POST | 周期 | +| `api.cycleLogInfo` | `/api/cycle/loginfo` | GET | 周期 | +| `api.cycleSummary` | `/api/cycle/summary` | GET | 周期 | +| `api.cycleReport` | `/api/cycle/report` | GET | 健康报告 | +| `api.cycleTags` | `/api/cycle/tags` | GET | 周期 | +| `api.moodSave` | `/api/mood/save` | POST | 情绪 | +| `api.moodList` | `/api/mood/index` | GET | 情绪 | +| `api.moodTrend` | `/api/mood/trend` | GET | 情绪、首页 | +| `api.moodRemove` | `/api/mood/remove` | POST | 情绪 | +| `api.contentList` | `/api/content/index` | GET | 情绪、内容 | +| `api.contentDetail` | `/api/content/detail` | GET | 内容详情 | +| `api.memberPlans` | `/api/member/plans` | GET(免登录) | 会员 | +| `api.memberStatus` | `/api/member/status` | GET | 会员、我的 | +| `api.memberOrder` | `/api/member/order` | POST | 会员 | +| `api.settingIndex` | `/api/setting/index` | GET | 我的 | +| `api.settingSave` | `/api/setting/save` | POST | 我的 | + +**约定** +- 鉴权:请求头 `token`(登录接口下发 UUID token,存 `uni.setStorageSync('hq_token')`) +- 响应:`{ code:1, msg, time, data }`;`code=401` 自动清登录态并跳登录页 +- 错误:`code=0` 由 `utils/request.js` 统一 toast,页面只处理业务成功分支 + +--- + +## 6. 体验设计要点 + +| 场景 | 处理方式 | +|---|---| +| 首屏加载 | 首页单接口聚合(`/api/home/index`)一次拿全,避免串行请求 | +| 加载反馈 | 全局 `uni.showLoading`(仅重接口)+ 按钮 loading 文案(保存中…) | +| 防重复提交 | `saving/paying` 标志位,按钮点击直接 return | +| 空状态 | 统一 `.hq-empty`(图标 + 文案 + 引导),如无情绪记录、无症状数据 | +| 错误态 | toast 提示 + 保留页面可操作;401 才跳登录 | +| 下拉刷新 | 首页、周期页开启 `enablePullDownRefresh` | +| 表单安全 | 备注/日记 500–1000 字上限,前端限制 + 后端二次截断 | +| 隐私 | 应用锁(4–6 位数字,后端只存 MD5 哈希)、仅本地存储开关、家人默认不可见原始数据 | +| 合规 | 报告/内容页固定展示「仅供参考,不能替代医疗诊断」 | +| 日记删除 | 二次确认弹窗(`confirmColor` 使用品牌色) | + +--- + +## 7. 全链路验证报告 + +### 7.1 后端接口(48 项断言,全部通过) + +```bash +python3 scripts/verify/api_flow_test.py # 默认跑线上环境,可用 HQ_API_BASE 覆盖 +``` + +覆盖链路:登录鉴权 → 周期记录/月历/预测/每日记录/汇总/报告 → 首页聚合 → 情绪记录/列表/趋势 → 内容列表/详情(含会员锁态/免责声明) → 会员套餐/状态/下单 → 设置读写(应用锁哈希、提醒时间) → 个人资料聚合/更新。 + +关键断言举例:月历天数 = 当月实际天数;症状 ID 反序列化 `[1,2,5]`;`access` 分布 `free/member`;设置回读生效;应用锁只返回 `has_lock_code` 不返回明文。 + +### 7.2 前后端契约静态校验(0 问题) + +```bash +python3 scripts/verify/contract_check.py +``` +- 24 个前端接口 → 后端控制器/方法全部存在 +- 页面调用的 21 个 `api.*` 均在 `api.js` 中定义 +- `pages.json` 8 个页面文件均存在;页面跳转目标均已注册 +- 模板组件均已注册;模板事件处理函数均已定义 +- SFC 标签配对与块完整性检查 + +### 7.3 Vue SFC 编译校验(11/11) + +```bash +npm i -D @vue/compiler-sfc@3.4.21 +node scripts/verify/vue_compile_check.mjs +``` +使用官方 `@vue/compiler-sfc` 对每个 `.vue` 做 `parse + compileTemplate + compileScript`,全部通过(揭示模板表达式/结构错误)。 + +### 7.4 SCSS 编译校验(10/10) + +```bash +npm i -D sass@1.71.1 +node scripts/verify/scss_compile_check.mjs +``` +按 uni-app 的方式把 `uni.scss` 变量注入每个 ` diff --git a/pages/cycle/index.vue b/pages/cycle/index.vue new file mode 100644 index 0000000..629d6e5 --- /dev/null +++ b/pages/cycle/index.vue @@ -0,0 +1,695 @@ + + + + + diff --git a/pages/cycle/report.vue b/pages/cycle/report.vue new file mode 100644 index 0000000..1a3fc62 --- /dev/null +++ b/pages/cycle/report.vue @@ -0,0 +1,360 @@ + + + + + diff --git a/pages/index/index.vue b/pages/index/index.vue index 4ca2b92..ace891e 100644 --- a/pages/index/index.vue +++ b/pages/index/index.vue @@ -1,52 +1,732 @@ - - - - - diff --git a/pages/login/index.vue b/pages/login/index.vue new file mode 100644 index 0000000..b3cf286 --- /dev/null +++ b/pages/login/index.vue @@ -0,0 +1,240 @@ + + + + + diff --git a/pages/member/index.vue b/pages/member/index.vue new file mode 100644 index 0000000..29a83db --- /dev/null +++ b/pages/member/index.vue @@ -0,0 +1,350 @@ + + + + + diff --git a/pages/mine/index.vue b/pages/mine/index.vue new file mode 100644 index 0000000..f238906 --- /dev/null +++ b/pages/mine/index.vue @@ -0,0 +1,627 @@ + + + + + diff --git a/pages/mood/index.vue b/pages/mood/index.vue new file mode 100644 index 0000000..19fa78b --- /dev/null +++ b/pages/mood/index.vue @@ -0,0 +1,660 @@ +