admin_new/README.md
Sisyphus 6d02a4b5d2 feat(F006): W2 + W4 + W31 admin_new 全部改动首次 commit
- W2: 4 主题 (科技蓝/中国红/Notion 紫/暗夜黑) + LoginView + DashboardView + 询价管理 (InquiryList + InquiryDetail)
- W4.1: 集成管理 - 应用列表 (OpenAppListView)
- W4.2: 集成管理 - 审计日志 (AuditLogListView) + 菜单 label 补全
- W4.2: 菜单从后端拉 + 看板接真 API
- W31: safeParseArray 防御 localStorage permissions 损坏 (运营后台白屏修复)

关联: Mac F002-W31-交接文档.md / F006-W4-交接文档.md / GIT-AUDIT-REPORT-2026-06-24.md
本地备份: ~/projects/_meta/f002-fix/admin-new-w4-*/
2026-06-24 11:05:18 +08:00

74 lines
2.1 KiB
Markdown

# Admin New (F006)
**重构后的管理后台** — 替代老的 renren-cloud-admin,渐进式双前端策略。
> 任何架构变更必须先看 [`ARCHITECTURE.md`](./ARCHITECTURE.md) 再改代码。
## 启动
```bash
# 安装依赖
npm install
# Dev (端口 3001,proxy /api 到 gateway:8080)
npm run dev
# Build
npm run build
# Type check
npm run type-check
```
访问:
- Dev: http://localhost:3001/admin/
- Prod: http://100.111.84.16:3000/admin/(待 nginx 配置)
## 4 套主题
切主题:顶栏"主题"按钮,或登录页底部 4 个色点。
| 主题 | 主色 | 触发 |
|---|---|---|
| 科技蓝(默认) | `#2563EB` | data-theme="tech-blue" |
| 中国红 | `#DC2626` | data-theme="red" |
| Notion 紫 | `#5645D4` | data-theme="purple" |
| 暗夜黑 | `#0F172A` | data-theme="dark" |
新增主题:改 `src/theme/themes.scss` + `src/theme/presets.ts` 两处即可。
## 当前进度 (W1 D1 末)
- [x] 项目骨架(Vite + Vue 3 + TS + Pinia + Element Plus)
- [x] 4 套主题系统(tokens + themes + presets)
- [x] ThemePicker 顶栏组件
- [x] AppLayout 主布局(顶栏 + 侧边栏 + 内容区)
- [x] LoginView 登录页(渐变 + 主题切换)
- [x] DashboardView 数据看板(mock 数据)
- [x] Vite proxy /api → gateway:8080
- [ ] D2: 登录接真实 OAuth2(axios + 路由守卫) — **明日**
- [ ] D3: 菜单从后端拉
- [ ] D4: 看板接真实 API
- [ ] D5: nginx 部署到 /admin/
## 目录结构(按 ARCHITECTURE.md)
```
src/
├── theme/ # 主题系统(独立子模块)
├── layout/ # 布局(AppLayout 已迁移至 components/AppLayout)
├── modules/ # 业务模块(每个独立)
│ ├── auth/ # 登录
│ └── dashboard/ # 数据看板
├── components/ # 跨模块组件
│ ├── AppLayout/
│ └── ThemePicker/
├── stores/ # Pinia (theme/user/menu)
├── api/ # HTTP 封装(W2 接入)
├── router/ # 路由 + 守卫
├── composables/ # 可复用逻辑(预留)
├── directives/ # 全局指令(预留)
├── styles/ # 全局样式
└── utils/ # 工具函数
```