Ingen beskrivning

Y7000\张扬阳 edb5a47858 docs: add local development guide 2 veckor sedan
.claude a3d544af32 重新写新计划之前的版本 2 veckor sedan
drizzle 0ecff59f31 已成功的部分,现在要进行测试了 2 veckor sedan
src 3c519b8471 test: clean up test artifacts 2 veckor sedan
tests 3c519b8471 test: clean up test artifacts 2 veckor sedan
.env.example 3eed182235 chore: stop tracking local env and dependencies 2 veckor sedan
.gitignore 3eed182235 chore: stop tracking local env and dependencies 2 veckor sedan
AGENTS.md 0ecff59f31 已成功的部分,现在要进行测试了 2 veckor sedan
ARCHITECTURE.md 9ae58a94d5 Initialize project with ARCHITECTURE.md and CLAUDE.md 2 veckor sedan
CLAUDE.md 9ae58a94d5 Initialize project with ARCHITECTURE.md and CLAUDE.md 2 veckor sedan
README.md edb5a47858 docs: add local development guide 2 veckor sedan
components.json 0ecff59f31 已成功的部分,现在要进行测试了 2 veckor sedan
diag.ts a3d544af32 重新写新计划之前的版本 2 veckor sedan
drizzle.config.ts ef7a2be60c 重写之前的缓存 2 veckor sedan
next-env.d.ts 0ecff59f31 已成功的部分,现在要进行测试了 2 veckor sedan
next.config.ts 0ecff59f31 已成功的部分,现在要进行测试了 2 veckor sedan
package-lock.json 0ecff59f31 已成功的部分,现在要进行测试了 2 veckor sedan
package.json 3c519b8471 test: clean up test artifacts 2 veckor sedan
postcss.config.mjs 0ecff59f31 已成功的部分,现在要进行测试了 2 veckor sedan
test-minio.ts a3d544af32 重新写新计划之前的版本 2 veckor sedan
test_sample.mp4 a3d544af32 重新写新计划之前的版本 2 veckor sedan
tsconfig.json 0ecff59f31 已成功的部分,现在要进行测试了 2 veckor sedan

README.md

企业知识库开发说明

本地运行

开发时需要两个进程:

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

默认访问地址:

http://127.0.0.1:3000/login

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

admin@ekb.com
hashed_password_here

构建和开发服务

next buildnext 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/*