frontend/README.md

AI-Native CRM Frontend

🎨 AI 原生客户关系管理系统 - 前端界面

这是一个基于 Next.js 构建的现代化 CRM 界面，深度集成 AI 驱动的动态 UI 渲染引擎。

🌟 核心特性 (Key Features)

• 生成式 UI (Generative UI)：集成 UniversalModuleRenderer，根据 AI 的指令实时绘制业务界面。
• 动态表单 (Dynamic Form)：支持 JSON Schema 驱动的复杂表单，具备实体关联选择功能。
• Copilot 深度集成：内置 AI 助手，用户可通过对话直接创建页面、生成报表。
• 低代码/零代码：业务模型和界面布局完全由后端 AI 元数据驱动。

🛠️ 技术栈 (Tech Stack)

• 框架: Next.js 15 (App Router)
• 样式: Tailwind CSS + Shadcn UI
• 字体: Geist (Vercel Typography)
• 图标: Lucide Icons
• 交互: CopilotKit React SDK

🚀 快速开始 (Quick Start)

前置条件

• Node.js 18+
• 已安装 npm 或 yarn

运行应用

1. 安装依赖：

   npm install
   

2. 配置环境变量： 在根目录创建 .env.local，配置 API 地址：

   NEXT_PUBLIC_API_URL=http://localhost:8080
   

3. 启动开发服务器：

   npm run dev
   

📂 关键组件

• src/components/UniversalModuleRenderer.tsx: 万能渲染枢纽。
• src/components/DynamicForm.tsx: 基于模式定义的动态表单。
• src/app/data/[entityCode]/page.tsx: 动态列表展示页。

📈 当前进度与基准

详细的功能实现状况请参阅：.antigravity/BASELINE.md

---

Created by Antigravity