# hafiizherdian/asset-management architecture

> Architecture diagram of the GitHub repository hafiizherdian/asset-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hafiizherdian/asset-management
- Repository: https://github.com/hafiizherdian/asset-management

## Overview

Asset Management – Kendaraan is a Next.js vehicle-asset application. Users import spreadsheet data, review vehicle and document/service records, and use an overview dashboard; header filters apply across the vehicle views. The documented capabilities and sampled source support the main page-to-query and import flows. The database schema and several page implementations were not sampled, so their internal details are not inferred.

Main entry points: [`lib/queries.ts`](https://github.com/hafiizherdian/asset-management/blob/master/lib/queries.ts) (Vehicle queries), [`components/Header.tsx`](https://github.com/hafiizherdian/asset-management/blob/master/components/Header.tsx) (Filter header), [`app/page.tsx`](https://github.com/hafiizherdian/asset-management/blob/master/app/page.tsx) (Overview dashboard), [`app/kendaraan/page.tsx`](https://github.com/hafiizherdian/asset-management/blob/master/app/kendaraan/page.tsx) (Vehicle list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Vehicle views"]
  node_layout["App shell<br/>[layout.tsx]"]
  node_sidebar["Navigation<br/>[Sidebar.tsx]"]
  node_header["Filter header<br/>[Header.tsx]"]
  node_filters["Filter controls<br/>[AreaFilter.tsx]"]
  node_filter_actions["Filter actions<br/>[filter-actions.ts]"]
  node_overview["Overview dashboard<br/>[page.tsx]"]
  node_vehicle_list["Vehicle list<br/>[page.tsx]"]
  node_vehicle_table["Vehicle table<br/>[KendaraanTable.tsx]"]
  node_service["Documents &amp; service<br/>[page.tsx]"]
end

subgraph group_ingestion["Import workflow"]
  node_import_page["Import history<br/>[page.tsx]"]
  node_importer["Spreadsheet importer"]
  node_parser["Import parser<br/>[import-parse.ts]"]
  node_import_actions["Import actions<br/>[import-actions.ts]"]
  node_delete_button["Delete log control"]
end

subgraph group_domain["Vehicle data services"]
  node_queries["Vehicle queries<br/>[queries.ts]"]
  node_vehicle_utils["Vehicle calculations<br/>[kendaraan-utils.ts]"]
  node_types["Vehicle types<br/>[types.ts]"]
end

subgraph group_persistence["Data persistence"]
  node_db_client["Postgres client<br/>[db.ts]"]
  node_schema[("Database schema<br/>[schema.sql]")]
end

node_user(("User"))
node_postgres[("PostgreSQL")]

node_user -->|"opens app"| node_layout
node_layout -->|"renders"| node_sidebar
node_user -->|"views dashboard"| node_overview
node_user -->|"views vehicles"| node_vehicle_list
node_user -->|"views documents"| node_service
node_user -->|"opens import"| node_import_page
node_overview -->|"renders"| node_header
node_vehicle_list -->|"renders"| node_header
node_vehicle_list -->|"renders"| node_vehicle_table
node_service -->|"renders"| node_header
node_overview -->|"loads vehicles"| node_queries
node_vehicle_list -->|"loads vehicles"| node_queries
node_service -->|"loads vehicles"| node_queries
node_overview -->|"calculates summaries"| node_vehicle_utils
node_service -->|"formats dates"| node_vehicle_utils
node_header -->|"loads filter options"| node_queries
node_header -->|"renders controls"| node_filters
node_filters -->|"sets filters"| node_filter_actions
node_queries -->|"queries database"| node_db_client
node_queries -->|"uses data types"| node_types
node_import_page -->|"loads import logs"| node_queries
node_import_page -->|"renders importer"| node_importer
node_import_page -->|"renders control"| node_delete_button
node_importer -->|"parses and plans"| node_parser
node_importer -->|"submits rows"| node_import_actions
node_import_actions -->|"validates rows"| node_parser
node_import_actions -->|"stores import"| node_db_client
node_delete_button -->|"deletes log"| node_import_actions
node_db_client -->|"connects to"| node_postgres
node_schema -.->|"defines tables"| node_postgres

click node_layout "https://github.com/hafiizherdian/asset-management/blob/master/app/layout.tsx"
click node_sidebar "https://github.com/hafiizherdian/asset-management/blob/master/components/Sidebar.tsx"
click node_header "https://github.com/hafiizherdian/asset-management/blob/master/components/Header.tsx"
click node_filters "https://github.com/hafiizherdian/asset-management/blob/master/components/AreaFilter.tsx"
click node_filter_actions "https://github.com/hafiizherdian/asset-management/blob/master/app/filter-actions.ts"
click node_overview "https://github.com/hafiizherdian/asset-management/blob/master/app/page.tsx"
click node_vehicle_list "https://github.com/hafiizherdian/asset-management/blob/master/app/kendaraan/page.tsx"
click node_vehicle_table "https://github.com/hafiizherdian/asset-management/blob/master/components/KendaraanTable.tsx"
click node_service "https://github.com/hafiizherdian/asset-management/blob/master/app/service/page.tsx"
click node_import_page "https://github.com/hafiizherdian/asset-management/blob/master/app/impor/page.tsx"
click node_importer "https://github.com/hafiizherdian/asset-management/blob/master/components/KendaraanImporter.tsx"
click node_parser "https://github.com/hafiizherdian/asset-management/blob/master/lib/import-parse.ts"
click node_import_actions "https://github.com/hafiizherdian/asset-management/blob/master/app/import-actions.ts"
click node_delete_button "https://github.com/hafiizherdian/asset-management/blob/master/components/DeleteLogButton.tsx"
click node_queries "https://github.com/hafiizherdian/asset-management/blob/master/lib/queries.ts"
click node_vehicle_utils "https://github.com/hafiizherdian/asset-management/blob/master/lib/kendaraan-utils.ts"
click node_types "https://github.com/hafiizherdian/asset-management/blob/master/lib/types.ts"
click node_db_client "https://github.com/hafiizherdian/asset-management/blob/master/lib/db.ts"
click node_schema "https://github.com/hafiizherdian/asset-management/blob/master/db/schema.sql"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_layout,node_sidebar,node_header,node_filters,node_filter_actions,node_overview,node_vehicle_list,node_vehicle_table,node_service,node_user toneBlue
class node_import_page,node_importer,node_parser,node_import_actions,node_delete_button,node_postgres toneAmber
class node_queries,node_vehicle_utils,node_types toneMint
class node_db_client,node_schema toneRose
```

## Components

### Vehicle views

- [App shell](https://github.com/hafiizherdian/asset-management/blob/master/app/layout.tsx): `app/layout.tsx`
- [Navigation](https://github.com/hafiizherdian/asset-management/blob/master/components/Sidebar.tsx): `components/Sidebar.tsx`
- [Filter header](https://github.com/hafiizherdian/asset-management/blob/master/components/Header.tsx): `components/Header.tsx`
- [Filter controls](https://github.com/hafiizherdian/asset-management/blob/master/components/AreaFilter.tsx): `components/AreaFilter.tsx`
- [Filter actions](https://github.com/hafiizherdian/asset-management/blob/master/app/filter-actions.ts): `app/filter-actions.ts`
- [Overview dashboard](https://github.com/hafiizherdian/asset-management/blob/master/app/page.tsx): `app/page.tsx`
- [Vehicle list](https://github.com/hafiizherdian/asset-management/blob/master/app/kendaraan/page.tsx): `app/kendaraan/page.tsx`
- [Vehicle table](https://github.com/hafiizherdian/asset-management/blob/master/components/KendaraanTable.tsx): `components/KendaraanTable.tsx`
- [Documents & service](https://github.com/hafiizherdian/asset-management/blob/master/app/service/page.tsx): `app/service/page.tsx`

### Import workflow

- [Import history](https://github.com/hafiizherdian/asset-management/blob/master/app/impor/page.tsx): `app/impor/page.tsx`
- [Spreadsheet importer](https://github.com/hafiizherdian/asset-management/blob/master/components/KendaraanImporter.tsx): `components/KendaraanImporter.tsx`
- [Import parser](https://github.com/hafiizherdian/asset-management/blob/master/lib/import-parse.ts): `lib/import-parse.ts`
- [Import actions](https://github.com/hafiizherdian/asset-management/blob/master/app/import-actions.ts): `app/import-actions.ts`
- [Delete log control](https://github.com/hafiizherdian/asset-management/blob/master/components/DeleteLogButton.tsx): `components/DeleteLogButton.tsx`

### Vehicle data services

- [Vehicle queries](https://github.com/hafiizherdian/asset-management/blob/master/lib/queries.ts): `lib/queries.ts`
- [Vehicle calculations](https://github.com/hafiizherdian/asset-management/blob/master/lib/kendaraan-utils.ts): `lib/kendaraan-utils.ts`
- [Vehicle types](https://github.com/hafiizherdian/asset-management/blob/master/lib/types.ts): `lib/types.ts`

### Data persistence

- [Postgres client](https://github.com/hafiizherdian/asset-management/blob/master/lib/db.ts): `lib/db.ts`
- [Database schema](https://github.com/hafiizherdian/asset-management/blob/master/db/schema.sql): `db/schema.sql`

### Other components

- **User**
- **PostgreSQL**

## Connections

- User → App shell: opens app (evidence: `README.md`)
- App shell → Navigation: renders (evidence: `app/layout.tsx`)
- User → Overview dashboard: views dashboard (evidence: `README.md`)
- User → Vehicle list: views vehicles (evidence: `README.md`)
- User → Documents & service: views documents (evidence: `README.md`)
- User → Import history: opens import (evidence: `README.md`)
- Overview dashboard → Filter header: renders (evidence: `app/page.tsx`)
- Vehicle list → Filter header: renders (evidence: `app/kendaraan/page.tsx`)
- Vehicle list → Vehicle table: renders (evidence: `app/kendaraan/page.tsx`)
- Documents & service → Filter header: renders (evidence: `app/service/page.tsx`)
- Overview dashboard → Vehicle queries: loads vehicles (evidence: `app/page.tsx`)
- Vehicle list → Vehicle queries: loads vehicles (evidence: `app/kendaraan/page.tsx`)
- Documents & service → Vehicle queries: loads vehicles (evidence: `app/service/page.tsx`)
- Overview dashboard → Vehicle calculations: calculates summaries (evidence: `app/page.tsx`)
- Documents & service → Vehicle calculations: formats dates (evidence: `app/service/page.tsx`)
- Filter header → Vehicle queries: loads filter options (evidence: `components/Header.tsx`)
- Filter header → Filter controls: renders controls (evidence: `components/Header.tsx`)
- Filter controls → Filter actions: sets filters (evidence: `components/AreaFilter.tsx`)
- Vehicle queries → Postgres client: queries database (evidence: `lib/queries.ts`)
- Vehicle queries → Vehicle types: uses data types (evidence: `lib/queries.ts`)
- Import history → Vehicle queries: loads import logs (evidence: `app/impor/page.tsx`)
- Import history → Spreadsheet importer: renders importer (evidence: `app/impor/page.tsx`)
- Import history → Delete log control: renders control (evidence: `app/impor/page.tsx`)
- Spreadsheet importer → Import parser: parses and plans (evidence: `components/KendaraanImporter.tsx`)
- Spreadsheet importer → Import actions: submits rows (evidence: `components/KendaraanImporter.tsx`)
- Import actions → Import parser: validates rows (evidence: `app/import-actions.ts`)
- Import actions → Postgres client: stores import (evidence: `app/import-actions.ts`)
- Delete log control → Import actions: deletes log (evidence: `components/DeleteLogButton.tsx`)
- Postgres client → PostgreSQL: connects to (evidence: `lib/db.ts`)
- Database schema → PostgreSQL: defines tables
