常见问题

x-boot-cloud 是完整业务系统吗？

不是。它是一个可复用的企业级 Java 微服务脚手架，并在其上逐步建设 AI 应用平台和其他业务模块。

为什么要区分 admin-api 和 app-api？

两者面向的用户和安全边界不同。后台管理入口承载企业后台和 AI 平台 MVP，应用端入口面向独立的应用场景，避免把不同访问模型混在一起。

Controller 为什么不能直接调用 Service？

Facade 是跨模块契约边界。通过 Controller → Facade → Service → Mapper，可以隔离 HTTP、RPC、业务规则和持久化，降低模块耦合并方便测试。

如何切换 AI 模型？

推荐通过数据库或 Nacos 管理 provider、base URL、API Key、模型名称、temperature、timeout 和启用状态。调用侧使用统一的 AI 配置抽象，不把供应商密钥硬编码在源码中。

Qdrant 是必需的吗？

不是所有场景都需要。AI 知识库/RAG 需要向量存储时可以接入 Qdrant；Learning OS V1 本地联调明确不要求 Qdrant。

如何新增业务模块？

先阅读 API 与业务服务 和 系统架构，明确服务职责后，在 x-boot-modules 下按 facade/service 结构实现，并在 API 模块添加入口和测试。

从哪里查看最新进度？

查看当前开发状态，并以主仓库的 docs/project/STATUS.md、TASKS.md 和代码测试结果为最终依据。