Files
2026-11-13 15:23:10 +08:00

3.2 KiB
Raw Permalink Blame History

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 无限滚动)
  • 个人信息编辑
  • 修改密码