You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.9 KiB
1.9 KiB
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 HeaderX-Creator-Id透传给后端实现数据隔离。
📈 当前开发进度 (Current Progress)
- AI 动态 UI 渲染：
UniversalModuleRenderer基础架构就绪。 - 动态表单与关联：支持枚举、模式匹配及实体级联选择。
- 会话隔离适配：前端已实现 Header 注入逻辑。
- CORS 联调：已完成与后端的跨域联调。
⚠️ 尚未解决的隐患 (Known Issues/Risks)
- 状态同步：多组件间由于 AI 异步返回导致的 UI 闪烁问题。
- 离线能力：目前完全依赖实时 AI 交互，缺乏离线暂存机制。
🚀 下一步计划 (Next Steps)
- AI 智能搜索界面：对接后端的 AI 增强搜索功能。
- 动态看板 (Dashboard)：实现可视化图表的 AI 渲染支持。
- 引导流程优化：提升用户通过对话创建新模块的体验。
Last Updated: 2026-03-25 by Antigravity