L1 Transaction Layer

Individual work items that flow through the system: claims, warrants, audit findings, and payments. Each transaction is discrete, trackable, and can be cryptographically signed for integrity.

Claims

Claim

Base claim model representing any request for payment against the county. Includes vendor info, amount, supporting documentation references.

src/isa95/L1_Transactions/claims/Claim.js

Vendor Amount Documentation Status

ClaimWorkflow

State machine for claim processing: submitted → reviewed → approved/rejected → paid. Tracks all state transitions with timestamps.

src/isa95/L1_Transactions/claims/ClaimWorkflow.js

State Machine Transitions Audit Trail

Audits

AuditEngagement

Represents a single audit engagement with scope, timeline, and assigned personnel. Links to findings and final report.

src/isa95/L1_Transactions/audits/AuditEngagement.js

Scope Timeline Personnel

Finding

Individual audit finding with severity, recommendation, and management response tracking. Supports finding lifecycle management.

src/isa95/L1_Transactions/audits/Finding.js

Severity Recommendation Response

AuditReport

Final audit report aggregating findings, conclusions, and recommendations. Supports draft/final states and distribution tracking.

src/isa95/L1_Transactions/audits/AuditReport.js

Findings Conclusions Distribution

Payments

Warrant

Payment authorization document. Links approved claims to actual disbursement. Requires Controller signature per PA Code §1720.

src/isa95/L1_Transactions/payments/Warrant.js

Authorization Signature §1720

Disbursement

Actual payment record: check number, wire reference, or ACH transaction. Reconciles against warrant and bank statement.

src/isa95/L1_Transactions/payments/Disbursement.js

Check/Wire/ACH Reconciliation

PayrollRun

Batch payroll processing record. Aggregates individual employee payments, tax withholdings, and benefit deductions.

src/isa95/L1_Transactions/payments/PayrollRun.js

Batch Withholdings Deductions

Receipt

Incoming payment record. Tracks revenue from fees, taxes, grants, and other sources. Links to appropriate fund and account.

src/isa95/L1_Transactions/payments/Receipt.js

Revenue Fund Account

Signing

BlockchainSigner

Cryptographic signing for transaction integrity. Creates immutable audit trail using hash chains. Optional but recommended for high-value transactions.

src/isa95/L1_Transactions/signing/BlockchainSigner.js

Hash Chain Signatures Verification