83 lines
3.7 KiB
Markdown
83 lines
3.7 KiB
Markdown
# 模灵科技官网管理端前期设计
|
|
|
|
本目录用于承接 `mlkj-website` 官网与赛道页的管理端建设前期设计。设计基于当前同级项目 `mlkj-website` 的页面、静态资源、NestJS API、Prisma 数据模型和已有简版后台能力整理。
|
|
|
|
## 文档索引
|
|
|
|
| 文件 | 内容 |
|
|
| --- | --- |
|
|
| [docs/00-current-site-audit.md](docs/00-current-site-audit.md) | 当前官网项目审计、已有能力、缺口与设计约束 |
|
|
| [docs/01-prd.md](docs/01-prd.md) | 管理端 PRD、用户角色、功能范围、验收标准 |
|
|
| [docs/02-product-flow.md](docs/02-product-flow.md) | 产品流程图:内容发布、素材上传、作品管理、评选流程 |
|
|
| [docs/03-design-spec.md](docs/03-design-spec.md) | 管理端页面、交互、信息架构与权限设计 |
|
|
| [docs/04-system-architecture.md](docs/04-system-architecture.md) | 系统架构、模块划分、部署与安全设计 |
|
|
| [docs/05-er-diagram.md](docs/05-er-diagram.md) | E-R 图与核心实体关系 |
|
|
| [docs/06-database-schema.md](docs/06-database-schema.md) | 数据库字段设计与现有 Prisma 表扩展建议 |
|
|
| [docs/07-api-design.md](docs/07-api-design.md) | API 设计说明、接口分组、权限边界 |
|
|
| [docs/swagger/openapi.yaml](docs/swagger/openapi.yaml) | OpenAPI 3.0 Swagger 设计稿 |
|
|
| [docs/08-route-design.md](docs/08-route-design.md) | 管理端前端路由、页面状态和菜单结构 |
|
|
| [docs/09-development-plan.md](docs/09-development-plan.md) | 详细开发计划、阶段拆分、交付物与验收 |
|
|
| [docs/10-development-standards.md](docs/10-development-standards.md) | 前后端、数据库、接口、测试、协作开发规范 |
|
|
| [docs/11-development-requirements.md](docs/11-development-requirements.md) | 开发环境、质量、安全、性能、上线要求 |
|
|
| [docs/12-cloud-deployment.md](docs/12-cloud-deployment.md) | 云服务器、云数据库、OSS、CDN、安全与运维设计 |
|
|
|
|
## 管理端应用
|
|
|
|
当前目录已包含第一版管理端前端应用:
|
|
|
|
```text
|
|
app/
|
|
index.html
|
|
assets/admin-app.css
|
|
assets/admin-app.js
|
|
serve.mjs
|
|
```
|
|
|
|
本地启动:
|
|
|
|
```bash
|
|
cd ~/AI\ SoulMate/开发/mlkj-website-admin
|
|
npm run dev
|
|
```
|
|
|
|
默认访问:
|
|
|
|
```text
|
|
http://127.0.0.1:4173/
|
|
```
|
|
|
|
管理端会调用 `mlkj-website` 后端的 `/api/admin/*`。本地开发时请先启动后端:
|
|
|
|
```bash
|
|
cd ~/AI\ SoulMate/开发/mlkj-website
|
|
HOST=127.0.0.1 PORT=3001 ADMIN_INITIAL_USERNAME=admin ADMIN_INITIAL_PASSWORD=admin123 node backend/dist/main.js
|
|
```
|
|
|
|
静态构建:
|
|
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
构建产物输出到:
|
|
|
|
```text
|
|
dist/
|
|
```
|
|
|
|
## 核心结论
|
|
|
|
1. 当前 `mlkj-website` 已有前台页面、NestJS 后端、Prisma 模型和一个极简 `admin.html` 管理页,可作为后续开发基础。
|
|
2. 现有后台已覆盖登录、控制台、作品、课程、咨询线索、文件登记,但官网文字内容、赛道页复杂区块、素材包、视频上传、评选打分尚未完整产品化。
|
|
3. 第一版管理端应优先解决运营高频问题:页面文案可编辑、图片和素材可上传、视频课程可发布、作品可维护、评委可打分、结果可汇总发布。
|
|
4. 技术上建议继续沿用现有 NestJS + Prisma + PostgreSQL + OSS 的方向,新增独立后台前端应用或替换当前 `frontend/public/admin.html` 为 Vite 管理端。
|
|
|
|
## 建议开发顺序
|
|
|
|
1. 完成后台基础工程:登录、JWT、RBAC、布局、文件上传。
|
|
2. 完成官网首页与赛道页内容区块管理:草稿、预览、发布。
|
|
3. 完成素材库、课程/视频、赛道资源包管理。
|
|
4. 完成作品管理:基础信息、图片、模型、附件、发布状态。
|
|
5. 完成作品评选:评审轮次、评委、指标、分配、打分、统计、获奖结果发布。
|
|
6. 前台页面逐步从静态 HTML/JSON 切换到 API 数据。
|