CreditAudit

The governance audit attached to a Project (a “credit”): five gate outcomes, a lineage checklist, an overall verdict and partner sign-off.

Purpose

Before a credit is released, it passes through five gates — mandate, scorecard, working file, artifacts and release. This record holds the status and rationale for each gate, a set of lineage assertions about how the work was produced, and the final verdict. Individual findings are recorded as exceptions, and deliberate limits of scope as abstentions.

Usage

Maintained by staff through the Filament project resource and read by the governance service.

app/Services/GovernanceAuditService.php — assembles audit data for the governance view
app/Filament/Resources/ProjectResource/Actions/EditProjectCreditAuditExceptionsAction.php — edits exceptions
app/Filament/Resources/ProjectResource/Actions/EditProjectCreditAuditAbstentionsAction.php — edits abstentions
app/Models/Project.php — declares the inverse relation

Relationships

Relation	Type	Related model
`project`	`belongsTo`	Project
`exceptions`	`hasMany`	CreditAuditException
`abstentions`	`hasMany`	CreditAuditAbstention
`approvingPartner`	`belongsTo`	User

Data shape

Table: credit_audits

Column	Type	Notes
`id`	`uuid`	Primary key
`project_id`	`uuid`	FK `projects`, cascade delete
`verdict_status`	`CreditAuditVerdict`	Nullable, `cleared` or `hold_for_release`
`verdict_description`	`text`	Nullable
`gate_1_status` … `gate_5_status`	`CreditAuditGateStatus`	not_reached, cleared, open_item, blocking
`gate_1_description` … `gate_5_description`	`text`	Nullable
`scale_abstention_description`	`text`	Nullable
`corroboration_description`	`text`	Nullable
`lineage_source_snapshot_captured`	`boolean`	Default false
`lineage_evidence_object_ledger_finalised`	`boolean`	Default false
`lineage_pillar_outputs_validated`	`boolean`	Default false
`lineage_priority_targets_assigned`	`boolean`	Default false
`lineage_focus_profiles_approved`	`boolean`	Default false
`lineage_client_release_approved`	`boolean`	Default false
`signoff_status`	`CreditAuditSignOffStatus`	Nullable, `withheld` or `cleared`
`signoff_approving_partner_id`	`uuid`	Nullable, FK `users`, null on delete
`signoff_release_date`	`date`	Nullable
`signoff_auditors_note`	`text`	Nullable
`created_at`, `updated_at`	`timestamp`	Nullable