# 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)
- [x] **AI 原生 CRUD**：已实现 Agent 驱动的插入、更新和删除。
- [x] **实体关联**：支持通过 `x-link-entity` 扩展 Schema 实现实体间关联选择。
- [x] **用户会话隔离**：已完成后端拦截与过滤逻辑，确保多用户数据不串线。
- [x] **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*