backend/README.md

AI-Native CRM Backend

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

本项目是一个基于 Spring Boot 和 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 命令：

   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

---

Created by Antigravity