3.2 KiB
3.2 KiB
mocmobile 项目 TODO List
技术栈:Vant 4 + Vite 8 + Vue 3 + TypeScript
✅ 已完成
基础架构
- 使用 Vite + Vue 3 + TypeScript 初始化项目
- 集成 Vant 4 移动端 UI 组件库(按需自动引入)
- 配置
@路径别名(src/) - 配置环境变量(
.env.development/.env.production)
路由与权限
- 集成 Vue Router,路由懒加载
- 全局前置守卫:未登录跳转登录页,已登录不可访问登录页
- 白名单路由放行
- 登录后跳转回来源页(
redirect参数) - 路由
meta.title自动设置页面标题
接口请求封装
- 基于 axios 封装统一请求实例
- 请求拦截器:自动携带 token(
Authorization: Bearer) - 响应拦截器:统一处理
code、错误提示、401 自动登出 - 支持
loading配置(Vant Toast loading) - 标准响应结构
ApiResult<T> { code, message, data }
移动端适配
- 配置
postcss-px-to-viewport-8-plugin(设计稿 375px) px自动转换为vw,字体同样自适应- viewport meta 禁止缩放、适配刘海屏(
viewport-fit=cover)
页面
- 登录页:用户名 + 密码,Vant Form 校验,loading 状态
- 404 页面
- 403 无权限页面(
/403,已加入路由白名单) - 站内消息页:汇总卡与页签固定,仅列表滚动,上拉加载(40 条,10 条/页)
- 变更查看页:筛选/排序区固定,仅列表滚动,上拉加载(40 条,10 条/页)
- 拍照上传页
- 变更详情页:返回板块固定、下方内容滚动,详情/进度/等级判定/判定说明跳转
- 变更进度页:6 节点时间轴,头部与详情页一致
- 等级判定页:判定汇总条 + 评估维度评分表
- 判定说明页:AI 判定结论、命中/排除规则、知识库引用、免责说明
用户状态
- Token 持久化(localStorage)
- 基于 Vue reactive 的轻量用户状态管理
📋 待办 / 可扩展
登录相关
- 接入真实登录接口(当前
/user/login为占位) - 密码显示/隐藏切换
- 记住用户名
- 图形验证码 / 短信验证码
- 第三方登录(微信等)
状态管理
- 引入 Pinia 替代轻量 reactive store(如需复杂状态)
- 用户信息持久化(刷新页面后恢复)
- 权限点 / 角色管理
请求层
- 请求重试机制
- 请求取消(AbortController)
- 请求防抖 / 节流
- 大文件上传 / 下载进度
工程化
- ESLint + Prettier 代码规范
- 提交规范(husky + commitlint + lint-staged)
- 单元测试(Vitest)
- CI/CD 配置
- 打包体积分析(rollup-plugin-visualizer)
体验优化
- 骨架屏
- 路由切换动画
- 图片懒加载
- 离线缓存(Service Worker / PWA)
- 暗黑模式
功能模块
- 首页业务接口对接(首页已删除,待确定落地页后对接)
- 列表页(搜索、分页、空状态)
- 详情页(路由参数 id 传参)
- 上拉加载(van-list 无限滚动)
- 个人信息编辑
- 修改密码