backend/.antigravity/BASELINE.md

Project Baseline: AI-Native CRM (Backend)

🏗️ 全局架构 (Global Architecture)

本项目是一个 AI 原生 (AI-Native) CRM 系统的后端。

• 核心理念：摆脱传统的 REST API 增删改查动作，所有的业务模块定义和数据变更都通过 AI Agent 调用 Tool 实现。
• 技术栈：JDK 19 + Spring Boot 3.2.4 + PostgreSQL。
• 关键组件：
  • CrmTools.java: 系统的“消息枢纽”，包含所有 @Tool 方法（Define, Save, Delete），直接与 Repository 交互。
  • AgentController.java: 主要入口，负责处理自然语言指令或业务事实报告。
  • 隔离机制：实现了基于 Header X-Creator-Id 的简易用户 Session 隔离，所有数据查询和变更均强制绑定 creatorId。

💼 业务逻辑 (Business Logic)

• 动态模块：系统支持通过 AI 指令动态创建业务实体（Entities），并在数据库中自动维护。
• AI 优先变更：禁用了传统的 CRUD REST 接口，强制所有数据变更流经 AI 逻辑，以保证业务意图的记录。

📈 当前开发进度 (Current Progress)

• AI 原生 CRUD：已实现 Agent 驱动的插入、更新和删除。
• 实体关联：支持通过 x-link-entity 扩展 Schema 实现实体间关联选择。
• 用户会话隔离：已完成后端拦截与过滤逻辑，确保多用户数据不串线。
• CORS 配置：已解决前后端跨域通信问题。

⚠️ 尚未解决的隐患 (Known Issues/Risks)

• 并发冲突：动态 Schema 变更在极高并发下的稳定性待验证。
• 权限细化：目前的 X-Creator-Id 仅做基础隔离，缺乏细粒度的 RBAC。

🚀 下一步计划 (Next Steps)

1. AI 增强搜索：实现通过 AI 生成复杂查询逻辑。
2. 仪表盘分析：开发动态数据的 AI 汇总分析模块。
3. 性能监控：针对 AI Tool 调用的耗时进行埋点监控。

---

Last Updated: 2026-03-25 by Antigravity