# 集成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应用程序为企业客户关系管理提供了坚实的基础，具有完全的可扩展性和定制能力。