Champa Intelligence Documentation¶

Enterprise Process Intelligence & Observability Platform for Camunda 7

Champa Intelligence is an enterprise-grade Process Intelligence and Observability Platform meticulously engineered to supercharge the Camunda 7 BPMN engine. It transforms raw process execution data into actionable, strategic business intelligence through advanced analytics, AI-powered insights, and comprehensive monitoring.

Quick Start

Get up and running in 15 minutes with Docker Compose
Features Overview

Explore all platform capabilities and use cases
API Reference

Complete REST API documentation with examples
Configuration

Configure for your Camunda environment
AI Analysis

Leverage Google Gemini for intelligent insights
Docker Deployment

Production-ready containerized deployment
Security Model

Role-based access control and authentication
Health Monitoring

Multi-node cluster monitoring with Prometheus metrics

What is Champa Intelligence?¶

Champa Intelligence addresses the critical visibility and analytics gaps inherent in standard Camunda deployments by providing:

For Leadership & Management¶

Portfolio Dashboard: Executive-level visibility across all process definitions
KPI Tracking: Real-time business metrics and success rates
AI-Powered Insights: Natural language analysis of process performance
Risk Assessment: Automated identification of problematic processes

For Process Analysts & Operations¶

Process Intelligence Dashboard: Deep-dive analytics with lazy-loaded components
Performance Metrics: P50, P95, P99 percentile analysis
Bottleneck Detection: Automated identification of performance hotspots
Journey Monitoring: End-to-end business journey tracking across processes

For Developers & DevOps¶

BPMN Diff Tool: Visual comparison of process versions with XML-level changes
Model Validator: 50+ linting rules for BPMN and DMN quality assurance
Health Monitoring: Multi-node cluster monitoring with JVM metrics
Incident Analysis: Root cause analysis with variable correlation

For Security & Administration¶

Role-Based Access Control: Granular permission system with 12+ distinct permissions
User Management: Complete user and role administration
Audit Logging: Comprehensive security and action audit trail
API Token Management: Secure programmatic access with TTL controls

Key Features¶

📊 Advanced Analytics¶

80+ Optimized SQL Queries: Hand-crafted queries for complex aggregations
Real-time Dashboards: Instant visibility into process health
Historical Trends: 12-month trend analysis and pattern recognition
Variable Analytics: Data quality, security, and compliance analysis

🤖 AI-Powered Intelligence¶

Google Gemini Integration: Natural language process analysis
Multiple Focus Areas: Incidents, performance, variables, patterns, and more
Customizable Detail Levels: Executive, standard, and technical deep-dives
Multi-language Support: Generate reports in 11+ languages

🏥 Health Monitoring¶

Multi-Node Cluster Support: Unified view across all Camunda nodes
JVM Metrics: Heap usage, GC statistics, thread analysis
Database Health: Connection pool, query performance, table sizes
Prometheus Integration: Native metrics endpoint for Grafana dashboards

🔍 Process Intelligence¶

Lazy-Loaded Dashboard: Instant page load with on-demand data fetching
10+ Analysis Sections: Operations, performance, UX, BI, quality, diagnostics
Dual-Version Comparison: Side-by-side analysis for migrations
DMN Analytics: Decision table execution patterns and statistics

🛡️ Enterprise Security¶

JWT-Based Authentication: Secure stateless token authentication
Session Management: Redis-backed sessions with TTL controls
Remember Me Tokens: Long-lived authentication for user convenience
Brute-Force Protection: Automatic account locking after failed attempts

Architecture Highlights¶

flowchart TB
    A[Browser] --> B[Alpine.js + Tailwind CSS]
    B --> C[Flask Application]
    C --> D[Blueprint Architecture]

    D --> E1[Auth Blueprint]
    D --> E2[Dashboard Blueprint]
    D --> E3[Health Blueprint]
    D --> E4[AI Analysis Blueprint]
    D --> E5[Journey Blueprint]
    D --> E6[Diff Tool Blueprint]

    C --> F[Redis Cache]
    C --> G[(Camunda Database)]
    C --> H[(System Database)]

    C --> I[Google Gemini AI]
    C --> J[Camunda REST API]
    J --> K[Camunda Cluster Nodes]

    C --> L[Prometheus Metrics]
    L --> M[Grafana Dashboards]

    style C fill:#3f51b5,color:#fff
    style F fill:#ff6b6b
    style G fill:#4caf50
    style H fill:#4caf50
    style I fill:#ffa726
    style L fill:#536dfe

Hold "Alt" / "Option" to enable pan & zoom

Technology Stack¶

Layer	Technologies
Backend	Python 3.12, Flask, Gunicorn
Frontend	Alpine.js, Tailwind CSS, BPMN.js, DMN.js
Database	PostgreSQL 15+
Cache	Redis 7+
AI	Google Gemini (default)
Monitoring	Prometheus, Grafana
Deployment	Docker, Docker Compose

Performance Features¶

Intelligent Caching¶

Multi-Level Cache Strategy: Redis for sessions, query results, and AI responses
Smart TTL Management: Different TTL for static vs. dynamic data
Cache Warming: Preload critical data for faster response times
Selective Invalidation: Surgical cache updates on deployments

Optimized Queries¶

80+ Hand-Crafted SQL: Optimized for Camunda's schema structure
Parallel Execution: ThreadPoolExecutor for concurrent data fetching
Lazy Loading: Load data only when needed in the UI
Batch Processing: Efficient bulk operations for large datasets

Frontend Performance¶

Lazy-Loaded Components: Dashboard sections load on-demand
Code Splitting: Webpack bundles optimized per feature
Asset Minification: TerserPlugin with obfuscation for production
Service Worker Ready: Progressive web app capabilities

Getting Started¶

Prerequisites¶

Docker and Docker Compose (recommended)
OR Python 3.12+, Node.js 18+, PostgreSQL 15+, Redis 7+
Access to Camunda 7 database
Google Gemini API key (for AI features)

Quick Start with Docker¶

# Clone repository
git clone https://github.com/########/champa-intelligence.git
cd champa-intelligence

# Configure environment
cp .env.example .env
# Edit .env with your settings

# Build and start
docker-compose -f docker-compose.server.yml up -d

# Initialize database
docker exec champa-intelligence python -c "from db import init_auth_db; init_auth_db()"

# Access application
open http://localhost:8088

Default credentials: admin / admin (change immediately!)

For detailed installation instructions, see Installation Guide.

Documentation Structure¶

📖 Getting Started¶

Learn how to install, configure, and deploy Champa Intelligence in your environment.

⚡ Features¶

Detailed guides for each platform feature with screenshots and use cases.

🏗️ Architecture¶

Deep dive into system design, database schema, caching, and security model.

🔌 API Reference¶

Complete REST API documentation with request/response examples and authentication.

🔐 Administration¶

User management, role configuration, and system administration guides.

💻 Development¶

Contributing guidelines, project structure, and development environment setup.

🚀 Deployment¶

Production deployment, Docker configuration, monitoring, and troubleshooting.

Support & Community¶

Website: champa-bpmn.com
Email: info@champa-bpmn.com
Documentation: You're reading it! 📚

License¶

Champa Intelligence is proprietary software. See LICENSE.md for details.