Workspace identity
Every request carries the active user, role, organization, and project context.
Security and governance
AurigaTrace keeps project data, user access, upload evidence, parser outputs, AI-assisted drafting, and report approvals inside explicit engineering control boundaries.
RBAC
project access
AI-safe
controlled context
audit
evidence trail
Governance architecture
User and role
identity headers, future SSO/Cognito path
Project evidence
uploads, jobs, statistics, findings
Report review
drafts, approvals, artifact references
AI context
stored summaries, prompt metadata, request log
Governance model
Security is part of the analysis workflow. A finding or report should show the project boundary, source file, parser run, statistics, rules, AI draft metadata, and reviewer action that produced it.
Every request carries the active user, role, organization, and project context.
Vehicle programs and validation campaigns keep uploads, rules, findings, and reports separate.
Upload sessions register file metadata before raw test evidence enters object storage.
Processing jobs preserve parser identity, format capability, state, and generated statistics.
Findings, reports, and AI drafts move through explicit engineering review states.
Operational actions, report generation, and AI requests stay traceable for governance.
Control surfaces
Scope work by organization, project, and role so validation, diagnostics, calibration, and platform users operate inside the right boundary.
Keep raw files, registered log records, processed statistics, rules, findings, reports, and AI request logs in distinct system records.
AI narrative drafting uses stored statistics, findings, and reviewed context rather than unrestricted raw log files.
The upload workflow creates traceable sessions and file registry rows before analysis jobs process the evidence.
Deployment controls separate application runtime, image publishing, database credentials, upload storage, and operational observability.
Reports are generated from approved evidence and can be tied back to project, log file, parser run, findings, and AI draft metadata.
Evidence lineage
The platform records the relationship between projects, uploads, parsers, signal statistics, rule results, AI context, and generated report artifacts so engineers can re-check decisions after a test campaign changes.
Raw evidence is preserved, AI sees controlled summaries, and reviewers approve conclusions before they become report evidence.
Audit console
| Event | Actor | Evidence | State |
|---|---|---|---|
| project.created | Validation Engineer | program boundary | approved |
| upload.registered | Upload Center | source file + size | traceable |
| parser.completed | Processing Job | parser id + version | stored |
| rules.evaluated | Rule Engine | threshold evidence | review |
| ai.draft.created | AI Assistant | context hash | controlled |
| report.generated | Reports | findings + narrative | attached |
AWS-backed operating controls
The deployment model separates image promotion, application runtime, object storage, relational metadata, secrets, and AI provider access so the platform can mature without mixing operational privileges with test evidence.
| Control | Implementation | Evidence |
|---|---|---|
| Identity | User and role headers now; SSO/Cognito-ready contract later | identity log |
| Deployment | GitHub Actions OIDC promotes container images to AWS | OIDC path |
| Runtime | FastAPI service boundary with environment-scoped configuration | health/version |
| Storage | S3 raw object storage separated from relational metadata | file lineage |
| Database | RDS PostgreSQL holds tenant-scoped engineering records | tenant keys |
| Secrets | Application secrets isolated from UI and report artifacts | secret scope |
| AI | Provider requests built from approved stored context | AI request log |
AI provenance
Claude draft requests are governed by stored platform context. Prompt metadata and request logs make the draft explainable before it is attached to an engineering report.
Project metadata
Processed statistics
Rule findings
Prompt version
Context hash
Draft review
Report reference
Inspect projects, uploaded logs, parser jobs, rules, findings, reports, AI drafts, and operational status from one controlled workspace.