Compliance

Represents administrative deadlines and regulatory compliance tracking for documents, certificates, or authorizations that have expiration dates and require renewal or verification. Compliance is a reusable entity that can be referenced by any document type (identity documents, driving licenses, professional certifications, permits, contracts) to centralize expiration tracking and audit trails. This design enables unified compliance dashboards across all types of administrative obligations without requiring inheritance. Each compliance record tracks validity periods, issuing authority, and lifecycle status independently.

11 properties
Schema

Properties

PropertyTypeModeDescriptionRequired
referencestring
stored

Official reference number or identifier of the document/certificate

Example: "DL-2024-123456"

Optional
issueDateDate
stored

Date when the document/certificate was issued

Example: "2020-01-15"

Optional
expirationDateDate
stored

Date when the document/certificate expires and requires renewal

Example: "2030-01-14"

Optional
issuingAuthoritystring
stored

Name of the authority or organization that issued the document

Example: "Department of Motor Vehicles"

Optional
issuingCountryCountry
stored

Country where the document was issued

Optional
statusstring
stored

Current lifecycle status of the compliance item

Values: active, expired, pending-renewal, revoked, suspended

Example: "active"

Optional
notesstring
stored

Additional notes or comments about this compliance item

Optional
metadatajson
stored

Additional structured data specific to the compliance type

Optional
isExpiredboolean
calculated

Whether the document has passed its expiration date

Optional
daysUntilExpirationnumber
calculated

Number of days remaining until expiration (negative if expired)

Optional
isValidboolean
calculated

Whether the document is currently valid (issued and not expired)

Optional

Examples

Example 1

{
  "@type": "Compliance",
  "reference": "PASS-533456789",
  "issueDate": "2020-01-15",
  "expirationDate": "2030-01-14",
  "issuingAuthority": "HM Passport Office",
  "issuingCountry": {
    "@type": "Country",
    "code": "GB",
    "name": "United Kingdom"
  },
  "status": "active"
}

Example 2

{
  "@type": "Compliance",
  "reference": "CDL-987654321",
  "issueDate": "2022-03-01",
  "expirationDate": "2025-03-01",
  "issuingAuthority": "Department of Motor Vehicles",
  "issuingCountry": {
    "@type": "Country",
    "code": "US",
    "name": "United States"
  },
  "status": "active",
  "notes": "Commercial driver license - medical certificate required"
}