Files
mlkj-website-admin/README.md
T
2026-06-29 19:27:33 +08:00

3.7 KiB

模灵科技官网管理端前期设计

本目录用于承接 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/

核心结论

  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 数据。