How mdresch/adpa works
ADPA is an enterprise document-processing and project-management platform. The main user journey is to organize work in a project, select a template, generate standards-aligned documentation with AI, then manage versions and connect documents to enterprise systems. The product also includes search and context retrieval, portfolio and governance workflows, digital twins, and operational analytics. The graph reflects README capabilities and the sampled frontend, backend, and orchestration code; several documented subsystems are represented at their tree-level entry points because their implementation was not sampled.
Main entry points: contextRetrievalService.ts Context retrieval · document-library-workspace.tsx Document library · route.ts Document generation · RitualController.cs Governance rituals
Components 26
Project workspace
- Project management
app/projects/projects-workspace.tsx - Project API
app/api/projects/route.ts - Project workspace
app/projects/[id]/components/project-workspace.tsx - Portfolio planning
app/portfolio/page.tsx
Document lifecycle
- Document library
app/documents/document-library-workspace.tsx - Document upload
app/api/documents/upload/route.ts - Document generation
app/api/generate/route.ts - Template management
app/templates/page.tsx - Document viewing
components/documents/DocumentViewer.tsx
AI and retrieval
- AI provider orchestration
server/src/services/aiService.ts - Chat endpoint
app/api/chat/route.ts - Context retrieval
server/src/modules/contextRetrieval/contextRetrievalService.ts - Keyword search
server/src/modules/contextRetrieval/engines/keywordSearchEngine.ts - RAG endpoints
server/src/routes/ragRoutes.ts
Integrations and governance
- Enterprise integrations
app/integrations/integrations-workspace.tsx - Digital twins
app/(dashboard)/digital-twin/page.tsx - Twin trigger rules
components/digital-twin/DigitalTwinTriggerRulesManager.tsx - Governance rituals
orchestrator/Adpa.Orchestrator/Controllers/RitualController.cs - Governance ledger
orchestrator/Adpa.Orchestrator/Data/GovernanceDbContext.cs
Monitoring and orchestration
- Analytics dashboard
app/analytics/page.tsx - Pipeline dashboard
app/process-flow/visual-pipeline/components/PipelineDashboard.tsx - Pipeline API client
app/process-flow/visual-pipeline/hooks/usePipelineAPI.ts - Review scheduling
server/src/routes/reviewRoutes.ts - PostgreSQL access
server/src/database/connection.ts
Other components
- Organization user
- Enterprise services
Connections 27
- Organization user → Project management: organizes work
README.md - Project management → Project API: loads projects
app/api/projects/route.ts - Organization user → Project workspace: manages project
README.md - Organization user → Document library: manages documents
README.md - Document library → Document upload: uploads files
README.md - Organization user → Template management: selects templates
README.md - Organization user → Document generation: requests generation
README.md - Document generation → AI provider orchestration: generates content
- Chat endpoint → Context retrieval: retrieves context
- Context retrieval → Keyword search: runs keyword search
server/src/modules/contextRetrieval/contextRetrievalService.ts - Context retrieval → PostgreSQL access: queries data
server/src/modules/contextRetrieval/contextRetrievalService.ts - RAG endpoints → Context retrieval: serves retrieval
- Document generation → Document viewing: produces documents
- Document library → Enterprise integrations: publishes or syncs
- Organization user → Enterprise integrations: configures integrations
README.md - Organization user → Portfolio planning: plans portfolio
README.md - Organization user → Digital twins: manages twins
- Digital twins → Twin trigger rules: manages rules
components/digital-twin/DigitalTwinTriggerRulesManager.tsx - Organization user → Governance rituals: reviews governance
- Governance rituals → Governance ledger: persists ledger
orchestrator/Adpa.Orchestrator/Controllers/RitualController.cs - Governance rituals → Enterprise services: checks governance
- Organization user → Analytics dashboard: monitors activity
README.md - Analytics dashboard → Pipeline dashboard: shows pipeline status
- Pipeline dashboard → Pipeline API client: requests job data
- Pipeline API client → Enterprise services: calls pipeline API
app/process-flow/visual-pipeline/hooks/usePipelineAPI.ts - Review scheduling → PostgreSQL access: checks programs
server/src/routes/reviewRoutes.ts - Enterprise services → Enterprise integrations: connects external tools
README.md