How haseebulhaque/apbra works
APBRA is a bounded Power BI report-generation prototype. A business user creates a case, provides a requirement and optional schema/evidence, clarifies and confirms material meaning, then receives a validated candidate or an explicit blocked/review state. The web app coordinates the workflow; the API provides protected case lifecycle, persistence, model access and private artifacts. The README documents the end-to-end generation stages, while source-index references support selected module links; unsampled implementation details are not inferred.
Main entry points: EnterpriseApp.tsx Case workspace · application.py Application services · api.py API routes · authorization.py Case authorization
Components 23
Business workspace
- Case workspace
apps/web/src/EnterpriseApp.tsx - Private cases
apps/web/src/privateCases.tsx - API client
apps/web/src/api.ts
Report generation
- Schema ingestion
apps/web/src/schemaIngestion.ts - Clarification
apps/web/src/clarification.ts - Confirmed contract
apps/web/src/confirmedRequirements.ts - Governed RAG
apps/web/src/rag.ts - Report design
apps/web/src/foundry.ts - Design normalization
apps/web/src/reportDesignNormalization.ts - Design guardrails
apps/web/src/guardrail.ts - PBIP compiler
apps/web/src/genericPowerBI.ts - Deployment guide
apps/web/src/deploymentGuide.ts
API and identity
- API routes
apps/api/src/apbra_api/api.py - Application services
apps/api/src/apbra_api/application.py - Case authorization
apps/api/src/apbra_api/authorization.py - OIDC adapter
apps/api/src/apbra_api/oidc_adapter.py - Model provider
apps/api/src/apbra_api/model_provider.py - Evidence handling
apps/api/src/apbra_api/evidence.py
Persistence and artifacts
- SQL persistence
apps/api/src/apbra_api/persistence.py - Private evidence store
apps/api/src/apbra_api/evidence.py - Private artifact store
apps/api/src/apbra_api/artifacts.py
Other components
- Business user
- Administrator
Connections 25
- Business user → Case workspace: uses
README.md - Administrator → Case workspace: administers
README.md - Case workspace → Private cases: opens
apps/web/src/EnterpriseApp.tsx - Case workspace → Schema ingestion: ingests schema
apps/web/src/EnterpriseApp.tsx - Case workspace → Clarification: coordinates
apps/web/src/EnterpriseApp.tsx - Case workspace → Confirmed contract: confirms meaning
apps/web/src/EnterpriseApp.tsx - Case workspace → Governed RAG: retrieves knowledge
apps/web/src/EnterpriseApp.tsx - Case workspace → Report design: requests design
apps/web/src/EnterpriseApp.tsx - Case workspace → Design normalization: normalizes
apps/web/src/EnterpriseApp.tsx - Case workspace → Design guardrails: evaluates
apps/web/src/EnterpriseApp.tsx - Case workspace → PBIP compiler: compiles candidate
apps/web/src/EnterpriseApp.tsx - Case workspace → Deployment guide: offers guidance
apps/web/src/EnterpriseApp.tsx - Private cases → API client: calls
apps/web/src/privateCases.tsx - API client → API routes: sends requests
README.md - API routes → Application services: dispatches
apps/api/src/apbra_api/api.py - API routes → Case authorization: resolves access
apps/api/src/apbra_api/api.py - API routes → OIDC adapter: uses identity
apps/api/src/apbra_api/api.py - Application services → SQL persistence: reads and writes
apps/api/src/apbra_api/application.py - Application services → Model provider: requests model calls
apps/api/src/apbra_api/application.py - Application services → Evidence handling: handles evidence
apps/api/src/apbra_api/application.py - Evidence handling → Private evidence store: stores evidence
README.md - Application services → Private artifact store: stores candidates
README.md - Application services → Case authorization: checks case access
apps/api/src/apbra_api/application.py - OIDC adapter → SQL persistence: resolves identity
apps/api/src/apbra_api/oidc_adapter.py - Case authorization → SQL persistence: queries access
apps/api/src/apbra_api/authorization.py