docs: Add project baseline architecture file and update README.
This commit is contained in:
@@ -0,0 +1,32 @@
|
||||
# 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 指令的监听与执行枢纽,负责实时绘制界面。
|
||||
- `DynamicForm.tsx`: 基于 JSON Schema 的动态表单渲染器,支持实体关联选择 (`x-link-entity`)。
|
||||
- `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] **会话隔离适配**:前端已实现 Header 注入逻辑。
|
||||
- [x] **CORS 联调**:已完成与后端的跨域联调。
|
||||
|
||||
## ⚠️ 尚未解决的隐患 (Known Issues/Risks)
|
||||
- **状态同步**:多组件间由于 AI 异步返回导致的 UI 闪烁问题。
|
||||
- **离线能力**:目前完全依赖实时 AI 交互,缺乏离线暂存机制。
|
||||
|
||||
## 🚀 下一步计划 (Next Steps)
|
||||
1. **AI 智能搜索界面**:对接后端的 AI 增强搜索功能。
|
||||
2. **动态看板 (Dashboard)**:实现可视化图表的 AI 渲染支持。
|
||||
3. **引导流程优化**:提升用户通过对话创建新模块的体验。
|
||||
|
||||
---
|
||||
*Last Updated: 2026-03-25 by Antigravity*
|
||||
Reference in New Issue
Block a user