# joshuazamora130-cpu/orgmate architecture

> Architecture diagram of the GitHub repository joshuazamora130-cpu/orgmate, 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/joshuazamora130-cpu/orgmate
- Repository: https://github.com/joshuazamora130-cpu/orgmate

## Overview

OrgMate is a student-organization management application with account access, membership and payment workflows, and officer dashboards. The visible workflow starts at login or sign-up; students can submit and review membership-fee payments, while treasurers manage ticket status and other officers review records and summaries. Source references support the main UI-to-service and officer-to-storage links. The README gives no further capability detail, and some subsystem implementations are unsampled, so uncertain connections are omitted.

Main entry points: [`src/main/java/src/ui/Login.java`](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/Login.java) (Login), [`src/main/java/src/services/PaymentStorage.java`](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/PaymentStorage.java) (Payment Storage), [`src/main/java/src/model/President.java`](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/President.java) (Organization Summary), [`src/main/java/src/ui/PaymentSubmission.java`](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/PaymentSubmission.java) (Payment Submission)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Accounts"]
  node_main["Application Entry<br/>[Main.java]"]
  node_login["Login<br/>[Login.java]"]
  node_signup["Sign Up<br/>[SignUp.java]"]
  node_auth["Authentication<br/>[Auth.java]"]
  node_accounts["Account Storage"]
  node_faculty["Faculty Accounts"]
end

subgraph group_membership["Membership Records"]
  node_studentdash["Student Dashboard"]
  node_roster["Roster Storage"]
  node_fee["Fee Calculator"]
end

subgraph group_payments["Payments and Audit"]
  node_submission["Payment Submission"]
  node_history["Payment History"]
  node_tickets["Payment Tickets<br/>[PaymentTicket.java]"]
  node_paymentstore["Payment Storage"]
  node_dbconnection["Database Connection"]
end

subgraph group_officers["Officer Workspaces"]
  node_treasurerui["Treasurer Dashboard"]
  node_treasurer["Treasurer Operations<br/>[Treasurer.java]"]
  node_auditorui["Auditor Dashboard"]
  node_auditor["Audit and Reports<br/>[Auditor.java]"]
  node_adviserui["Adviser Dashboard"]
  node_adviser["Adviser Operations<br/>[Adviser.java]"]
  node_presidentui["President Dashboard"]
  node_president["Organization Summary<br/>[President.java]"]
  node_secretaryui["Secretary Dashboard"]
  node_secretary["Secretary Operations<br/>[Secretary.java]"]
end

node_student(("Student / Officer"))
node_database[("PostgreSQL Database")]

node_student -->|"starts app"| node_main
node_main -->|"opens"| node_login
node_main -->|"opens"| node_signup
node_student -.->|"provides credentials"| node_login
node_login -->|"authenticates"| node_auth
node_signup -->|"validates"| node_auth
node_signup -->|"registers account"| node_accounts
node_auth -->|"looks up account"| node_accounts
node_auth -->|"checks faculty"| node_faculty
node_login -->|"routes student"| node_studentdash
node_login -->|"routes treasurer"| node_treasurerui
node_login -->|"routes auditor"| node_auditorui
node_login -->|"routes adviser"| node_adviserui
node_login -->|"routes president"| node_presidentui
node_login -->|"routes secretary"| node_secretaryui
node_studentdash -->|"opens submission"| node_submission
node_studentdash -->|"opens history"| node_history
node_submission -->|"calculates fee"| node_fee
node_submission -->|"saves ticket"| node_paymentstore
node_submission -->|"creates ticket"| node_tickets
node_history -->|"loads history"| node_paymentstore
node_treasurerui -->|"uses operations"| node_treasurer
node_treasurer -->|"updates ticket"| node_paymentstore
node_treasurerui -->|"loads tickets"| node_paymentstore
node_auditorui -->|"uses audits"| node_auditor
node_auditor -->|"reads tickets"| node_paymentstore
node_adviserui -->|"uses operations"| node_adviser
node_adviser -->|"reads payment records"| node_paymentstore
node_presidentui -->|"uses summaries"| node_president
node_president -->|"counts accounts"| node_accounts
node_president -->|"counts students"| node_roster
node_president -->|"summarizes tickets"| node_paymentstore
node_president -->|"requests membership report"| node_secretary
node_secretaryui -.->|"uses operations"| node_secretary
node_accounts -->|"opens connection"| node_dbconnection
node_paymentstore -->|"opens connection"| node_dbconnection
node_roster -->|"opens connection"| node_dbconnection
node_dbconnection -->|"connects via JDBC"| node_database

click node_main "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/Main.java"
click node_login "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/Login.java"
click node_signup "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/SignUp.java"
click node_auth "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/authentication/Auth.java"
click node_accounts "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/AccountStorage.java"
click node_faculty "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/FacultyAccountStorage.java"
click node_studentdash "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/StudentDashboard.java"
click node_roster "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/StudentRosterStorage.java"
click node_fee "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/MembershipFeeCalculator.java"
click node_submission "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/PaymentSubmission.java"
click node_history "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/PaymentHistory.java"
click node_tickets "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/PaymentTicket.java"
click node_paymentstore "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/PaymentStorage.java"
click node_dbconnection "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/DatabaseConnection.java"
click node_treasurerui "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/TreasurerDashboard.java"
click node_treasurer "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/Treasurer.java"
click node_auditorui "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/AuditorDashboard.java"
click node_auditor "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/Auditor.java"
click node_adviserui "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/AdviserDashboard.java"
click node_adviser "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/Adviser.java"
click node_presidentui "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/PresidentDashboard.java"
click node_president "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/President.java"
click node_secretaryui "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/SecretaryDashboard.java"
click node_secretary "https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/Secretary.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_signup,node_auth,node_accounts,node_faculty toneBlue
class node_studentdash,node_roster,node_fee,node_database toneAmber
class node_submission,node_history,node_tickets,node_paymentstore,node_dbconnection toneMint
class node_treasurerui,node_treasurer,node_auditorui,node_auditor,node_adviserui,node_adviser,node_presidentui,node_president,node_secretaryui,node_secretary toneRose
class node_student toneIndigo
```

## Components

### Access and Accounts

- [Application Entry](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/Main.java): `src/main/java/src/Main.java`
- [Login](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/Login.java): `src/main/java/src/ui/Login.java`
- [Sign Up](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/SignUp.java): `src/main/java/src/ui/SignUp.java`
- [Authentication](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/authentication/Auth.java): `src/main/java/src/authentication/Auth.java`
- [Account Storage](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/AccountStorage.java): `src/main/java/src/services/AccountStorage.java`
- [Faculty Accounts](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/FacultyAccountStorage.java): `src/main/java/src/services/FacultyAccountStorage.java`

### Membership Records

- [Student Dashboard](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/StudentDashboard.java): `src/main/java/src/ui/StudentDashboard.java`
- [Roster Storage](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/StudentRosterStorage.java): `src/main/java/src/services/StudentRosterStorage.java`
- [Fee Calculator](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/MembershipFeeCalculator.java): `src/main/java/src/services/MembershipFeeCalculator.java`

### Payments and Audit

- [Payment Submission](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/PaymentSubmission.java): `src/main/java/src/ui/PaymentSubmission.java`
- [Payment History](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/PaymentHistory.java): `src/main/java/src/ui/PaymentHistory.java`
- [Payment Tickets](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/PaymentTicket.java): `src/main/java/src/model/PaymentTicket.java`
- [Payment Storage](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/services/PaymentStorage.java): `src/main/java/src/services/PaymentStorage.java`
- [Database Connection](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/DatabaseConnection.java): `src/main/java/src/DatabaseConnection.java`

### Officer Workspaces

- [Treasurer Dashboard](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/TreasurerDashboard.java): `src/main/java/src/ui/TreasurerDashboard.java`
- [Treasurer Operations](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/Treasurer.java): `src/main/java/src/model/Treasurer.java`
- [Auditor Dashboard](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/AuditorDashboard.java): `src/main/java/src/ui/AuditorDashboard.java`
- [Audit and Reports](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/Auditor.java): `src/main/java/src/model/Auditor.java`
- [Adviser Dashboard](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/AdviserDashboard.java): `src/main/java/src/ui/AdviserDashboard.java`
- [Adviser Operations](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/Adviser.java): `src/main/java/src/model/Adviser.java`
- [President Dashboard](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/PresidentDashboard.java): `src/main/java/src/ui/PresidentDashboard.java`
- [Organization Summary](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/President.java): `src/main/java/src/model/President.java`
- [Secretary Dashboard](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/ui/SecretaryDashboard.java): `src/main/java/src/ui/SecretaryDashboard.java`
- [Secretary Operations](https://github.com/joshuazamora130-cpu/orgmate/blob/main/src/main/java/src/model/Secretary.java): `src/main/java/src/model/Secretary.java`

### Other components

- **Student / Officer**
- **PostgreSQL Database**

## Connections

- Student / Officer → Application Entry: starts app (evidence: `src/main/java/src/Main.java`)
- Application Entry → Login: opens (evidence: `src/main/java/src/Main.java`)
- Application Entry → Sign Up: opens (evidence: `src/main/java/src/Main.java`)
- Student / Officer → Login: provides credentials
- Login → Authentication: authenticates (evidence: `src/main/java/src/ui/Login.java`)
- Sign Up → Authentication: validates (evidence: `src/main/java/src/ui/SignUp.java`)
- Sign Up → Account Storage: registers account (evidence: `src/main/java/src/ui/SignUp.java`)
- Authentication → Account Storage: looks up account (evidence: `src/main/java/src/authentication/Auth.java`)
- Authentication → Faculty Accounts: checks faculty (evidence: `src/main/java/src/authentication/Auth.java`)
- Login → Student Dashboard: routes student (evidence: `src/main/java/src/ui/Login.java`)
- Login → Treasurer Dashboard: routes treasurer (evidence: `src/main/java/src/ui/Login.java`)
- Login → Auditor Dashboard: routes auditor (evidence: `src/main/java/src/ui/Login.java`)
- Login → Adviser Dashboard: routes adviser (evidence: `src/main/java/src/ui/Login.java`)
- Login → President Dashboard: routes president (evidence: `src/main/java/src/ui/Login.java`)
- Login → Secretary Dashboard: routes secretary (evidence: `src/main/java/src/ui/Login.java`)
- Student Dashboard → Payment Submission: opens submission (evidence: `src/main/java/src/ui/StudentDashboard.java`)
- Student Dashboard → Payment History: opens history (evidence: `src/main/java/src/ui/StudentDashboard.java`)
- Payment Submission → Fee Calculator: calculates fee (evidence: `src/main/java/src/ui/PaymentSubmission.java`)
- Payment Submission → Payment Storage: saves ticket (evidence: `src/main/java/src/ui/PaymentSubmission.java`)
- Payment Submission → Payment Tickets: creates ticket (evidence: `src/main/java/src/ui/PaymentSubmission.java`)
- Payment History → Payment Storage: loads history (evidence: `src/main/java/src/ui/PaymentHistory.java`)
- Treasurer Dashboard → Treasurer Operations: uses operations (evidence: `src/main/java/src/ui/TreasurerDashboard.java`)
- Treasurer Operations → Payment Storage: updates ticket (evidence: `src/main/java/src/model/Treasurer.java`)
- Treasurer Dashboard → Payment Storage: loads tickets (evidence: `src/main/java/src/ui/TreasurerDashboard.java`)
- Auditor Dashboard → Audit and Reports: uses audits (evidence: `src/main/java/src/ui/AuditorDashboard.java`)
- Audit and Reports → Payment Storage: reads tickets (evidence: `src/main/java/src/model/Auditor.java`)
- Adviser Dashboard → Adviser Operations: uses operations (evidence: `src/main/java/src/ui/AdviserDashboard.java`)
- Adviser Operations → Payment Storage: reads payment records (evidence: `src/main/java/src/model/Adviser.java`)
- President Dashboard → Organization Summary: uses summaries (evidence: `src/main/java/src/ui/PresidentDashboard.java`)
- Organization Summary → Account Storage: counts accounts (evidence: `src/main/java/src/model/President.java`)
- Organization Summary → Roster Storage: counts students (evidence: `src/main/java/src/model/President.java`)
- Organization Summary → Payment Storage: summarizes tickets (evidence: `src/main/java/src/model/President.java`)
- Organization Summary → Secretary Operations: requests membership report (evidence: `src/main/java/src/model/President.java`)
- Secretary Dashboard → Secretary Operations: uses operations
- Account Storage → Database Connection: opens connection (evidence: `src/main/java/src/services/AccountStorage.java`)
- Payment Storage → Database Connection: opens connection (evidence: `src/main/java/src/services/PaymentStorage.java`)
- Roster Storage → Database Connection: opens connection (evidence: `src/main/java/src/services/StudentRosterStorage.java`)
- Database Connection → PostgreSQL Database: connects via JDBC (evidence: `src/main/java/src/DatabaseConnection.java`)
