# Project Baseline: AI-Native CRM (Frontend)

## 🏗️ 全局架构 (Global Architecture)
本项目是一个 **AI 原生 (AI-Native) CRM** 系统的客户端。
- **核心理念**：通过 AI 驱动的消息流实现动态 UI 生成和业务处理。
- **技术栈**：Next.js 15 (App Router) + Tailwind CSS + Lucide Icons。
- **关键组件**：
    - `UniversalModuleRenderer.tsx`: 后端 AI 下发 UI 指令的监听与执行枢纽。
    - `CopilotProvider.tsx`: **已更新**，取消本地 AI 运行时，改为直连后端 `/api/copilotkit` 端口。
    - `DynamicForm.tsx`: 基于 JSON Schema 的动态表单渲染器。
    - `EntityDataPage`: 动态列表展示页面，通过 AI 代理执行编辑和删除操作。

## 💼 业务逻辑 (Business Logic)
- **事实报告 (Fact Reporting)**：前端不直接调用保存接口，而是向 AI 报告“用户填写的业务事实”，由 AI 决定调用的工具。
- **Session 维护**：从 `localStorage` 获取 `crm_user_id`，并通过 API Header `X-Creator-Id` 透传给后端实现数据隔离。

## 📈 当前开发进度 (Current Progress)
- [x] **AI 动态 UI 渲染**：`UniversalModuleRenderer` 基础架构就绪。
- [x] **动态表单与关联**：支持枚举、模式匹配及实体级联选择。
- [x] **安全优化**：移除了前端 API Key，所有 AI 请求通过后端转发。
- [x] **业务模块共享**：适配后端变更，侧边栏现可按公共定义渲染所有活跃模块。

## ⚠️ 尚未解决的隐患 (Known Issues/Risks)
- **共享冲突提示**：缺乏对公共模块并发编辑的 UI 级冲突提示。
- **状态同步**：多组件间由于 AI 异步返回导致的 UI 闪烁问题。

## 🚀 下一步计划 (Next Steps)
1. **数据权限展示**：在 UI 层面区分公共数据与私人数据。
2. **AI 智能搜索界面**：对接后端的 AI 增强搜索功能。

---
*Last Updated: 2026-03-25 by Antigravity*