- 复制
.env.example为.env,并修改其中的生产环境密码。后端会自动读取项目根目录的该文件。 - 执行
docker compose up -d启动 MySQL、Redis、MinIO、Milvus 和 Ollama。首次下载模型需要较长时间。 - 执行
cd server; mvn spring-boot:run启动 API(默认8080)。 - 执行
cd client; npm install; npm run dev启动双前端:管理端5173,用户端5174。
默认初始管理员由 .env 的 INITIAL_ADMIN_USERNAME / INITIAL_ADMIN_PASSWORD 决定,默认是 admin / Admin@123。
智能问答页支持选择本地 Ollama 或云端 DeepSeek。DeepSeek 默认占位 Key 为 123456,正式使用前请在 .env 中将 DEEPSEEK_API_KEY 替换为真实密钥;接口地址和模型可分别通过 DEEPSEEK_BASE_URL、DEEPSEEK_MODEL 调整。
后端使用 MINIO_ACCESS_KEY 和 MINIO_SECRET_KEY 访问 MinIO;本地 Compose 默认与 MINIO_ROOT_USER、MINIO_ROOT_PASSWORD 相同。若 MinIO 数据卷曾以不同的 Root 凭据初始化,修改 .env 不会重置已存在数据卷中的凭据:请将这两个后端变量设置为 MinIO 当前有效的 Access Key/Secret Key,并重启后端。
server:Spring Boot 4 + Spring AI + MyBatis-Plus 的模块化单体,支持 PDF、Word、PPT、TXT、Markdown 与 Excel 文档解析。client/apps/admin:管理员后台。client/apps/portal:普通用户知识问答门户。client/packages/shared:共享 TypeScript API 类型和请求工具。
API 统一以 /api/v1 为前缀;流式问答使用 SSE。
基础建表在 server/src/main/resources/schema.sql。对已存在的数据库,按文件名时间顺序执行 server/src/main/resources/db/migration/ 内的 SQL 脚本,每个脚本只执行一次;后续字段变更均以 yyyyMMdd_序号_说明.sql 格式新增脚本,不在应用启动代码中执行 DDL。