/ontology → entity-types

PermitCase

Description

A single permit application + its lifecycle.

Instances

1,786,796

Properties

Declared Properties

Property	Type	Constraints	Description
Case Number case_number	`string`	requiredindexed	AHJ-assigned case identifier. e.g. B-2024-12345
Application Number application_number	`string`	indexed	Applicant-facing application ID. e.g. A-2024-00789
Permit Type permit_type	`string`	indexed	Building/Electrical/etc. e.g. Building
Project Type project_type	`string`	indexed	Classified project category. e.g. addition
Current Status current_status	`enum` Submitted \| Under Review \| Comments Issued +6	indexed	Latest case status. e.g. Under Review
Terminal Status terminal_status	`enum` Issued \| Denied \| Withdrawn +2	indexed	Final or current terminal state. e.g. Issued
Submitted At submitted_at	`datetime`	indexed	Date application submitted. e.g. 2024-06-12
Approved At approved_at	`datetime`		Date plan review approved. e.g. 2024-09-04
Issued At issued_at	`datetime`	indexed	Date permit issued. e.g. 2024-09-12
Denied At denied_at	`datetime`		Date case denied.
Closed At closed_at	`datetime`		Date case closed.
Total Review Days total_review_days	`integer`	indexed	Days from submitted to issued/denied. e.g. 92
Revision Count revision_count	`integer`	indexed	Number of plan revisions. e.g. 2
First Pass first_pass	`boolean`	indexed	True if issued without revisions. e.g. false
Applicant applicant	`string`	indexedevidence	Property owner name (public record). e.g. Jane Doe
Contractor contractor	`string`	indexedevidence	Licensed contractor name. e.g. ACME Construction LLC
Architect architect	`string`	indexedevidence	Architect or designer. e.g. Smith Architecture PC
Address address	`address`	indexedevidence	Project address (raw). e.g. 16 Delaware Ave
Normalized Address normalized_address	`address`	indexed	Normalized project address. e.g. 16 Delaware Ave, Jersey City, NJ
Block/Lot block_lot	`string`	indexed	Tax block-lot. e.g. 19602-38
Validation Tier validation_tier	`integer`	requiredindexed	1=extracted, 2=cross-confirmed, 3=human verified. e.g. 2
Confidence confidence	`decimal`		Extractor confidence 0-1. e.g. 0.92

Outgoing Edges (15)

AMENDMENT_OF

Child PermitCase amends a parent PermitCase (e.g. permit XXX+A amends XXX).

ASSOCIATED_WITH_ACTOR

A PermitCase/Decision is associated with an Actor (architect/contractor).

CO_OCCURS_WITH

Statistical co-occurrence of two entities (most often two Corrections).

FOLLOWED_BY

PermitCase A was filed before PermitCase B at the same Property. Materialized by graph_projector_followed_by; edge attributes include days_between + sequence_position.

GOVERNED_BY

An entity is governed by a code section.

HAS_OUTCOME

A PermitCase has a current/terminal Outcome.

HAS_PREDICTION

A PermitCase has zero or more Predictions (one per model version).

IMPACTED_BY_POLICY

An entity is governed by a Policy (zoning rule, historic overlay, etc).

LOCATED_IN

Entity is spatially located in another entity (AHJ, ZoningDistrict, Neighborhood, or Property).

PRECEDED

A entity preceded B in a timeline.

PROJECTED_FROM

Entity was projected from a fixture or raw doc.

REVIEWED_BY

A PermitCase, Project, Correction, or Decision was reviewed by a Department or ReviewerCluster.

SAME_PROPERTY_AS

Two PermitCases located at the same Property (canonical ordering: from < to). Materialized by graph_projector_same_property.

SIMILAR_TO

Statistical similarity (project↔project, AHJ↔AHJ).

VIOLATES

An entity violates a code section.

Incoming Edges (10)

← AMENDMENT_OF

Child PermitCase amends a parent PermitCase (e.g. permit XXX+A amends XXX).

← APPROVED_AFTER

A Decision came after a prior Decision/event in a chain.

← CO_OCCURS_WITH

Statistical co-occurrence of two entities (most often two Corrections).

← CONDITIONED_ON

An approval Decision was conditioned on something.

← FOLLOWED_BY

PermitCase A was filed before PermitCase B at the same Property. Materialized by graph_projector_followed_by; edge attributes include days_between + sequence_position.

← PRECEDED

A entity preceded B in a timeline.

← PREPARED_BY

Actor (architect/engineer/owner/applicant) prepared this PermitCase. Source: pg_doc_actor_projects.block_lot match.

← REQUIRES

A code section requires an entity / configuration.

← SAME_PROPERTY_AS

Two PermitCases located at the same Property (canonical ordering: from < to). Materialized by graph_projector_same_property.

← SIMILAR_TO

Statistical similarity (project↔project, AHJ↔AHJ).