# gawbx/univoice architecture

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

- Interactive diagram: https://gitdiagram.com/gawbx/univoice
- Repository: https://github.com/gawbx/univoice

## Overview

UniVoice is a Java Swing campus-feedback application, with a console entry point as well. The main workflow is role-based sign-in, student submission and validation, creation of a Pending feedback record, then administrator review, status changes, and cleanup. Authentication and feedback records are represented in sampled source; the README documents file persistence and administration capabilities, but the referenced FeedbackManager implementation is not in the tree. Edges to that unsampled subsystem are therefore documented or marked unverified rather than attributed to inspected code.

Main entry points: [`src/univoice/SubmitPanel.java`](https://github.com/gawbx/univoice/blob/main/src/univoice/SubmitPanel.java) (Feedback submission), [`src/univoice/MainFrame.java`](https://github.com/gawbx/univoice/blob/main/src/univoice/MainFrame.java) (Main window), [`src/univoice/LoginPanel.java`](https://github.com/gawbx/univoice/blob/main/src/univoice/LoginPanel.java) (Sign-in screen), [`src/univoice/AuthService.java`](https://github.com/gawbx/univoice/blob/main/src/univoice/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application Entry"]
  node_launch["Application entry<br/>[CampusTracker.java]"]
end

subgraph group_identity["Identity and Validation"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_validator["Input validation<br/>[Validator.java]"]
  node_role["Account role<br/>[Role.java]"]
  node_session["User session<br/>[Session.java]"]
end

subgraph group_feedback["Feedback Records"]
  node_record_manager["Record management"]
  node_record_file[("Feedback file")]
  node_feedback["Feedback record<br/>[Feedback.java]"]
  node_suggestion["Suggestion record<br/>[Suggestion.java]"]
  node_complaint["Complaint record<br/>[Complaint.java]"]
  node_factory["Record factory"]
  node_status["Record status<br/>[Status.java]"]
end

subgraph group_interface["User Interface"]
  node_window["Main window<br/>[MainFrame.java]"]
  node_login["Sign-in screen<br/>[LoginPanel.java]"]
  node_submit["Feedback submission<br/>[SubmitPanel.java]"]
  node_admin["Admin records view<br/>[MainFrame.java]"]
  node_about["About page<br/>[AboutPanel.java]"]
  node_theme["Theme styling<br/>[Theme.java]"]
  node_page["Responsive page<br/>[Page.java]"]
  node_responsive["Responsive sizing<br/>[Responsive.java]"]
  node_grid["Grid flow layout"]
  node_wrap["Wrap layout<br/>[WrapLayout.java]"]
  node_wraptext["Wrapped text<br/>[WrapText.java]"]
end

node_user(("Student or admin"))

node_user -->|"starts"| node_launch
node_launch -->|"launches"| node_window
node_window -->|"shows"| node_login
node_login -->|"authenticates"| node_auth
node_auth -->|"checks IDs"| node_validator
node_auth -->|"assigns role"| node_role
node_auth -->|"creates"| node_session
node_login -->|"checks input"| node_validator
node_window -->|"configures"| node_auth
node_window -->|"shows"| node_submit
node_submit -->|"validates"| node_validator
node_submit -->|"submits records"| node_record_manager
node_launch -->|"creates"| node_record_manager
node_record_manager -.->|"loads and saves"| node_record_file
node_record_manager -.->|"manages records"| node_feedback
node_submit -->|"creates"| node_suggestion
node_submit -->|"creates"| node_complaint
node_factory -->|"creates"| node_suggestion
node_factory -->|"creates"| node_complaint
node_suggestion -->|"extends"| node_feedback
node_complaint -->|"extends"| node_feedback
node_feedback -->|"stores status"| node_status
node_window -.->|"shows"| node_admin
node_admin -.->|"reviews records"| node_record_manager
node_window -->|"shows"| node_about
node_window -->|"uses"| node_theme
node_login -->|"uses"| node_theme
node_submit -->|"uses"| node_theme
node_login -->|"uses"| node_page
node_submit -->|"uses"| node_page
node_login -->|"adapts to"| node_responsive
node_submit -->|"adapts to"| node_responsive
node_submit -->|"lays out"| node_grid
node_submit -->|"lays out"| node_wrap
node_login -->|"displays messages"| node_wraptext
node_about -->|"lays out"| node_grid
node_about -->|"uses"| node_theme

click node_launch "https://github.com/gawbx/univoice/blob/main/src/univoice/CampusTracker.java"
click node_window "https://github.com/gawbx/univoice/blob/main/src/univoice/MainFrame.java"
click node_login "https://github.com/gawbx/univoice/blob/main/src/univoice/LoginPanel.java"
click node_auth "https://github.com/gawbx/univoice/blob/main/src/univoice/AuthService.java"
click node_validator "https://github.com/gawbx/univoice/blob/main/src/univoice/Validator.java"
click node_role "https://github.com/gawbx/univoice/blob/main/src/univoice/Role.java"
click node_session "https://github.com/gawbx/univoice/blob/main/src/univoice/Session.java"
click node_submit "https://github.com/gawbx/univoice/blob/main/src/univoice/SubmitPanel.java"
click node_record_manager "https://github.com/gawbx/univoice/tree/main/src/univoice/service"
click node_record_file "https://github.com/gawbx/univoice/tree/main/data"
click node_feedback "https://github.com/gawbx/univoice/blob/main/src/univoice/model/Feedback.java"
click node_suggestion "https://github.com/gawbx/univoice/blob/main/src/univoice/model/Suggestion.java"
click node_complaint "https://github.com/gawbx/univoice/blob/main/src/univoice/model/Complaint.java"
click node_factory "https://github.com/gawbx/univoice/blob/main/src/univoice/model/FeedbackFactory.java"
click node_status "https://github.com/gawbx/univoice/blob/main/src/univoice/model/Status.java"
click node_admin "https://github.com/gawbx/univoice/blob/main/src/univoice/MainFrame.java"
click node_about "https://github.com/gawbx/univoice/blob/main/src/univoice/ui/AboutPanel.java"
click node_theme "https://github.com/gawbx/univoice/blob/main/src/univoice/ui/Theme.java"
click node_page "https://github.com/gawbx/univoice/blob/main/src/univoice/Page.java"
click node_responsive "https://github.com/gawbx/univoice/blob/main/src/univoice/Responsive.java"
click node_grid "https://github.com/gawbx/univoice/blob/main/src/univoice/GridFlowLayout.java"
click node_wrap "https://github.com/gawbx/univoice/blob/main/src/univoice/WrapLayout.java"
click node_wraptext "https://github.com/gawbx/univoice/blob/main/src/univoice/WrapText.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_launch toneBlue
class node_auth,node_validator,node_role,node_session toneAmber
class node_record_manager,node_record_file,node_feedback,node_suggestion,node_complaint,node_factory,node_status toneMint
class node_window,node_login,node_submit,node_admin,node_about,node_theme,node_page,node_responsive,node_grid,node_wrap,node_wraptext toneRose
class node_user toneIndigo
```

## Components

### Application Entry

- [Application entry](https://github.com/gawbx/univoice/blob/main/src/univoice/CampusTracker.java): `src/univoice/CampusTracker.java`

### Identity and Validation

- [Authentication](https://github.com/gawbx/univoice/blob/main/src/univoice/AuthService.java): `src/univoice/AuthService.java`
- [Input validation](https://github.com/gawbx/univoice/blob/main/src/univoice/Validator.java): `src/univoice/Validator.java`
- [Account role](https://github.com/gawbx/univoice/blob/main/src/univoice/Role.java): `src/univoice/Role.java`
- [User session](https://github.com/gawbx/univoice/blob/main/src/univoice/Session.java): `src/univoice/Session.java`

### Feedback Records

- [Record management](https://github.com/gawbx/univoice/tree/main/src/univoice/service): `src/univoice/service`
- [Feedback file](https://github.com/gawbx/univoice/tree/main/data): `data`
- [Feedback record](https://github.com/gawbx/univoice/blob/main/src/univoice/model/Feedback.java): `src/univoice/model/Feedback.java`
- [Suggestion record](https://github.com/gawbx/univoice/blob/main/src/univoice/model/Suggestion.java): `src/univoice/model/Suggestion.java`
- [Complaint record](https://github.com/gawbx/univoice/blob/main/src/univoice/model/Complaint.java): `src/univoice/model/Complaint.java`
- [Record factory](https://github.com/gawbx/univoice/blob/main/src/univoice/model/FeedbackFactory.java): `src/univoice/model/FeedbackFactory.java`
- [Record status](https://github.com/gawbx/univoice/blob/main/src/univoice/model/Status.java): `src/univoice/model/Status.java`

### User Interface

- [Main window](https://github.com/gawbx/univoice/blob/main/src/univoice/MainFrame.java): `src/univoice/MainFrame.java`
- [Sign-in screen](https://github.com/gawbx/univoice/blob/main/src/univoice/LoginPanel.java): `src/univoice/LoginPanel.java`
- [Feedback submission](https://github.com/gawbx/univoice/blob/main/src/univoice/SubmitPanel.java): `src/univoice/SubmitPanel.java`
- [Admin records view](https://github.com/gawbx/univoice/blob/main/src/univoice/MainFrame.java): `src/univoice/MainFrame.java`
- [About page](https://github.com/gawbx/univoice/blob/main/src/univoice/ui/AboutPanel.java): `src/univoice/ui/AboutPanel.java`
- [Theme styling](https://github.com/gawbx/univoice/blob/main/src/univoice/ui/Theme.java): `src/univoice/ui/Theme.java`
- [Responsive page](https://github.com/gawbx/univoice/blob/main/src/univoice/Page.java): `src/univoice/Page.java`
- [Responsive sizing](https://github.com/gawbx/univoice/blob/main/src/univoice/Responsive.java): `src/univoice/Responsive.java`
- [Grid flow layout](https://github.com/gawbx/univoice/blob/main/src/univoice/GridFlowLayout.java): `src/univoice/GridFlowLayout.java`
- [Wrap layout](https://github.com/gawbx/univoice/blob/main/src/univoice/WrapLayout.java): `src/univoice/WrapLayout.java`
- [Wrapped text](https://github.com/gawbx/univoice/blob/main/src/univoice/WrapText.java): `src/univoice/WrapText.java`

### Other components

- **Student or admin**

## Connections

- Student or admin → Application entry: starts (evidence: `README.md`)
- Application entry → Main window: launches (evidence: `src/univoice/CampusTracker.java`)
- Main window → Sign-in screen: shows (evidence: `src/univoice/MainFrame.java`)
- Sign-in screen → Authentication: authenticates (evidence: `src/univoice/LoginPanel.java`)
- Authentication → Input validation: checks IDs (evidence: `src/univoice/AuthService.java`)
- Authentication → Account role: assigns role (evidence: `src/univoice/AuthService.java`)
- Authentication → User session: creates (evidence: `src/univoice/AuthService.java`)
- Sign-in screen → Input validation: checks input (evidence: `src/univoice/LoginPanel.java`)
- Main window → Authentication: configures (evidence: `src/univoice/MainFrame.java`)
- Main window → Feedback submission: shows (evidence: `src/univoice/MainFrame.java`)
- Feedback submission → Input validation: validates (evidence: `src/univoice/SubmitPanel.java`)
- Feedback submission → Record management: submits records (evidence: `src/univoice/SubmitPanel.java`)
- Application entry → Record management: creates (evidence: `src/univoice/CampusTracker.java`)
- Record management → Feedback file: loads and saves (evidence: `README.md`)
- Record management → Feedback record: manages records (evidence: `README.md`)
- Feedback submission → Suggestion record: creates (evidence: `src/univoice/SubmitPanel.java`)
- Feedback submission → Complaint record: creates (evidence: `src/univoice/SubmitPanel.java`)
- Record factory → Suggestion record: creates (evidence: `src/univoice/model/FeedbackFactory.java`)
- Record factory → Complaint record: creates (evidence: `src/univoice/model/FeedbackFactory.java`)
- Suggestion record → Feedback record: extends (evidence: `src/univoice/model/Suggestion.java`)
- Complaint record → Feedback record: extends (evidence: `src/univoice/model/Complaint.java`)
- Feedback record → Record status: stores status (evidence: `src/univoice/model/Feedback.java`)
- Main window → Admin records view: shows (evidence: `README.md`)
- Admin records view → Record management: reviews records (evidence: `README.md`)
- Main window → About page: shows (evidence: `src/univoice/MainFrame.java`)
- Main window → Theme styling: uses (evidence: `src/univoice/MainFrame.java`)
- Sign-in screen → Theme styling: uses (evidence: `src/univoice/LoginPanel.java`)
- Feedback submission → Theme styling: uses (evidence: `src/univoice/SubmitPanel.java`)
- Sign-in screen → Responsive page: uses (evidence: `src/univoice/LoginPanel.java`)
- Feedback submission → Responsive page: uses (evidence: `src/univoice/SubmitPanel.java`)
- Sign-in screen → Responsive sizing: adapts to (evidence: `src/univoice/LoginPanel.java`)
- Feedback submission → Responsive sizing: adapts to (evidence: `src/univoice/SubmitPanel.java`)
- Feedback submission → Grid flow layout: lays out (evidence: `src/univoice/SubmitPanel.java`)
- Feedback submission → Wrap layout: lays out (evidence: `src/univoice/SubmitPanel.java`)
- Sign-in screen → Wrapped text: displays messages (evidence: `src/univoice/LoginPanel.java`)
- About page → Grid flow layout: lays out (evidence: `src/univoice/ui/AboutPanel.java`)
- About page → Theme styling: uses (evidence: `src/univoice/ui/AboutPanel.java`)
