yumoqing/integrated_crm_app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
integrated_crm_app/README.md
yumoqing b6ff13734c feat(crm): 集成商机管理模块并更新构建脚本 
- 添加商机管理模块到集成CRM应用
- 更新构建脚本以包含商机管理模块
- 生成完整的数据库模式文件 integrated_crm_app_schema.sql
- 更新模块初始化逻辑
2026-04-16 14:32:41 +08:00

5.7 KiB
Raw Blame History

集成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. 构建应用

cd ~/repos/integrated_crm_app
./build.sh

2. 创建数据库

-- 执行生成的SQL脚本
mysql -u your_user -p your_database < integrated_crm_app_schema.sql

3. 启动服务器

# 使用AhServer（推荐）
ahserver --port 8080 --root wwwroot/

# 或使用其他Web服务器
python3 -m http.server 8080 --directory wwwroot

4. 访问应用

🔧 导航说明

主要功能区

  • 客户管理: 客户档案、公海池、交接流程
  • 商机管理: 销售漏斗、商机创建、阶段变更、预测分析
  • 合同管理: 合同创建、AI分析、里程碑跟踪
  • 财务管理: 记账、应收应付、财务报表
  • 审批中心: 待处理任务、审批历史、工作流配置
  • 仪表板: KPI卡片、趋势图表、个性化配置
  • 系统管理: 用户、角色、参数、代码管理

移动端访问

  • 在手机浏览器中直接访问相同URL
  • 系统自动检测并提供移动端优化界面
  • 审批和报表功能在移动端完全可用

🎯 自定义点

UI定制

  • 修改 base.ui 重新排列或添加标签页
  • 调整样式通过 wwwroot/styles/ 目录

认证扩展

  • 扩展 login.dspy 添加额外认证方法
  • 集成LDAP、OAuth等外部认证源

业务逻辑

  • 在各模块中添加跨模块验证逻辑
  • 扩展审批触发条件和工作流规则

报表创建

  • 使用统一仪表板创建新的数据源组合
  • 开发自定义报表模板满足特定需求

✅ 验证清单

  • 所有8个模块按正确顺序加载
  • 统一TabPanel界面显示所有模块
  • 集中认证与RBAC无缝集成
  • 跨模块数据关系正常工作
  • 基于组织的数据隔离已实施
  • 响应式设计在移动/桌面设备上工作
  • 构建脚本处理所有模块类型（JSON/XLSX）
  • 生产就绪代码具有适当的错误处理
  • 完整文档在README.md中

🚀 扩展机会

高级功能

  • 工作流自动化: 跨模块审批工作流
  • 高级分析: 跨所有模块的统一仪表板
  • 移动应用: 使用相同后端的原生移动界面
  • API网关: 用于外部集成的RESTful API层

集成场景

  • ERP集成: 连接外部会计系统
  • 营销自动化: 链接邮件/活动平台
  • 文档管理: 集成文件存储服务
  • 支付网关: 连接在线支付处理器

这个集成CRM应用程序为企业客户关系管理提供了坚实的基础，具有完全的可扩展性和定制能力。