YOCSEF 开源共建平台

前端 React 18 + Ant Design + Vite，后端 NestJS 10 + MySQL 8。当前已接通真实数据库，运营知识库（P08）与文化传承（P09/P10）的数据会持久化。

1. 环境要求

• Node.js 20+
• MySQL 8.0，本机默认账号口令：mysql / mysql
• 数据库：yocsef_platform

2. 首次启动

# 1) 初始化数据库与种子文件（会重建本地 common / event / knowledge / culture 表）
npm run db:init

# 2) 安装依赖（仓库未使用 workspace 提升）
npm --prefix apps/server install
npm --prefix apps/web install

# 3) 同时启动后端 3001 + 前端 5173
npm run dev

浏览器打开：http://localhost:5173/zone/yocsef/

也可以分开启动：

npm run dev:server
npm run dev:web

3. 登录账号

登录页 /login 的演示账号（口令 yocsef@2026）：

账号	姓名	角色
zhibin	志斌	超级管理员
canghai	沧海	内容编辑
chengyi	程毅	内容编辑（知识库 / 文化传承）

后端账号口令来自 apps/server/.env 的 AUTH_PASSWORD，数据库连接参数也在同文件：

DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=mysql
DB_PASSWORD=mysql
DB_NAME=yocsef_platform
AUTH_PASSWORD=yocsef@2026

apps/server/.env 和 apps/web/.env 均已被 gitignore，模板见各自的 .env.example。

4. 已实现接口

模块	接口
登录	POST /api/auth/login、GET /api/auth/me、POST /api/auth/logout
字典	GET /api/dict/:typeKey、POST/PUT/DELETE /api/admin/dict/:typeKey/items
知识库	GET /api/knowledge、GET /api/knowledge/:id、GET /api/admin/knowledge、POST/PUT/DELETE /api/admin/knowledge*
文化传承	GET /api/culture、GET /api/culture/:id、GET /api/culture/:id/media、GET /api/admin/culture、POST/PUT/DELETE /api/admin/culture*
上传	POST /api/files/upload、静态文件 /zone/yocsef/uploads/*
活动下拉	GET /api/events、GET /api/events/:id

所有响应统一为 { code, message, data, traceId }；业务错误通过 data.code 返回，前端统一提示。

5. P09 / P10 使用说明

• 每个文化栏目区块右上角都有「＋ 新增内容」，点击后打开 P10 新建表单，并自动预选该栏目。
• 栏目下拉旁「＋ 新增栏目」会写入 sys_dict_item，刷新后仍保留。
• 新建内容保存到 yoc_culture_item；图片/视频先走 POST /api/files/upload，正文中保存平台内 URL。
• 文化内容、知识库文档、字典栏目均可在 MySQL 中直接查到。

6. 常用命令

npm run db:init       # 重建本地库并写入种子
npm run dev           # 前后端一起启动
npm run typecheck     # 前后端类型检查
npm run build         # 前端构建 + 后端 tsc 编译