# 集成CRM管理系统

## 概述
这是一个集成了客户管理、合同管理、商机管理、财务管理、基础编码管理和RBAC权限控制的完整CRM解决方案。

## 功能模块

### 1. 客户管理模块 (Customer Management)
- **客户档案管理**: 支持个人和企业客户，360度视图集成商机、合同、服务记录
- **客户交接管理**: 自动化交接流程，三阶段审批工作流
- **客户公海池**: 基于不活跃期的自动回收和分配机制

### 2. 商机管理模块 (Opportunity Management)  
- **商机全生命周期**: 手动录入/线索转化，自定义销售漏斗阶段
- **商机分析**: 漏斗可视化，基于历史转化率的收入预测（偏差≤15%）

### 3. 合同管理模块 (Contract Management)
- **合同全流程**: 从商机一键生成，AI条款解析和风险预警
- **履约跟踪**: 里程碑管理，逾期自动提醒
- **分阶段收款**: 订单作为收款执行单元，自动拆分付款节点

### 4. 财务管理模块 (Financial Management)
- **应收管理**: 订单维度精细化管理，账期监控和逾期提醒
- **收款管理**: 多订单关联收款，金额验证防止超收
- **支出管理**: 关联已核销合同收款的支出控制

### 5. 基础模块 (AppBase)
- **编码管理**: 分层键值对管理（appcodes/appcodes_kv表）
- **参数管理**: 系统参数和业务日期管理

### 6. 权限控制模块 (RBAC)
- **用户管理**: 多种认证方式（密码、手机、二维码）
- **角色权限**: 树形权限结构，细粒度访问控制
- **组织管理**: 多租户支持，提供商/经销商/客户层级

## 技术架构

### 前端
- **Bricks Framework**: JSON驱动的组件化UI框架
- **响应式设计**: 适配不同屏幕尺寸
- **模块化布局**: TabPanel组织各功能模块

### 后端  
- **AhServer**: 异步HTTP应用服务器
- **SQLor Database Module**: 数据库抽象层
- **Async/Await**: 异步编程模型

### 安全
- **多租户隔离**: 组织级别数据隔离
- **RBAC集成**: 统一权限控制
- **敏感字段保护**: 密码等字段自动隐藏

## 部署说明

### 目录结构
```
integrated_crm_app/
├── integrated_crm_app/     # Python包
│   ├── __init__.py
│   └── init.py            # 模块加载器
├── wwwroot/               # 前端资源
│   ├── base.ui           # 主布局
│   ├── login.ui          # 登录页面  
│   └── login.dspy        # 登录处理
├── pyproject.toml         # 包配置
└── README.md              # 文档
```

### 构建步骤
1. 将所有模块放置在 `~/repos/` 目录下
2. 运行主应用的 `build.sh` 脚本（需要创建）
3. 启动 AhServer 应用

### 依赖模块
- appbase (基础模块)
- rbac (权限模块)  
- customer_management (客户管理)
- opportunity_management (商机管理)
- contract_management (合同管理)
- financial_management (财务管理)

## 使用说明

1. **首次访问**: 自动跳转到登录页面
2. **主界面**: TabPanel布局，六大功能模块
3. **权限控制**: 基于RBAC的角色权限体系
4. **数据隔离**: 组织级别的数据访问控制

## 扩展性

- **新增模块**: 遵循模块开发规范，可轻松集成
- **自定义字段**: 通过appbase编码管理扩展
- **工作流定制**: 可扩展业务流程和审批规则
- **报表扩展**: 基于现有数据模型创建新报表

## 版本信息
- **版本**: 1.0.0
- **状态**: 生产就绪
- **兼容性**: 遵循所有模块开发规范