knowledge

企业知识库开发说明

本地运行

开发时需要两个进程：

npm run dev
npm run worker:media

• npm run dev 启动 Next.js 页面和 API。
• npm run worker:media 消费 BullMQ 队列并调用 FFmpeg 生成 HLS。
• 如果只启动 npm run dev，视频可以上传，但会停在 pending 或 processing，直到 worker 启动。

默认访问地址：

http://127.0.0.1:3000/login

默认开发账号来自 seed 数据：

admin@ekb.com
hashed_password_here

构建和开发服务

next build 和 next typegen 会改写 .next 目录。不要在已有 npm run dev 进程运行期间执行构建后继续使用旧 dev server；构建或类型检查后请重启开发服务。

推荐顺序：

npm run typecheck
npm run build
npm run dev

媒体测试

媒体测试依赖：

• PostgreSQL
• Redis
• MinIO
• FFmpeg
• 项目根目录的 test_sample.mp4

常用验证命令：

npm run test:upload
npm run test:media-pipeline
npm run test:media-status
npm run test:media-list
npm run test:media-permission
npm run test:media-delete

测试会尽量清理自己创建的媒体记录、资源记录、原始 MinIO 对象和 HLS 输出。不要用这些测试脚本验证需要长期保留的人工上传文件。

如果本地库里已经有旧测试残留，可以运行：

npm run test:cleanup

该脚本只清理使用测试前缀创建的数据，例如 e2e-*、media-list-*、media-status-*、admin-flow-*@ekb.com 和 /permission-admin/*。