How ghilhermealves/crm works
This is a multi-service CRM: users enter through a Next.js interface and an OIDC gateway, then use backend CRM capabilities for sales, customer records, files, analytics, and AI assistance. The graph preserves the README’s major product branches and sampled implementation links. Many backend modules are represented by their exact enclosing directories because their source was not sampled; those relationships are omitted unless documented or evidenced by excerpts.
Main entry points: src CRM interface · auth OIDC gateway · crm CRM API · StorageService.java File storage
Components 21
User experience
- CRM interface
frontend-refine/src - Pipeline interface
frontend-refine/src/features/sales/pipeline/hooks/usePipelines.ts - Storage interface
frontend-refine/src/features/masterdata/storage/hooks/useStorage.ts
Identity and access
- OIDC gateway
auth-service/src/main/java/com/becommerce/auth - User resolution
auth-service/src/main/java/com/becommerce/auth/application/identity/service/CurrentUserResolutionService.java
CRM operations
- CRM API
backend/src/main/java/com/becommerce/crm - Sales pipeline
backend/src/main/java/com/becommerce/crm/sales/pipeline/application/service/PipelineService.java - Pipeline API
backend/src/main/java/com/becommerce/crm/sales/pipeline/web/PipelineController.java - File storage
backend/src/main/java/com/becommerce/crm/masterdata/storage/application/service/StorageService.java - Omnichannel messaging
backend/src/main/java/com/becommerce/crm/communication/omnichannel - Billing
backend/src/main/java/com/becommerce/crm/billing
Insights and automation
- Customer 360
backend/src/main/java/com/becommerce/crm/analytics/customer360 - Analytics
backend/src/main/java/com/becommerce/crm/analytics/reporting - Dashboard
backend/src/main/java/com/becommerce/crm/analytics/dashboard - Audit trail
backend/src/main/java/com/becommerce/crm/analytics/audit/application/service/TenantAuditRecorder.java - AI assistant
backend/src/main/java/com/becommerce/crm/automation/ai/application/service
Other components
- CRM user
- Keycloak
- PostgreSQL
- Redis
- MinIO storage
Connections 19
- CRM user → CRM interface: uses
- CRM interface → OIDC gateway: authenticates through
- OIDC gateway → Keycloak: uses OIDC
- OIDC gateway → CRM API: relays requests
- CRM API → PostgreSQL: uses
- OIDC gateway → Redis: uses rate limiting
- OIDC gateway → User resolution: resolves users
auth-service/src/main/java/com/becommerce/auth/application/gateway/service/GatewayOidcService.java - CRM API → Pipeline API: serves pipeline routes
backend/src/main/java/com/becommerce/crm/sales/pipeline/web/PipelineController.java - Pipeline API → Sales pipeline: delegates to
backend/src/main/java/com/becommerce/crm/sales/pipeline/web/PipelineController.java - Pipeline interface → CRM interface: forms sales UI
frontend-refine/src/features/sales/pipeline/hooks/usePipelines.ts - Storage interface → CRM API: uses storage API
- File storage → MinIO storage: stores files
- File storage → Audit trail: records changes
backend/src/main/java/com/becommerce/crm/masterdata/storage/application/service/StorageService.java - Sales pipeline → Audit trail: records changes
backend/src/main/java/com/becommerce/crm/sales/pipeline/application/service/PipelineService.java - AI assistant → Customer 360: builds customer context
backend/src/main/java/com/becommerce/crm/automation/ai/application/service/AiContextualAnalysisService.java - CRM interface → Omnichannel messaging: uses messaging
- CRM interface → Billing: uses billing
- CRM interface → Analytics: views reports
- CRM interface → Dashboard: views metrics