first commit

README.md

@@ -0,0 +1,61 @@
+# zt-closet-manage-frontend
+
+「纸条衣橱」管理后台前端系统，对接 [zt-closet-manage-backend](https://git.lzcwy.cn/zhengchiliu/zt-closet-manage-backend)（Go + Gin）提供的 `/api/v1` 接口。
+
+## 技术栈
+
+| 分类 | 技术 |
+| --- | --- |
+| 框架 | Vue 3（`<script setup lang="ts">`）+ TypeScript |
+| 构建 | Vite |
+| UI | Element Plus（全量引入，靛蓝主题定制） |
+| 路由 | vue-router 4（全局守卫：登录态 + 超管权限） |
+| 状态 | Pinia（auth store 持久化 token / 管理员信息） |
+| HTTP | axios（Bearer 注入、业务码统一处理、11002 过期自动刷新重放） |
+
+## 功能模块
+
+- **登录与鉴权**：账号密码登录、JWT 双 token 自动刷新、登出、修改密码
+- **仪表盘**：用户/订单/营收/待办统计聚合
+- **用户管理**：分页搜索、详情（四类额度）、封禁/解封、额度/VIP 人工调整
+- **商品管理**：新增/编辑/上下架/软删除
+- **订单与退款**：订单列表与详情、退款审核（通过/驳回）
+- **内容审核**：穿搭审核（通过/驳回/封禁）、衣物列表、衣柜分享封禁
+- **通知推送**：单用户通知、全量广播
+- **管理员管理**（超管专属）：列表/创建/编辑/删除
+
+## 快速开始
+
+```sh
+npm install
+npm run dev        # 开发（默认 http://localhost:5173）
+npm run build      # 类型检查 + 生产构建
+```
+
+开发环境下 `/api` 请求经 Vite 代理转发至 `http://localhost:8080`（后端默认端口），需先启动后端服务：
+
+```bash
+cd ../zt-closet-manage-backend && go run .
+```
+
+## 目录结构
+
+```
+src/
+├── api/          # 接口封装（与后端 DTO 一一对应）
+├── assets/       # 全局样式与 Element Plus 主题变量
+├── components/   # 通用组件（筛选卡片、分页条）
+├── layout/       # 后台布局（侧边栏、顶栏）
+├── router/       # 路由表与全局守卫
+├── stores/       # Pinia（auth）
+├── types/        # 类型定义（对齐后端 json tag）
+├── utils/        # request 封装、格式化、枚举映射
+└── views/        # 业务页面（按模块懒加载）
+```
+
+## 约定
+
+- 金额单位后端为「分」，前端统一按「元」展示与输入（提交时乘 100 取整）
+- 时间戳为 Unix 秒，统一格式化为 `YYYY-MM-DD HH:mm:ss`
+- 业务结果以响应体 `code` 为准（多数业务错误 HTTP 仍为 200）
+- access token 过期（业务码 11002）时自动用 refresh token 换取新 token 并重放原请求