当前项目审计
1. 项目位置
已审阅项目:/Users/max/AI SoulMate/开发/mlkj-website
当前项目包含:
| 目录/文件 |
说明 |
frontend |
Vite 静态前台,包含官网首页、赛道页、作品详情、课程详情和一个简版管理页 |
backend |
NestJS API,包含 Swagger、Prisma、mock 数据兜底 |
backend/prisma/schema.prisma |
PostgreSQL 数据模型 |
frontend/public/locales |
官网和赛道页多语言文案 JSON |
frontend/public/assets |
Logo、赛道图、奖项图标、页面 CSS/JS |
docs/admin-content-management-plan.md |
已有简版管理端内容管理方案 |
2. 当前技术栈
| 层 |
技术 |
| 官网前台 |
HTML + CSS + 原生 JS + Vite |
| 简版后台 |
frontend/public/admin.html + assets/admin.js |
| 后端 API |
NestJS |
| API 文档 |
Swagger/OpenAPI |
| ORM |
Prisma |
| 数据库 |
PostgreSQL |
| 文件存储规划 |
阿里云 OSS |
| 部署 |
Docker、Nginx、docker compose |
3. 当前前台页面
| 页面 |
文件 |
主要内容 |
| 公司官网 |
frontend/index.html |
Hero、提案定位、业务版图、产品矩阵、解决方案、案例、合作咨询 |
| 赛道页 |
frontend/competition.html |
大赛介绍、赛程、赛事说明、资源包、作品展示、在线学习、合作伙伴 |
| 作品详情 |
frontend/work-detail.html |
作品基础信息、AIGC 过程、模型与附件展示 |
| 课程详情 |
frontend/course-detail.html |
宣讲/培训视频详情 |
| 简版后台 |
frontend/admin.html |
登录、控制台、作品、课程、线索、文件库 |
4. 当前后端能力
已存在的公开接口:
| 模块 |
接口 |
| 站点 |
GET /api/site/config、GET /api/site/home |
| 大赛 |
GET /api/competition、GET /api/competition/schedule |
| 作品 |
GET /api/works、GET /api/works/:id、POST /api/works/:id/vote |
| 课程 |
GET /api/courses、GET /api/courses/:id |
| 线索 |
前台提交能力在 inquiries 模块中已有骨架 |
已存在的后台接口:
| 模块 |
接口 |
| 登录 |
POST /api/admin/auth/login |
| 控制台 |
GET /api/admin/dashboard |
| 作品 |
GET/POST/PATCH/DELETE /api/admin/works |
| 课程 |
GET/POST/PATCH/DELETE /api/admin/courses |
| 线索 |
GET /api/admin/inquiries、PATCH /api/admin/inquiries/:id/status |
| 文件 |
POST /api/admin/uploads、GET /api/admin/files |
5. 当前数据模型
现有 Prisma 模型已经包含:
| 类型 |
表 |
| 官网配置 |
site_configs、home_sections |
| 大赛 |
competitions、competition_schedules、competition_resources、partners |
| 作品 |
works、work_images、work_files、work_votes |
| 课程视频 |
courses |
| 内容延展 |
cases、news |
| 咨询线索 |
inquiries |
| 文件 |
files |
| 管理后台 |
admin_users、admin_roles、admin_user_roles、operation_logs |
6. 主要缺口
| 缺口 |
影响 |
| 官网首页和赛道页大量文案仍在 HTML 或 locale JSON 中 |
运营无法自行修改页面内容 |
| 赛道页复杂区块没有完整后台模型 |
奖项、设计要求、参赛须知、资源包、合作伙伴等更新成本高 |
| 文件接口只是登记记录,不是完整上传流程 |
图片、视频、模型、资料包还不能在后台形成稳定闭环 |
| 作品评选只有投票表,无评委评分模型 |
无法支持评审轮次、指标打分、汇总排名、获奖发布 |
| 权限模型已建表但未完整接入 |
后续多角色运营、评委、管理员隔离不足 |
| 内容缺少版本/预览/发布流程 |
修改线上内容风险较高 |
7. 设计约束
- 前台视觉和页面结构第一阶段尽量不大改,优先把数据来源从静态内容切到 API。
- 管理端应兼容现有表,不推倒重来;新增表集中补足内容区块、评审和上传能力。
- 所有后台写操作必须进入操作日志,尤其是发布、下架、评分、结果确认。
- 文件本体放 OSS,数据库只保存元信息、业务归属和访问地址。
- 作品评选与公众投票分开建模,避免把点赞数当作评委评分。