# seanthekiller/java architecture

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

- Interactive diagram: https://gitdiagram.com/seanthekiller/java
- Repository: https://github.com/seanthekiller/java

## Overview

This is a Java Swing service-centre portal. The main workflow starts at login, dispatches users to role-specific dashboards, and supports appointment booking and assignment, service work, payment, and management reporting. Counter staff also manage customers and appointments; customers can manage profiles, appointments, and feedback; technicians handle assigned jobs. The app persists its records as text files through FileUtil. Unsampled modules are included where the source index identifies their role or references; edges are limited to relationships shown there or in excerpts.

Main entry points: [`Assignment/common/FileUtil.java`](https://github.com/seanthekiller/java/blob/main/Assignment/common/FileUtil.java) (File access), [`Assignment/login/LoginFrame.java`](https://github.com/seanthekiller/java/blob/main/Assignment/login/LoginFrame.java) (Role login), [`Assignment/manager/ManagerFrame.java`](https://github.com/seanthekiller/java/blob/main/Assignment/manager/ManagerFrame.java) (Manager dashboard), [`Assignment/counter/CounterFrame.java`](https://github.com/seanthekiller/java/blob/main/Assignment/counter/CounterFrame.java) (Counter dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and access"]
  node_main["Application entry<br/>[Main.java]"]
  node_login["Role login<br/>[LoginFrame.java]"]
  node_auth["Login manager<br/>[LoginManager.java]"]
end

subgraph group_operations["Service operations"]
  node_counter["Counter dashboard<br/>[CounterFrame.java]"]
  node_appointments["Appointment desk"]
  node_booking["Appointment creation"]
  node_customers["Customer management"]
  node_customerlist["Customer list"]
  node_payments["Payment desk"]
  node_customerportal["Customer portal<br/>[CustomerFrame.java]"]
  node_customerfunctions["Customer actions"]
  node_technician["Technician workspace"]
  node_technicianfunctions["Job operations"]
end

subgraph group_management["Management"]
  node_manager["Manager dashboard<br/>[ManagerFrame.java]"]
  node_useradmin["User administration"]
  node_crud["Account screens<br/>[CRUDFrame.java]"]
  node_prices["Price settings"]
  node_feedback["Feedback review<br/>[FeedbackFrame.java]"]
  node_reports["Report screens<br/>[ReportsFrame.java]"]
  node_reportlogic["Report calculations"]
end

subgraph group_shared["Shared data and models"]
  node_storage[("Text-file records")]
  node_fileutil["File access<br/>[FileUtil.java]"]
  node_appointmentmodel["Appointment model<br/>[Appointment.java]"]
  node_paymentmodel["Payment model<br/>[Payment.java]"]
  node_userprofile["User and profile<br/>[User.java]"]
  node_customerentity["Customer entity<br/>[Customer.java]"]
  node_commentmodel["Comments<br/>[Comment.java]"]
  node_priceentity["Service prices<br/>[ServicePrice.java]"]
  node_profiledialog["Profile editor"]
  node_feedbackmodel["Feedback records<br/>[Feedback.java]"]
end

node_user(("Portal user"))

node_user -->|"starts"| node_main
node_main -->|"opens"| node_login
node_user -->|"signs in"| node_login
node_login -->|"checks credentials"| node_auth
node_login -->|"opens role dashboard"| node_counter
node_login -->|"opens role dashboard"| node_manager
node_login -->|"opens role dashboard"| node_technician
node_login -->|"opens role dashboard"| node_customerportal
node_counter -->|"opens"| node_appointments
node_appointments -->|"opens"| node_booking
node_counter -->|"opens"| node_customers
node_customers -->|"uses"| node_customerlist
node_counter -.->|"opens"| node_payments
node_customerportal -->|"uses"| node_customerfunctions
node_technician -->|"uses"| node_technicianfunctions
node_manager -->|"opens"| node_crud
node_manager -->|"opens"| node_prices
node_manager -->|"opens"| node_feedback
node_manager -.->|"opens"| node_reports
node_crud -->|"delegates to"| node_useradmin
node_prices -->|"updates prices"| node_useradmin
node_reports -->|"uses"| node_reportlogic
node_fileutil -->|"reads and writes"| node_storage
node_useradmin -->|"persists changes"| node_fileutil
node_userprofile -->|"adds to users"| node_fileutil
node_profiledialog -->|"saves profile"| node_fileutil
node_customerentity -->|"extends"| node_userprofile
node_appointments -->|"loads records"| node_fileutil
node_booking -->|"uses records"| node_fileutil
node_payments -->|"uses records"| node_fileutil
node_customerfunctions -->|"uses records"| node_fileutil
node_technicianfunctions -.->|"supports job actions"| node_technician
node_reportlogic -->|"reads records"| node_fileutil
node_fileutil -->|"loads"| node_appointmentmodel
node_fileutil -->|"loads"| node_paymentmodel
node_fileutil -->|"loads"| node_priceentity
node_payments -->|"uses"| node_appointmentmodel
node_useradmin -->|"updates"| node_priceentity
node_appointments -->|"uses"| node_commentmodel
node_customerportal -->|"uses"| node_profiledialog
node_feedback -->|"reads"| node_feedbackmodel
node_reportlogic -->|"uses"| node_appointmentmodel
node_reportlogic -->|"uses"| node_paymentmodel

click node_main "https://github.com/seanthekiller/java/blob/main/Assignment/Main.java"
click node_login "https://github.com/seanthekiller/java/blob/main/Assignment/login/LoginFrame.java"
click node_auth "https://github.com/seanthekiller/java/blob/main/Assignment/login/LoginManager.java"
click node_counter "https://github.com/seanthekiller/java/blob/main/Assignment/counter/CounterFrame.java"
click node_appointments "https://github.com/seanthekiller/java/blob/main/Assignment/counter/ManageAppointmentFrame.java"
click node_booking "https://github.com/seanthekiller/java/blob/main/Assignment/counter/CreateAppointment.java"
click node_customers "https://github.com/seanthekiller/java/blob/main/Assignment/counter/ManageCustomerFrame.java"
click node_customerlist "https://github.com/seanthekiller/java/blob/main/Assignment/counter/CustomerListPanel.java"
click node_payments "https://github.com/seanthekiller/java/blob/main/Assignment/counter/ManagePaymentFrame.java"
click node_customerportal "https://github.com/seanthekiller/java/blob/main/Assignment/customer/CustomerFrame.java"
click node_customerfunctions "https://github.com/seanthekiller/java/blob/main/Assignment/customer/CustomerFunctions.java"
click node_technician "https://github.com/seanthekiller/java/blob/main/Assignment/techniciancustomer/TechnicianFrame.java"
click node_technicianfunctions "https://github.com/seanthekiller/java/blob/main/Assignment/techniciancustomer/TechnicianFunctions.java"
click node_manager "https://github.com/seanthekiller/java/blob/main/Assignment/manager/ManagerFrame.java"
click node_useradmin "https://github.com/seanthekiller/java/blob/main/Assignment/manager/ManagerFunctions.java"
click node_crud "https://github.com/seanthekiller/java/blob/main/Assignment/manager/CRUDFrame.java"
click node_prices "https://github.com/seanthekiller/java/blob/main/Assignment/manager/SetPricesFrame.java"
click node_feedback "https://github.com/seanthekiller/java/blob/main/Assignment/manager/FeedbackFrame.java"
click node_reports "https://github.com/seanthekiller/java/blob/main/Assignment/manager/ReportsFrame.java"
click node_reportlogic "https://github.com/seanthekiller/java/blob/main/Assignment/manager/ReportFunctions.java"
click node_storage "https://github.com/seanthekiller/java/tree/main/Assignment/data"
click node_fileutil "https://github.com/seanthekiller/java/blob/main/Assignment/common/FileUtil.java"
click node_appointmentmodel "https://github.com/seanthekiller/java/blob/main/Assignment/common/Appointment.java"
click node_paymentmodel "https://github.com/seanthekiller/java/blob/main/Assignment/common/Payment.java"
click node_userprofile "https://github.com/seanthekiller/java/blob/main/Assignment/common/User.java"
click node_customerentity "https://github.com/seanthekiller/java/blob/main/Assignment/customer/Customer.java"
click node_commentmodel "https://github.com/seanthekiller/java/blob/main/Assignment/common/Comment.java"
click node_priceentity "https://github.com/seanthekiller/java/blob/main/Assignment/common/ServicePrice.java"
click node_profiledialog "https://github.com/seanthekiller/java/blob/main/Assignment/common/EditProfileDialog.java"
click node_feedbackmodel "https://github.com/seanthekiller/java/blob/main/Assignment/common/Feedback.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_main,node_login,node_auth,node_user toneBlue
class node_counter,node_appointments,node_booking,node_customers,node_customerlist,node_payments,node_customerportal,node_customerfunctions,node_technician,node_technicianfunctions toneAmber
class node_manager,node_useradmin,node_crud,node_prices,node_feedback,node_reports,node_reportlogic toneMint
class node_storage,node_fileutil,node_appointmentmodel,node_paymentmodel,node_userprofile,node_customerentity,node_commentmodel,node_priceentity,node_profiledialog,node_feedbackmodel toneRose
```

## Components

### Entry and access

- [Application entry](https://github.com/seanthekiller/java/blob/main/Assignment/Main.java): `Assignment/Main.java`
- [Role login](https://github.com/seanthekiller/java/blob/main/Assignment/login/LoginFrame.java): `Assignment/login/LoginFrame.java`
- [Login manager](https://github.com/seanthekiller/java/blob/main/Assignment/login/LoginManager.java): `Assignment/login/LoginManager.java`

### Service operations

- [Counter dashboard](https://github.com/seanthekiller/java/blob/main/Assignment/counter/CounterFrame.java): `Assignment/counter/CounterFrame.java`
- [Appointment desk](https://github.com/seanthekiller/java/blob/main/Assignment/counter/ManageAppointmentFrame.java): `Assignment/counter/ManageAppointmentFrame.java`
- [Appointment creation](https://github.com/seanthekiller/java/blob/main/Assignment/counter/CreateAppointment.java): `Assignment/counter/CreateAppointment.java`
- [Customer management](https://github.com/seanthekiller/java/blob/main/Assignment/counter/ManageCustomerFrame.java): `Assignment/counter/ManageCustomerFrame.java`
- [Customer list](https://github.com/seanthekiller/java/blob/main/Assignment/counter/CustomerListPanel.java): `Assignment/counter/CustomerListPanel.java`
- [Payment desk](https://github.com/seanthekiller/java/blob/main/Assignment/counter/ManagePaymentFrame.java): `Assignment/counter/ManagePaymentFrame.java`
- [Customer portal](https://github.com/seanthekiller/java/blob/main/Assignment/customer/CustomerFrame.java): `Assignment/customer/CustomerFrame.java`
- [Customer actions](https://github.com/seanthekiller/java/blob/main/Assignment/customer/CustomerFunctions.java): `Assignment/customer/CustomerFunctions.java`
- [Technician workspace](https://github.com/seanthekiller/java/blob/main/Assignment/techniciancustomer/TechnicianFrame.java): `Assignment/techniciancustomer/TechnicianFrame.java`
- [Job operations](https://github.com/seanthekiller/java/blob/main/Assignment/techniciancustomer/TechnicianFunctions.java): `Assignment/techniciancustomer/TechnicianFunctions.java`

### Management

- [Manager dashboard](https://github.com/seanthekiller/java/blob/main/Assignment/manager/ManagerFrame.java): `Assignment/manager/ManagerFrame.java`
- [User administration](https://github.com/seanthekiller/java/blob/main/Assignment/manager/ManagerFunctions.java): `Assignment/manager/ManagerFunctions.java`
- [Account screens](https://github.com/seanthekiller/java/blob/main/Assignment/manager/CRUDFrame.java): `Assignment/manager/CRUDFrame.java`
- [Price settings](https://github.com/seanthekiller/java/blob/main/Assignment/manager/SetPricesFrame.java): `Assignment/manager/SetPricesFrame.java`
- [Feedback review](https://github.com/seanthekiller/java/blob/main/Assignment/manager/FeedbackFrame.java): `Assignment/manager/FeedbackFrame.java`
- [Report screens](https://github.com/seanthekiller/java/blob/main/Assignment/manager/ReportsFrame.java): `Assignment/manager/ReportsFrame.java`
- [Report calculations](https://github.com/seanthekiller/java/blob/main/Assignment/manager/ReportFunctions.java): `Assignment/manager/ReportFunctions.java`

### Shared data and models

- [Text-file records](https://github.com/seanthekiller/java/tree/main/Assignment/data): `Assignment/data`
- [File access](https://github.com/seanthekiller/java/blob/main/Assignment/common/FileUtil.java): `Assignment/common/FileUtil.java`
- [Appointment model](https://github.com/seanthekiller/java/blob/main/Assignment/common/Appointment.java): `Assignment/common/Appointment.java`
- [Payment model](https://github.com/seanthekiller/java/blob/main/Assignment/common/Payment.java): `Assignment/common/Payment.java`
- [User and profile](https://github.com/seanthekiller/java/blob/main/Assignment/common/User.java): `Assignment/common/User.java`
- [Customer entity](https://github.com/seanthekiller/java/blob/main/Assignment/customer/Customer.java): `Assignment/customer/Customer.java`
- [Comments](https://github.com/seanthekiller/java/blob/main/Assignment/common/Comment.java): `Assignment/common/Comment.java`
- [Service prices](https://github.com/seanthekiller/java/blob/main/Assignment/common/ServicePrice.java): `Assignment/common/ServicePrice.java`
- [Profile editor](https://github.com/seanthekiller/java/blob/main/Assignment/common/EditProfileDialog.java): `Assignment/common/EditProfileDialog.java`
- [Feedback records](https://github.com/seanthekiller/java/blob/main/Assignment/common/Feedback.java): `Assignment/common/Feedback.java`

### Other components

- **Portal user**

## Connections

- Portal user → Application entry: starts (evidence: `Assignment/Main.java`)
- Application entry → Role login: opens (evidence: `Assignment/Main.java`)
- Portal user → Role login: signs in (evidence: `Assignment/login/LoginFrame.java`)
- Role login → Login manager: checks credentials (evidence: `Assignment/login/LoginFrame.java`)
- Role login → Counter dashboard: opens role dashboard (evidence: `Assignment/login/LoginFrame.java`)
- Role login → Manager dashboard: opens role dashboard (evidence: `Assignment/login/LoginFrame.java`)
- Role login → Technician workspace: opens role dashboard (evidence: `Assignment/login/LoginFrame.java`)
- Role login → Customer portal: opens role dashboard (evidence: `Assignment/login/LoginFrame.java`)
- Counter dashboard → Appointment desk: opens (evidence: `Assignment/counter/CounterFrame.java`)
- Appointment desk → Appointment creation: opens (evidence: `Assignment/counter/ManageAppointmentFrame.java`)
- Counter dashboard → Customer management: opens (evidence: `Assignment/counter/CounterFrame.java`)
- Customer management → Customer list: uses (evidence: `Assignment/counter/ManageCustomerFrame.java`)
- Counter dashboard → Payment desk: opens (evidence: `Assignment/counter/CounterFrame.java`)
- Customer portal → Customer actions: uses (evidence: `Assignment/customer/CustomerFrame.java`)
- Technician workspace → Job operations: uses (evidence: `Assignment/techniciancustomer/TechnicianFrame.java`)
- Manager dashboard → Account screens: opens (evidence: `Assignment/manager/ManagerFrame.java`)
- Manager dashboard → Price settings: opens (evidence: `Assignment/manager/ManagerFrame.java`)
- Manager dashboard → Feedback review: opens (evidence: `Assignment/manager/ManagerFrame.java`)
- Manager dashboard → Report screens: opens (evidence: `Assignment/manager/ManagerFrame.java`)
- Account screens → User administration: delegates to (evidence: `Assignment/manager/CRUDFrame.java`)
- Price settings → User administration: updates prices (evidence: `Assignment/manager/SetPricesFrame.java`)
- Report screens → Report calculations: uses (evidence: `Assignment/manager/ReportsFrame.java`)
- File access → Text-file records: reads and writes (evidence: `Assignment/common/FileUtil.java`)
- User administration → File access: persists changes (evidence: `Assignment/manager/ManagerFunctions.java`)
- User and profile → File access: adds to users (evidence: `Assignment/common/User.java`)
- Profile editor → File access: saves profile (evidence: `Assignment/common/EditProfileDialog.java`)
- Customer entity → User and profile: extends (evidence: `Assignment/customer/Customer.java`)
- Appointment desk → File access: loads records (evidence: `Assignment/counter/ManageAppointmentFrame.java`)
- Appointment creation → File access: uses records (evidence: `Assignment/counter/CreateAppointment.java`)
- Payment desk → File access: uses records (evidence: `Assignment/counter/ManagePaymentFrame.java`)
- Customer actions → File access: uses records (evidence: `Assignment/customer/CustomerFunctions.java`)
- Job operations → Technician workspace: supports job actions (evidence: `Assignment/techniciancustomer/TechnicianFrame.java`)
- Report calculations → File access: reads records (evidence: `Assignment/manager/ReportFunctions.java`)
- File access → Appointment model: loads (evidence: `Assignment/common/FileUtil.java`)
- File access → Payment model: loads (evidence: `Assignment/common/FileUtil.java`)
- File access → Service prices: loads (evidence: `Assignment/common/FileUtil.java`)
- Payment desk → Appointment model: uses (evidence: `Assignment/counter/ManagePaymentFrame.java`)
- User administration → Service prices: updates (evidence: `Assignment/manager/ManagerFunctions.java`)
- Appointment desk → Comments: uses (evidence: `Assignment/counter/ManageAppointmentFrame.java`)
- Customer portal → Profile editor: uses (evidence: `Assignment/customer/CustomerFrame.java`)
- Feedback review → Feedback records: reads (evidence: `Assignment/manager/FeedbackFrame.java`)
- Report calculations → Appointment model: uses (evidence: `Assignment/manager/ReportFunctions.java`)
- Report calculations → Payment model: uses (evidence: `Assignment/manager/ReportFunctions.java`)
