# AI-Native CRM Backend

🚀 **AI 原生客户关系管理系统 - 后端服务**

本项目是一个基于 [Spring Boot](https://spring.io/projects/spring-boot) 和 [LangChain4j](https://github.com/langchain4j/langchain4j) 构建的 AI 原生后端系统。

## 🏗️ 核心理念 (Core Concepts)

与传统 CRM 不同，本项目完全围绕 **AI Agent** 逻辑构建：
- **AI 枢纽 (AI Hub)**：通过 `CrmTools.java` 定义的一系列 `@Tool` 方法，AI Agent 可以直接操作数据库。
- **动态实体 (Dynamic Entities)**：支持在运行时通过自然语言指令动态定义新的业务模块。
- **免 API 维护**：减少了为每个业务动作手动编写 Controller 的需求，一切数据变更均由 AI 驱动。

## 🛠️ 技术栈 (Tech Stack)

- **语言**: Java 19
- **框架**: Spring Boot 3.2.4
- **持久层**: Spring Data JPA + PostgreSQL
- **AI 框架**: LangChain4j 0.30.0
- **构建工具**: Maven 3.x

## 🚀 快速开始 (Quick Start)

### 前置条件
- 已安装 JDK 19 或更高版本。
- 本地运行的 PostgreSQL 数据库。
- 有效的 AI 模型 API Key（请在环境变量或配置文件中配置）。

### 运行应用
1. 克隆项目并进入 backend 目录。
2. 修改 `src/main/resources/application.properties` 配置数据库连接。
3. 执行 Maven 命令：
   ```bash
   mvn clean install
   mvn spring-boot:run
   ```

## 📂 项目结构

- `src/main/java/com/.../crm/controller/AgentController.java`: AI 交互的主入口。
- `src/main/java/com/.../crm/tools/CrmTools.java`: AI 直接调用的工具集合。
- `src/main/java/com/.../crm/model/SysEntity.java`: 动态实体的元数据定义。
- `sql/`: 包含初始化数据库的 SQL 脚本。

## 📈 当前进度与基准
详细的架构和进度记录请参阅：[.antigravity/BASELINE.md](.antigravity/BASELINE.md)

---
*Created by Antigravity*