# pndkrisna/pakem architecture

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

## Overview

Pakem is a desktop application for managing a sanggar’s members and skill-level groupings. The visible workflow starts with login, opens role-aware application screens, and supports member records, level-change history, category/subgroup management, and automatic grouping. Service implementations coordinate database access through DAOs and a shared JDBC connection. The User model also documents attendance, schedules, events, materials, finances, and settings permissions, but the supplied tree shows no corresponding implementation modules; these are noted as documented capabilities rather than mapped workflows.

Main entry points: [`src/main/java/com/pakem/service/impl/KategoriServiceImpl.java`](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/service/impl/KategoriServiceImpl.java) (Level and grouping workflows), [`src/main/java/com/pakem/Main.java`](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/Main.java) (Startup), [`src/main/java/com/pakem/ui/MainFrame.java`](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/MainFrame.java) (Role-aware workspace), [`src/main/java/com/pakem/ui/anggota/AnggotaListPanel.java`](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/anggota/AnggotaListPanel.java) (Member list and form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_main["Startup<br/>[Main.java]"]
  node_login["Login screen<br/>[LoginPanel.java]"]
  node_auth["Authentication"]
  node_frame["Role-aware workspace<br/>[MainFrame.java]"]
  node_othercap["Other role capabilities<br/>[User.java]"]
end

subgraph group_people["Member management"]
  node_memberui["Member list and form"]
  node_memberform["Member editing"]
  node_historyui["Level history view"]
  node_membersvc["Member workflows"]
  node_membermodel["Member and history models<br/>[Anggota.java]"]
end

subgraph group_levels["Levels and groups"]
  node_levelui["Level management screen"]
  node_levelform["Category and subgroup forms"]
  node_moveui["Subgroup transfer dialog"]
  node_levelsvc["Level and grouping workflows"]
  node_levelmodel["Level and subgroup models"]
end

subgraph group_data["Persistence"]
  node_memberdao["Member persistence"]
  node_leveldao["Category persistence"]
  node_subgroupdao["Subgroup persistence"]
  node_dbconn["JDBC connection"]
end

node_operator(("Staff or coach"))
node_mysql[("MySQL database")]

node_operator -.->|"starts app"| node_main
node_main -.->|"opens workspace"| node_login
node_main -->|"initializes auth"| node_auth
node_main -->|"creates frame"| node_frame
node_login -->|"authenticates"| node_auth
node_frame -->|"opens member view"| node_memberui
node_frame -->|"opens level view"| node_levelui
node_memberui -->|"opens form"| node_memberform
node_memberui -->|"opens history"| node_historyui
node_memberui -->|"requests member operations"| node_membersvc
node_memberform -->|"submits member data"| node_membersvc
node_historyui -->|"requests history"| node_membersvc
node_membersvc -->|"uses member DAO"| node_memberdao
node_memberdao -->|"gets connection"| node_dbconn
node_levelui -->|"opens category form"| node_levelform
node_levelui -->|"opens transfer dialog"| node_moveui
node_levelui -->|"requests level operations"| node_levelsvc
node_levelform -->|"submits category changes"| node_levelsvc
node_moveui -->|"requests transfer"| node_levelsvc
node_levelsvc -->|"uses category DAO"| node_leveldao
node_levelsvc -->|"uses subgroup DAO"| node_subgroupdao
node_leveldao -->|"gets connection"| node_dbconn
node_subgroupdao -->|"gets connection"| node_dbconn
node_dbconn -->|"JDBC access"| node_mysql
node_frame -->|"checks role permissions"| node_othercap

click node_main "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/Main.java"
click node_login "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/LoginPanel.java"
click node_auth "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/service/impl/AuthServiceImpl.java"
click node_frame "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/MainFrame.java"
click node_memberui "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/anggota/AnggotaListPanel.java"
click node_memberform "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/anggota/AnggotaFormDialog.java"
click node_historyui "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/anggota/RiwayatTingkatDialog.java"
click node_membersvc "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/service/impl/AnggotaServiceImpl.java"
click node_membermodel "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/model/Anggota.java"
click node_memberdao "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/dao/impl/AnggotaDaoImpl.java"
click node_levelui "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/kategori/KategoriTingkatPanel.java"
click node_levelform "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/kategori/KategoriFormDialog.java"
click node_moveui "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/kategori/PindahSubkelompokDialog.java"
click node_levelsvc "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/service/impl/KategoriServiceImpl.java"
click node_levelmodel "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/model/KategoriTingkat.java"
click node_leveldao "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/dao/impl/KategoriTingkatDaoImpl.java"
click node_subgroupdao "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/dao/impl/SubkelompokDaoImpl.java"
click node_dbconn "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/config/DatabaseConnection.java"
click node_othercap "https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/model/User.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_frame,node_othercap toneBlue
class node_memberui,node_memberform,node_historyui,node_membersvc,node_membermodel,node_mysql toneAmber
class node_levelui,node_levelform,node_moveui,node_levelsvc,node_levelmodel toneMint
class node_memberdao,node_leveldao,node_subgroupdao,node_dbconn toneRose
class node_operator toneIndigo
```

## Components

### Application entry

- [Startup](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/Main.java): `src/main/java/com/pakem/Main.java`
- [Login screen](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/LoginPanel.java): `src/main/java/com/pakem/ui/LoginPanel.java`
- [Authentication](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/service/impl/AuthServiceImpl.java): `src/main/java/com/pakem/service/impl/AuthServiceImpl.java`
- [Role-aware workspace](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/MainFrame.java): `src/main/java/com/pakem/ui/MainFrame.java`
- [Other role capabilities](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/model/User.java): `src/main/java/com/pakem/model/User.java`

### Member management

- [Member list and form](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/anggota/AnggotaListPanel.java): `src/main/java/com/pakem/ui/anggota/AnggotaListPanel.java`
- [Member editing](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/anggota/AnggotaFormDialog.java): `src/main/java/com/pakem/ui/anggota/AnggotaFormDialog.java`
- [Level history view](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/anggota/RiwayatTingkatDialog.java): `src/main/java/com/pakem/ui/anggota/RiwayatTingkatDialog.java`
- [Member workflows](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/service/impl/AnggotaServiceImpl.java): `src/main/java/com/pakem/service/impl/AnggotaServiceImpl.java`
- [Member and history models](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/model/Anggota.java): `src/main/java/com/pakem/model/Anggota.java`

### Levels and groups

- [Level management screen](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/kategori/KategoriTingkatPanel.java): `src/main/java/com/pakem/ui/kategori/KategoriTingkatPanel.java`
- [Category and subgroup forms](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/kategori/KategoriFormDialog.java): `src/main/java/com/pakem/ui/kategori/KategoriFormDialog.java`
- [Subgroup transfer dialog](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/ui/kategori/PindahSubkelompokDialog.java): `src/main/java/com/pakem/ui/kategori/PindahSubkelompokDialog.java`
- [Level and grouping workflows](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/service/impl/KategoriServiceImpl.java): `src/main/java/com/pakem/service/impl/KategoriServiceImpl.java`
- [Level and subgroup models](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/model/KategoriTingkat.java): `src/main/java/com/pakem/model/KategoriTingkat.java`

### Persistence

- [Member persistence](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/dao/impl/AnggotaDaoImpl.java): `src/main/java/com/pakem/dao/impl/AnggotaDaoImpl.java`
- [Category persistence](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/dao/impl/KategoriTingkatDaoImpl.java): `src/main/java/com/pakem/dao/impl/KategoriTingkatDaoImpl.java`
- [Subgroup persistence](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/dao/impl/SubkelompokDaoImpl.java): `src/main/java/com/pakem/dao/impl/SubkelompokDaoImpl.java`
- [JDBC connection](https://github.com/pndkrisna/pakem/blob/main/src/main/java/com/pakem/config/DatabaseConnection.java): `src/main/java/com/pakem/config/DatabaseConnection.java`

### Other components

- **Staff or coach**
- **MySQL database**

## Connections

- Staff or coach → Startup: starts app
- Startup → Login screen: opens workspace
- Startup → Authentication: initializes auth (evidence: `src/main/java/com/pakem/Main.java`)
- Startup → Role-aware workspace: creates frame (evidence: `src/main/java/com/pakem/Main.java`)
- Login screen → Authentication: authenticates (evidence: `src/main/java/com/pakem/ui/LoginPanel.java`)
- Role-aware workspace → Member list and form: opens member view (evidence: `src/main/java/com/pakem/ui/MainFrame.java`)
- Role-aware workspace → Level management screen: opens level view (evidence: `src/main/java/com/pakem/ui/MainFrame.java`)
- Member list and form → Member editing: opens form (evidence: `src/main/java/com/pakem/ui/anggota/AnggotaListPanel.java`)
- Member list and form → Level history view: opens history (evidence: `src/main/java/com/pakem/ui/anggota/AnggotaListPanel.java`)
- Member list and form → Member workflows: requests member operations (evidence: `src/main/java/com/pakem/ui/anggota/AnggotaListPanel.java`)
- Member editing → Member workflows: submits member data (evidence: `src/main/java/com/pakem/ui/anggota/AnggotaFormDialog.java`)
- Level history view → Member workflows: requests history (evidence: `src/main/java/com/pakem/ui/anggota/RiwayatTingkatDialog.java`)
- Member workflows → Member persistence: uses member DAO (evidence: `src/main/java/com/pakem/service/impl/AnggotaServiceImpl.java`)
- Member persistence → JDBC connection: gets connection (evidence: `src/main/java/com/pakem/dao/impl/AnggotaDaoImpl.java`)
- Level management screen → Category and subgroup forms: opens category form (evidence: `src/main/java/com/pakem/ui/kategori/KategoriTingkatPanel.java`)
- Level management screen → Subgroup transfer dialog: opens transfer dialog (evidence: `src/main/java/com/pakem/ui/kategori/KategoriTingkatPanel.java`)
- Level management screen → Level and grouping workflows: requests level operations (evidence: `src/main/java/com/pakem/ui/kategori/KategoriTingkatPanel.java`)
- Category and subgroup forms → Level and grouping workflows: submits category changes (evidence: `src/main/java/com/pakem/ui/kategori/KategoriFormDialog.java`)
- Subgroup transfer dialog → Level and grouping workflows: requests transfer (evidence: `src/main/java/com/pakem/ui/kategori/PindahSubkelompokDialog.java`)
- Level and grouping workflows → Category persistence: uses category DAO (evidence: `src/main/java/com/pakem/service/impl/KategoriServiceImpl.java`)
- Level and grouping workflows → Subgroup persistence: uses subgroup DAO (evidence: `src/main/java/com/pakem/service/impl/KategoriServiceImpl.java`)
- Category persistence → JDBC connection: gets connection (evidence: `src/main/java/com/pakem/dao/impl/KategoriTingkatDaoImpl.java`)
- Subgroup persistence → JDBC connection: gets connection (evidence: `src/main/java/com/pakem/dao/impl/SubkelompokDaoImpl.java`)
- JDBC connection → MySQL database: JDBC access (evidence: `src/main/java/com/pakem/config/DatabaseConnection.java`)
- Role-aware workspace → Other role capabilities: checks role permissions (evidence: `src/main/java/com/pakem/ui/MainFrame.java`)
