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