AGENTS.md 3.5 KB
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/wisdom/index- 智慧维度（心智测评） - 心:
pages/mind/index- 心理/情感维度 - 我的:
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） - NEVER 在
:class绑定中调用方法（如:class="getStatusClass(item)"），微信小程序模板编译器不支持带参数的方法调用 → 改用内联表达式（如:class="'status-' + item._cssClass"）或计算属性 - NEVER 在 CSS 类名、选择器中使用中文（如
.val-偏高、.badge-低风险），微信小程序 wxss 编译器不支持中文类名 → 使用英文（如.val-high、.badge-low），数据中的中文状态通过_cssClass字段映射
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获取四级地址数据
- 调试工具: 微信开发者工具需配置合法域名