How andresilvaaaa/product_hub_crm works
Operations Hub is a workspace-based operations platform for software houses, with an admin dashboard and a client portal. The central business workflow moves from commercial leads and quotes through contract preparation/signing, project delivery, and invoicing; client-facing review and portal access support that workflow. The API also provides identity, platform subscriptions/usage controls, notifications, integrations, AI and agent access. Edges are limited to relationships shown in the README or source index; optional or unsampled connections are dashed and unverified.
Main entry points: main.py API application · service.py Contracts and signing · database.py SQL database · financial_fulfillment_service.py Invoices and payments
Components 22
Web Experience
- Admin dashboard
apps/web/src/app/(dashboard)/dashboard/page.tsx - Client portal
apps/web/src/app/(portal)/portal/dashboard/page.tsx
Commercial Operations
- CRM and leads
apps/api/app/modules/crm/service.py - Service catalog
apps/api/app/modules/catalog/service.py - Quotes and review
apps/api/app/modules/commercial/service.py - Contracts and signing
apps/api/app/modules/contracts/service.py
Delivery and Billing
- Project delivery
apps/api/app/modules/projects/service.py - Scope and tasks
apps/api/app/modules/projects/scope_service.py - File storage
apps/api/app/modules/documents/file_storage.py - Invoices and payments
apps/api/app/modules/billing/financial_fulfillment_service.py
Platform Services
- API application
apps/api/app/main.py - Identity and access
apps/api/app/modules/identity/service.py - SQL database
apps/api/app/infrastructure/database.py - Notifications
apps/api/app/modules/notifications/service.py - Audit and outbox
apps/api/app/modules/audit/models.py - Platform billing
apps/api/app/modules/platform/billing_service.py
AI and Integrations
- AI capabilities
apps/api/app/modules/ai/service.py - MCP agent access
apps/api/app/mcp/server.py - Agent channels
apps/api/app/channels/service.py - Calendar integration
apps/api/app/modules/meetings/google_calendar.py
Other components
- Workspace staff
- Client users
Connections 28
- Workspace staff → Admin dashboard: uses
- Client users → Client portal: uses
- Admin dashboard → API application: requests
- Client portal → API application: requests
- API application → Identity and access: routes
apps/api/app/main.py - API application → CRM and leads: routes
apps/api/app/main.py - API application → Quotes and review: routes
apps/api/app/main.py - API application → Contracts and signing: routes
apps/api/app/main.py - API application → Invoices and payments: routes
apps/api/app/main.py - API application → SQL database: opens sessions
apps/api/app/infrastructure/database.py - CRM and leads → SQL database: persists records
- Service catalog → SQL database: persists catalog
- Quotes and review → Contracts and signing: prepares contract
apps/api/app/modules/contracts/service.py - Quotes and review → Audit and outbox: records review
- Contracts and signing → Project delivery: fulfills agreement
apps/api/app/modules/projects/service.py - Contracts and signing → Invoices and payments: creates invoices
apps/api/app/modules/billing/financial_fulfillment_service.py - Project delivery → Scope and tasks: manages scope
apps/api/app/modules/projects/service.py - Invoices and payments → Project delivery: activates project
apps/api/app/modules/billing/financial_fulfillment_service.py - Invoices and payments → Notifications: notifies customers
- Notifications → Audit and outbox: records events
apps/api/app/modules/notifications/service.py - Platform billing → Notifications: sends notices
apps/api/app/modules/platform/billing_service.py - AI capabilities → Contracts and signing: uses contract data
apps/api/app/modules/ai/service.py - AI capabilities → Project delivery: uses project data
apps/api/app/modules/ai/service.py - MCP agent access → Identity and access: checks agent access
apps/api/app/mcp/server.py - MCP agent access → SQL database: opens sessions
apps/api/app/mcp/server.py - Agent channels → AI capabilities: dispatches requests
- Calendar integration → API application: syncs meetings
- File storage → SQL database: stores metadata