databases.softwareshinobi.com/landing/docs/monacomotors.md

# Monaco Motors

## Schema Overview

The Monaco Motors database centralizes all critical business data, enabling efficient management of sales, customer information, vehicle inventory, and dealership operations.

## Table Summary

| Table Name | Primary Responsibility |
| :--------- | :--------------------- |
| `Customer` | Stores essential customer contact and identification details. |
| `Deal` | Records each vehicle sales transaction, linking customers, agents, vehicles, and insurance. |
| `Dealership` | Defines the various dealerships, associating them with distributors and geographic regions. |
| `Distributor` | Catalogs the vehicle distributors, providing their unique identifiers and names. |
| `Insurance` | Contains details about insurance policies associated with vehicle deals. |
| `Manager` | Manages information for dealership managers, including their assigned dealership and distributor. |
| `Region` | Maps geographic regions to their respective ZIP codes and names. |
| `Sales_Agent` | Houses details for sales agents, including their manager and assigned dealership. |
| `Vehicle` | Maintains the inventory of vehicles, capturing their specifications, dealership, and pricing. |

## `Customer` Table

This table stores comprehensive customer information, critical for sales tracking, communication, and relationship management.

| Column Name | Data Type | Description |
| :---------- | :-------- | :---------- |
| `CustomerID` | CHAR(8) | Unique identifier for this entity. Used for all lookups and relationships. |
| `AgentID` | CHAR(8) | Establishes a relationship with `Sales_Agent.AgentID`. Essential for data integrity and joins. |
| `CustFirstName` | VARCHAR(15) | The customer's first name. |
| `CustLastName` | VARCHAR(15) | The customer's last name. |
| `PhoneNumber` | VARCHAR(12) | The customer's primary phone number. |
| `Email` | VARCHAR(40) | The customer's email address. |

## `Deal` Table

This table records every completed vehicle transaction, linking all involved entities and providing a historical record of sales.

| Column Name | Data Type | Description |
| :---------- | :-------- | :---------- |
| `DealID` | CHAR(5) | Unique identifier for this entity. Used for all lookups and relationships. |
| `VehicleID` | CHAR(3) | Establishes a relationship with `Vehicle.VehicleID`. Essential for data integrity and joins. |
| `AgentID` | CHAR(8) | Establishes a relationship with `Sales_Agent.AgentID`. Essential for data integrity and joins. |
| `CustomerID` | CHAR(8) | Establishes a relationship with `Customer.CustomerID`. Essential for data integrity and joins. |
| `InsuranceID` | CHAR(5) (Optional) | Establishes a relationship with `Insurance.InsuranceID`. Essential for data integrity and joins. Mandates explicit `null` handling in Java code. |
| `DealDate` | DATE | The date the deal was closed. Map to `java.time.LocalDate` for modern date/time handling. |

## `Dealership` Table

This table defines each dealership within the Monaco Motors ecosystem, including its geographic and distribution affiliations.

| Column Name | Data Type | Description |
| :---------- | :-------- | :---------- |
| `DealershipID` | CHAR(5) | Unique identifier for this entity. Used for all lookups and relationships. |
| `DistributorID` | CHAR(8) | Establishes a relationship with `Distributor.DistributorID`. Essential for data integrity and joins. |
| `RegionID` | CHAR(3) | Establishes a relationship with `Region.RegionID`. Essential for data integrity and joins. Part of a composite foreign key. |
| `RegionZIP` | CHAR(5) | Establishes a relationship with `Region.RegionZIP`. Essential for data integrity and joins. Part of a composite foreign key. |
| `DealershipName` | VARCHAR(40) | The official name of the dealership. |

## `Distributor` Table

This table lists all vehicle distributors that supply to Monaco Motors dealerships.

| Column Name | Data Type | Description |
| :---------- | :-------- | :---------- |
| `DistributorID` | CHAR(8) | Unique identifier for this entity. Used for all lookups and relationships. |
| `DistributorName` | VARCHAR(40) | The name of the vehicle distributor. |

## `Insurance` Table

This table stores details about the insurance policies associated with vehicle deals, including policy types and renewal dates.

| Column Name | Data Type | Description |
| :---------- | :-------- | :---------- |
| `InsuranceID` | CHAR(5) | Unique identifier for this entity. Used for all lookups and relationships. |
| `PolicyType` | VARCHAR(15) | Describes the type of insurance policy (e.g., "Full Coverage", "Liability"). |
| `RenewalDate` | DATE | The date the insurance policy is due for renewal. Map to `java.time.LocalDate` for modern date/time handling. |

## `Manager` Table

This table contains information about the managers overseeing dealerships, including their salary and bonus details.

| Column Name | Data Type | Description |
| :---------- | :-------- | :---------- |
| `ManagerID` | CHAR(8) | Unique identifier for this entity. Used for all lookups and relationships. |
| `DealershipID` | CHAR(5) | Establishes a relationship with `Dealership.DealershipID`. Essential for data integrity and joins. |
| `DistributorID` | CHAR(8) | Establishes a relationship with `Distributor.DistributorID`. Essential for data integrity and joins. |
| `MngrFirstName` | VARCHAR(15) | The manager's first name. |
| `MngrLastName` | VARCHAR(15) | The manager's last name. |
| `MngrSalary` | DECIMAL(8,2) | The manager's annual salary. Map to `java.math.BigDecimal` for financial values to ensure precision. |
| `MngrBonus` | DECIMAL(8,2) (Optional) | The manager's annual bonus. Map to `java.math.BigDecimal` for financial values to ensure precision. Mandates explicit `null` handling in Java code. |

## `Region` Table

This table defines geographic regions by their ID, ZIP code, and descriptive name.

| Column Name | Data Type | Description |
| :---------- | :-------- | :---------- |
| `RegionID` | CHAR(3) | Unique identifier for this entity, part of a composite primary key. Used for all lookups and relationships. |
| `RegionZIP` | CHAR(5) | The ZIP code associated with the region, part of a composite primary key. Used for all lookups and relationships. |
| `RegionName` | VARCHAR(15) | The descriptive name of the region (e.g., "EMEA", "APJ", "AMS"). |

## `Sales_Agent` Table

This table stores details for each sales agent, including their reporting manager and assigned dealership.

| Column Name | Data Type | Description |
| :---------- | :-------- | :---------- |
| `AgentID` | CHAR(8) | Unique identifier for this entity. Used for all lookups and relationships. |
| `ManagerID` | CHAR(8) | Establishes a relationship with `Manager.ManagerID`. Essential for data integrity and joins. |
| `DealershipID` | CHAR(5) | Establishes a relationship with `Dealership.DealershipID`. Essential for data integrity and joins. |
| `AgentFirstName` | VARCHAR(15) | The sales agent's first name. |
| `AgentLastName` | VARCHAR(15) | The sales agent's last name. |
| `AgentSalary` | DECIMAL(9,2) | The sales agent's annual salary. Map to `java.math.BigDecimal` for financial values to ensure precision. |

## `Vehicle` Table

This table details the vehicle inventory, including specifications, pricing, and associated dealerships and distributors.

| Column Name | Data Type | Description |
| :---------- | :-------- | :---------- |
| `VehicleID` | CHAR(3) | Unique identifier for this entity. Used for all lookups and relationships. |
| `DealershipID` | CHAR(5) | Establishes a relationship with `Dealership.DealershipID`. Essential for data integrity and joins. |
| `DistributorID` | CHAR(8) | Establishes a relationship with `Distributor.DistributorID`. Essential for data integrity and joins. |
| `Make` | VARCHAR(40) | The manufacturer of the vehicle. |
| `Model` | VARCHAR(40) | The specific model of the vehicle. |
| `BodyType` | VARCHAR(40) | The body style of the vehicle (e.g., "Coupe", "SUV", "Spyder"). |
| `ModelYear` | INT | The manufacturing year of the vehicle. |
| `Price` | DECIMAL(9,2) | The selling price of the vehicle. Map to `java.math.BigDecimal` for financial values to ensure precision. |