# 1xterminal/aku_crud architecture

> Architecture diagram of the GitHub repository 1xterminal/aku_crud, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1xterminal/aku_crud
- Repository: https://github.com/1xterminal/aku_crud

## Overview

AKU is a Laravel CRUD web application for managing local business, facilities, schools and tourism records. Users browse searchable, sortable and paginated tables, then create, update or delete records; spreadsheet import/export and category or school-level management extend that workflow. The README documents these capabilities, and sampled controllers confirm CRUD and spreadsheet handling for some domains; unsampled controller and route details are represented only at the shared directory level. Authentication, role-based access and profile management are additional product areas.

Main entry points: [`app/Http/Controllers`](https://github.com/1xterminal/aku_crud/tree/main/app/Http/Controllers) (Request handlers), [`routes/web.php`](https://github.com/1xterminal/aku_crud/blob/main/routes/web.php) (Web routes), [`resources/views/pages/table`](https://github.com/1xterminal/aku_crud/tree/main/resources/views/pages/table) (Table pages), [`resources/views/layouts/app.blade.php`](https://github.com/1xterminal/aku_crud/blob/main/resources/views/layouts/app.blade.php) (Application layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_routes["Web routes<br/>[web.php]"]
  node_tables["Table pages"]
  node_layout["Application layout<br/>[app.blade.php]"]
  node_browserjs["Table interactions<br/>[app.js]"]
end

subgraph group_records["Record management"]
  node_controllers["Request handlers"]
  node_recordmodels["Domain models"]
  node_categories["Categories and levels"]
end

subgraph group_accounts["Accounts and access"]
  node_accountsctl["Account handlers"]
  node_authpages["Login and registration"]
  node_profile["Profile page"]
  node_admin["Admin page<br/>[admin.blade.php]"]
  node_user_model["User model<br/>[User.php]"]
  node_seed["Initial data and roles<br/>[DatabaseSeeder.php]"]
end

subgraph group_storage["Persistence and exchange"]
  node_db[("Application database")]
  node_exports["Excel exports"]
  node_excel["Excel package"]
end

node_user(("User"))

node_user -->|"sends requests"| node_routes
node_routes -->|"dispatches"| node_controllers
node_controllers -->|"renders tables"| node_tables
node_tables -->|"uses layout"| node_layout
node_layout -->|"loads scripts"| node_browserjs
node_browserjs -->|"requests updates"| node_routes
node_controllers -->|"queries and changes"| node_recordmodels
node_controllers -->|"queries and changes"| node_categories
node_recordmodels -->|"reads and writes"| node_db
node_categories -->|"reads and writes"| node_db
node_controllers -->|"creates exports"| node_exports
node_exports -->|"generates workbook"| node_excel
node_controllers -->|"imports workbook"| node_excel
node_user -->|"submits credentials"| node_authpages
node_authpages -->|"submits forms"| node_routes
node_routes -->|"dispatches"| node_accountsctl
node_accountsctl -->|"authenticates and updates"| node_user_model
node_user_model -->|"reads and writes"| node_db
node_accountsctl -->|"renders profile"| node_profile
node_accountsctl -->|"renders admin page"| node_admin
node_seed -->|"seeds users and roles"| node_db

click node_routes "https://github.com/1xterminal/aku_crud/blob/main/routes/web.php"
click node_controllers "https://github.com/1xterminal/aku_crud/tree/main/app/Http/Controllers"
click node_tables "https://github.com/1xterminal/aku_crud/tree/main/resources/views/pages/table"
click node_layout "https://github.com/1xterminal/aku_crud/blob/main/resources/views/layouts/app.blade.php"
click node_browserjs "https://github.com/1xterminal/aku_crud/blob/main/public/js/app.js"
click node_recordmodels "https://github.com/1xterminal/aku_crud/tree/main/app/Models"
click node_categories "https://github.com/1xterminal/aku_crud/tree/main/app/Models"
click node_accountsctl "https://github.com/1xterminal/aku_crud/tree/main/app/Http/Controllers"
click node_authpages "https://github.com/1xterminal/aku_crud/tree/main/resources/views/auth"
click node_profile "https://github.com/1xterminal/aku_crud/blob/main/resources/views/pages/user-profile.blade.php"
click node_admin "https://github.com/1xterminal/aku_crud/blob/main/resources/views/pages/admin/admin.blade.php"
click node_user_model "https://github.com/1xterminal/aku_crud/blob/main/app/Models/User.php"
click node_exports "https://github.com/1xterminal/aku_crud/tree/main/app/Exports"
click node_seed "https://github.com/1xterminal/aku_crud/blob/main/database/seeders/DatabaseSeeder.php"

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_routes,node_tables,node_layout,node_browserjs,node_user toneBlue
class node_controllers,node_recordmodels,node_categories toneAmber
class node_accountsctl,node_authpages,node_profile,node_admin,node_user_model,node_seed toneMint
class node_db,node_exports,node_excel toneRose
```

## Components

### Web experience

- [Web routes](https://github.com/1xterminal/aku_crud/blob/main/routes/web.php): `routes/web.php`
- [Table pages](https://github.com/1xterminal/aku_crud/tree/main/resources/views/pages/table): `resources/views/pages/table`
- [Application layout](https://github.com/1xterminal/aku_crud/blob/main/resources/views/layouts/app.blade.php): `resources/views/layouts/app.blade.php`
- [Table interactions](https://github.com/1xterminal/aku_crud/blob/main/public/js/app.js): `public/js/app.js`

### Record management

- [Request handlers](https://github.com/1xterminal/aku_crud/tree/main/app/Http/Controllers): `app/Http/Controllers`
- [Domain models](https://github.com/1xterminal/aku_crud/tree/main/app/Models): `app/Models`
- [Categories and levels](https://github.com/1xterminal/aku_crud/tree/main/app/Models): `app/Models`

### Accounts and access

- [Account handlers](https://github.com/1xterminal/aku_crud/tree/main/app/Http/Controllers): `app/Http/Controllers`
- [Login and registration](https://github.com/1xterminal/aku_crud/tree/main/resources/views/auth): `resources/views/auth`
- [Profile page](https://github.com/1xterminal/aku_crud/blob/main/resources/views/pages/user-profile.blade.php): `resources/views/pages/user-profile.blade.php`
- [Admin page](https://github.com/1xterminal/aku_crud/blob/main/resources/views/pages/admin/admin.blade.php): `resources/views/pages/admin/admin.blade.php`
- [User model](https://github.com/1xterminal/aku_crud/blob/main/app/Models/User.php): `app/Models/User.php`
- [Initial data and roles](https://github.com/1xterminal/aku_crud/blob/main/database/seeders/DatabaseSeeder.php): `database/seeders/DatabaseSeeder.php`

### Persistence and exchange

- **Application database**
- [Excel exports](https://github.com/1xterminal/aku_crud/tree/main/app/Exports): `app/Exports`
- **Excel package**

### Other components

- **User**

## Connections

- User → Web routes: sends requests
- Web routes → Request handlers: dispatches
- Request handlers → Table pages: renders tables
- Table pages → Application layout: uses layout
- Application layout → Table interactions: loads scripts
- Table interactions → Web routes: requests updates
- Request handlers → Domain models: queries and changes
- Request handlers → Categories and levels: queries and changes
- Domain models → Application database: reads and writes
- Categories and levels → Application database: reads and writes
- Request handlers → Excel exports: creates exports
- Excel exports → Excel package: generates workbook
- Request handlers → Excel package: imports workbook
- User → Login and registration: submits credentials
- Login and registration → Web routes: submits forms
- Web routes → Account handlers: dispatches
- Account handlers → User model: authenticates and updates
- User model → Application database: reads and writes
- Account handlers → Profile page: renders profile
- Account handlers → Admin page: renders admin page
- Initial data and roles → Application database: seeds users and roles