How nossairaa/auditsphere works
AuditSphere is an internal-audit platform spanning mission planning, risk/control evidence, findings and independent validation, then corrective actions through verification and closure. Users work through the Next.js BFF, which preserves tokens server-side before calling the gateway and services. The graph follows documented service responsibilities and sampled calls; several links between domain stages and unsampled capabilities are documented in the README and are shown with README evidence. Detailed browser-to-BFF and gateway routing beyond the README are not sampled.
Main entry points: MissionController.java Mission lifecycle · Remediation.java Corrective actions · GatewayApplication.java API gateway · NotificationController.java Notifications
Components 28
Web application
- Next.js workspace
apps/web/src/app - BFF API
apps/web/src/app/api - OIDC session
apps/web/src/lib/auth.ts
Audit service
- Mission lifecycle
services/audit-service/src/main/java/com/auditsphere/audit/MissionController.java - Mission records
services/audit-service/src/main/java/com/auditsphere/audit/Mission.java - Audit programs
services/audit-service/src/main/java/com/auditsphere/audit/AuditProgramController.java - Auditor directory
services/audit-service/src/main/java/com/auditsphere/audit/AuditorDirectory.java - Controls and evidence
services/audit-service/src/main/java/com/auditsphere/audit/ControlEvidenceController.java - Evidence object store
services/audit-service/src/main/java/com/auditsphere/audit/EvidenceStore.java - Findings
services/audit-service/src/main/java/com/auditsphere/audit/FindingController.java - Audit history
services/audit-service/src/main/java/com/auditsphere/audit/MissionActionLog.java - Independent review
services/audit-service/src/main/java/com/auditsphere/audit/workflow/ReviewWorkflow.java
Remediation service
- Corrective actions
services/remediation-service/src/main/java/com/auditsphere/remediation/Remediation.java - Action management
services/remediation-service/src/main/java/com/auditsphere/remediation/ActionController.java - Follow-up verification
services/remediation-service/src/main/java/com/auditsphere/remediation/FollowUpController.java - Action attachments
services/remediation-service/src/main/java/com/auditsphere/remediation/AttachmentController.java - Attachment store
services/remediation-service/src/main/java/com/auditsphere/remediation/AttachmentStore.java
Events and workflow
- Review worker
services/audit-service/src/main/java/com/auditsphere/audit/workflow/ReviewWorker.java - Temporal
- Assignment events
services/audit-service/src/main/java/com/auditsphere/audit/AssignmentOutbox.java - Kafka
- Notifications
services/notification-service/src/main/java/com/auditsphere/notification/NotificationController.java - Live notification stream
services/notification-service/src/main/java/com/auditsphere/notification/NotificationStream.java
API and identity
- API gateway
services/api-gateway/src/main/java/com/auditsphere/gateway/GatewayApplication.java - Keycloak
- Service PostgreSQL
- Private S3 storage
Other components
- Audit team
Connections 33
- Audit team → Next.js workspace: uses
README.md - Next.js workspace → BFF API: requests
README.md - BFF API → OIDC session: checks session
apps/web/src/app/api/session/route.ts - OIDC session → Keycloak: OIDC login
README.md - BFF API → API gateway: forwards JWT
README.md - API gateway → Mission lifecycle: routes requests
README.md - API gateway → Corrective actions: routes requests
README.md - API gateway → Notifications: routes requests
README.md - Mission lifecycle → Mission records: reads and writes
services/audit-service/src/main/java/com/auditsphere/audit/MissionController.java - Mission lifecycle → Auditor directory: validates users
services/audit-service/src/main/java/com/auditsphere/audit/MissionController.java - Audit programs → Mission records: reads and writes
services/audit-service/src/main/java/com/auditsphere/audit/AuditProgramController.java - Controls and evidence → Evidence object store: stores evidence
services/audit-service/src/main/java/com/auditsphere/audit/ControlEvidenceController.java - Mission lifecycle → Controls and evidence: includes controls
README.md - Mission lifecycle → Findings: governs findings
README.md - Findings → Audit history: records changes
README.md - Mission lifecycle → Audit history: records actions
services/audit-service/src/main/java/com/auditsphere/audit/MissionController.java - Mission lifecycle → Independent review: submits review
README.md - Independent review → Temporal: starts durable workflow
README.md - Review worker → Temporal: runs workflows
services/audit-service/src/main/java/com/auditsphere/audit/workflow/ReviewWorker.java - Findings → Corrective actions: synchronizes issues
README.md - Action management → Corrective actions: uses action scope
services/remediation-service/src/main/java/com/auditsphere/remediation/ActionController.java - Follow-up verification → Corrective actions: checks scope
services/remediation-service/src/main/java/com/auditsphere/remediation/FollowUpController.java - Action attachments → Corrective actions: authorizes action
services/remediation-service/src/main/java/com/auditsphere/remediation/AttachmentController.java - Action attachments → Attachment store: reads and writes
services/remediation-service/src/main/java/com/auditsphere/remediation/AttachmentController.java - Mission lifecycle → Assignment events: records outbox
README.md - Assignment events → Kafka: publishes events
README.md - Kafka → Notifications: delivers events
README.md - Notifications → Live notification stream: subscribes clients
services/notification-service/src/main/java/com/auditsphere/notification/NotificationController.java - Mission lifecycle → Service PostgreSQL: persists domain state
README.md - Corrective actions → Service PostgreSQL: persists domain state
README.md - Notifications → Service PostgreSQL: reads notification state
README.md - Evidence object store → Private S3 storage: stores objects
README.md - Attachment store → Private S3 storage: stores objects
README.md