L0 Base Data Types

Foundational types and enumerations that all other modules build upon. These define the primitive data structures for money, people, accounts, and legal references.

Core Types

Money

Precise decimal representation of monetary values. Handles currency, rounding rules, and arithmetic operations without floating-point errors.

src/isa95/L0_Data/types/Money.js

          const amount = Money.from("1234.56", "USD");

          amount.add(Money.from("100.00"));

          // → $1,334.56

Person

Represents any individual: employee, vendor contact, elected official, citizen. Includes name, contact info, and role references.

src/isa95/L0_Data/types/Person.js

Name Contact Roles Identifiers

Account

Chart of accounts entry. Fund, department, object code structure per PA county accounting standards. Supports hierarchical rollups.

src/isa95/L0_Data/types/Account.js

Fund Department Object Code Hierarchy

LegalReference

Citation to PA Code, Home Rule Charter, or other legal authority. Supports section, subsection, and paragraph granularity.

src/isa95/L0_Data/types/LegalReference.js

          const ref = LegalReference.paCode("16", "1720");

          // → Title 16, §1720 (Controller duties)

DateRange

Fiscal period representation. Handles fiscal years, quarters, months. Supports overlap detection and period arithmetic.

src/isa95/L0_Data/types/DateRange.js

Fiscal Year Quarters Overlap

Address

Physical and mailing address with PA-specific validation. Supports Northampton County municipalities and zip codes.

src/isa95/L0_Data/types/Address.js

Street Municipality Zip Validation

Document

Reference to supporting documentation: contracts, invoices, receipts. Includes metadata, retention schedule, and access controls.

src/isa95/L0_Data/types/Document.js

Metadata Retention Access

Enumerations

ClaimStatus

All possible states for a claim: DRAFT, SUBMITTED, UNDER_REVIEW, APPROVED, REJECTED, PAID, VOIDED.

src/isa95/L0_Data/enums/ClaimStatus.js

DRAFT SUBMITTED APPROVED PAID

AuditType

Categories of audits: FINANCIAL, COMPLIANCE, PERFORMANCE, SPECIAL, FOLLOW_UP per Government Auditing Standards.

src/isa95/L0_Data/enums/AuditType.js

FINANCIAL COMPLIANCE PERFORMANCE

FindingSeverity

Audit finding severity levels: MATERIAL_WEAKNESS, SIGNIFICANT_DEFICIENCY, CONTROL_DEFICIENCY, OBSERVATION.

src/isa95/L0_Data/enums/FindingSeverity.js

MATERIAL SIGNIFICANT DEFICIENCY

FundType

Governmental fund types: GENERAL, SPECIAL_REVENUE, CAPITAL_PROJECTS, DEBT_SERVICE, ENTERPRISE, INTERNAL_SERVICE.

src/isa95/L0_Data/enums/FundType.js

GENERAL SPECIAL CAPITAL ENTERPRISE

JSON Schemas

claim.schema.json

JSON Schema for claim validation. Enforces required fields, data types, and business rules before persistence.

src/isa95/L0_Data/schemas/claim.schema.json

Validation Required Fields Business Rules

warrant.schema.json

JSON Schema for warrant validation. Ensures proper authorization chain and required signatures.

src/isa95/L0_Data/schemas/warrant.schema.json

Authorization Signatures Chain

audit.schema.json

JSON Schema for audit engagement records. Validates scope, timeline, and finding structure.

src/isa95/L0_Data/schemas/audit.schema.json

Scope Timeline Findings