yumoqing
b6ff13734c
- 添加商机管理模块到集成CRM应用 - 更新构建脚本以包含商机管理模块 - 生成完整的数据库模式文件 integrated_crm_app_schema.sql - 更新模块初始化逻辑
159 lines
5.7 KiB
Markdown
159 lines
5.7 KiB
Markdown
# 集成CRM应用程序
|
||
|
||
## 📋 概述
|
||
这是一个完整的集成CRM应用程序，将8个核心模块无缝整合到一个统一的Web界面中：
|
||
|
||
1. **客户管理** - 客户档案、交接管理、公海池
|
||
2. **商机管理** - 销售漏斗、阶段管理、漏斗可视化、成交预测（偏差率≤15%）
|
||
3. **合同管理** - AI分析、里程碑跟踪、履约管理
|
||
4. **财务管理** - 记账、应收应付、财务报表
|
||
5. **审批工作流** - 跨模块审批、统一审批中心、移动端支持
|
||
6. **统一仪表板** - 实时KPI、业务智能、移动端优化报表
|
||
7. **基础模块** - 代码管理、参数管理
|
||
8. **RBAC鉴权** - 用户管理、角色权限、多租户安全
|
||
|
||
## 🚀 主要特性
|
||
|
||
### 统一界面
|
||
- **TabPanel导航**: 单页面应用，7个主要标签页
|
||
- **响应式设计**: 自动适配桌面和移动设备
|
||
- **一致的用户体验**: 所有模块使用统一的设计语言
|
||
- **集中认证**: 基于RBAC的统一登录系统
|
||
|
||
### 模块集成
|
||
- **客户 ↔ 商机**: 客户360°视图包含关联商机
|
||
- **商机 ↔ 合同**: 一键生成合同，状态自动同步
|
||
- **合同 ↔ 财务**: 合同里程碑自动生成应收
|
||
- **跨模块审批**: 统一审批中心处理所有模块的审批需求
|
||
- **统一仪表板**: 实时聚合所有模块的关键数据
|
||
|
||
### 移动端支持
|
||
- **专用移动UI**: 审批和报表模块有专门的移动端界面
|
||
- **触摸优化**: 大按钮、简化操作流程
|
||
- **离线支持**: 关键审批操作支持离线缓存
|
||
- **性能优化**: 移动端数据加载和渲染优化
|
||
|
||
## 🛠️ 技术架构
|
||
|
||
### 前端架构
|
||
- **Bricks Framework**: JSON驱动的组件化UI系统
|
||
- **主布局**: `base.ui` 使用TabPanel组织所有模块
|
||
- **认证界面**: `login.ui` + `login.dspy` 集成RBAC认证
|
||
- **模块集成**: Frame组件加载各个模块的UI
|
||
|
||
### 后端架构
|
||
- **模块加载器**: `init.py` 按依赖顺序加载8个模块
|
||
- **依赖顺序**: AppBase → RBAC → 业务模块 → 增强模块
|
||
- **函数暴露**: ServerEnv暴露所有必需的函数
|
||
- **异步设计**: 正确使用awaitify处理同步函数
|
||
|
||
### 数据库架构
|
||
- **共享模式**: 所有模块使用同一数据库，通过org_id隔离
|
||
- **引用完整性**: 外键维护数据一致性
|
||
- **性能优化**: 在频繁查询字段上建立战略索引
|
||
- **DDL生成**: 从JSON/XLSX定义自动生成模式
|
||
|
||
## 📂 目录结构
|
||
```
|
||
integrated_crm_app/
|
||
├── integrated_crm_app/ # Python包
|
||
│ ├── __init__.py # 包标记
|
||
│ └── init.py # 主模块加载器
|
||
├── wwwroot/ # 主应用前端
|
||
│ ├── base.ui # 统一布局（TabPanel）
|
||
│ ├── login.ui # 集中登录表单
|
||
│ └── login.dspy # RBAC集成认证处理器
|
||
├── build.sh # 构建脚本（处理所有模块）
|
||
├── pyproject.toml # 包配置
|
||
├── README.md # 详细文档
|
||
└── integrated_crm_app_schema.sql # 数据库模式（构建时生成）
|
||
```
|
||
|
||
## ⚡ 快速开始
|
||
|
||
### 1. 构建应用
|
||
```bash
|
||
cd ~/repos/integrated_crm_app
|
||
./build.sh
|
||
```
|
||
|
||
### 2. 创建数据库
|
||
```sql
|
||
-- 执行生成的SQL脚本
|
||
mysql -u your_user -p your_database < integrated_crm_app_schema.sql
|
||
```
|
||
|
||
### 3. 启动服务器
|
||
```bash
|
||
# 使用AhServer（推荐）
|
||
ahserver --port 8080 --root wwwroot/
|
||
|
||
# 或使用其他Web服务器
|
||
python3 -m http.server 8080 --directory wwwroot
|
||
```
|
||
|
||
### 4. 访问应用
|
||
- **登录页面**: http://localhost:8080/main/login.ui
|
||
- **主界面**: 登录后自动跳转到 http://localhost:8080/main/base.ui
|
||
|
||
## 🔧 导航说明
|
||
|
||
### 主要功能区
|
||
- **客户管理**: 客户档案、公海池、交接流程
|
||
- **商机管理**: 销售漏斗、商机创建、阶段变更、预测分析
|
||
- **合同管理**: 合同创建、AI分析、里程碑跟踪
|
||
- **财务管理**: 记账、应收应付、财务报表
|
||
- **审批中心**: 待处理任务、审批历史、工作流配置
|
||
- **仪表板**: KPI卡片、趋势图表、个性化配置
|
||
- **系统管理**: 用户、角色、参数、代码管理
|
||
|
||
### 移动端访问
|
||
- 在手机浏览器中直接访问相同URL
|
||
- 系统自动检测并提供移动端优化界面
|
||
- 审批和报表功能在移动端完全可用
|
||
|
||
## 🎯 自定义点
|
||
|
||
### UI定制
|
||
- 修改 `base.ui` 重新排列或添加标签页
|
||
- 调整样式通过 `wwwroot/styles/` 目录
|
||
|
||
### 认证扩展
|
||
- 扩展 `login.dspy` 添加额外认证方法
|
||
- 集成LDAP、OAuth等外部认证源
|
||
|
||
### 业务逻辑
|
||
- 在各模块中添加跨模块验证逻辑
|
||
- 扩展审批触发条件和工作流规则
|
||
|
||
### 报表创建
|
||
- 使用统一仪表板创建新的数据源组合
|
||
- 开发自定义报表模板满足特定需求
|
||
|
||
## ✅ 验证清单
|
||
|
||
- [x] 所有8个模块按正确顺序加载
|
||
- [x] 统一TabPanel界面显示所有模块
|
||
- [x] 集中认证与RBAC无缝集成
|
||
- [x] 跨模块数据关系正常工作
|
||
- [x] 基于组织的数据隔离已实施
|
||
- [x] 响应式设计在移动/桌面设备上工作
|
||
- [x] 构建脚本处理所有模块类型（JSON/XLSX）
|
||
- [x] 生产就绪代码具有适当的错误处理
|
||
- [x] 完整文档在README.md中
|
||
|
||
## 🚀 扩展机会
|
||
|
||
### 高级功能
|
||
- **工作流自动化**: 跨模块审批工作流
|
||
- **高级分析**: 跨所有模块的统一仪表板
|
||
- **移动应用**: 使用相同后端的原生移动界面
|
||
- **API网关**: 用于外部集成的RESTful API层
|
||
|
||
### 集成场景
|
||
- **ERP集成**: 连接外部会计系统
|
||
- **营销自动化**: 链接邮件/活动平台
|
||
- **文档管理**: 集成文件存储服务
|
||
- **支付网关**: 连接在线支付处理器
|
||
|
||
这个集成CRM应用程序为企业客户关系管理提供了坚实的基础，具有完全的可扩展性和定制能力。 |