Generate Table Models and schema

.env.example

@@ -1,4 +1,4 @@
-SQLALCHEMY_DATABASE_URI=sqilte+aiosqlite:///./firemsdata.db
+SQLALCHEMY_DATABASE_URI=sqlite+aiosqlite:///./database/firemsdata.db
 OPENAI_API_KEY=
 OPENAI_MODEL_NAME=
 CHROMA_COLLECTION_NAME=

alembic.ini

@@ -86,7 +86,7 @@ path_separator = os
 # database URL.  This is consumed by the user-maintained env.py script only.
 # other means of configuring database URLs may be customized within the env.py
 # file.
-sqlalchemy.url = driver://user:pass@localhost/dbname
+sqlalchemy.url = sqlite+aiosqlite:///./database/firemsdata.db
 
 
 [post_write_hooks]

alembic/versions/273997959ba7_add_6_models_in_database.py

@@ -0,0 +1,32 @@
+"""Add 6 models in database
+
+Revision ID: 273997959ba7
+Revises: 
+Create Date: 2026-03-13 11:51:55.126289
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = '273997959ba7'
+down_revision: Union[str, Sequence[str], None] = None
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    pass
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    pass
+    # ### end Alembic commands ###

data/rag_input_data/incidentpersonnel_columns_details.txt

@@ -1,656 +1,159 @@
-Column Name: incidentkey
-Description: The primary key for the incident table. This is a unique, system-generated 14-character identifier for every incident record. It serves as the fundamental link to all other related tables in the database, such as apparatus and personnel. This value is used to join with the incident table to get incident-level details.
+Column Name: personnelkey
+Description: Unique system-generated identifier for the personnel record associated with an incident. This serves as the primary key for the incident_personnel table and uniquely identifies a responder assigned to a specific incident.
 Data Type: char(14), NOT NULL
-Examples: _4GR15262U_SMS, _4GR15HZEC_SMS, _4GR166YT7_SMS
-
-Column Name: apparatuskey
-Description: The primary key for the apparatus table. This is a unique, system-generated 14-character identifier for a specific apparatus response to an incident. It serves as the primary link between apparatus response records and personnel assignments. It indicates which piece of equipment a person was assigned to for a given incident.
-Data Type: char(14), NOT NULL
-Examples: _4GR15265W_SMS, _4GR15HZF7_SMS, _4GR166YUI_SMS
-
-Column Name: pslid
-Description: A unique, system-generated identifier for an individual firefighter or personnel record. This key links a personnel record to their assignments in an incident. It is the primary identifier used to join with a master personnel table to retrieve static information like name and rank.
-Data Type: char(15), NOT NULL
-Examples: _1XL0XJ7VGDEFA, _26H0W4XBHCPAU, _2FW0KTEBFCPAU
-
-Column Name: personnelid
-Description: An employee or badge number assigned to the firefighter or personnel. This is a human-readable identifier, likely used for payroll, scheduling, or internal identification, and is distinct from the system-generated pslid.
-Data Type: int, NOT NULL
 Examples:
-219, 378, 390
+_4GR15265W_SMS, _4GR15HZF7_SMS
+
 
 Column Name: namefirst
-Description: The first name of the firefighter or personnel. The data shows it is stored with trailing spaces to pad the value to a fixed length.
+Description: The first name of the firefighter or personnel involved in the incident. The value may include trailing spaces because it is stored as a fixed-length field.
 Data Type: char(25), NOT NULL
 Examples:
 Dale, Brandon, Kyle
 
+
 Column Name: namemi
-Description: The middle initial of the firefighter or personnel. This field may contain a single character, a space, or be blank.
+Description: The middle initial of the firefighter or personnel. This field may contain a single character or may be empty.
 Data Type: char(2), NULL
 Examples:
 E, A, S
 
+
 Column Name: namelast
-Description: The last name of the firefighter or personnel. The data shows it is stored with trailing spaces to pad the value to a fixed length.
+Description: The last name of the firefighter or personnel assigned to the incident.
 Data Type: char(25), NOT NULL
 Examples:
 Bryan, Davis, Coles
 
+
 Column Name: namesuffix
-Description: A suffix for the personnel's name (e.g., Jr., Sr., III). This field is entirely NULL in the provided data sample.
+Description: Optional suffix associated with the personnel name such as Jr., Sr., or III.
 Data Type: char(5), NULL
 Examples:
-NULL, NULL, NULL
-
-Column Name: namefirstlast
-Description: A concatenated string of the personnel's first and last name in "First Last" format (e.g., "Dale Bryan"). This is likely a pre-processed field for reporting or display purposes.
-Data Type: varchar(51), NOT NULL
-Examples:
-Dale Bryan, Brandon Davis, Kyle Coles
+Jr, Sr, III
 
-Column Name: namelastfirst
-Description: A concatenated string of the personnel's last and first name in "Last, First" format (e.g., "Bryan, Dale"). This is likely a pre-processed field for reporting or display purposes, such as in lists sorted by last name.
-Data Type: varchar(51), NOT NULL
-Examples:
-Bryan, Dale, Davis, Brandon, Coles, Kyle
-
-Column Name: namefull
-Description: The full name of the personnel, including first name, middle initial, and last name (e.g., "Dale E Bryan"). This is likely a pre-processed field for display purposes.
-Data Type: varchar(77), NOT NULL
-Examples:
-Dale E Bryan, Brandon A Davis, Kyle S Coles
 
 Column Name: rank
-Description: The rank or title of the firefighter (e.g., Captain, Firefighter, Engineer). This is used to identify the role and seniority of the personnel on the incident scene.
+Description: Rank or title of the firefighter or personnel such as Captain, Firefighter, or Engineer. This identifies the personnel's role or seniority in the department.
 Data Type: char(10), NOT NULL
 Examples:
 CAPT, FF, ENG
 
+
 Column Name: actiontaken1code
-Description: A code representing the primary action taken by the personnel on the incident. This field is likely a foreign key to a reference table of action codes.
+Description: Code representing the primary action taken by the personnel during the incident. This usually references a predefined action code list.
 Data Type: int, NULL
 Examples:
 NULL, NULL, 93
 
+
 Column Name: actiontaken1descip
-Description: A textual description corresponding to the actiontaken1code. This provides a human-readable explanation of the primary action taken (e.g., "Cancelled en route").
+Description: Human-readable description corresponding to the primary action code. It explains the action performed by the personnel.
 Data Type: varchar(50), NULL
 Examples:
 NULL, NULL, Cancelled en route
 
+
 Column Name: actiontaken2code
-Description: A code representing a secondary action taken by the personnel on the incident. This field is likely a foreign key to a reference table of action codes.
+Description: Code representing a secondary action taken by the personnel during the incident.
 Data Type: int, NULL
 Examples:
 NULL, NULL, NULL
 
+
 Column Name: actiontaken2descip
-Description: A textual description corresponding to the actiontaken2code. This provides a human-readable explanation of the secondary action taken.
+Description: Textual description corresponding to the secondary action code.
 Data Type: varchar(50), NULL
 Examples:
 NULL, NULL, NULL
 
+
 Column Name: actiontaken3code
-Description: A code representing a tertiary action taken by the personnel on the incident. This field is likely a foreign key to a reference table of action codes.
+Description: Code representing a tertiary action taken by the personnel during the incident.
 Data Type: int, NULL
 Examples:
 NULL, NULL, NULL
 
+
 Column Name: actiontaken3descip
-Description: A textual description corresponding to the actiontaken3code. This provides a human-readable explanation of the tertiary action taken.
+Description: Textual description corresponding to the tertiary action code.
 Data Type: varchar(50), NULL
 Examples:
 NULL, NULL, NULL
 
+
 Column Name: actiontaken4code
-Description: A code representing a quaternary action taken by the personnel on the incident. This field is likely a foreign key to a reference table of action codes.
+Description: Code representing a fourth action taken by the personnel during the incident.
 Data Type: int, NULL
 Examples:
 NULL, NULL, NULL
 
+
 Column Name: actiontaken4descip
-Description: A textual description corresponding to the actiontaken4code. This provides a human-readable explanation of the quaternary action taken.
+Description: Textual description corresponding to the fourth action code.
 Data Type: varchar(50), NULL
 Examples:
 NULL, NULL, NULL
 
+
 Column Name: amount1
-Description: A generic numeric field, likely used for various purposes depending on the context of the action taken or a specific data collection requirement. In this dataset, it is predominantly NULL.
+Description: Generic numeric field used for additional reporting metrics related to personnel participation in the incident.
 Data Type: float, NULL
 Examples:
 NULL, NULL, NULL
 
+
 Column Name: amount2
-Description: A secondary generic numeric field, likely used for various purposes depending on the context of the action taken or a specific data collection requirement. In this dataset, it is predominantly NULL.
+Description: Secondary generic numeric field used for additional measurements or reporting metrics.
 Data Type: float, NULL
 Examples:
 NULL, NULL, NULL
 
+
 Column Name: crole
-Description: A numeric code indicating the specific role of the personnel on the incident or apparatus assignment (e.g., officer, driver, firefighter). This is distinct from their permanent rank and specific to the call.
+Description: Numeric code indicating the operational role of the personnel during the incident or apparatus assignment, such as officer, driver, or firefighter.
 Data Type: int, NULL
 Examples:
 NULL, NULL, NULL
 
+
 Column Name: losapcreditcode
-Description: A numeric code indicating whether the personnel received LOSAP (Length of Service Award Program) credit for their participation in this incident.
+Description: Numeric code indicating whether the personnel received LOSAP (Length of Service Award Program) credit for their participation in the incident.
 Data Type: int, NULL
 Examples:
 1, 1, 1
 
+
 Column Name: losapcreditdescrip
-Description: A textual description corresponding to the losapcreditcode, indicating whether LOSAP credit was awarded (e.g., "Losap Credit").
+Description: Textual description corresponding to the LOSAP credit code indicating credit eligibility.
 Data Type: varchar(50), NULL
 Examples:
 Losap Credit, Losap Credit, Losap Credit
 
-Column Name: incidentkey (duplicate)
-Description: (Duplicate) The primary key for the incident table, repeated here likely to facilitate joins or reporting within this dataset.
-Data Type: char(14), NOT NULL
-Examples:
-_4GR15262U_SMS, _4GR15HZEC_SMS, _4GR166YT7_SMS
-
-Column Name: apparatuskey (duplicate)
-Description: (Duplicate) The primary key for the apparatus table, repeated here likely to facilitate joins or reporting within this dataset.
-Data Type: char(14), NOT NULL
-Examples:
-_4GR15265W_SMS, _4GR15HZF7_SMS, _4GR166YUI_SMS
 
 Column Name: apparatusid
-Description: A human-readable identifier or "unit number" for the apparatus (e.g., "BE7", "BE6", "BE3"). This is the identifier used in radio communications and daily operations to refer to the vehicle.
+Description: Human-readable identifier or unit number for the apparatus the personnel was assigned to during the incident.
 Data Type: char(10), NOT NULL
 Examples:
 BE7, BE6, BE3
 
-Column Name: deptunitornotcode
-Description: A numeric code indicating whether the apparatus is a department-owned unit or from another agency/service. A value of 0 likely means it is a department unit.
-Data Type: int, NOT NULL
-Examples:
-0, 0, 0
-
-Column Name: deptunitornotdescrip
-Description: A textual description corresponding to the deptunitornotcode, indicating if the apparatus is a department unit (e.g., "DeptUnit").
-Data Type: varchar(50), NOT NULL
-Examples:
-DeptUnit, DeptUnit, DeptUnit
-
-Column Name: priorityresponsecode
-Description: A numeric code indicating the priority of the response (e.g., emergency vs. non-emergency). A value of 1 typically signifies an emergency response (lights and sirens).
-Data Type: int, NOT NULL
-Examples:
-1, 1, 1
-
-Column Name: priorityresponsedescrip
-Description: A textual description corresponding to the priorityresponsecode. This confirms the response priority, e.g., "Yes" for emergency, "No" for non-emergency.
-Data Type: varchar(50), NOT NULL
-Examples:
-Yes, Yes, Yes
-
-Column Name: cancelledenroutecode
-Description: A numeric code indicating whether the apparatus was cancelled while en route to the incident. A value of 1 typically means "Yes", 0 means "No".
-Data Type: int, NOT NULL
-Examples:
-0, 1, 1
-
-Column Name: cancelledenroutedescrip
-Description: A textual description corresponding to the cancelledenroutecode. This indicates if the unit was cancelled en route, e.g., "No" or "Yes".
-Data Type: varchar(50), NOT NULL
-Examples:
-No, Yes, Yes
-
-Column Name: firstarrivingunitcode
-Description: A numeric code indicating whether this apparatus was the first to arrive on the scene of the incident. A value of 1 means "Yes", 0 means "No".
-Data Type: int, NOT NULL
-Examples:
-1, 0, 1
-
-Column Name: firstarrivingunitdescrip
-Description: A textual description corresponding to the firstarrivingunitcode. This confirms if the unit was the first to arrive, e.g., "Yes" or "No".
-Data Type: varchar(50), NOT NULL
-Examples:
-Yes, No, Yes
-
-Column Name: dispatchtype
-Description: A numeric code representing the type of dispatch (e.g., how the call was received or categorized). This field is often NULL.
-Data Type: int, NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: dispatchtypedescrip
-Description: A textual description corresponding to the dispatchtype. This field is often NULL.
-Data Type: varchar(50), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: respondedfromquarterscode
-Description: A numeric code indicating whether the apparatus responded directly from its quarters/station. A value of 1 likely means "Yes", 0 means "No".
-Data Type: int, NOT NULL
-Examples:
-0, 0, 0
-
-Column Name: respondedfromquarterdescrip
-Description: A textual description corresponding to the respondedfromquarterscode. This indicates if the response was from quarters, e.g., "No" (meaning they were likely already in service or responding from another location).
-Data Type: varchar(50), NOT NULL
-Examples:
-No, No, No
-
-Column Name: mainapparatususecode
-Description: A numeric code describing the primary function or use of the apparatus (e.g., suppression, rescue). A value of 1 indicates suppression.
-Data Type: int, NOT NULL
-Examples:
-1, 1, 1
-
-Column Name: mainapparatususedescrip
-Description: A textual description corresponding to the mainapparatususecode, describing the apparatus's primary function (e.g., "Suppression").
-Data Type: varchar(50), NOT NULL
-Examples:
-Suppression, Suppression, Suppression
-
-Column Name: apparatustypecode
-Description: A numeric code representing the specific type of apparatus (e.g., engine, truck, ambulance). A value of 11 indicates an engine, 12 indicates a truck/aerial.
-Data Type: int, NOT NULL
-Examples:
-11, 11, 11
-
-Column Name: apparatustypedescrip
-Description: A textual description corresponding to the apparatustypecode, providing the type of vehicle (e.g., "Engine", "Truck or aerial").
-Data Type: varchar(50), NOT NULL
-Examples:
-Engine, Engine, Engine
-
-Column Name: actiontaken1code (duplicate)
-Description: (Duplicate) A code representing the primary action taken by the apparatus on the incident. This is likely the same as the personnel-level action code.
-Data Type: int, NULL
-Examples:
-NULL, 93, 86
-
-Column Name: actiontaken1descip (duplicate)
-Description: (Duplicate) A textual description corresponding to the apparatus-level actiontaken1code.
-Data Type: varchar(50), NULL
-Examples:
-NULL, Cancelled en route, Investigate
-
-Column Name: actiontaken2code (duplicate)
-Description: (Duplicate) A code representing a secondary action taken by the apparatus.
-Data Type: int, NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: actiontaken2descip (duplicate)
-Description: (Duplicate) A textual description corresponding to the apparatus-level actiontaken2code.
-Data Type: varchar(50), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: actiontaken3code (duplicate)
-Description: (Duplicate) A code representing a tertiary action taken by the apparatus.
-Data Type: int, NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: actiontaken3descip (duplicate)
-Description: (Duplicate) A textual description corresponding to the apparatus-level actiontaken3code.
-Data Type: varchar(50), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: actiontaken4code (duplicate)
-Description: (Duplicate) A code representing a quaternary action taken by the apparatus.
-Data Type: int, NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: actiontaken4descip (duplicate)
-Description: (Duplicate) A textual description corresponding to the apparatus-level actiontaken4code.
-Data Type: varchar(50), NULL
-Examples:
-NULL, NULL, NULL
 
 Column Name: numberofresponders
-Description: The total number of personnel who responded on this apparatus to the incident.
+Description: The total number of personnel who responded on the associated apparatus to the incident.
 Data Type: int, NOT NULL
 Examples:
 3, 3, 3
 
-Column Name: dispatchdatetime
-Description: The combined date and time the apparatus was dispatched to the incident. Stored as a string in the format "HH:MM.ss" or similar.
-Data Type: nvarchar(255), NULL
-Examples:
-08:31.0, 20:21.0, 39:16.0
-
-Column Name: dispatchtime
-Description: The time the apparatus was dispatched, represented in a 24-hour format (e.g., 19:08:31 for 7:08:31 PM).
-Data Type: nvarchar(255), NULL
-Examples:
-19:08:31, 19:20:21, 19:39:16
-
-Column Name: dispatchdate
-Description: The date the apparatus was dispatched, in MM/DD/YYYY format.
-Data Type: nvarchar(255), NULL
-Examples:
-10/9/2015, 10/9/2015, 10/9/2015
-
-Column Name: dispatchenroutetime
-Description: The duration between the dispatch time and the time the unit went en route. Formatted as HH:MM:SS.
-Data Type: nvarchar(255), NULL
-Examples:
-0:00:44, 0:01:15, NULL
-
-Column Name: dispatchenroutediffseconds
-Description: The dispatchenroutetime expressed in total seconds. Useful for calculating average response times.
-Data Type: int, NULL
-Examples:
-44, 75, 0
-
-Column Name: enroutetoscenedatetime
-Description: The combined date and time the apparatus marked that it was en route to the scene.
-Data Type: nvarchar(255), NULL
-Examples:
-09:15.0, 21:36.0, 00:00.0
-
-Column Name: enroutetoscenetime
-Description: The time the apparatus marked en route, in a 24-hour format.
-Data Type: nvarchar(255), NULL
-Examples:
-19:09:15, 19:21:36, 
-
-Column Name: enroutetoscenedate
-Description: The date the apparatus marked en route.
-Data Type: nvarchar(255), NULL
-Examples:
-10/9/2015, 10/9/2015, NULL
-
-Column Name: enroutearrivalscenetime
-Description: The duration between the unit marking en route and its arrival on the scene. Formatted as HH:MM:SS.
-Data Type: nvarchar(255), NULL
-Examples:
-0:01:55, 0:03:37, NULL
-
-Column Name: enroutearrivalscenediffseconds
-Description: The enroutearrivalscenetime expressed in total seconds.
-Data Type: int, NULL
-Examples:
-115, 217, 0
-
-Column Name: responsetime
-Description: The total duration from dispatch to arrival on scene. Formatted as HH:MM:SS.
-Data Type: nvarchar(255), NULL
-Examples:
-0:02:39, 0:04:52, 0:00:00
 
 Column Name: responsetimeseconds
-Description: The total responsetime expressed in seconds. This is a critical metric for performance analysis.
+Description: Total response time from dispatch to arrival on the scene expressed in seconds. This is an important operational performance metric.
 Data Type: int, NULL
 Examples:
 159, 292, 0
 
-Column Name: arrivaldatetime
-Description: The combined date and time the apparatus arrived on the scene.
-Data Type: nvarchar(255), NULL
-Examples:
-11:10.0, 25:13.0, 00:00.0
-
-Column Name: arrivaltime
-Description: The time the apparatus arrived on the scene, in a 24-hour format.
-Data Type: nvarchar(255), NULL
-Examples:
-19:11:10, 19:25:13, 
-
-Column Name: arrivaldate
-Description: The date the apparatus arrived on the scene.
-Data Type: nvarchar(255), NULL
-Examples:
-10/9/2015, 10/9/2015, NULL
-
-Column Name: arrivaltoenroutehospdifftime
-Description: The duration between arrival on scene and the unit going en route to a hospital (for EMS calls). This field is largely NULL for non-EMS runs.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: arrivaltoenroutehospdiffseconds
-Description: The arrivaltoenroutehospdifftime expressed in seconds.
-Data Type: int, NULL
-Examples:
-0, 0, 0
-
-Column Name: enroutetohospitaldatetime
-Description: The combined date and time the unit went en route to the hospital.
-Data Type: nvarchar(255), NULL
-Examples:
-00:00.0, 00:00.0, 00:00.0
-
-Column Name: enroutetohospitaltime
-Description: The time the unit went en route to the hospital.
-Data Type: nvarchar(255), NULL
-Examples:
-, , 
-
-Column Name: enroutetohospitaldate
-Description: The date the unit went en route to the hospital.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: enroutetoarrivalhospdifftime
-Description: The duration between going en route to the hospital and arriving at the hospital. This field is largely NULL.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: enroutetoarrivalhospdiffseconds
-Description: The enroutetoarrivalhospdifftime expressed in seconds.
-Data Type: int, NULL
-Examples:
-0, 0, 0
-
-Column Name: arrivalscenetoarrivalhospdifftime
-Description: The total duration from arrival on scene to arrival at the hospital (for patient transports). This field is largely NULL.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: arrivalscenetoarrivalhospdiffseconds
-Description: The arrivalscenetoarrivalhospdifftime expressed in seconds.
-Data Type: int, NULL
-Examples:
-0, 0, 0
-
-Column Name: hospitalarrivaldatetime
-Description: The combined date and time the apparatus arrived at the hospital.
-Data Type: nvarchar(255), NULL
-Examples:
-00:00.0, 00:00.0, 00:00.0
-
-Column Name: hospitalarrivaltime
-Description: The time the apparatus arrived at the hospital.
-Data Type: nvarchar(255), NULL
-Examples:
-, , 
-
-Column Name: hospitalarrivaldate
-Description: The date the apparatus arrived at the hospital.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: arrivalclearhospdifftime
-Description: The duration between arrival at the hospital and the unit clearing (becoming available) from the hospital. This field is largely NULL.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: arrivalclearhospdiffseconds
-Description: The arrivalclearhospdifftime expressed in seconds.
-Data Type: int, NULL
-Examples:
-0, 0, 0
-
-Column Name: cleardatetime
-Description: The combined date and time the apparatus cleared the incident and became available for service.
-Data Type: nvarchar(255), NULL
-Examples:
-16:17.0, 40:39.0, 41:06.0
-
-Column Name: cleartime
-Description: The time the apparatus cleared the incident, in a 24-hour format.
-Data Type: nvarchar(255), NULL
-Examples:
-19:16:17, 19:40:39, 19:41:06
-
-Column Name: cleardate
-Description: The date the apparatus cleared the incident.
-Data Type: nvarchar(255), NULL
-Examples:
-10/9/2015, 10/9/2015, 10/9/2015
-
-Column Name: dispatchcleardifftime
-Description: The total duration from initial dispatch to the unit clearing the incident. Formatted as HH:MM:SS.
-Data Type: nvarchar(255), NULL
-Examples:
-0:07:46, 0:20:18, 0:01:50
 
 Column Name: dispatchcleardiffseconds
-Description: The total dispatchcleardifftime expressed in seconds. This represents the total time the unit was committed to the incident.
-Data Type: int, NULL
-Examples:
-466, 1218, 110
-
-Column Name: inservicedatetime
-Description: The combined date and time the unit was marked as "in service" or available at the start of their shift. This field is largely NULL or 00:00.0.
-Data Type: nvarchar(255), NULL
-Examples:
-00:00.0, 00:00.0, 00:00.0
-
-Column Name: inservicetime
-Description: The time the unit was marked "in service".
-Data Type: nvarchar(255), NULL
-Examples:
-, , 
-
-Column Name: inservicedate
-Description: The date the unit was marked "in service".
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: emsruncode
-Description: A code or identifier for an EMS (Emergency Medical Services) run, if applicable. The value "Not EMS Run" indicates this was not an EMS incident.
-Data Type: nvarchar(255), NULL
-Examples:
-Not EMS Run, Not EMS Run, Not EMS Run
-
-Column Name: emsrundescrip
-Description: A description of the EMS run. This field is largely NULL.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: emsrunnumber
-Description: A specific run number for the EMS call. This field is largely NULL.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: losapcode
-Description: A code indicating LOSAP credit, similar to losapcreditcode.
+Description: Total duration from dispatch until the apparatus cleared the incident and became available again, expressed in seconds.
 Data Type: int, NULL
 Examples:
-1, 1, 1
-
-Column Name: losapdescrip
-Description: A description of the LOSAP credit, similar to losapcreditdescrip.
-Data Type: nvarchar(255), NULL
-Examples:
-Losap Credit, Losap Credit, Losap Credit
-
-Column Name: alarmscode
-Description: A code indicating the alarm level or type for the incident. This field is largely NULL.
-Data Type: int, NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: alarmdescrip
-Description: A description of the alarm level. This field is largely NULL.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: amount1 (duplicate)
-Description: (Duplicate) Another instance of the generic amount1 field, likely for apparatus-level data. Predominantly NULL.
-Data Type: float, NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: amount2 (duplicate)
-Description: (Duplicate) Another instance of the generic amount2 field, likely for apparatus-level data. Predominantly NULL.
-Data Type: float, NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: fdid_no
-Description: The Fire Department ID number or identifier. This field is consistently NULL in the provided sample.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: stagingdatetime
-Description: The combined date and time the apparatus went to a staging area. This field is largely NULL or 00:00.0.
-Data Type: nvarchar(255), NULL
-Examples:
-00:00.0, 00:00.0, 00:00.0
-
-Column Name: stagingtime
-Description: The time the apparatus went to a staging area.
-Data Type: nvarchar(255), NULL
-Examples:
-, , 
-
-Column Name: stagingdate
-Description: The date the apparatus went to a staging area.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: AtPatientSideDateTime
-Description: The combined date and time the personnel arrived at the patient's side (for EMS incidents). This field is largely NULL or 00:00.0.
-Data Type: nvarchar(255), NULL
-Examples:
-00:00.0, 00:00.0, 00:00.0
-
-Column Name: AtPatientSideTime
-Description: The time the personnel arrived at the patient's side.
-Data Type: nvarchar(255), NULL
-Examples:
-, , 
-
-Column Name: AtPatientSideDate
-Description: The date the personnel arrived at the patient's side.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: FacilityDateTime
-Description: The combined date and time the personnel arrived at a medical facility. This field is largely NULL or 00:00.0.
-Data Type: nvarchar(255), NULL
-Examples:
-00:00.0, 00:00.0, 00:00.0
-
-Column Name: FacilityTime
-Description: The time the personnel arrived at a medical facility.
-Data Type: nvarchar(255), NULL
-Examples:
-, , 
-
-Column Name: FacilityDate
-Description: The date the personnel arrived at a medical facility.
-Data Type: nvarchar(255), NULL
-Examples:
-NULL, NULL, NULL
-
-Column Name: changedate
-Description: The date and time the record was last updated or changed. The format appears to be a floating-point number representing time, possibly the number of minutes or seconds after a reference point.
-Data Type: float, NULL
-Examples:
-17:39.0, 42:11.5, 48:24.5
+466, 1218, 110

poetry.lock

@@ -1,4 +1,4 @@
-# This file is automatically @generated by Poetry 2.3.2 and should not be changed by hand.
+# This file is automatically @generated by Poetry 2.3.1 and should not be changed by hand.
 
 [[package]]
 name = "aiosqlite"
@@ -1903,6 +1903,95 @@ files = [
     {file = "packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4"},
 ]
 
+[[package]]
+name = "pandas"
+version = "3.0.1"
+description = "Powerful data structures for data analysis, time series, and statistics"
+optional = false
+python-versions = ">=3.11"
+groups = ["main"]
+files = [
+    {file = "pandas-3.0.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:de09668c1bf3b925c07e5762291602f0d789eca1b3a781f99c1c78f6cac0e7ea"},
+    {file = "pandas-3.0.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:24ba315ba3d6e5806063ac6eb717504e499ce30bd8c236d8693a5fd3f084c796"},
+    {file = "pandas-3.0.1-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:406ce835c55bac912f2a0dcfaf27c06d73c6b04a5dde45f1fd3169ce31337389"},
+    {file = "pandas-3.0.1-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:830994d7e1f31dd7e790045235605ab61cff6c94defc774547e8b7fdfbff3dc7"},
+    {file = "pandas-3.0.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:a64ce8b0f2de1d2efd2ae40b0abe7f8ae6b29fbfb3812098ed5a6f8e235ad9bf"},
+    {file = "pandas-3.0.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:9832c2c69da24b602c32e0c7b1b508a03949c18ba08d4d9f1c1033426685b447"},
+    {file = "pandas-3.0.1-cp311-cp311-win_amd64.whl", hash = "sha256:84f0904a69e7365f79a0c77d3cdfccbfb05bf87847e3a51a41e1426b0edb9c79"},
+    {file = "pandas-3.0.1-cp311-cp311-win_arm64.whl", hash = "sha256:4a68773d5a778afb31d12e34f7dd4612ab90de8c6fb1d8ffe5d4a03b955082a1"},
+    {file = "pandas-3.0.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:476f84f8c20c9f5bc47252b66b4bb25e1a9fc2fa98cead96744d8116cb85771d"},
+    {file = "pandas-3.0.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:0ab749dfba921edf641d4036c4c21c0b3ea70fea478165cb98a998fb2a261955"},
+    {file = "pandas-3.0.1-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b8e36891080b87823aff3640c78649b91b8ff6eea3c0d70aeabd72ea43ab069b"},
+    {file = "pandas-3.0.1-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:532527a701281b9dd371e2f582ed9094f4c12dd9ffb82c0c54ee28d8ac9520c4"},
+    {file = "pandas-3.0.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:356e5c055ed9b0da1580d465657bc7d00635af4fd47f30afb23025352ba764d1"},
+    {file = "pandas-3.0.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:9d810036895f9ad6345b8f2a338dd6998a74e8483847403582cab67745bff821"},
+    {file = "pandas-3.0.1-cp312-cp312-win_amd64.whl", hash = "sha256:536232a5fe26dd989bd633e7a0c450705fdc86a207fec7254a55e9a22950fe43"},
+    {file = "pandas-3.0.1-cp312-cp312-win_arm64.whl", hash = "sha256:0f463ebfd8de7f326d38037c7363c6dacb857c5881ab8961fb387804d6daf2f7"},
+    {file = "pandas-3.0.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:5272627187b5d9c20e55d27caf5f2cd23e286aba25cadf73c8590e432e2b7262"},
+    {file = "pandas-3.0.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:661e0f665932af88c7877f31da0dc743fe9c8f2524bdffe23d24fdcb67ef9d56"},
+    {file = "pandas-3.0.1-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:75e6e292ff898679e47a2199172593d9f6107fd2dd3617c22c2946e97d5df46e"},
+    {file = "pandas-3.0.1-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1ff8cf1d2896e34343197685f432450ec99a85ba8d90cce2030c5eee2ef98791"},
+    {file = "pandas-3.0.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:eca8b4510f6763f3d37359c2105df03a7a221a508f30e396a51d0713d462e68a"},
+    {file = "pandas-3.0.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:06aff2ad6f0b94a17822cf8b83bbb563b090ed82ff4fe7712db2ce57cd50d9b8"},
+    {file = "pandas-3.0.1-cp313-cp313-win_amd64.whl", hash = "sha256:9fea306c783e28884c29057a1d9baa11a349bbf99538ec1da44c8476563d1b25"},
+    {file = "pandas-3.0.1-cp313-cp313-win_arm64.whl", hash = "sha256:a8d37a43c52917427e897cb2e429f67a449327394396a81034a4449b99afda59"},
+    {file = "pandas-3.0.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:d54855f04f8246ed7b6fc96b05d4871591143c46c0b6f4af874764ed0d2d6f06"},
+    {file = "pandas-3.0.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:4e1b677accee34a09e0dc2ce5624e4a58a1870ffe56fc021e9caf7f23cd7668f"},
+    {file = "pandas-3.0.1-cp313-cp313t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a9cabbdcd03f1b6cd254d6dda8ae09b0252524be1592594c00b7895916cb1324"},
+    {file = "pandas-3.0.1-cp313-cp313t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5ae2ab1f166668b41e770650101e7090824fd34d17915dd9cd479f5c5e0065e9"},
+    {file = "pandas-3.0.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:6bf0603c2e30e2cafac32807b06435f28741135cb8697eae8b28c7d492fc7d76"},
+    {file = "pandas-3.0.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:6c426422973973cae1f4a23e51d4ae85974f44871b24844e4f7de752dd877098"},
+    {file = "pandas-3.0.1-cp313-cp313t-win_amd64.whl", hash = "sha256:b03f91ae8c10a85c1613102c7bef5229b5379f343030a3ccefeca8a33414cf35"},
+    {file = "pandas-3.0.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:99d0f92ed92d3083d140bf6b97774f9f13863924cf3f52a70711f4e7588f9d0a"},
+    {file = "pandas-3.0.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:3b66857e983208654294bb6477b8a63dee26b37bdd0eb34d010556e91261784f"},
+    {file = "pandas-3.0.1-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:56cf59638bf24dc9bdf2154c81e248b3289f9a09a6d04e63608c159022352749"},
+    {file = "pandas-3.0.1-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c1a9f55e0f46951874b863d1f3906dcb57df2d9be5c5847ba4dfb55b2c815249"},
+    {file = "pandas-3.0.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:1849f0bba9c8a2fb0f691d492b834cc8dadf617e29015c66e989448d58d011ee"},
+    {file = "pandas-3.0.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:c3d288439e11b5325b02ae6e9cc83e6805a62c40c5a6220bea9beb899c073b1c"},
+    {file = "pandas-3.0.1-cp314-cp314-win_amd64.whl", hash = "sha256:93325b0fe372d192965f4cca88d97667f49557398bbf94abdda3bf1b591dbe66"},
+    {file = "pandas-3.0.1-cp314-cp314-win_arm64.whl", hash = "sha256:97ca08674e3287c7148f4858b01136f8bdfe7202ad25ad04fec602dd1d29d132"},
+    {file = "pandas-3.0.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:58eeb1b2e0fb322befcf2bbc9ba0af41e616abadb3d3414a6bc7167f6cbfce32"},
+    {file = "pandas-3.0.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:cd9af1276b5ca9e298bd79a26bda32fa9cc87ed095b2a9a60978d2ca058eaf87"},
+    {file = "pandas-3.0.1-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:94f87a04984d6b63788327cd9f79dda62b7f9043909d2440ceccf709249ca988"},
+    {file = "pandas-3.0.1-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:85fe4c4df62e1e20f9db6ebfb88c844b092c22cd5324bdcf94bfa2fc1b391221"},
+    {file = "pandas-3.0.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:331ca75a2f8672c365ae25c0b29e46f5ac0c6551fdace8eec4cd65e4fac271ff"},
+    {file = "pandas-3.0.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:15860b1fdb1973fffade772fdb931ccf9b2f400a3f5665aef94a00445d7d8dd5"},
+    {file = "pandas-3.0.1-cp314-cp314t-win_amd64.whl", hash = "sha256:44f1364411d5670efa692b146c748f4ed013df91ee91e9bec5677fb1fd58b937"},
+    {file = "pandas-3.0.1-cp314-cp314t-win_arm64.whl", hash = "sha256:108dd1790337a494aa80e38def654ca3f0968cf4f362c85f44c15e471667102d"},
+    {file = "pandas-3.0.1.tar.gz", hash = "sha256:4186a699674af418f655dbd420ed87f50d56b4cd6603784279d9eef6627823c8"},
+]
+
+[package.dependencies]
+numpy = {version = ">=1.26.0", markers = "python_version < \"3.14\""}
+python-dateutil = ">=2.8.2"
+tzdata = {version = "*", markers = "sys_platform == \"win32\" or sys_platform == \"emscripten\""}
+
+[package.extras]
+all = ["PyQt5 (>=5.15.9)", "SQLAlchemy (>=2.0.36)", "adbc-driver-postgresql (>=1.2.0)", "adbc-driver-sqlite (>=1.2.0)", "beautifulsoup4 (>=4.12.3)", "bottleneck (>=1.4.2)", "fastparquet (>=2024.11.0)", "fsspec (>=2024.10.0)", "gcsfs (>=2024.10.0)", "html5lib (>=1.1)", "hypothesis (>=6.116.0)", "jinja2 (>=3.1.5)", "lxml (>=5.3.0)", "matplotlib (>=3.9.3)", "numba (>=0.60.0)", "numexpr (>=2.10.2)", "odfpy (>=1.4.1)", "openpyxl (>=3.1.5)", "psycopg2 (>=2.9.10)", "pyarrow (>=13.0.0)", "pyiceberg (>=0.8.1)", "pymysql (>=1.1.1)", "pyreadstat (>=1.2.8)", "pytest (>=8.3.4)", "pytest-xdist (>=3.6.1)", "python-calamine (>=0.3.0)", "pytz (>=2024.2)", "pyxlsb (>=1.0.10)", "qtpy (>=2.4.2)", "s3fs (>=2024.10.0)", "scipy (>=1.14.1)", "tables (>=3.10.1)", "tabulate (>=0.9.0)", "xarray (>=2024.10.0)", "xlrd (>=2.0.1)", "xlsxwriter (>=3.2.0)", "zstandard (>=0.23.0)"]
+aws = ["s3fs (>=2024.10.0)"]
+clipboard = ["PyQt5 (>=5.15.9)", "qtpy (>=2.4.2)"]
+compression = ["zstandard (>=0.23.0)"]
+computation = ["scipy (>=1.14.1)", "xarray (>=2024.10.0)"]
+excel = ["odfpy (>=1.4.1)", "openpyxl (>=3.1.5)", "python-calamine (>=0.3.0)", "pyxlsb (>=1.0.10)", "xlrd (>=2.0.1)", "xlsxwriter (>=3.2.0)"]
+feather = ["pyarrow (>=13.0.0)"]
+fss = ["fsspec (>=2024.10.0)"]
+gcp = ["gcsfs (>=2024.10.0)"]
+hdf5 = ["tables (>=3.10.1)"]
+html = ["beautifulsoup4 (>=4.12.3)", "html5lib (>=1.1)", "lxml (>=5.3.0)"]
+iceberg = ["pyiceberg (>=0.8.1)"]
+mysql = ["SQLAlchemy (>=2.0.36)", "pymysql (>=1.1.1)"]
+output-formatting = ["jinja2 (>=3.1.5)", "tabulate (>=0.9.0)"]
+parquet = ["pyarrow (>=13.0.0)"]
+performance = ["bottleneck (>=1.4.2)", "numba (>=0.60.0)", "numexpr (>=2.10.2)"]
+plot = ["matplotlib (>=3.9.3)"]
+postgresql = ["SQLAlchemy (>=2.0.36)", "adbc-driver-postgresql (>=1.2.0)", "psycopg2 (>=2.9.10)"]
+pyarrow = ["pyarrow (>=13.0.0)"]
+spss = ["pyreadstat (>=1.2.8)"]
+sql-other = ["SQLAlchemy (>=2.0.36)", "adbc-driver-postgresql (>=1.2.0)", "adbc-driver-sqlite (>=1.2.0)"]
+test = ["hypothesis (>=6.116.0)", "pytest (>=8.3.4)", "pytest-xdist (>=3.6.1)"]
+timezone = ["pytz (>=2024.2)"]
+xml = ["lxml (>=5.3.0)"]
+
 [[package]]
 name = "protobuf"
 version = "6.33.5"
@@ -3057,6 +3146,19 @@ files = [
 [package.dependencies]
 typing-extensions = ">=4.12.0"
 
+[[package]]
+name = "tzdata"
+version = "2025.3"
+description = "Provider of IANA time zone data"
+optional = false
+python-versions = ">=2"
+groups = ["main"]
+markers = "sys_platform == \"win32\" or sys_platform == \"emscripten\""
+files = [
+    {file = "tzdata-2025.3-py2.py3-none-any.whl", hash = "sha256:06a47e5700f3081aab02b2e513160914ff0694bce9947d6b76ebd6bf57cfc5d1"},
+    {file = "tzdata-2025.3.tar.gz", hash = "sha256:de39c2ca5dc7b0344f2eba86f49d614019d29f060fc4ebc8a417896a620b56a7"},
+]
+
 [[package]]
 name = "urllib3"
 version = "2.6.3"
@@ -3415,4 +3517,4 @@ type = ["pytest-mypy"]
 [metadata]
 lock-version = "2.1"
 python-versions = "3.12.*"
-content-hash = "803850d1cde995f9cc832bc6c192008e6ecc5dbe92db556156811006e69807db"
+content-hash = "71ae3966704d36786fc8db92b5c592b9b92682cf7d3cc913039a86ced4b02b18"

src/entities/apparatus/__init__.py

@@ -0,0 +1,2 @@
+from _model import *
+from _schema import *

src/entities/apparatus/_model.py

@@ -0,0 +1,68 @@
+from sqlalchemy import Column, String, Integer, Boolean, DateTime, Text, Numeric, ForeignKey
+from sqlalchemy.orm import relationship
+from base import BaseModel_
+
+
+class ApparatusModel(BaseModel_):
+    __tablename__ = "apparatus"
+
+    apparatuskey = Column(String(14), primary_key=True, index=True)
+    incidentkey = Column(String(14), ForeignKey("incident.incidentkey"))
+    apsid = Column(String(14), nullable=True)
+    apparatusid = Column(String(8), nullable=True)
+    priorityresponseflag = Column(Boolean, nullable=True)
+    arrivaldate = Column(DateTime, nullable=True)
+    scenedate = Column(DateTime, nullable=True)
+    enroutedate = Column(DateTime, nullable=True)
+    facilitydate = Column(DateTime, nullable=True)
+    cleardate = Column(DateTime, nullable=True)
+    dispatchdate = Column(DateTime, nullable=True)
+    inservicedate = Column(DateTime, nullable=True)
+    cancelledenrouteflag = Column(Boolean, nullable=True)
+    numberpeople = Column(Integer, nullable=True)
+    usecode = Column(String(4), nullable=True)
+    actiontaken1 = Column(String(4), nullable=True)
+    actiontaken2 = Column(String(4), nullable=True)
+    actiontaken3 = Column(String(4), nullable=True)
+    actiontaken4 = Column(String(4), nullable=True)
+    apparatustype = Column(String(4), nullable=True)
+    amount1 = Column(Numeric(10, 2), nullable=True)
+    amount2 = Column(Numeric(10, 2), nullable=True)
+    otherinfo = Column(String(20), nullable=True)
+    logcomments = Column(Text, nullable=True)
+    fdid_no = Column(String(20), nullable=True)
+    paramedicdispatch = Column(String(6), nullable=True)
+    firstarrivingunit = Column(Boolean, nullable=True)
+    inservicetime = Column(DateTime, nullable=True)
+    respondfromquarters = Column(Boolean, nullable=True)
+    changedate = Column(DateTime, nullable=True)
+    rowguid = Column(String(36), nullable=False)
+    hydrant_idnumber = Column(String(20), nullable=True)
+    hydrant_location = Column(String(116), nullable=True)
+    alarms = Column(String(10), nullable=True)
+    llosap_credit = Column(Boolean, nullable=True)
+    emsrun = Column(Boolean, nullable=True)
+    emsrunnumber = Column(String(14), nullable=True)
+    lprocessepcr = Column(Boolean, nullable=True)
+    nepcrrun = Column(Integer, nullable=True)
+    stagingdate = Column(DateTime, nullable=True)
+    isepcr = Column(Boolean, nullable=True)
+    unit_exc = Column(String(10), nullable=True)
+    aedtype = Column(String(10), nullable=True)
+    odometeronscene = Column(Numeric(12, 2), nullable=True)
+    odometerdestination = Column(Numeric(12, 2), nullable=True)
+    mileagetransport = Column(Numeric(12, 2), nullable=True)
+    atpatientsidetime = Column(DateTime, nullable=True)
+    aerialdeviceused = Column(Integer, nullable=True)
+    gmtoffset = Column(String(6), nullable=True)
+    firsteffectiveunit = Column(Integer, nullable=True)
+    lnfirsexported = Column(Boolean, nullable=True)
+    nfirsexporteddate = Column(DateTime, nullable=True)
+    infirssequence = Column(Integer, nullable=True)
+    nfirsttransactiontype = Column(String(1), nullable=True)
+    hydrant_used = Column(Integer, nullable=True)
+    defaultdispatchcode = Column(String(25), nullable=True)
+    responsetime = Column(String(20), nullable=True)
+    turntime = Column(String(20), nullable=True)
+    
+    incident = relationship("Incident", back_populates="apparatus")

src/entities/apparatus/_schema.py

@@ -0,0 +1,307 @@
+from pydantic import Field
+from datetime import datetime
+from typing import Optional
+from decimal import Decimal
+from base import BaseSchema
+
+
+class ApparatusSchema(BaseSchema):
+
+    apparatuskey: str = Field(
+        ...,
+        description="Primary key for the apparatus table. Unique 14-character identifier representing a specific apparatus response to an incident.",
+        example="_4GR15265W_SMS"
+    )
+
+    incidentkey: Optional[str] = Field(
+        ...,
+        description="Foreign key linking this apparatus response to the incident table.",
+        example="_4GR15262U_SMS"
+    )
+
+    apsid: Optional[str] = Field(
+        ...,
+        description="System-generated identifier used internally for apparatus personnel or assignment records.",
+        example="_APS123456789"
+    )
+
+    apparatusid: Optional[str] = Field(
+        ...,
+        description="Human-readable apparatus or unit identifier used in dispatch and radio communication.",
+        example="BE7"
+    )
+
+    priorityresponseflag: Optional[bool] = Field(
+        ...,
+        description="Indicates whether the apparatus responded with priority (lights and sirens)."
+    )
+
+    arrivaldate: Optional[datetime] = Field(
+        ...,
+        description="Date and time when the apparatus arrived at the incident scene."
+    )
+
+    scenedate: Optional[datetime] = Field(
+        ...,
+        description="Date and time when the apparatus officially reached the scene location."
+    )
+
+    enroutedate: Optional[datetime] = Field(
+        ...,
+        description="Date and time when the apparatus began traveling to the incident after dispatch."
+    )
+
+    facilitydate: Optional[datetime] = Field(
+        ...,
+        description="Date and time when the apparatus arrived at a medical facility with a patient (EMS incidents)."
+    )
+
+    cleardate: Optional[datetime] = Field(
+        ...,
+        description="Date and time when the apparatus cleared the incident and became available for another response."
+    )
+
+    dispatchdate: Optional[datetime] = Field(
+        ...,
+        description="Date and time when the apparatus was dispatched to the incident."
+    )
+
+    inservicedate: Optional[datetime] = Field(
+        ...,
+        description="Date and time when the apparatus returned to service after completing the incident."
+    )
+
+    cancelledenrouteflag: Optional[bool] = Field(
+        ...,
+        description="Indicates whether the apparatus was cancelled while en route to the incident."
+    )
+
+    numberpeople: Optional[int] = Field(
+        ...,
+        description="Total number of personnel assigned to this apparatus during the incident."
+    )
+
+    usecode: Optional[str] = Field(
+        ...,
+        description="NFIRS code identifying how the apparatus was used in the incident response."
+    )
+
+    actiontaken1: Optional[str] = Field(
+        ...,
+        description="NFIRS code representing the primary action taken by the apparatus."
+    )
+
+    actiontaken2: Optional[str] = Field(
+        ...,
+        description="NFIRS code representing the secondary action taken."
+    )
+
+    actiontaken3: Optional[str] = Field(
+        ...,
+        description="NFIRS code representing the tertiary action taken."
+    )
+
+    actiontaken4: Optional[str] = Field(
+        ...,
+        description="NFIRS code representing the fourth action taken during the incident."
+    )
+
+    apparatustype: Optional[str] = Field(
+        ...,
+        description="NFIRS apparatus type code representing the type of responding vehicle."
+    )
+
+    amount1: Optional[Decimal] = Field(
+        ...,
+        description="Monetary value associated with the apparatus response such as property loss or equipment value."
+    )
+
+    amount2: Optional[Decimal] = Field(
+        ...,
+        description="Additional monetary value related to the incident such as property saved."
+    )
+
+    otherinfo: Optional[str] = Field(
+        ...,
+        description="Additional miscellaneous information associated with the apparatus response."
+    )
+
+    logcomments: Optional[str] = Field(
+        ...,
+        description="Free-text comments or operational notes recorded during the apparatus response."
+    )
+
+    fdid_no: Optional[str] = Field(
+        ...,
+        description="Fire Department Identification Number (FDID) representing the department responsible for the incident."
+    )
+
+    paramedicdispatch: Optional[str] = Field(
+        ...,
+        description="Indicator showing whether paramedics were dispatched with the apparatus."
+    )
+
+    firstarrivingunit: Optional[bool] = Field(
+        ...,
+        description="Indicates whether this apparatus was the first unit to arrive on scene."
+    )
+
+    inservicetime: Optional[datetime] = Field(
+        ...,
+        description="Time when the apparatus returned to service after completing the response."
+    )
+
+    respondfromquarters: Optional[bool] = Field(
+        ...,
+        description="Indicates whether the apparatus responded directly from its station."
+    )
+
+    changedate: Optional[datetime] = Field(
+        ...,
+        description="Timestamp representing when this record was last modified."
+    )
+
+    rowguid: str = Field(
+        ...,
+        description="Globally unique identifier (GUID) used internally for replication or system-level identification."
+    )
+
+    hydrant_idnumber: Optional[str] = Field(
+        ...,
+        description="Identifier of the fire hydrant used during the incident response."
+    )
+
+    hydrant_location: Optional[str] = Field(
+        ...,
+        description="Location description of the hydrant used during the response."
+    )
+
+    alarms: Optional[str] = Field(
+        ...,
+        description="Alarm level associated with the incident response."
+    )
+
+    llosap_credit: Optional[bool] = Field(
+        ...,
+        description="Indicates whether LOSAP (Length of Service Award Program) credit was awarded."
+    )
+
+    emsrun: Optional[bool] = Field(
+        ...,
+        description="Indicates whether this apparatus response was related to an EMS call."
+    )
+
+    emsrunnumber: Optional[str] = Field(
+        ...,
+        description="Unique identifier associated with the EMS patient care report."
+    )
+
+    lprocessepcr: Optional[bool] = Field(
+        ...,
+        description="Indicates whether an electronic patient care report (ePCR) was processed."
+    )
+
+    nepcrrun: Optional[int] = Field(
+        ...,
+        description="Numeric identifier representing the ePCR run sequence."
+    )
+
+    stagingdate: Optional[datetime] = Field(
+        ...,
+        description="Date and time when the apparatus entered a staging area during the incident."
+    )
+
+    isepcr: Optional[bool] = Field(
+        ...,
+        description="Indicates whether this incident has an associated electronic patient care report."
+    )
+
+    unit_exc: Optional[str] = Field(
+        ...,
+        description="Internal code used for apparatus unit exceptions or operational categories."
+    )
+
+    aedtype: Optional[str] = Field(
+        ...,
+        description="Type of automated external defibrillator (AED) used during the response."
+    )
+
+    odometeronscene: Optional[Decimal] = Field(
+        ...,
+        description="Vehicle odometer reading when arriving on scene."
+    )
+
+    odometerdestination: Optional[Decimal] = Field(
+        ...,
+        description="Vehicle odometer reading when reaching the destination (hospital or facility)."
+    )
+
+    mileagetransport: Optional[Decimal] = Field(
+        ...,
+        description="Mileage traveled while transporting a patient."
+    )
+
+    atpatientsidetime: Optional[datetime] = Field(
+        ...,
+        description="Date and time when personnel reached the patient."
+    )
+
+    created: datetime = Field(
+        ...,
+        description="Timestamp indicating when the apparatus response record was created."
+    )
+
+    aerialdeviceused: Optional[int] = Field(
+        ...,
+        description="Indicator showing whether an aerial device (ladder platform etc.) was used."
+    )
+
+    gmtoffset: Optional[str] = Field(
+        ...,
+        description="Timezone offset from GMT for the recorded timestamps."
+    )
+
+    firsteffectiveunit: Optional[int] = Field(
+        ...,
+        description="Indicates whether this apparatus was the first effective operational unit."
+    )
+
+    lnfirsexported: Optional[bool] = Field(
+        ...,
+        description="Indicates whether the incident record was exported to the NFIRS reporting system."
+    )
+
+    nfirsexporteddate: Optional[datetime] = Field(
+        ...,
+        description="Date when the incident data was exported to NFIRS."
+    )
+
+    infirssequence: Optional[int] = Field(
+        ...,
+        description="NFIRS sequence number used for tracking exported records."
+    )
+
+    nfirsttransactiontype: Optional[str] = Field(
+        ...,
+        description="NFIRS transaction type code representing the type of record export."
+    )
+
+    hydrant_used: Optional[int] = Field(
+        ...,
+        description="Indicator representing whether a hydrant was used during the incident."
+    )
+
+    defaultdispatchcode: Optional[str] = Field(
+        ...,
+        description="Default dispatch code assigned to the apparatus response."
+    )
+
+    responsetime: Optional[str] = Field(
+        ...,
+        description="Total response time from dispatch to arrival at scene formatted as HH:MM:SS."
+    )
+
+    turntime: Optional[str] = Field(
+        ...,
+        description="Time between dispatch and apparatus leaving the station (turnout time)."
+    )

src/entities/auv_incidentapparatus/__init__.py

@@ -0,0 +1,2 @@
+from _model import *
+from _schema import *

src/entities/auv_incidentapparatus/_model.py

@@ -0,0 +1,95 @@
+from sqlalchemy import Column, String, Integer, Date, DateTime, Time, ForeignKey
+from sqlalchemy.orm import relationship
+from base import BaseModel_
+
+
+class IncidentApparatusModel(BaseModel_):
+    __tablename__ = "auv_incidentapparatus"
+
+    apparatuskey = Column(String(14), primary_key=True, index=True)
+    incidentkey = Column(String(14), ForeignKey("incident.incidentkey"))
+    apparatusid = Column(String(20))
+    deptunitornotcode = Column(Integer)
+    deptunitornotdescrip = Column(String(50))
+    priorityresponsecode = Column(Integer)
+    priorityresponsedescrip = Column(String(50))
+    cancelledenroutecode = Column(Integer)
+    cancelledenroutedescrip = Column(String(50))
+    firstarrivingunitcode = Column(Integer)
+    firstarrivingunitdescrip = Column(String(50))
+    dispatchtype = Column(Integer)
+    dispatchtypedescrip = Column(String(100))
+    respondedfromquarterscode = Column(Integer)
+    respondedfromquarterdescrip = Column(String(100))
+    mainapparatususecode = Column(Integer)
+    mainapparatususedescrip = Column(String(100))
+    apparatustypecode = Column(Integer)
+    apparatustypedescrip = Column(String(100))
+    actiontaken1code = Column(String(10))
+    actiontaken1descip = Column(String(255))
+    actiontaken2code = Column(String(10))
+    actiontaken2descip = Column(String(255))
+    actiontaken3code = Column(String(10))
+    actiontaken3descip = Column(String(255))
+    actiontaken4code = Column(String(10))
+    actiontaken4descip = Column(String(255))
+    numberofresponders = Column(Integer)
+    dispatchdatetime = Column(DateTime)
+    dispatchtime = Column(Time)
+    dispatchdate = Column(Date)
+    dispatchenroutetime = Column(Time)
+    dispatchenroutediffseconds = Column(Integer)
+    enroutetoscenedatetime = Column(DateTime)
+    enroutetoscenetime = Column(Time)
+    enroutetoscenedate = Column(Date)
+    enroutearrivalscenetime = Column(Time)
+    enroutearrivalscenediffseconds = Column(Integer)
+    responsetime = Column(Time)
+    responsetimeseconds = Column(Integer)
+    arrivaldatetime = Column(DateTime)
+    arrivaltime = Column(Time)
+    arrivaldate = Column(Date)
+    arrivaltoenroutehospdifftime = Column(Time)
+    arrivaltoenroutehospdiffseconds = Column(Integer)
+    enroutetohospitaldatetime = Column(DateTime)
+    enroutetohospitaltime = Column(Time)
+    enroutetohospitaldate = Column(Date)
+    enroutetoarrivalhospdifftime = Column(Time)
+    enroutetoarrivalhospdiffseconds = Column(Integer)
+    arrivalscenetoarrivalhospdifftime = Column(Time)
+    arrivalscenetoarrivalhospdiffseconds = Column(Integer)
+    hospitalarrivaldatetime = Column(DateTime)
+    hospitalarrivaltime = Column(Time)
+    hospitalarrivaldate = Column(Date)
+    arrivalclearhospdifftime = Column(Time)
+    arrivalclearhospdiffseconds = Column(Integer)
+    cleardatetime = Column(DateTime)
+    cleartime = Column(Time)
+    cleardate = Column(Date)
+    dispatchcleardifftime = Column(Time)
+    dispatchcleardiffseconds = Column(Integer)
+    inservicedatetime = Column(DateTime)
+    inservicetime = Column(Time)
+    inservicedate = Column(Date)
+    emsruncode = Column(String(10))
+    emsrundescrip = Column(String(100))
+    emsrunnumber = Column(Integer)
+    losapcode = Column(Integer)
+    losapdescrip = Column(String(100))
+    alarmscode = Column(Integer)
+    alarmdescrip = Column(String(100))
+    amount1 = Column(Integer)
+    amount2 = Column(Integer)
+    fdid_no = Column(String(20))
+    stagingdatetime = Column(DateTime)
+    stagingtime = Column(Time)
+    stagingdate = Column(Date)
+    AtPatientSideDateTime = Column(DateTime)
+    AtPatientSideTime = Column(Time)
+    AtPatientSideDate = Column(Date)
+    FacilityDateTime = Column(DateTime)
+    FacilityTime = Column(Time)
+    FacilityDate = Column(Date)
+    changedate = Column(DateTime)
+
+    incident = relationship("Incident", back_populates="apparatus")

src/entities/auv_incidentapparatus/_schema.py

@@ -0,0 +1,484 @@
+from datetime import date, datetime, time
+from typing import Optional
+from pydantic import Field
+from base import BaseSchema
+
+
+class IncidentApparatusSchema(BaseSchema):
+    """Base model for Incident Apparatus view with common fields."""
+    
+    # Primary Keys and Identifiers
+    incidentkey: str = Field(
+        ..., 
+        description="The primary key for the incident table. This is a unique, system-generated 14-character identifier for every incident record.",
+        max_length=14,
+        examples=["_48Y061NFN_SMS", "_48Y006CZ7_SMS", "_48Y09QZRO_SMS"]
+    )
+    apparatuskey: Optional[str] = Field(
+        ...,
+        description="The primary key for the apparatus table. This is a unique, system-generated 14-character identifier for a specific apparatus response to an incident.",
+        max_length=14,
+        examples=["_48Y062BSQ_SMS", "_48Y006D02_SMS", "_48Y09RO93_SMS"]
+    )
+    apparatusid: Optional[str] = Field(
+        ...,
+        description="The public-facing identifier or 'unit number' of the apparatus (e.g., 'BE5', 'BB2').",
+        examples=["BE5", "BE13", "BE2", "BB2"]
+    )
+    
+    # Apparatus Classification
+    deptunitornotcode: Optional[int] = Field(
+        ...,
+        description="A code indicating whether the apparatus is a primary department unit or another type of resource. '0' = DeptUnit.",
+        ge=0,
+        le=1,
+        examples=[0]
+    )
+    deptunitornotdescrip: Optional[str] = Field(
+        ...,
+        description="A description of the apparatus's departmental affiliation. 'DeptUnit' indicates the apparatus is owned and operated by the fire department.",
+        examples=["DeptUnit"]
+    )
+    
+    # Response Priority
+    priorityresponsecode: Optional[int] = Field(
+        ...,
+        description="A code indicating the priority of the response. '1' = emergent response, '0' = non-emergent.",
+        ge=0,
+        le=1,
+        examples=[0, 1]
+    )
+    priorityresponsedescrip: Optional[str] = Field(
+        ...,
+        description="A description of the response priority. 'Yes' = emergent response, 'No' = non-emergent.",
+        examples=["No", "Yes"]
+    )
+    
+    # Cancellation Status
+    cancelledenroutecode: Optional[int] = Field(
+        ...,
+        description="A code indicating whether the apparatus was cancelled while responding. '1' = Yes, '0' = No.",
+        ge=0,
+        le=1,
+        examples=[0, 1]
+    )
+    cancelledenroutedescrip: Optional[str] = Field(
+        ...,
+        description="A description of the cancellation status. 'Yes' = cancelled en route, 'No' = not cancelled.",
+        examples=["No", "Yes"]
+    )
+    
+    # First Arriving Unit
+    firstarrivingunitcode: Optional[int] = Field(
+        ...,
+        description="A code indicating whether this apparatus was the first to arrive on scene. '1' = Yes, '0' = No.",
+        ge=0,
+        le=1,
+        examples=[1, 0]
+    )
+    firstarrivingunitdescrip: Optional[str] = Field(
+        ...,
+        description="A description of the first-arriving status. 'Yes' = first to arrive, 'No' = not first.",
+        examples=["Yes", "No"]
+    )
+    
+    # Dispatch Type
+    dispatchtype: Optional[int] = Field(
+        ...,
+        description="A code indicating the type of dispatch. This field appears to be unused or deprecated.",
+        examples=[None]
+    )
+    dispatchtypedescrip: Optional[str] = Field(
+        ...,
+        description="A description of the dispatch type. This field appears to be unused or deprecated.",
+        examples=[None]
+    )
+    
+    # Response Origin
+    respondedfromquarterscode: Optional[int] = Field(
+        ...,
+        description="A code indicating whether the apparatus responded directly from its quarters. '1' = Yes, '0' = No.",
+        ge=0,
+        le=1,
+        examples=[0, 1]
+    )
+    respondedfromquarterdescrip: Optional[str] = Field(
+        ...,
+        description="A description of the response origin. 'Yes' = responded from station, 'No' = already out.",
+        examples=["No", "Yes"]
+    )
+    
+    # Apparatus Use
+    mainapparatususecode: Optional[int] = Field(
+        ...,
+        description="A code representing the primary function or use of the apparatus during this response. '1' = suppression, '2' = EMS.",
+        ge=0,
+        le=2,
+        examples=[1]
+    )
+    mainapparatususedescrip: Optional[str] = Field(
+        ...,
+        description="A description of the primary apparatus use. 'Suppression' indicates the apparatus is primarily for firefighting.",
+        examples=["Suppression"]
+    )
+    
+    # Apparatus Type
+    apparatustypecode: Optional[int] = Field(
+        ...,
+        description="A code that specifies the type of apparatus. '11' = Engine, '12' = Truck/Aerial, '92' = Chief Officer, '16' = Brush Truck.",
+        examples=[11, 92, 12, 16]
+    )
+    apparatustypedescrip: Optional[str] = Field(
+        ...,
+        description="A description of the apparatus type. Provides the full textual name for the apparatustypecode.",
+        examples=["Engine", "Chief officer car", "Truck or aerial", "Brush truck"]
+    )
+    
+    # Actions Taken
+    actiontaken1code: Optional[str] = Field(
+        ...,
+        description="A code representing the first primary action taken by the crew of this apparatus at the scene.",
+        examples=["93", "86", "31"]
+    )
+    actiontaken1descip: Optional[str] = Field(
+        ...,
+        description="A description of the first action taken by the crew.",
+        examples=["Cancelled en route", "Investigate", "Provide first aid & check for injuries"]
+    )
+    
+    actiontaken2code: Optional[str] = Field(
+        ...,
+        description="A code representing the second primary action taken by the crew of this apparatus at the scene.",
+        examples=["93", "86", "31"]
+    )
+    actiontaken2descip: Optional[str] = Field(
+        ...,
+        description="A description of the second action taken by the crew.",
+        examples=["Cancelled en route", "Investigate", "Provide first aid & check for injuries"]
+    )
+    
+    actiontaken3code: Optional[str] = Field(
+        ...,
+        description="A code representing the third primary action taken by the crew of this apparatus at the scene.",
+        examples=["93", "86", "31"]
+    )
+    actiontaken3descip: Optional[str] = Field(
+        ...,
+        description="A description of the third action taken by the crew.",
+        examples=["Cancelled en route", "Investigate", "Provide first aid & check for injuries"]
+    )
+    
+    actiontaken4code: Optional[str] = Field(
+        ...,
+        description="A code representing the fourth primary action taken by the crew of this apparatus at the scene.",
+        examples=["93", "86", "31"]
+    )
+    actiontaken4descip: Optional[str] = Field(
+        ...,
+        description="A description of the fourth action taken by the crew.",
+        examples=["Cancelled en route", "Investigate", "Provide first aid & check for injuries"]
+    )
+    
+    # Personnel
+    numberofresponders: Optional[int] = Field(
+        ...,
+        description="The number of personnel who responded on this apparatus to the incident.",
+        ge=0,
+        examples=[3, 1, 4]
+    )
+    
+    # Dispatch Timestamps
+    dispatchdatetime: Optional[datetime] = Field(
+        ...,
+        description="The date and time when the apparatus was dispatched to the incident."
+    )
+    dispatchtime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus was dispatched, derived from dispatchdatetime."
+    )
+    dispatchdate: Optional[date] = Field(
+        ...,
+        description="The date on which the apparatus was dispatched, derived from dispatchdatetime."
+    )
+    
+    # En Route Timestamps
+    dispatchenroutetime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus acknowledged the dispatch and began traveling to the scene (en route)."
+    )
+    dispatchenroutediffseconds: Optional[int] = Field(
+        ...,
+        description="The time difference, in seconds, between dispatch and en route (turnout time).",
+        ge=0,
+        examples=[91, 79, 109]
+    )
+    
+    enroutetoscenedatetime: Optional[datetime] = Field(
+        ...,
+        description="The date and time when the apparatus reported that it was en route to the scene."
+    )
+    enroutetoscenetime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus reported it was en route to the scene."
+    )
+    enroutetoscenedate: Optional[date] = Field(
+        ...,
+        description="The date on which the apparatus reported it was en route to the scene."
+    )
+    
+    enroutearrivalscenetime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus arrived at the scene of the incident."
+    )
+    enroutearrivalscenediffseconds: Optional[int] = Field(
+        ...,
+        description="The time difference, in seconds, between en route and arrival on scene (travel time).",
+        ge=0,
+        examples=[0, 372]
+    )
+    
+    # Arrival Timestamps
+    responsetime: Optional[time] = Field(
+        ...,
+        description="The total time from dispatch to arrival on scene (h:mm:ss)."
+    )
+    responsetimeseconds: Optional[int] = Field(
+        ...,
+        description="The total response time, in seconds, from dispatch to arrival on scene.",
+        ge=0,
+        examples=[0, 457]
+    )
+    
+    arrivaldatetime: Optional[datetime] = Field(
+        ...,
+        description="The date and time when the apparatus arrived on the scene of the incident."
+    )
+    arrivaltime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus arrived on the scene."
+    )
+    arrivaldate: Optional[date] = Field(
+        ...,
+        description="The date on which the apparatus arrived on the scene."
+    )
+    
+    arrivaltoenroutehospdifftime: Optional[time] = Field(
+        ...,
+        description="This field appears to be unused or deprecated for this dataset. May relate to EMS transport time calculations."
+    )
+    arrivaltoenroutehospdiffseconds: Optional[int] = Field(
+        ...,
+        description="This field appears to be unused or deprecated for this dataset.",
+        ge=0,
+        examples=[0]
+    )
+    
+    # Hospital Transport Timestamps
+    enroutetohospitaldatetime: Optional[datetime] = Field(
+        ...,
+        description="The date and time when the apparatus began transporting a patient to the hospital. NULL for non-EMS responses."
+    )
+    enroutetohospitaltime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus began transporting a patient to the hospital."
+    )
+    enroutetohospitaldate: Optional[date] = Field(
+        ...,
+        description="The date on which the apparatus began transporting a patient to the hospital."
+    )
+    
+    enroutetoarrivalhospdifftime: Optional[time] = Field(
+        ...,
+        description="This field appears to be unused or deprecated for this dataset."
+    )
+    enroutetoarrivalhospdiffseconds: Optional[int] = Field(
+        ...,
+        description="This field appears to be unused or deprecated for this dataset.",
+        ge=0,
+        examples=[0]
+    )
+    
+    arrivalscenetoarrivalhospdifftime: Optional[time] = Field(
+        ...,
+        description="This field appears to be unused or deprecated for this dataset."
+    )
+    arrivalscenetoarrivalhospdiffseconds: Optional[int] = Field(
+        ...,
+        description="This field appears to be unused or deprecated for this dataset.",
+        ge=0,
+        examples=[0]
+    )
+    
+    hospitalarrivaldatetime: Optional[datetime] = Field(
+        ...,
+        description="The date and time when the apparatus arrived at the hospital with a patient. NULL for non-EMS responses."
+    )
+    hospitalarrivaltime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus arrived at the hospital."
+    )
+    hospitalarrivaldate: Optional[date] = Field(
+        ...,
+        description="The date on which the apparatus arrived at the hospital."
+    )
+    
+    arrivalclearhospdifftime: Optional[time] = Field(
+        ...,
+        description="This field appears to be unused or deprecated for this dataset."
+    )
+    arrivalclearhospdiffseconds: Optional[int] = Field(
+        ...,
+        description="This field appears to be unused or deprecated for this dataset.",
+        ge=0,
+        examples=[0]
+    )
+    
+    # Clear Timestamps
+    cleardatetime: Optional[datetime] = Field(
+        ...,
+        description="The date and time when the apparatus was cleared from the incident and became available for another response."
+    )
+    cleartime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus was cleared from the incident."
+    )
+    cleardate: Optional[date] = Field(
+        ...,
+        description="The date on which the apparatus was cleared from the incident."
+    )
+    
+    dispatchcleardifftime: Optional[time] = Field(
+        ...,
+        description="The total time from dispatch to being cleared from the incident (h:mm:ss)."
+    )
+    dispatchcleardiffseconds: Optional[int] = Field(
+        ...,
+        description="The total time from dispatch to being cleared, in seconds.",
+        ge=0,
+        examples=[550, 325, 655]
+    )
+    
+    # In Service Timestamps
+    inservicedatetime: Optional[datetime] = Field(
+        ...,
+        description="The date and time when the apparatus was placed back in service and available for responses."
+    )
+    inservicetime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus was placed back in service."
+    )
+    inservicedate: Optional[date] = Field(
+        ...,
+        description="The date on which the apparatus was placed back in service."
+    )
+    
+    # EMS Information
+    emsruncode: Optional[str] = Field(
+        ...,
+        description="A code indicating whether this was an EMS (Emergency Medical Services) run.",
+        examples=["Not EMS Run"]
+    )
+    emsrundescrip: Optional[str] = Field(
+        ...,
+        description="A description of the EMS run status.",
+        examples=[None]
+    )
+    emsrunnumber: Optional[int] = Field(
+        ...,
+        description="A number associated with the EMS run, potentially a sequential or tracking number.",
+        examples=[None]
+    )
+    
+    # LOSAP Information
+    losapcode: Optional[int] = Field(
+        ...,
+        description="A code related to LOSAP (Length of Service Award Program) credit. '1' = qualifies for LOSAP credit.",
+        ge=0,
+        le=1,
+        examples=[1]
+    )
+    losapdescrip: Optional[str] = Field(
+        ...,
+        description="A description of the LOSAP credit status.",
+        examples=["Losap Credit"]
+    )
+    
+    # Alarms Information
+    alarmscode: Optional[int] = Field(
+        ...,
+        description="A code indicating the alarm level or number of alarms for the incident.",
+        examples=[None]
+    )
+    alarmdescrip: Optional[str] = Field(
+        ...,
+        description="A description of the alarm level.",
+        examples=[None]
+    )
+    
+    # Amount Fields
+    amount1: Optional[int] = Field(
+        ...,
+        description="Generic numeric field, possibly for recording quantities like hose lengths, water used, or other resources.",
+        examples=[None]
+    )
+    amount2: Optional[int] = Field(
+        ...,
+        description="Generic numeric field, possibly for recording quantities like hose lengths, water used, or other resources.",
+        examples=[None]
+    )
+    
+    # FDID
+    fdid_no: Optional[str] = Field(
+        ...,
+        description="The Fire Department ID number.",
+        examples=[None]
+    )
+    
+    # Staging Information
+    stagingdatetime: Optional[datetime] = Field(
+        ...,
+        description="The date and time when the apparatus was placed in a staging area."
+    )
+    stagingtime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus was placed in a staging area."
+    )
+    stagingdate: Optional[date] = Field(
+        ...,
+        description="The date on which the apparatus was placed in a staging area."
+    )
+    
+    # Patient Side Information
+    AtPatientSideDateTime: Optional[datetime] = Field(
+        ...,
+        description="The date and time when the crew arrived at the patient's side, typically for EMS calls."
+    )
+    AtPatientSideTime: Optional[time] = Field(
+        ...,
+        description="The time of day when the crew arrived at the patient's side."
+    )
+    AtPatientSideDate: Optional[date] = Field(
+        ...,
+        description="The date on which the crew arrived at the patient's side."
+    )
+    
+    # Facility Information (duplicate of hospital fields)
+    FacilityDateTime: Optional[datetime] = Field(
+        ...,
+        description="The date and time when the apparatus arrived at a medical facility with a patient."
+    )
+    FacilityTime: Optional[time] = Field(
+        ...,
+        description="The time of day when the apparatus arrived at a medical facility."
+    )
+    FacilityDate: Optional[date] = Field(
+        ...,
+        description="The date on which the apparatus arrived at a medical facility."
+    )
+    
+    # Change Tracking
+    changedate: Optional[datetime] = Field(
+        ...,
+        description="A timestamp indicating the last time this record was modified in the database.",
+        examples=["43:34.2", "10:02.9", "36:07.4"]
+    )

src/entities/auv_incidentbase/__init__.py

@@ -0,0 +1,2 @@
+from _model import *
+from _schema import *

src/entities/auv_incidentbase/_model.py

@@ -0,0 +1,185 @@
+from sqlalchemy import Column, String, Integer, Float, DateTime, Text
+from base import BaseModel_
+
+
+class IncidentBaseModel(BaseModel_):
+    __tablename__ = "auv_incidentbase"
+
+    incidentkey = Column(String(14), primary_key=True, index=True)
+    IncidentNumber = Column(String(20))
+    IncidentExposureNumber = Column(String(5))
+    CompletedReportCode = Column(String(2))
+    CompletedReportDescrip = Column(String(50))
+    ReviewedReportCode = Column(String(2))
+    ReviewReportDescrip = Column(String(50))
+    PublicReleaseReportCode = Column(String(2))
+    PublicReleaseReportDescrip = Column(String(50))
+    DidNotArriveCode = Column(String(2))
+    DidNotArriveDescrip = Column(String(50))
+    AlarmDateTime = Column(DateTime)
+    Alarmtime = Column(String(10))
+    Alarmdate = Column(String(10))
+    ArrivalDateTime = Column(DateTime)
+    Arrivaltime = Column(String(10))
+    Arrivaldate = Column(String(10))
+    ControlledDateTime = Column(DateTime)
+    Controlledtime = Column(String(10))
+    Controlleddate = Column(String(10))
+    ClearedDateTime = Column(DateTime)
+    Clearedtime = Column(String(10))
+    Cleareddate = Column(String(10))
+    ResponseTime = Column(String(20))
+    ResponseTimediffseconds = Column(Integer)
+    IncidentTotalTime1 = Column(String(20))
+    IncidentTotalTimediffseconds = Column(Integer)
+    District = Column(String(20))
+    Station = Column(String(20))
+    Shift = Column(String(10))
+    Alarms = Column(Integer)
+    IncidentTypeCode = Column(String(10))
+    IncidentTypeDescrip = Column(String(255))
+    InitialDispatchCode = Column(String(10))
+    finaldispatchcode = Column(String(10))
+    MutualAidFlagCode = Column(String(2))
+    MutualAidTypeCode = Column(String(10))
+    MutualAidTypeDescrip = Column(String(255))
+    MutalAidIncidentNo = Column(String(50))
+    actiontaken1code = Column(String(10))
+    actiontaken1descip = Column(String(255))
+    actiontaken2code = Column(String(10))
+    actiontaken2descip = Column(String(255))
+    actiontaken3code = Column(String(10))
+    actiontaken3descip = Column(String(255))
+    ApparatusSuppressionCount = Column(Integer)
+    ApparatusEMSCount = Column(Integer)
+    ApparatusOtherCount = Column(Integer)
+    ApparatusTotalCount = Column(Integer)
+    PersonnelSuppressionCount = Column(Integer)
+    PersonnelEMSCount = Column(Integer)
+    PersonnelOtherCount = Column(Integer)
+    PersonnelTotalCount = Column(Integer)
+    MAidApparatusSuppressionCount = Column(Integer)
+    MAidApparatusEMSCount = Column(Integer)
+    MAidApparatusOtherCount = Column(Integer)
+    MAidApparatusTotalCount = Column(Integer)
+    MAidPersonnelSuppressionCount = Column(Integer)
+    MaidPersonnelEMSCount = Column(Integer)
+    MAidPersonnelOtherCount = Column(Integer)
+    MaidPersonnelTotalCount = Column(Integer)
+    LossProperty = Column(Float)
+    LossContents = Column(Float)
+    ValueProperty = Column(Float)
+    ValueContents = Column(Float)
+    LossTotal = Column(Float)
+    ValueTotal = Column(Float)
+    ValueSaved = Column(Float)
+    DetectorAlertedCode = Column(String(10))
+    DetectorAlertedDescrip = Column(String(255))
+    HazardMaterialReleasedCode = Column(String(10))
+    HazardMaterialReleasedDescrip = Column(String(255))
+    PropertyUseCode = Column(String(10))
+    PropertyUseDescrip = Column(String(255))
+    MixedUseCode = Column(String(10))
+    MixedUseDescrip = Column(String(255))
+    StreetNumber = Column(String(50))
+    StreetPrefix = Column(String(20))
+    StreetName = Column(String(255))
+    StreetType = Column(String(20))
+    StreetSuffix = Column(String(20))
+    Apartment = Column(String(20))
+    City = Column(String(100))
+    State = Column(String(20))
+    ZipCode = Column(String(20))
+    AddressComposite = Column(Text)
+    CityStateZipComposite = Column(Text)
+    CensusTract = Column(String(20))
+    EmsProvidedCode = Column(String(2))
+    EMSProvidedDescrip = Column(String(50))
+    LocationTypeCode = Column(String(5))
+    LocationTypeDescrip = Column(String(100))
+    fatalfireservicecode = Column(String(2))
+    fatalfireservicedescrip = Column(String(100))
+    fatalciviliancode = Column(String(2))
+    fatalciviliandescrip = Column(String(100))
+    injuredfireservicecode = Column(String(2))
+    injuredfireservicedescrip = Column(String(100))
+    injuredciviliancode = Column(String(2))
+    injuredciviliandescrip = Column(String(100))
+    casualtiescode = Column(String(2))
+    casualtiesdescrip = Column(String(100))
+    priorityrespcode = Column(String(2))
+    priorityrespdescrip = Column(String(100))
+    crossstreetprefix = Column(String(20))
+    crossstreetname = Column(String(255))
+    crossstreettype = Column(String(20))
+    crossstreetsuffix = Column(String(20))
+    CrossStreetComposite = Column(Text)
+    directions = Column(Text)
+    county = Column(String(100))
+    mappage = Column(String(50))
+    hwycalloutrequestby = Column(String(50))
+    hwyinvestpolicecode = Column(String(10))
+    hwyinvetpolicedescrip = Column(String(255))
+    hwyofficer = Column(String(100))
+    hwybadgenumber = Column(String(20))
+    hwyreportnumber = Column(String(50))
+    hwycauseemergcode = Column(String(10))
+    hwycauseemergdescrip = Column(String(255))
+    hwycauseotherdescrip = Column(Text)
+    hwyloecode = Column(String(10))
+    hwyloedescrip = Column(String(255))
+    hwyloeotherdescrip = Column(Text)
+    hwyobstrcutioncode = Column(String(10))
+    hwyobstructiondescrip = Column(String(255))
+    hwyobstructionotherdescrip = Column(Text)
+    hwynoservicecode = Column(String(2))
+    hwynoservicedescrip = Column(String(100))
+    hwyextinguishcode = Column(String(2))
+    hwyextinguishdescrip = Column(String(100))
+    hwycleanupcode = Column(String(2))
+    hwycleanupdescrip = Column(String(100))
+    hwyextractioncode = Column(String(2))
+    hwyextractiodescrip = Column(String(100))
+    hwyfirstaidcode = Column(String(2))
+    hwyfirstaidedescrip = Column(String(100))
+    hwydamagecode = Column(String(2))
+    hwydamagedescrip = Column(String(100))
+    hwyprivatedamcode = Column(String(2))
+    hwyprivatedescrip = Column(String(100))
+    hwycitycode = Column(String(2))
+    hwycitydescrip = Column(String(100))
+    hwyothercode = Column(String(2))
+    hwynotherdescrip = Column(String(100))
+    hwyothertext = Column(Text)
+    water_used = Column(String(2))
+    water_used_quantity = Column(Float)
+    foam_used = Column(String(2))
+    foam_used_quantity = Column(Float)
+    oilzorb_used = Column(String(2))
+    oilzorb_used_quantity = Column(Float)
+    other_used = Column(String(2))
+    other_used_quantity = Column(Float)
+    codetectpresentcode = Column(String(2))
+    codetectpresentdescrip = Column(String(100))
+    cotypecode = Column(String(10))
+    cotypedescrip = Column(String(255))
+    copowersupplycode = Column(String(10))
+    copowersupplydescrip = Column(String(255))
+    cooperationcode = Column(String(10))
+    cooperationdescrip = Column(String(255))
+    coeffectivecode = Column(String(10))
+    coeffectivedescrip = Column(String(255))
+    cofailurecode = Column(String(10))
+    cofailuredescrip = Column(String(255))
+    codetectormfg = Column(String(100))
+    codetectormodel = Column(String(100))
+    cochildrencount = Column(Integer)
+    coyouthscount = Column(Integer)
+    coadultscount = Column(Integer)
+    coseniorscount = Column(Integer)
+    latitude = Column(Float)
+    longitude = Column(Float)
+    changedate = Column(DateTime)
+    IncidentDateTime = Column(DateTime)
+    Incidenttime = Column(String(10))
+    Incidentdate = Column(String(10))

src/entities/auv_incidentbase/_schema.py

@@ -0,0 +1,193 @@
+from pydantic import BaseModel, Field
+from datetime import datetime, time, date
+from typing import Optional
+from base import BaseSchema
+
+
+class IncidentBaseSchema(BaseSchema):
+    """Base Pydantic schema for IncidentFullView, matching the SQLAlchemy model."""
+    
+    IncidentNumber: Optional[str] = Field(None, description="The human-readable, sequential number assigned to an incident by the dispatch center.")
+    IncidentExposureNumber: Optional[str] = Field(None, description="A number used to differentiate between multiple separate fire or event 'exposures'.")
+    CompletedReportCode: Optional[str] = Field(None, description="A code indicating the completion status of the incident report.")
+    CompletedReportDescrip: Optional[str] = Field(None, description="A textual description corresponding to the CompletedReportCode.")
+    ReviewedReportCode: Optional[str] = Field(None, description="A code indicating whether the incident report has been reviewed.")
+    ReviewReportDescrip: Optional[str] = Field(None, description="A textual description corresponding to the ReviewedReportCode.")
+    PublicReleaseReportCode: Optional[str] = Field(None, description="A code indicating if the report is cleared for public release.")
+    PublicReleaseReportDescrip: Optional[str] = Field(None, description="A textual description corresponding to the PublicReleaseReportCode.")
+    DidNotArriveCode: Optional[str] = Field(None, description="A flag indicating whether the fire unit arrived on the scene.")
+    DidNotArriveDescrip: Optional[str] = Field(None, description="A textual description corresponding to the DidNotArriveCode.")
+    AlarmDateTime: Optional[datetime] = Field(None, description="The timestamp the alarm was received.")
+    Alarmtime: Optional[str] = Field(None, description="The time portion of the alarm receipt timestamp.")
+    Alarmdate: Optional[str] = Field(None, description="The date portion of the alarm receipt timestamp.")
+    ArrivalDateTime: Optional[datetime] = Field(None, description="The timestamp the first unit arrived on the scene.")
+    Arrivaltime: Optional[str] = Field(None, description="The time portion of the arrival timestamp.")
+    Arrivaldate: Optional[str] = Field(None, description="The date portion of the arrival timestamp.")
+    ControlledDateTime: Optional[datetime] = Field(None, description="The timestamp the incident was controlled.")
+    Controlledtime: Optional[str] = Field(None, description="The time portion of the controlled timestamp.")
+    Controlleddate: Optional[str] = Field(None, description="The date portion of the controlled timestamp.")
+    ClearedDateTime: Optional[datetime] = Field(None, description="The timestamp the incident was cleared.")
+    Clearedtime: Optional[str] = Field(None, description="The time portion of the cleared timestamp.")
+    Cleareddate: Optional[str] = Field(None, description="The date portion of the cleared timestamp.")
+    ResponseTime: Optional[str] = Field(None, description="Human-readable representation of the time taken from alarm to arrival (MM:SS).")
+    ResponseTimediffseconds: Optional[int] = Field(None, description="The ResponseTime expressed purely as a total number of seconds.")
+    IncidentTotalTime1: Optional[str] = Field(None, description="Human-readable representation of the total incident duration.")
+    IncidentTotalTimediffseconds: Optional[int] = Field(None, description="The total incident duration expressed as a total number of seconds.")
+    District: Optional[str] = Field(None, description="The district code for the geographic area in which the incident occurred.")
+    Station: Optional[str] = Field(None, description="The station number or code of the primary fire station that responded.")
+    Shift: Optional[str] = Field(None, description="The shift that was on duty at the time of the incident.")
+    Alarms: Optional[int] = Field(None, description="The number of alarms for the incident.")
+    IncidentTypeCode: Optional[str] = Field(None, description="A code that classifies the primary type of incident.")
+    IncidentTypeDescrip: Optional[str] = Field(None, description="A textual description corresponding to the IncidentTypeCode.")
+    InitialDispatchCode: Optional[str] = Field(None, description="The code for the initial dispatch call type.")
+    finaldispatchcode: Optional[str] = Field(None, description="The final code assigned to the dispatch.")
+    MutualAidFlagCode: Optional[str] = Field(None, description="Flag indicating if mutual aid was requested.")
+    MutualAidTypeCode: Optional[str] = Field(None, description="The code for the type of mutual aid provided.")
+    MutualAidTypeDescrip: Optional[str] = Field(None, description="A textual description of the mutual aid type.")
+    MutalAidIncidentNo: Optional[str] = Field(None, description="The incident number of the mutual aid agency.")
+    actiontaken1code: Optional[str] = Field(None, description="Code describing the primary action taken by fire personnel.")
+    actiontaken1descip: Optional[str] = Field(None, description="Textual description of the primary action taken.")
+    actiontaken2code: Optional[str] = Field(None, description="Code describing the secondary action taken by fire personnel.")
+    actiontaken2descip: Optional[str] = Field(None, description="Textual description of the secondary action taken.")
+    actiontaken3code: Optional[str] = Field(None, description="Code describing the tertiary action taken by fire personnel.")
+    actiontaken3descip: Optional[str] = Field(None, description="Textual description of the tertiary action taken.")
+    ApparatusSuppressionCount: Optional[int] = Field(None, description="Number of suppression apparatus (fire engines) that responded.")
+    ApparatusEMSCount: Optional[int] = Field(None, description="Number of EMS apparatus (ambulances) that responded.")
+    ApparatusOtherCount: Optional[int] = Field(None, description="Number of other apparatus that responded.")
+    ApparatusTotalCount: Optional[int] = Field(None, description="Total number of apparatus that responded.")
+    PersonnelSuppressionCount: Optional[int] = Field(None, description="Number of suppression personnel that responded.")
+    PersonnelEMSCount: Optional[int] = Field(None, description="Number of EMS personnel that responded.")
+    PersonnelOtherCount: Optional[int] = Field(None, description="Number of other personnel that responded.")
+    PersonnelTotalCount: Optional[int] = Field(None, description="Total number of personnel that responded.")
+    MAidApparatusSuppressionCount: Optional[int] = Field(None, description="Number of mutual aid suppression apparatus that responded.")
+    MAidApparatusEMSCount: Optional[int] = Field(None, description="Number of mutual aid EMS apparatus that responded.")
+    MAidApparatusOtherCount: Optional[int] = Field(None, description="Number of mutual aid other apparatus that responded.")
+    MAidApparatusTotalCount: Optional[int] = Field(None, description="Total number of mutual aid apparatus that responded.")
+    MAidPersonnelSuppressionCount: Optional[int] = Field(None, description="Number of mutual aid suppression personnel that responded.")
+    MaidPersonnelEMSCount: Optional[int] = Field(None, description="Number of mutual aid EMS personnel that responded.")
+    MAidPersonnelOtherCount: Optional[int] = Field(None, description="Number of mutual aid other personnel that responded.")
+    MaidPersonnelTotalCount: Optional[int] = Field(None, description="Total number of mutual aid personnel that responded.")
+    LossProperty: Optional[float] = Field(None, description="Value of property loss.")
+    LossContents: Optional[float] = Field(None, description="Value of contents loss.")
+    ValueProperty: Optional[float] = Field(None, description="Value of property at risk.")
+    ValueContents: Optional[float] = Field(None, description="Value of contents at risk.")
+    LossTotal: Optional[float] = Field(None, description="Total value of loss (property + contents).")
+    ValueTotal: Optional[float] = Field(None, description="Total value at risk (property + contents).")
+    ValueSaved: Optional[float] = Field(None, description="Total value saved.")
+    DetectorAlertedCode: Optional[str] = Field(None, description="Code indicating if and how a detector alerted occupants.")
+    DetectorAlertedDescrip: Optional[str] = Field(None, description="Textual description of how the detector alerted.")
+    HazardMaterialReleasedCode: Optional[str] = Field(None, description="Code indicating if a hazardous material was released.")
+    HazardMaterialReleasedDescrip: Optional[str] = Field(None, description="Textual description of the hazardous material released.")
+    PropertyUseCode: Optional[str] = Field(None, description="Code for the primary use of the property.")
+    PropertyUseDescrip: Optional[str] = Field(None, description="Textual description of the property use.")
+    MixedUseCode: Optional[str] = Field(None, description="Code indicating if the property has mixed uses.")
+    MixedUseDescrip: Optional[str] = Field(None, description="Textual description of the mixed use.")
+    StreetNumber: Optional[str] = Field(None, description="The street number of the incident location.")
+    StreetPrefix: Optional[str] = Field(None, description="The street prefix (e.g., N, S, E, W).")
+    StreetName: Optional[str] = Field(None, description="The name of the street.")
+    StreetType: Optional[str] = Field(None, description="The street type (e.g., St, Ave, Rd).")
+    StreetSuffix: Optional[str] = Field(None, description="The street suffix.")
+    Apartment: Optional[str] = Field(None, description="Apartment or unit number.")
+    City: Optional[str] = Field(None, description="The city of the incident location.")
+    State: Optional[str] = Field(None, description="The state of the incident location.")
+    ZipCode: Optional[str] = Field(None, description="The zip code of the incident location.")
+    AddressComposite: Optional[str] = Field(None, description="A concatenated string of the full, formatted street address.")
+    CityStateZipComposite: Optional[str] = Field(None, description="A concatenated string of the city, state, and zip code.")
+    CensusTract: Optional[str] = Field(None, description="The census tract of the incident location.")
+    EmsProvidedCode: Optional[str] = Field(None, description="Code indicating if EMS was provided.")
+    EMSProvidedDescrip: Optional[str] = Field(None, description="Textual description of EMS provided.")
+    LocationTypeCode: Optional[str] = Field(None, description="Code for the type of location (e.g., building, street).")
+    LocationTypeDescrip: Optional[str] = Field(None, description="Textual description of the location type.")
+    fatalfireservicecode: Optional[str] = Field(None, description="Code indicating a firefighter fatality.")
+    fatalfireservicedescrip: Optional[str] = Field(None, description="Description of firefighter fatality.")
+    fatalciviliancode: Optional[str] = Field(None, description="Code indicating a civilian fatality.")
+    fatalciviliandescrip: Optional[str] = Field(None, description="Description of civilian fatality.")
+    injuredfireservicecode: Optional[str] = Field(None, description="Code indicating a firefighter injury.")
+    injuredfireservicedescrip: Optional[str] = Field(None, description="Description of firefighter injury.")
+    injuredciviliancode: Optional[str] = Field(None, description="Code indicating a civilian injury.")
+    injuredciviliandescrip: Optional[str] = Field(None, description="Description of civilian injury.")
+    casualtiescode: Optional[str] = Field(None, description="Code indicating casualties.")
+    casualtiesdescrip: Optional[str] = Field(None, description="Description of casualties.")
+    priorityrespcode: Optional[str] = Field(None, description="Code indicating priority of response.")
+    priorityrespdescrip: Optional[str] = Field(None, description="Description of priority response.")
+    crossstreetprefix: Optional[str] = Field(None, description="Prefix for the nearest cross street.")
+    crossstreetname: Optional[str] = Field(None, description="Name of the nearest cross street.")
+    crossstreettype: Optional[str] = Field(None, description="Type of the nearest cross street.")
+    crossstreetsuffix: Optional[str] = Field(None, description="Suffix for the nearest cross street.")
+    CrossStreetComposite: Optional[str] = Field(None, description="Concatenated string of the nearest cross street.")
+    directions: Optional[str] = Field(None, description="Special directions to the incident location.")
+    county: Optional[str] = Field(None, description="The county of the incident location.")
+    mappage: Optional[str] = Field(None, description="Map page or grid reference.")
+    hwycalloutrequestby: Optional[str] = Field(None, description="Highway incident: who requested the call out.")
+    hwyinvestpolicecode: Optional[str] = Field(None, description="Highway incident: code for police investigation.")
+    hwyinvetpolicedescrip: Optional[str] = Field(None, description="Highway incident: description of police investigation.")
+    hwyofficer: Optional[str] = Field(None, description="Highway incident: name of the officer.")
+    hwybadgenumber: Optional[str] = Field(None, description="Highway incident: badge number of the officer.")
+    hwyreportnumber: Optional[str] = Field(None, description="Highway incident: report number.")
+    hwycauseemergcode: Optional[str] = Field(None, description="Highway incident: code for the cause of the emergency.")
+    hwycauseemergdescrip: Optional[str] = Field(None, description="Highway incident: description of the cause.")
+    hwycauseotherdescrip: Optional[str] = Field(None, description="Highway incident: other cause description.")
+    hwyloecode: Optional[str] = Field(None, description="Highway incident: code for the location of the emergency.")
+    hwyloedescrip: Optional[str] = Field(None, description="Highway incident: description of the location.")
+    hwyloeotherdescrip: Optional[str] = Field(None, description="Highway incident: other location description.")
+    hwyobstrcutioncode: Optional[str] = Field(None, description="Highway incident: code for obstructions.")
+    hwyobstructiondescrip: Optional[str] = Field(None, description="Highway incident: description of obstructions.")
+    hwyobstructionotherdescrip: Optional[str] = Field(None, description="Highway incident: other obstruction description.")
+    hwynoservicecode: Optional[str] = Field(None, description="Highway incident: code for no service.")
+    hwynoservicedescrip: Optional[str] = Field(None, description="Highway incident: description of no service.")
+    hwyextinguishcode: Optional[str] = Field(None, description="Highway incident: code for extinguishment.")
+    hwyextinguishdescrip: Optional[str] = Field(None, description="Highway incident: description of extinguishment.")
+    hwycleanupcode: Optional[str] = Field(None, description="Highway incident: code for cleanup.")
+    hwycleanupdescrip: Optional[str] = Field(None, description="Highway incident: description of cleanup.")
+    hwyextractioncode: Optional[str] = Field(None, description="Highway incident: code for extraction.")
+    hwyextractiodescrip: Optional[str] = Field(None, description="Highway incident: description of extraction.")
+    hwyfirstaidcode: Optional[str] = Field(None, description="Highway incident: code for first aid.")
+    hwyfirstaidedescrip: Optional[str] = Field(None, description="Highway incident: description of first aid.")
+    hwydamagecode: Optional[str] = Field(None, description="Highway incident: code for property damage.")
+    hwydamagedescrip: Optional[str] = Field(None, description="Highway incident: description of property damage.")
+    hwyprivatedamcode: Optional[str] = Field(None, description="Highway incident: code for private property damage.")
+    hwyprivatedescrip: Optional[str] = Field(None, description="Highway incident: description of private damage.")
+    hwycitycode: Optional[str] = Field(None, description="Highway incident: code for city property damage.")
+    hwycitydescrip: Optional[str] = Field(None, description="Highway incident: description of city damage.")
+    hwyothercode: Optional[str] = Field(None, description="Highway incident: code for other actions.")
+    hwynotherdescrip: Optional[str] = Field(None, description="Highway incident: description of other actions.")
+    hwyothertext: Optional[str] = Field(None, description="Highway incident: other text.")
+    water_used: Optional[str] = Field(None, description="Flag indicating if water was used.")
+    water_used_quantity: Optional[float] = Field(None, description="Quantity of water used.")
+    foam_used: Optional[str] = Field(None, description="Flag indicating if foam was used.")
+    foam_used_quantity: Optional[float] = Field(None, description="Quantity of foam used.")
+    oilzorb_used: Optional[str] = Field(None, description="Flag indicating if oil/zorb was used.")
+    oilzorb_used_quantity: Optional[float] = Field(None, description="Quantity of oil/zorb used.")
+    other_used: Optional[str] = Field(None, description="Flag indicating if other agents were used.")
+    other_used_quantity: Optional[float] = Field(None, description="Quantity of other agents used.")
+    codetectpresentcode: Optional[str] = Field(None, description="Code indicating if a CO detector was present.")
+    codetectpresentdescrip: Optional[str] = Field(None, description="Description of CO detector presence.")
+    cotypecode: Optional[str] = Field(None, description="Code for the type of CO detector.")
+    cotypedescrip: Optional[str] = Field(None, description="Description of the type of CO detector.")
+    copowersupplycode: Optional[str] = Field(None, description="Code for the power supply of the CO detector.")
+    copowersupplydescrip: Optional[str] = Field(None, description="Description of the power supply.")
+    cooperationcode: Optional[str] = Field(None, description="Code indicating if the CO detector was operational.")
+    cooperationdescrip: Optional[str] = Field(None, description="Description of CO detector operation.")
+    coeffectivecode: Optional[str] = Field(None, description="Code indicating if the CO detector was effective.")
+    coeffectivedescrip: Optional[str] = Field(None, description="Description of CO detector effectiveness.")
+    cofailurecode: Optional[str] = Field(None, description="Code indicating CO detector failure.")
+    cofailuredescrip: Optional[str] = Field(None, description="Description of CO detector failure.")
+    codetectormfg: Optional[str] = Field(None, description="Manufacturer of the CO detector.")
+    codetectormodel: Optional[str] = Field(None, description="Model of the CO detector.")
+    cochildrencount: Optional[int] = Field(None, description="Number of children affected by CO incident.")
+    coyouthscount: Optional[int] = Field(None, description="Number of youths affected by CO incident.")
+    coadultscount: Optional[int] = Field(None, description="Number of adults affected by CO incident.")
+    coseniorscount: Optional[int] = Field(None, description="Number of seniors affected by CO incident.")
+    latitude: Optional[float] = Field(None, description="Latitude of the incident location.")
+    longitude: Optional[float] = Field(None, description="Longitude of the incident location.")
+    changedate: Optional[datetime] = Field(None, description="Timestamp when the record was last changed.")
+    IncidentDateTime: Optional[datetime] = Field(None, description="Combined incident date and time.")
+    Incidenttime: Optional[str] = Field(None, description="Time portion of the incident timestamp.")
+    Incidentdate: Optional[str] = Field(None, description="Date portion of the incident timestamp.")
+    memberdescrip: Optional[str] = Field(None, description="The role or description of the crew member who made the report.")
+    memberidnumber: Optional[str] = Field(None, description="The unique identifier or employee ID number for the reporting member.")
+    membernamelast: Optional[str] = Field(None, description="Last name of the reporting member.")
+    membernamefirst: Optional[str] = Field(None, description="First name of the reporting member.")
+    membermi: Optional[str] = Field(None, description="Middle initial of the reporting member.")
+    memberpositiondescrip: Optional[str] = Field(None, description="The job title or rank of the reporting member.")
+    memberassignmentdescrip: Optional[str] = Field(None, description="The crew or unit assignment of the reporting member.")

src/entities/auv_incidentpersonnel/__init__.py

@@ -0,0 +1,2 @@
+from _model import *
+from _schema import *

src/entities/auv_incidentpersonnel/_model.py

@@ -0,0 +1,30 @@
+from sqlalchemy import Column, String, Integer, Float
+from database import Base
+
+
+class IncidentPersonnelModel(Base):
+    __tablename__ = "auv_incidentpersonnel"
+
+    personnelkey = Column(String(14), primary_key=True, index=True)
+    namefirst = Column(String(25))
+    namemi = Column(String(2))
+    namelast = Column(String(25))
+    namesuffix = Column(String(5))
+    rank = Column(String(10))
+    actiontaken1code = Column(String(10))
+    actiontaken1descip = Column(String(255))
+    actiontaken2code = Column(String(10))
+    actiontaken2descip = Column(String(255))
+    actiontaken3code = Column(String(10))
+    actiontaken3descip = Column(String(255))
+    actiontaken4code = Column(String(10))
+    actiontaken4descip = Column(String(255))
+    amount1 = Column(Float)
+    amount2 = Column(Float)
+    crole = Column(Integer)
+    losapcreditcode = Column(Integer)
+    losapcreditdescrip = Column(String(100))
+    apparatusid = Column(String(10))
+    numberofresponders = Column(Integer)
+    responsetimeseconds = Column(Integer)
+    dispatchcleardiffseconds = Column(Integer)

src/entities/auv_incidentpersonnel/_schema.py

@@ -0,0 +1,156 @@
+from typing import Optional
+from pydantic import BaseModel, Field
+
+
+class IncidentPersonnelSchema(BaseModel):
+    """
+    Schema representing personnel assigned to a fire incident.
+    This table links firefighters/personnel with apparatus and incidents,
+    including their actions, response details, and role during the event.
+    """
+
+    personnelkey: str = Field(
+        ...,
+        max_length=14,
+        description="Unique system-generated identifier for a personnel assignment record in an incident. "
+                    "Used as the primary key linking personnel activity within the incident dataset.",
+        examples=["_4GR15265W_SMS"]
+    )
+
+    namefirst: Optional[str] = Field(
+        None,
+        max_length=25,
+        description="First name of the firefighter or personnel.",
+        examples=["Dale", "Brandon", "Kyle"]
+    )
+
+    namemi: Optional[str] = Field(
+        None,
+        max_length=2,
+        description="Middle initial of the firefighter or personnel.",
+        examples=["E", "A", "S"]
+    )
+
+    namelast: Optional[str] = Field(
+        None,
+        max_length=25,
+        description="Last name of the firefighter or personnel.",
+        examples=["Bryan", "Davis", "Coles"]
+    )
+
+    namesuffix: Optional[str] = Field(
+        None,
+        max_length=5,
+        description="Name suffix such as Jr., Sr., or III.",
+        examples=["Jr", "III"]
+    )
+
+    rank: Optional[str] = Field(
+        None,
+        max_length=10,
+        description="Rank or title of the personnel during service.",
+        examples=["CAPT", "FF", "ENG"]
+    )
+
+    actiontaken1code: Optional[str] = Field(
+        None,
+        max_length=10,
+        description="Code representing the primary action taken by the personnel during the incident.",
+        examples=["93"]
+    )
+
+    actiontaken1descip: Optional[str] = Field(
+        None,
+        max_length=255,
+        description="Description of the primary action taken.",
+        examples=["Cancelled en route"]
+    )
+
+    actiontaken2code: Optional[str] = Field(
+        None,
+        max_length=10,
+        description="Code representing the secondary action taken by personnel."
+    )
+
+    actiontaken2descip: Optional[str] = Field(
+        None,
+        max_length=255,
+        description="Description of the secondary action taken."
+    )
+
+    actiontaken3code: Optional[str] = Field(
+        None,
+        max_length=10,
+        description="Code representing the tertiary action taken by personnel."
+    )
+
+    actiontaken3descip: Optional[str] = Field(
+        None,
+        max_length=255,
+        description="Description of the tertiary action taken."
+    )
+
+    actiontaken4code: Optional[str] = Field(
+        None,
+        max_length=10,
+        description="Code representing the fourth action taken by personnel."
+    )
+
+    actiontaken4descip: Optional[str] = Field(
+        None,
+        max_length=255,
+        description="Description of the fourth action taken."
+    )
+
+    amount1: Optional[float] = Field(
+        None,
+        description="Generic numeric value related to incident reporting or action measurement."
+    )
+
+    amount2: Optional[float] = Field(
+        None,
+        description="Secondary numeric value used for reporting metrics."
+    )
+
+    crole: Optional[int] = Field(
+        None,
+        description="Code indicating the operational role of the personnel during the incident.",
+        examples=[1, 2]
+    )
+
+    losapcreditcode: Optional[int] = Field(
+        None,
+        description="Code indicating whether LOSAP (Length of Service Award Program) credit was awarded.",
+        examples=[1]
+    )
+
+    losapcreditdescrip: Optional[str] = Field(
+        None,
+        max_length=100,
+        description="Description indicating LOSAP credit eligibility.",
+        examples=["Losap Credit"]
+    )
+
+    apparatusid: Optional[str] = Field(
+        None,
+        max_length=10,
+        description="Human-readable identifier for the responding apparatus or unit.",
+        examples=["BE7", "BE6", "BE3"]
+    )
+
+    numberofresponders: Optional[int] = Field(
+        None,
+        description="Total number of personnel responding on this apparatus."
+    )
+
+    responsetimeseconds: Optional[int] = Field(
+        None,
+        description="Total time from dispatch to arrival at the scene expressed in seconds.",
+        examples=[159, 292]
+    )
+
+    dispatchcleardiffseconds: Optional[int] = Field(
+        None,
+        description="Total time from dispatch until the unit cleared the incident.",
+        examples=[466, 1218]
+    )

src/entities/base/_model.py

@@ -10,12 +10,7 @@ class BaseModel_(Base):
     __abstract__ = True  # This model should not be instantiated directly
     __table_args__ = {"extend_existing": True}  # Allow table extension
 
-    id = Column(BigInteger, primary_key=True, autoincrement=True, nullable=False)
-    created_at = Column(DateTime, server_default=func.now(), nullable=False)
-    updated_at = Column(
-        DateTime, server_default=func.now(), onupdate=func.now(), nullable=False
-    )
-    deleted_at = Column(DateTime, nullable=True)
+    created = Column(DateTime, server_default=func.now(), nullable=False)
 
     def to_dict(self, keys_not_to_include: list[str] = []) -> dict:
         return {

src/entities/incident/__init__.py

@@ -0,0 +1,2 @@
+from _model import *
+from _schema import *

src/entities/incident/_model.py

@@ -0,0 +1,113 @@
+from sqlalchemy import Column, String, Integer, Float, Boolean, DateTime, Text, Numeric
+from sqlalchemy.orm import relationship
+from base import BaseModel_
+
+class IncidentModel(BaseModel_):
+    __tablename__ = "incident"
+
+    incidentkey = Column(String(14), primary_key=True, index=True)
+    incidentdate = Column(DateTime)
+    incidentnumber = Column(String(10))
+    exposure = Column(String(3))
+    incidentstatus = Column(String(20))
+    reviewstatusflag = Column(Boolean, nullable=False)
+    publicreleaseflag = Column(Boolean, nullable=False)
+    completed = Column(Boolean, nullable=False)
+    transactiontype = Column(String(4))
+    district = Column(String(10))
+    station = Column(String(30))
+    shift = Column(String(2))
+    company = Column(String(64))
+    incidenttype = Column(String(4), nullable=False)
+    initialdispatchcode = Column(String(25))
+    mutualaidcode = Column(String(4), nullable=False)
+    alarmdate = Column(DateTime)
+    arrivaldate = Column(DateTime)
+    didnotarriveflag = Column(Boolean, nullable=False)
+    controlleddate = Column(DateTime)
+    lastunitcleareddate = Column(DateTime)
+    includemutualaidflag = Column(Boolean, nullable=False)
+    madepartment = Column(String(30))
+    madeptincidentno = Column(String(9))
+    alarms = Column(Integer)
+    actiontaken1 = Column(String(4))
+    actiontaken2 = Column(String(4))
+    actiontaken3 = Column(String(4))
+    resourceformusedflag = Column(Boolean, nullable=False)
+    apparatussuppression = Column(Integer)
+    apparatusems = Column(Integer)
+    apparatusother = Column(Integer)
+    personnelsuppression = Column(Integer)
+    personnelems = Column(Integer)
+    personnelother = Column(Integer)
+    lossproperty = Column(Numeric)
+    losscontents = Column(Numeric)
+    valueproperty = Column(Numeric)
+    valuecontents = Column(Numeric)
+    fatalfireservice = Column(Integer)
+    fatalother = Column(Integer)
+    nonfatalfireservice = Column(Integer)
+    nonfatalother = Column(Integer)
+    detector = Column(String(4))
+    hazardmaterialreleased = Column(String(4))
+    mixeduse = Column(String(4))
+    propertyuse = Column(String(4))
+    emsprovidedflag = Column(Boolean, nullable=False)
+    casualtiesflag = Column(Integer)
+    priorityresponseflag = Column(Boolean)
+    vendorid = Column(String(20))
+    locationtype = Column(Float)
+    censustract = Column(String(7))
+    numberormile = Column(String(8))
+    streetprefix = Column(String(2))
+    streethighway = Column(String(30))
+    streettype = Column(String(4))
+    streetsuffix = Column(String(2))
+    apartment = Column(String(15))
+    city = Column(String(20))
+    state = Column(String(2))
+    postalcode = Column(String(20))
+    directions = Column(Text)
+    latitude = Column(String(20))
+    longitude = Column(String(20))
+    compositeaddress = Column(String(50), nullable=False)
+    county = Column(String(20))
+    occupancykey = Column(String(14))
+    occupancynumber = Column(String(16))
+    occupancyname = Column(String(40))
+    runcard = Column(String(8))
+    mappage = Column(String(20))
+    descrip = Column(String(30))
+    addressvalidated = Column(Integer)
+    CADCompleted = Column(Boolean)
+    changedate = Column(DateTime)
+    rowguid = Column(String(50))
+    LogComments = Column(Text)
+    Incident_ID = Column(Integer, nullable=False)
+    loss_not_known = Column(Boolean, nullable=False)
+    collecteddate = Column(DateTime)
+    DispatchIncType = Column(String(80))
+    nfscasualtycnt = Column(Integer)
+    ncivcasualtycnt = Column(Integer)
+    psaptime = Column(DateTime)
+    ResponseType = Column(String(10))
+    CADText1 = Column(String(50))
+    CADText2 = Column(String(50))
+    CADText3 = Column(String(50))
+    CADCombo1 = Column(String(50))
+    CADCombo2 = Column(String(50))
+    CADCombo3 = Column(String(50))
+    GMTOffSet = Column(String(6))
+    CADDate1 = Column(DateTime)
+    CADDate2 = Column(DateTime)
+    CADDate3 = Column(DateTime)
+    responseTime = Column(String(20))
+    turnTime = Column(String(20))
+    Mapset = Column(String(6))
+    Easting = Column(String(5))
+    Northing = Column(String(5))
+    
+    # relationships
+    apparatus = relationship("Apparatus", back_populates="incident")
+    personnel = relationship("Personnel", back_populates="incident")
+    incident_apparatus = relationship("IncidentApparatusModel", back_populates="incident")

src/entities/incident/_schema.py

@@ -0,0 +1,209 @@
+from pydantic import Field
+from typing import Optional
+from datetime import datetime
+from base import BaseSchema
+
+
+class IncidentSchema(BaseSchema):
+
+    incidentkey: str = Field(..., description="Primary key for the incident record.", example="_48Y00K5I8_SMS")
+
+    incidentdate: Optional[datetime] = Field(None, description="Date and time when the incident occurred.")
+
+    incidentnumber: Optional[str] = Field(None, description="Public facing incident number.", example="1500003")
+
+    exposure: Optional[str] = Field(None, description="Exposure number representing related incidents.", example="0")
+
+    incidentstatus: Optional[str] = Field(None, description="Status of the incident report.")
+
+    reviewstatusflag: bool = Field(..., description="Indicates if the incident report has been reviewed.", example=False)
+
+    publicreleaseflag: bool = Field(..., description="Indicates if the report is approved for public release.")
+
+    completed: bool = Field(..., description="Indicates whether the incident report is complete.")
+
+    transactiontype: Optional[str] = Field(None, description="Internal transaction type for database sync.")
+
+    district: Optional[str] = Field(None, description="Fire district where the incident occurred.", example="B07")
+
+    station: Optional[str] = Field(None, description="Station responsible for the incident.", example="B7")
+
+    shift: Optional[str] = Field(None, description="Duty shift active during the incident.", example="B")
+
+    company: Optional[str] = Field(None, description="Legacy company identifier.")
+
+    incidenttype: str = Field(..., description="NFIRS classification code for incident type.", example="321")
+
+    initialdispatchcode: Optional[str] = Field(None, description="Dispatch center code.", example="FWX")
+
+    mutualaidcode: str = Field(..., description="Mutual aid participation code.", example="N")
+
+    alarmdate: Optional[datetime] = Field(None, description="Time when the incident alarm was received.")
+
+    arrivaldate: Optional[datetime] = Field(None, description="Time when the first unit arrived.")
+
+    didnotarriveflag: bool = Field(..., description="Indicates if units were cancelled before arrival.")
+
+    controlleddate: Optional[datetime] = Field(None, description="Time when the incident was controlled.")
+
+    lastunitcleareddate: Optional[datetime] = Field(None, description="Time when the last unit cleared the scene.")
+
+    includemutualaidflag: bool = Field(..., description="Indicates if mutual aid resources participated.")
+
+    madepartment: Optional[str] = Field(None, description="Mutual aid department name.")
+
+    madeptincidentno: Optional[str] = Field(None, description="Mutual aid department incident number.")
+
+    alarms: Optional[int] = Field(None, description="Number of alarms dispatched.", example=1)
+
+    actiontaken1: Optional[str] = Field(None, description="Primary action taken.")
+
+    actiontaken2: Optional[str] = Field(None, description="Secondary action taken.")
+
+    actiontaken3: Optional[str] = Field(None, description="Tertiary action taken.")
+
+    resourceformusedflag: bool = Field(..., description="Indicates if resource form was used.")
+
+    apparatussuppression: Optional[int] = Field(None, description="Number of suppression apparatus.")
+
+    apparatusems: Optional[int] = Field(None, description="Number of EMS apparatus.")
+
+    apparatusother: Optional[int] = Field(None, description="Other apparatus responding.")
+
+    personnelsuppression: Optional[int] = Field(None, description="Suppression personnel count.")
+
+    personnelems: Optional[int] = Field(None, description="EMS personnel count.")
+
+    personnelother: Optional[int] = Field(None, description="Other personnel responding.")
+
+    lossproperty: Optional[float] = Field(None, description="Estimated property loss.")
+
+    losscontents: Optional[float] = Field(None, description="Estimated contents loss.")
+
+    valueproperty: Optional[float] = Field(None, description="Estimated property value before incident.")
+
+    valuecontents: Optional[float] = Field(None, description="Estimated contents value before incident.")
+
+    fatalfireservice: Optional[int] = Field(None, description="Fire service fatalities.")
+
+    fatalother: Optional[int] = Field(None, description="Civilian fatalities.")
+
+    nonfatalfireservice: Optional[int] = Field(None, description="Non fatal injuries to firefighters.")
+
+    nonfatalother: Optional[int] = Field(None, description="Civilian injuries.")
+
+    detector: Optional[str] = Field(None, description="Smoke detector presence code.")
+
+    hazardmaterialreleased: Optional[str] = Field(None, description="Hazardous material release code.")
+
+    mixeduse: Optional[str] = Field(None, description="Mixed occupancy usage code.")
+
+    propertyuse: Optional[str] = Field(None, description="NFIRS property use classification.")
+
+    emsprovidedflag: bool = Field(..., description="Indicates EMS services were provided.")
+
+    casualtiesflag: Optional[int] = Field(None, description="Indicates casualties occurred.")
+
+    priorityresponseflag: Optional[bool] = Field(None, description="Indicates priority emergency response.")
+
+    vendorid: Optional[str] = Field(None, description="Vendor system identifier.")
+
+    locationtype: Optional[float] = Field(None, description="Location classification type.")
+
+    censustract: Optional[str] = Field(None, description="Census tract identifier.")
+
+    numberormile: Optional[str] = Field(None, description="Street number or mile marker.")
+
+    streetprefix: Optional[str] = Field(None, description="Street directional prefix.")
+
+    streethighway: Optional[str] = Field(None, description="Street or highway name.")
+
+    streettype: Optional[str] = Field(None, description="Street type (St, Rd, Ave).")
+
+    streetsuffix: Optional[str] = Field(None, description="Directional suffix.")
+
+    apartment: Optional[str] = Field(None, description="Apartment or unit number.")
+
+    city: Optional[str] = Field(None, description="City of incident.", example="Bakersfield")
+
+    state: Optional[str] = Field(None, description="State abbreviation.", example="CA")
+
+    postalcode: Optional[str] = Field(None, description="ZIP code.", example="93309")
+
+    directions: Optional[str] = Field(None, description="Additional location directions.")
+
+    latitude: Optional[str] = Field(None, description="Latitude coordinate.")
+
+    longitude: Optional[str] = Field(None, description="Longitude coordinate.")
+
+    compositeaddress: str = Field(..., description="Full combined address.", example="2601 S REAL RD 77")
+
+    county: Optional[str] = Field(None, description="County name.", example="KERN")
+
+    occupancykey: Optional[str] = Field(None, description="Occupancy identifier.")
+
+    occupancynumber: Optional[str] = Field(None, description="Occupancy number.")
+
+    occupancyname: Optional[str] = Field(None, description="Occupancy name.")
+
+    runcard: Optional[str] = Field(None, description="Dispatch run card.")
+
+    mappage: Optional[str] = Field(None, description="Map page reference.")
+
+    descrip: Optional[str] = Field(None, description="Short incident description.")
+
+    addressvalidated: Optional[int] = Field(None, description="Indicates if address was validated.")
+
+    CADCompleted: Optional[bool] = Field(None, description="Indicates CAD record completion.")
+
+    changedate: Optional[datetime] = Field(None, description="Last modified timestamp.")
+
+    rowguid: Optional[str] = Field(None, description="Row GUID for replication.")
+
+    LogComments: Optional[str] = Field(None, description="Additional log comments.")
+
+    Incident_ID: int = Field(..., description="Internal numeric incident identifier.")
+
+    loss_not_known: bool = Field(..., description="Indicates if loss values are unknown.")
+
+    collecteddate: Optional[datetime] = Field(None, description="Date when data was collected.")
+
+    DispatchIncType: Optional[str] = Field(None, description="Dispatch incident type.")
+
+    nfscasualtycnt: Optional[int] = Field(None, description="Fire service casualty count.")
+
+    ncivcasualtycnt: Optional[int] = Field(None, description="Civilian casualty count.")
+
+    psaptime: Optional[datetime] = Field(None, description="Public Safety Answering Point call time.")
+
+    ResponseType: Optional[str] = Field(None, description="Response classification.")
+
+    CADText1: Optional[str] = Field(None, description="Custom CAD text field 1.")
+
+    CADText2: Optional[str] = Field(None, description="Custom CAD text field 2.")
+
+    CADText3: Optional[str] = Field(None, description="Custom CAD text field 3.")
+
+    CADCombo1: Optional[str] = Field(None, description="Custom CAD combo field 1.")
+
+    CADCombo2: Optional[str] = Field(None, description="Custom CAD combo field 2.")
+
+    CADCombo3: Optional[str] = Field(None, description="Custom CAD combo field 3.")
+
+    GMTOffSet: Optional[str] = Field(None, description="Time zone offset from GMT.")
+
+    CADDate1: Optional[datetime] = Field(None, description="Custom CAD date field 1.")
+
+    CADDate2: Optional[datetime] = Field(None, description="Custom CAD date field 2.")
+
+    CADDate3: Optional[datetime] = Field(None, description="Custom CAD date field 3.")
+
+    responseTime: Optional[str] = Field(None, description="Response time benchmark.")
+
+    turnTime: Optional[str] = Field(None, description="Turnout time from alarm to dispatch.")
+
+    Mapset: Optional[str] = Field(None, description="Map set identifier.")
+
+    Easting: Optional[str] = Field(None, description="Grid easting coordinate.")
+
+    Northing: Optional[str] = Field(None, description="Grid northing coordinate.")

src/entities/personnel/__init__.py

@@ -0,0 +1,2 @@
+from _model import *
+from _schema import *

src/entities/personnel/_model.py

@@ -0,0 +1,44 @@
+from sqlalchemy import Column, String, DateTime, Boolean, Integer, Float, ForeignKey
+from sqlalchemy.orm import relationship
+from base import BaseModel_
+
+
+class PersonnelModel(BaseModel_):
+    __tablename__ = "personnel"
+
+    personnelkey = Column(String(14), primary_key=True, index=True)
+    incidentkey = Column(String(14), ForeignKey("incident.incidentkey"))
+    apparatuskey = Column(String(14), ForeignKey("apparatus.incidentkey"))
+    pslid = Column(String(14), nullable=True)
+    rosid = Column(String(14), nullable=True)
+    personnelid = Column(String(9), nullable=True)
+    lastname = Column(String(25), nullable=True)
+    firstname = Column(String(25), nullable=True)
+    middleinitial = Column(String(1), nullable=True)
+    namesuffix = Column(String(4), nullable=True)
+    rank = Column(String(10), nullable=True)
+    actiontaken1 = Column(String(4), nullable=True)
+    actiontaken2 = Column(String(4), nullable=True)
+    actiontaken3 = Column(String(4), nullable=True)
+    actiontaken4 = Column(String(4), nullable=True)
+    amount1 = Column(Float, nullable=True)
+    amount2 = Column(Float, nullable=True)
+    changedate = Column(DateTime, nullable=True)
+    rowguid = Column(String, nullable=False)
+    crole = Column(String(4), nullable=True)
+    lLosap_credit = Column(Boolean, nullable=True)
+    MedCert = Column(String(4), nullable=True)
+    cAdditionalRole = Column(String(8), nullable=True)
+    AgencyID = Column(String(14), nullable=True)
+    AgencyDesc = Column(String(40), nullable=True)
+    AgencyCode = Column(String(8), nullable=True)
+    lNFIRSExported = Column(Boolean, nullable=True)
+    NFIRSExportedDate = Column(DateTime, nullable=True)
+    iNFIRSSequence = Column(Integer, nullable=True)
+    NFIRSTransactiontype = Column(String(1), nullable=True)
+    
+    incident = relationship("Incident", back_populates="personnel")
+    apparatus = relationship("Apparatus", back_populates="personnel")
+
+
+

src/entities/personnel/_schema.py

@@ -0,0 +1,182 @@
+from pydantic import Field
+from typing import Optional
+from datetime import datetime
+from base import BaseSchema
+
+
+class PersonnelSchema(BaseSchema):
+
+    personnelkey: str = Field(
+        ...,
+        description="Primary key for the personnel table. A unique system-generated identifier for every firefighter or personnel record. Used to link personnel records to apparatus, incidents, and other related tables.",
+        examples=["_48Y00K5KE_SMS", "_48Y00K5KF_SMS", "_48Y00K5KG_SMS"]
+    )
+
+    incidentkey: str = Field(
+        ...,
+        description="Unique identifier of the incident associated with this personnel record. Links this personnel entry to a specific incident in the incident table.",
+        examples=["_48Y00K5I8_SMS", "_48Y00K5IA_SMS", "_48Y00JH1N_SMS"]
+    )
+
+    apparatuskey: Optional[str] = Field(
+        ...,
+        description="Identifier of the apparatus assigned to the personnel for the incident. Links personnel to a specific equipment or response unit.",
+        examples=["_48Y00K5JZ_SMS", "_48Y00K5J4_SMS"]
+    )
+
+    pslid: Optional[str] = Field(
+        ...,
+        description="Personnel shift or assignment identifier. Represents a unique combination of a person and their station or apparatus assignment for a shift.",
+        examples=["_1XL0VELG6DEFA", "_1XL0Y55W0DEFA"]
+    )
+
+    rosid: Optional[str] = Field(
+        ...,
+        description="Legacy or rarely used identifier possibly representing a 'Report of Service' reference. Often null in data.",
+        examples=[None]
+    )
+
+    personnelid: Optional[str] = Field(
+        ...,
+        description="Human-readable personnel identifier such as an employee number or badge number used internally.",
+        examples=["359", "326", "436"]
+    )
+
+    lastname: Optional[str] = Field(
+        ...,
+        description="Last name of the firefighter or personnel member.",
+        examples=["Woodard", "Taylor", "Topete"]
+    )
+
+    firstname: Optional[str] = Field(
+        ...,
+        description="First name of the firefighter or personnel member.",
+        examples=["Randall", "Michael", "Adrian"]
+    )
+
+    middleinitial: Optional[str] = Field(
+        ...,
+        description="Middle initial of the firefighter or personnel member.",
+        examples=["E", "D", "T"]
+    )
+
+    namesuffix: Optional[str] = Field(
+        ...,
+        description="Suffix used in the person's name such as Jr., Sr., or III.",
+        examples=["Jr", "Sr"]
+    )
+
+    rank: Optional[str] = Field(
+        ...,
+        description="Rank or title of the firefighter within the department.",
+        examples=["ENG", "CAPT", "FF"]
+    )
+
+    actiontaken1: Optional[str] = Field(
+        ...,
+        description="Primary action performed by the personnel member during the incident. Usually represented by standardized codes such as NFIRS action codes.",
+        examples=["93", "86"]
+    )
+
+    actiontaken2: Optional[str] = Field(
+        ...,
+        description="Secondary action performed during the incident.",
+        examples=[None]
+    )
+
+    actiontaken3: Optional[str] = Field(
+        ...,
+        description="Third action performed during the incident.",
+        examples=[None]
+    )
+
+    actiontaken4: Optional[str] = Field(
+        ...,
+        description="Fourth action performed during the incident.",
+        examples=[None]
+    )
+
+    amount1: Optional[float] = Field(
+        ...,
+        description="Monetary amount associated with the personnel such as overtime pay, stipend, or incident-related compensation.",
+        examples=[150.00]
+    )
+
+    amount2: Optional[float] = Field(
+        ...,
+        description="Second monetary value associated with the personnel.",
+        examples=[75.00]
+    )
+
+    changedate: Optional[datetime] = Field(
+        ...,
+        description="Timestamp representing when the personnel record was last updated.",
+    )
+
+    rowguid: str = Field(
+        ...,
+        description="Globally unique identifier (GUID) used by SQL Server for replication and system tracking.",
+        examples=[
+            "A58628E4-154E-4369-AA48-B6AA569CABEA",
+            "66660C59-3899-463F-8268-C09209928414"
+        ]
+    )
+
+    crole: Optional[str] = Field(
+        ...,
+        description="Special role played by the personnel during the incident such as Safety Officer or Incident Commander.",
+    )
+
+    lLosap_credit: Optional[bool] = Field(
+        ...,
+        description="Boolean indicator showing whether the personnel earns LOSAP (Length of Service Award Program) credit for the incident.",
+        examples=[True, False]
+    )
+
+    MedCert: Optional[str] = Field(
+        ...,
+        description="Medical certification level of the personnel such as EMT or Paramedic.",
+    )
+
+    cAdditionalRole: Optional[str] = Field(
+        ...,
+        description="Additional role performed by the personnel that may not be captured by standard role codes.",
+    )
+
+    AgencyID: Optional[str] = Field(
+        ...,
+        description="Identifier of the external agency associated with the personnel during mutual aid incidents.",
+    )
+
+    AgencyDesc: Optional[str] = Field(
+        ...,
+        description="Description of the agency associated with AgencyID.",
+    )
+
+    AgencyCode: Optional[str] = Field(
+        ...,
+        description="Short code representing the agency.",
+    )
+
+    lNFIRSExported: Optional[bool] = Field(
+        ...,
+        description="Flag indicating whether the record has been exported to the NFIRS reporting system.",
+        examples=[True, False]
+    )
+
+    NFIRSExportedDate: Optional[datetime] = Field(
+        ...,
+        description="Date and time when the record was exported to NFIRS."
+    )
+
+    iNFIRSSequence: Optional[int] = Field(
+        ...,
+        description="Sequence number used when multiple records are exported in a single NFIRS batch.",
+        examples=[1, 2, 3]
+    )
+
+    NFIRSTransactiontype: Optional[str] = Field(
+        ...,
+        description="Type of NFIRS transaction such as Insert (A), Update (U), or Delete (D).",
+        examples=["A", "U", "D"]
+    )