How sourabhbarwal/idp works
IDP is a self-service developer portal: engineers use the React dashboard to register services, scaffold repositories, deploy workloads, and inspect operational health. The backend separates these capabilities into HTTP services; the README documents shared gateway routing and observability, while sampled sources confirm key request handlers and the Copilot’s live context calls. Some README-listed subsystems have no sampled implementation excerpts, so their documented capabilities are represented without speculative internal wiring.
Main entry points: api-client.ts API client · platform-context.service.ts Platform context · alerts.controller.ts Alert rules and events · copilot.controller.ts Copilot chat
Components 31
Developer portal
- React dashboard
frontend/src/App.tsx - API client
frontend/src/lib/api-client.ts - Nginx gateway
- Sign in / register
frontend/src/pages/auth/LoginPage.tsx - Service catalog UI
frontend/src/pages/catalog/ServiceListPage.tsx - AI Copilot UI
frontend/src/pages/copilot/CopilotPage.tsx
Identity and catalog
- Auth and user API
backend/auth-service/src/infrastructure/web/auth.controller.ts - User administration
backend/auth-service/src/infrastructure/web/users.controller.ts - Service catalog API
backend/service-catalog-service/src/infrastructure/web/services.controller.ts - Catalog persistence
backend/service-catalog-service/src/infrastructure/persistence/repositories/service.repository.adapter.ts
Developer delivery
- Project templates
backend/template-service/src/application/use-cases/generate-template.use-case.ts - Repository provisioning
backend/repository-service/src/infrastructure/web/repositories.controller.ts - Deployment API
backend/deployment-service/src/infrastructure/web/deployments.controller.ts
Operations and insights
- Metrics queries
backend/monitoring-service/src/application/prometheus-query.service.ts - Log queries
backend/logging-service/src/application/loki-query.service.ts - Alert rules and events
backend/alert-service/src/infrastructure/web/alerts.controller.ts - Notifications
backend/notification-service/src/application/services/notification-dispatcher.service.ts - Audit queries
backend/audit-service/src/application/audit-query.service.ts - Cost analysis
backend/cost-service/src/application/cost-analysis.service.ts - DORA metrics
backend/dora-service/src/application/dora-metrics.service.ts - Copilot chat
backend/ai-copilot-service/src/infrastructure/web/copilot.controller.ts - Platform context
backend/ai-copilot-service/src/application/platform-context.service.ts
Platform services
- Realtime events
backend/realtime-service/src/infrastructure/websocket/events.gateway.ts - Shared PostgreSQL
Other components
- Developer
- GitHub
- Kubernetes
- Prometheus
- Loki
- AlertManager
- Groq AI
Connections 36
- Developer → React dashboard: uses
- React dashboard → API client: requests
- API client → Nginx gateway: sends HTTP
- Nginx gateway → Auth and user API: routes requests
- Nginx gateway → User administration: routes requests
- Nginx gateway → Service catalog API: routes requests
- Nginx gateway → Deployment API: routes requests
- Nginx gateway → Repository provisioning: routes requests
- Nginx gateway → Alert rules and events: routes requests
- Nginx gateway → Metrics queries: routes requests
- Nginx gateway → Log queries: routes requests
- Nginx gateway → Copilot chat: routes requests
- Nginx gateway → DORA metrics: routes requests
- Nginx gateway → Cost analysis: routes requests
- Nginx gateway → Audit queries: routes requests
- Sign in / register → API client: submits credentials
- Service catalog UI → API client: requests catalog
- AI Copilot UI → API client: sends chat
- Auth and user API → Shared PostgreSQL: stores identity data
- User administration → Shared PostgreSQL: reads user data
- Service catalog API → Catalog persistence: calls use cases
- Catalog persistence → Shared PostgreSQL: reads and writes
- Repository provisioning → GitHub: provisions repositories
- Deployment API → Kubernetes: manages deployments
- Metrics queries → Prometheus: queries metrics
- Log queries → Loki: queries logs
- AlertManager → Alert rules and events: posts webhook
- Alert rules and events → Notifications: dispatches alerts
- Audit queries → Shared PostgreSQL: queries audit schemas
- Copilot chat → Platform context: requests context
- Platform context → Alert rules and events: fetches active alerts
- Platform context → Cost analysis: fetches cost summary
- Platform context → Metrics queries: fetches service metrics
- Copilot chat → Groq AI: generates responses
- Realtime events → React dashboard: pushes events
- Project templates → Developer: returns project archive