# velikkom/tahsilat-app architecture

> Architecture diagram of the GitHub repository velikkom/tahsilat-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/velikkom/tahsilat-app
- Repository: https://github.com/velikkom/tahsilat-app

## Overview

Tahsilat is a collections-management application with a Next.js frontend and Spring backend. Users authenticate, manage customers and collections, review financial summaries, and manage trips with print and spreadsheet-import workflows. The tree also shows administration and collection/trip import capabilities. The README is empty; several links between frontend pages, controllers, and service implementations are inferred from the tree and are marked unverified rather than presented as inspected call paths.

Main entry points: [`frontend/src/app/(dashboard)/layout.js`](https://github.com/velikkom/tahsilat-app/blob/master/frontend/src/app/(dashboard)/layout.js) (Next.js pages), [`backend/tahsilat/src/main/java/com/veli/tahsilat/trip/service/impl/TripServiceImpl.java`](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/service/impl/TripServiceImpl.java) (Trip service), [`frontend/src/app/(dashboard)/trips/page.jsx`](https://github.com/velikkom/tahsilat-app/blob/master/frontend/src/app/(dashboard)/trips/page.jsx) (Trip pages), [`backend/tahsilat/src/main/java/com/veli/tahsilat/collection/service/impl/CollectionServiceImpl.java`](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/collection/service/impl/CollectionServiceImpl.java) (Collection service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_web["Next.js pages<br/>[layout.js]"]
  node_auth_pages["Sign-in pages<br/>[page.jsx]"]
  node_trip_pages["Trip pages<br/>[page.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth_service["Auth API"]
  node_auth_logic["Authentication"]
  node_jwt["JWT handling<br/>[JwtService.java]"]
  node_session["Session validation"]
  node_users["User administration"]
  node_user_store[("User records")]
end

subgraph group_finance["Customers and collections"]
  node_customers["Customer management"]
  node_customer_logic["Customer service"]
  node_collections["Collection management"]
  node_collection_logic["Collection service"]
  node_collection_import["Collection import"]
  node_collection_store[("Collection records")]
  node_customer_store[("Customer records")]
end

subgraph group_insights["Financial insights"]
  node_dashboard["Dashboard analytics"]
  node_dashboard_logic["Dashboard service"]
  node_reports["Financial reports"]
  node_report_logic["Report service"]
end

subgraph group_trips["Trip operations"]
  node_trips["Trip management"]
  node_trip_logic["Trip service"]
  node_trip_import["Trip spreadsheet import"]
  node_trip_export["Trip documents"]
  node_trip_store[("Trip records")]
end

node_user(("User"))

node_user -->|"signs in"| node_auth_pages
node_user -->|"uses"| node_web
node_auth_pages -.->|"authenticates"| node_auth_service
node_auth_service -.->|"delegates to"| node_auth_logic
node_auth_logic -.->|"issues tokens"| node_jwt
node_session -->|"checks session"| node_user_store
node_users -.->|"manages users"| node_user_store
node_web -.->|"requests customers"| node_customers
node_customers -.->|"delegates to"| node_customer_logic
node_customer_logic -.->|"persists customers"| node_customer_store
node_web -.->|"requests collections"| node_collections
node_collections -.->|"delegates to"| node_collection_logic
node_collection_logic -.->|"persists collections"| node_collection_store
node_web -.->|"uploads spreadsheet"| node_collection_import
node_collection_import -.->|"creates collections"| node_collection_logic
node_web -.->|"requests metrics"| node_dashboard
node_dashboard -.->|"delegates to"| node_dashboard_logic
node_web -.->|"requests reports"| node_reports
node_reports -.->|"delegates to"| node_report_logic
node_trip_pages -.->|"requests trips"| node_trips
node_trips -.->|"delegates to"| node_trip_logic
node_trip_logic -.->|"persists trips"| node_trip_store
node_trip_pages -.->|"uploads spreadsheet"| node_trip_import
node_trip_import -.->|"creates trips"| node_trip_logic
node_trip_pages -.->|"requests documents"| node_trip_export
node_trip_logic -.->|"generates documents"| node_trip_export

click node_web "https://github.com/velikkom/tahsilat-app/blob/master/frontend/src/app/(dashboard)/layout.js"
click node_auth_pages "https://github.com/velikkom/tahsilat-app/blob/master/frontend/src/app/login/page.jsx"
click node_auth_service "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/auth/controller/AuthController.java"
click node_auth_logic "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/auth/service/impl/AuthServiceImpl.java"
click node_jwt "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/security/jwt/JwtService.java"
click node_session "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/security/session/SessionValidationService.java"
click node_users "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/user/controller/UserController.java"
click node_user_store "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/user/repository/UserRepository.java"
click node_customers "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/customer/controller/CustomerController.java"
click node_customer_logic "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/customer/service/impl/CustomerServiceImpl.java"
click node_collections "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/collection/controller/CollectionController.java"
click node_collection_logic "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/collection/service/impl/CollectionServiceImpl.java"
click node_collection_import "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/collection/importexcel/service/impl/ExcelImportServiceImpl.java"
click node_collection_store "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/collection/repository/CollectionRepository.java"
click node_customer_store "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/customer/repository/CustomerRepository.java"
click node_dashboard "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/dashboard/controller/DashboardController.java"
click node_dashboard_logic "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/dashboard/service/impl/DashboardServiceImpl.java"
click node_reports "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/report/controller/ReportController.java"
click node_report_logic "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/report/service/impl/ReportServiceImpl.java"
click node_trip_pages "https://github.com/velikkom/tahsilat-app/blob/master/frontend/src/app/(dashboard)/trips/page.jsx"
click node_trips "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/controller/TripController.java"
click node_trip_logic "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/service/impl/TripServiceImpl.java"
click node_trip_import "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/importexcel/service/impl/TripExcelImportServiceImpl.java"
click node_trip_export "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/export/TripDocumentGenerator.java"
click node_trip_store "https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/repository/TripRepository.java"

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_web,node_auth_pages,node_trip_pages,node_user toneBlue
class node_auth_service,node_auth_logic,node_jwt,node_session,node_users,node_user_store toneAmber
class node_customers,node_customer_logic,node_collections,node_collection_logic,node_collection_import,node_collection_store,node_customer_store toneMint
class node_dashboard,node_dashboard_logic,node_reports,node_report_logic toneRose
class node_trips,node_trip_logic,node_trip_import,node_trip_export,node_trip_store toneIndigo
```

## Components

### Web application

- [Next.js pages](https://github.com/velikkom/tahsilat-app/blob/master/frontend/src/app/(dashboard)/layout.js): `frontend/src/app/(dashboard)/layout.js`
- [Sign-in pages](https://github.com/velikkom/tahsilat-app/blob/master/frontend/src/app/login/page.jsx): `frontend/src/app/login/page.jsx`
- [Trip pages](https://github.com/velikkom/tahsilat-app/blob/master/frontend/src/app/(dashboard)/trips/page.jsx): `frontend/src/app/(dashboard)/trips/page.jsx`

### Identity and access

- [Auth API](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/auth/controller/AuthController.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/auth/controller/AuthController.java`
- [Authentication](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/auth/service/impl/AuthServiceImpl.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/auth/service/impl/AuthServiceImpl.java`
- [JWT handling](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/security/jwt/JwtService.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/security/jwt/JwtService.java`
- [Session validation](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/security/session/SessionValidationService.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/security/session/SessionValidationService.java`
- [User administration](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/user/controller/UserController.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/user/controller/UserController.java`
- [User records](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/user/repository/UserRepository.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/user/repository/UserRepository.java`

### Customers and collections

- [Customer management](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/customer/controller/CustomerController.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/customer/controller/CustomerController.java`
- [Customer service](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/customer/service/impl/CustomerServiceImpl.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/customer/service/impl/CustomerServiceImpl.java`
- [Collection management](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/collection/controller/CollectionController.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/collection/controller/CollectionController.java`
- [Collection service](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/collection/service/impl/CollectionServiceImpl.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/collection/service/impl/CollectionServiceImpl.java`
- [Collection import](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/collection/importexcel/service/impl/ExcelImportServiceImpl.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/collection/importexcel/service/impl/ExcelImportServiceImpl.java`
- [Collection records](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/collection/repository/CollectionRepository.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/collection/repository/CollectionRepository.java`
- [Customer records](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/customer/repository/CustomerRepository.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/customer/repository/CustomerRepository.java`

### Financial insights

- [Dashboard analytics](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/dashboard/controller/DashboardController.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/dashboard/controller/DashboardController.java`
- [Dashboard service](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/dashboard/service/impl/DashboardServiceImpl.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/dashboard/service/impl/DashboardServiceImpl.java`
- [Financial reports](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/report/controller/ReportController.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/report/controller/ReportController.java`
- [Report service](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/report/service/impl/ReportServiceImpl.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/report/service/impl/ReportServiceImpl.java`

### Trip operations

- [Trip management](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/controller/TripController.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/trip/controller/TripController.java`
- [Trip service](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/service/impl/TripServiceImpl.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/trip/service/impl/TripServiceImpl.java`
- [Trip spreadsheet import](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/importexcel/service/impl/TripExcelImportServiceImpl.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/trip/importexcel/service/impl/TripExcelImportServiceImpl.java`
- [Trip documents](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/export/TripDocumentGenerator.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/trip/export/TripDocumentGenerator.java`
- [Trip records](https://github.com/velikkom/tahsilat-app/blob/master/backend/tahsilat/src/main/java/com/veli/tahsilat/trip/repository/TripRepository.java): `backend/tahsilat/src/main/java/com/veli/tahsilat/trip/repository/TripRepository.java`

### Other components

- **User**

## Connections

- User → Sign-in pages: signs in
- User → Next.js pages: uses
- Sign-in pages → Auth API: authenticates
- Auth API → Authentication: delegates to
- Authentication → JWT handling: issues tokens
- Session validation → User records: checks session (evidence: `backend/tahsilat/src/main/java/com/veli/tahsilat/security/session/SessionValidationService.java`)
- User administration → User records: manages users
- Next.js pages → Customer management: requests customers
- Customer management → Customer service: delegates to
- Customer service → Customer records: persists customers
- Next.js pages → Collection management: requests collections
- Collection management → Collection service: delegates to
- Collection service → Collection records: persists collections
- Next.js pages → Collection import: uploads spreadsheet
- Collection import → Collection service: creates collections
- Next.js pages → Dashboard analytics: requests metrics
- Dashboard analytics → Dashboard service: delegates to
- Next.js pages → Financial reports: requests reports
- Financial reports → Report service: delegates to
- Trip pages → Trip management: requests trips
- Trip management → Trip service: delegates to
- Trip service → Trip records: persists trips
- Trip pages → Trip spreadsheet import: uploads spreadsheet
- Trip spreadsheet import → Trip service: creates trips
- Trip pages → Trip documents: requests documents
- Trip service → Trip documents: generates documents
