integrated_crm_app/README.md
2026-04-16 13:41:15 +08:00

99 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 集成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
- **状态**: 生产就绪
- **兼容性**: 遵循所有模块开发规范