mica-admin: Skill for Claude Code

mica-admin-uniapp 移动端开发

uniapp（@dcloudio 3.0）+ Vue 3.5 + Vite 6 + Pinia + TS。后端同 mica-admin-server，认证同为 RSA 加密密码 + 算术验证码 + JWT。

目录约定

src/
├── pages/                  # tabBar 页面，只有 3 个：index / message / profile
├── modules/<name>/         # 业务模块，按功能拆
│   ├── pages/*.vue
│   ├── stores/
│   └── api.ts
├── modules/extension/      # 二次开发专区（只新增不修改）
│   └── workbench/registry.ts   # 工作台卡片注册中心
├── api/                    # 通用接口层（auth / user / notice / message）
├── stores/auth.ts          # 认证 store
├── utils/                  # request / rsa / storage / format / uuid
├── config/env.ts           # 类型化环境变量 + isH5 / isMp / isApp
├── locales/langs/
└── pages.json              # 所有页面必须在此注册
static/                     # 静态资源放这里，不要放 src/assets/

• 别名 @/ → src/（与 web 端的 #/ 不同）。
• tabBar 页面放 pages/，其余页面一律放 modules/<name>/pages/。
• 新增页面必须同时在 src/pages.json 的 pages 数组注册，否则跳转直接失败（小程序尤其）。

完整模板见 references/module-page.md。

网络层

统一用 @/utils/request 的 http，不要直接调 uni.request：

import { http } from '@/utils/request'
import type { PageResult } from '@/utils/request'

export function getBanners(params: { current?: number; size?: number; title?: string }) {
  return http.get<PageResult<BannerVo>>('/api/system/banner', params)
}

http.get(url, params, options) / post|put|delete(url, data, options)。约定：

• 成功返回裸数据体：分页是 MyBatis-Plus IPage 结构 { records, total, current, size, pages }（注意：移动端直接消费 records，不像 web 端有 parsePage 转 list）。
• 失败是 R 包装 { code: 非0, msg }；拦截层已自动 uni.showToast 并 reject，业务侧 catch 不要重复 toast。
• 401 已自动清 token 并 uni.reLaunch('/modules/auth/pages/login')。
• 需要静默失败传 { hideError: true }；免鉴权接口传 { hideAuth: true }。
• token 存储 key 为 mica-admin-token，走 @/utils/storage；用 getToken/setToken/clearToken，不要自己读缓存。

页面写法

• 一律 <script setup lang="ts"> + Composition API，TS 严格模式，避免 any，props/emits 显式声明。
• 小颗粒状态 ref，复杂对象 reactive，派生值 computed。跨页面共享才进 Pinia store。
• 数据加载写成 async function load() + loading 标志 + try/finally，onMounted 调用。
• 下拉刷新：pages.json 里该页 style.enablePullDownRefresh: true，页面用 onPullDownRefresh()（@dcloudio/uni-app 导出）配 uni.stopPullDownRefresh()。
• 跳转 uni.navigateTo({ url: '/modules/xxx/pages/detail?id=1' })，参数在 onLoad(query) 里取；登录态切换用 uni.reLaunch；tabBar 用 uni.switchTab。
• 提示用 uni.showToast({ icon: 'none' })，确认用 uni.showModal。