cfc/cfc-frontend/AGENTS.md

zxyj-frontend

uni-app 微信小程序前端，Vue 2 语法，家庭教育任务管理。

WHERE TO LOOK

Task	Location	Notes
页面组件	pages/*/	login, index, tasks, rewards, profile, guide, games等
页面注册	pages.json	TabBar配置和页面路径
应用配置	manifest.json	AppID: wx5ba8038ef16fb245
全局样式	uni.scss	SCSS变量和全局样式
应用入口	App.vue	全局生命周期和配置
组件库	components/	地址选择器、任务卡片等可复用组件
API配置	config/	baseUrl和请求封装

STRUCTURE

pages/
├── index/          # 首页（角色分流）
├── login/          # 登录页
├── tasks/          # 任务管理
├── rewards/        # 心愿单
├── profile/        # 个人中心
├── guide/          # 成长规划师功能
├── games/          # 小游戏
└── parent/         # 家长专属功能

TabBar 配置

pages.json 中定义 5 个 TabBar 页面（TabBar 文案，非五维维度名）：

• 首页: pages/index/index - 角色分流入口
• 身体: pages/body/index - 身体健康维度
• 心智: pages/mind/index - 心智维度
• 关系: pages/action/index - 对应五维"行"（behavior），行为决定关系
• 我的: pages/profile/profile - 个人设置和积分

CONVENTIONS

• Vue 2: 使用 Options API，生命周期 onLoad、onShow
• 页面注册: 新页面必须在 pages.json 中注册
• 导航: 使用 uni.navigateTo、uni.redirectTo
• API 调用: 使用 uni.request，统一在 config.baseUrl
• 地址选择: 使用 components/address-picker.vue 四级联动组件
• 角色切换: 页面根据用户角色显示不同内容

ANTI-PATTERNS

• DO NOT 创建页面后忘记在 pages.json 注册
• DO NOT 硬编码 API 地址，使用 config.baseUrl
• DO NOT 在前端存储敏感信息 (密码、密钥)
• NEVER 跳过 JWT 认证直接调用需登录接口
• NEVER 在本地存储中保存敏感用户信息
• NEVER 在 WXML/Vue 模板中使用可选链 ?.，微信小程序不支持 → 使用 && 代替（如 currentWish?.title 改为 currentWish && currentWish.title）

UNIQUE FEATURES

• 地址匹配页面: pages/match/street-match.vue - 街道地址匹配功能
• 地址编辑页面: pages/family/address-edit.vue - 家庭地址管理
• 四级地址选择: components/address-picker.vue - 省市区街道联动
• 双角色界面: 根据用户角色(parent/child)显示不同UI

COMMANDS

npm install             # 安装依赖
npm run dev:mp-weixin   # 开发模式 (微信小程序)
npm run build:mp-weixin # 构建生产版本

NOTES

• 小程序AppID: wx5ba8038ef16fb245
• 后端API地址: 配置在 config/index.js 的 baseUrl
• 地址数据: 使用后端街道API获取四级地址数据
• 调试工具: 微信开发者工具需配置合法域名