|
|
|
|
@ -0,0 +1,32 @@
|
|
|
|
|
# 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* |