# el-hash97/leader-team-control architecture

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

- Interactive diagram: https://gitdiagram.com/el-hash97/leader-team-control
- Repository: https://github.com/el-hash97/leader-team-control

## Overview

Leader Team Control is a Next.js team-operations app: leaders monitor skills and attendance, manage upgrade plans and training, and review reports/settings; members use a portal for their skills, leave, and voice feedback. Leader pages read and mutate shared client state, which loads and persists through server actions to Supabase. Authentication and member-scoped data access are server-side. The graph preserves the README’s major capabilities; several page implementations are identified from the tree and README rather than sampled source, so their internal call paths are not asserted.

Main entry points: [`src/lib/store.tsx`](https://github.com/el-hash97/leader-team-control/blob/main/src/lib/store.tsx) (Client state), [`src/app/actions.ts`](https://github.com/el-hash97/leader-team-control/blob/main/src/app/actions.ts) (Server actions), [`src/app/inbox-actions.ts`](https://github.com/el-hash97/leader-team-control/blob/main/src/app/inbox-actions.ts) (Inbox actions), [`src/lib/server/member.ts`](https://github.com/el-hash97/leader-team-control/blob/main/src/lib/server/member.ts) (Member access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_leader["Leader operations"]
  node_dashboard["Dashboard KPIs<br/>[page.tsx]"]
  node_members["Member records<br/>[page.tsx]"]
  node_member_profile["Member profile<br/>[page.tsx]"]
  node_skillmap["Skill map<br/>[page.tsx]"]
  node_plans["Upgrade plans<br/>[page.tsx]"]
  node_training["Training matrix<br/>[page.tsx]"]
  node_attendance["Daily attendance<br/>[page.tsx]"]
  node_reports["Reports and CSV<br/>[page.tsx]"]
  node_settings["Team settings<br/>[page.tsx]"]
  node_leave_admin["Leave decisions<br/>[page.tsx]"]
  node_voice_admin["Voice inbox<br/>[page.tsx]"]
end

subgraph group_member["Member portal"]
  node_member_home["Member home<br/>[page.tsx]"]
  node_member_skill["My skills<br/>[page.tsx]"]
  node_member_leave["Leave requests<br/>[cuti-view.tsx]"]
  node_member_voice["Member voice<br/>[voice-view.tsx]"]
  node_member_account["Member account<br/>[page.tsx]"]
  node_member_ui["Member UI components<br/>[member-ui.tsx]"]
end

subgraph group_server["Server services"]
  node_actions["Server actions<br/>[actions.ts]"]
  node_inbox_actions["Inbox actions<br/>[inbox-actions.ts]"]
  node_session["Session security<br/>[session.ts]"]
  node_member_service["Member access<br/>[member.ts]"]
  node_db["Supabase access<br/>[db.ts]"]
end

subgraph group_domain["Domain and persistence"]
  node_store["Client state<br/>[store.tsx]"]
  node_rules["Business rules<br/>[rules.ts]"]
  node_shared_ui["Shared UI components<br/>[ui.tsx]"]
  node_db_map["Database mapping<br/>[db-map.ts]"]
  node_plan_meta["Plan metadata<br/>[plan-meta.ts]"]
  node_voice_meta["Voice metadata<br/>[voice-meta.ts]"]
end

node_leader_actor(("Team leader"))
node_member_actor(("Team member"))
node_database[("Supabase database")]

node_leader_actor -->|"views"| node_dashboard
node_leader_actor -->|"manages"| node_members
node_leader_actor -->|"reviews skills"| node_skillmap
node_leader_actor -->|"plans upgrades"| node_plans
node_leader_actor -->|"reviews training"| node_training
node_leader_actor -->|"records"| node_attendance
node_leader_actor -->|"exports"| node_reports
node_leader_actor -->|"configures"| node_settings
node_leader_actor -->|"decides leave"| node_leave_admin
node_leader_actor -->|"reviews voice"| node_voice_admin
node_member_actor -->|"opens portal"| node_member_home
node_member_actor -->|"views skills"| node_member_skill
node_member_actor -->|"requests leave"| node_member_leave
node_member_actor -->|"sends feedback"| node_member_voice
node_member_actor -->|"manages account"| node_member_account
node_dashboard -->|"reads state"| node_store
node_members -->|"reads state"| node_store
node_member_profile -->|"reads state"| node_store
node_skillmap -->|"reads state"| node_store
node_plans -->|"reads state"| node_store
node_training -->|"reads state"| node_store
node_attendance -->|"reads state"| node_store
node_reports -->|"reads state"| node_store
node_settings -->|"reads state"| node_store
node_store -->|"persists changes"| node_actions
node_store -->|"loads state"| node_actions
node_actions -->|"checks session"| node_session
node_actions -->|"loads and writes"| node_db
node_member_service -->|"reads member session"| node_session
node_member_service -->|"loads portal data"| node_db
node_actions -->|"requires member"| node_member_service
node_inbox_actions -->|"checks leader session"| node_session
node_inbox_actions -->|"requires member"| node_member_service
node_inbox_actions -->|"reads and updates"| node_db
node_db -->|"queries"| node_database
node_db -->|"maps rows"| node_db_map
node_db_map -->|"uses rules"| node_rules
node_store -->|"maps state"| node_db_map
node_store -->|"calculates derived state"| node_rules
node_attendance -->|"calculates attendance"| node_rules
node_member_home -->|"loads portal"| node_member_service
node_member_home -->|"loads leaves and voices"| node_inbox_actions
node_member_skill -.->|"loads member data"| node_member_service
node_member_leave -.->|"submits leave"| node_inbox_actions
node_member_voice -.->|"sends voice"| node_inbox_actions
node_member_account -->|"updates account"| node_actions
node_member_home -->|"renders header"| node_member_ui
node_dashboard -->|"renders components"| node_shared_ui

click node_dashboard "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/dashboard/page.tsx"
click node_members "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/members/page.tsx"
click node_member_profile "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/members/%5Bid%5D/page.tsx"
click node_skillmap "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/skill-map/page.tsx"
click node_plans "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/plans/page.tsx"
click node_training "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/trainings/page.tsx"
click node_attendance "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/attendance/page.tsx"
click node_reports "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/reports/page.tsx"
click node_settings "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/settings/page.tsx"
click node_leave_admin "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/cuti/page.tsx"
click node_voice_admin "https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/voice/page.tsx"
click node_member_home "https://github.com/el-hash97/leader-team-control/blob/main/src/app/me/page.tsx"
click node_member_skill "https://github.com/el-hash97/leader-team-control/blob/main/src/app/me/skill/page.tsx"
click node_member_leave "https://github.com/el-hash97/leader-team-control/blob/main/src/app/me/cuti/cuti-view.tsx"
click node_member_voice "https://github.com/el-hash97/leader-team-control/blob/main/src/app/me/voice/voice-view.tsx"
click node_member_account "https://github.com/el-hash97/leader-team-control/blob/main/src/app/me/akun/page.tsx"
click node_store "https://github.com/el-hash97/leader-team-control/blob/main/src/lib/store.tsx"
click node_rules "https://github.com/el-hash97/leader-team-control/blob/main/src/lib/rules.ts"
click node_actions "https://github.com/el-hash97/leader-team-control/blob/main/src/app/actions.ts"
click node_inbox_actions "https://github.com/el-hash97/leader-team-control/blob/main/src/app/inbox-actions.ts"
click node_session "https://github.com/el-hash97/leader-team-control/blob/main/src/lib/server/session.ts"
click node_member_service "https://github.com/el-hash97/leader-team-control/blob/main/src/lib/server/member.ts"
click node_db "https://github.com/el-hash97/leader-team-control/blob/main/src/lib/server/db.ts"
click node_member_ui "https://github.com/el-hash97/leader-team-control/blob/main/src/components/member-ui.tsx"
click node_shared_ui "https://github.com/el-hash97/leader-team-control/blob/main/src/components/ui.tsx"
click node_db_map "https://github.com/el-hash97/leader-team-control/blob/main/src/lib/db-map.ts"
click node_plan_meta "https://github.com/el-hash97/leader-team-control/blob/main/src/components/plan-meta.ts"
click node_voice_meta "https://github.com/el-hash97/leader-team-control/blob/main/src/components/voice-meta.ts"

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_dashboard,node_members,node_member_profile,node_skillmap,node_plans,node_training,node_attendance,node_reports,node_settings,node_leave_admin,node_voice_admin toneBlue
class node_member_home,node_member_skill,node_member_leave,node_member_voice,node_member_account,node_member_ui,node_database toneAmber
class node_actions,node_inbox_actions,node_session,node_member_service,node_db toneMint
class node_store,node_rules,node_shared_ui,node_db_map,node_plan_meta,node_voice_meta toneRose
class node_leader_actor,node_member_actor toneIndigo
```

## Components

### Leader operations

- [Dashboard KPIs](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/dashboard/page.tsx): `src/app/(app)/dashboard/page.tsx`
- [Member records](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/members/page.tsx): `src/app/(app)/members/page.tsx`
- [Member profile](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/members/%5Bid%5D/page.tsx): `src/app/(app)/members/[id]/page.tsx`
- [Skill map](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/skill-map/page.tsx): `src/app/(app)/skill-map/page.tsx`
- [Upgrade plans](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/plans/page.tsx): `src/app/(app)/plans/page.tsx`
- [Training matrix](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/trainings/page.tsx): `src/app/(app)/trainings/page.tsx`
- [Daily attendance](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/attendance/page.tsx): `src/app/(app)/attendance/page.tsx`
- [Reports and CSV](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/reports/page.tsx): `src/app/(app)/reports/page.tsx`
- [Team settings](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/settings/page.tsx): `src/app/(app)/settings/page.tsx`
- [Leave decisions](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/cuti/page.tsx): `src/app/(app)/cuti/page.tsx`
- [Voice inbox](https://github.com/el-hash97/leader-team-control/blob/main/src/app/(app)/voice/page.tsx): `src/app/(app)/voice/page.tsx`

### Member portal

- [Member home](https://github.com/el-hash97/leader-team-control/blob/main/src/app/me/page.tsx): `src/app/me/page.tsx`
- [My skills](https://github.com/el-hash97/leader-team-control/blob/main/src/app/me/skill/page.tsx): `src/app/me/skill/page.tsx`
- [Leave requests](https://github.com/el-hash97/leader-team-control/blob/main/src/app/me/cuti/cuti-view.tsx): `src/app/me/cuti/cuti-view.tsx`
- [Member voice](https://github.com/el-hash97/leader-team-control/blob/main/src/app/me/voice/voice-view.tsx): `src/app/me/voice/voice-view.tsx`
- [Member account](https://github.com/el-hash97/leader-team-control/blob/main/src/app/me/akun/page.tsx): `src/app/me/akun/page.tsx`
- [Member UI components](https://github.com/el-hash97/leader-team-control/blob/main/src/components/member-ui.tsx): `src/components/member-ui.tsx`

### Server services

- [Server actions](https://github.com/el-hash97/leader-team-control/blob/main/src/app/actions.ts): `src/app/actions.ts`
- [Inbox actions](https://github.com/el-hash97/leader-team-control/blob/main/src/app/inbox-actions.ts): `src/app/inbox-actions.ts`
- [Session security](https://github.com/el-hash97/leader-team-control/blob/main/src/lib/server/session.ts): `src/lib/server/session.ts`
- [Member access](https://github.com/el-hash97/leader-team-control/blob/main/src/lib/server/member.ts): `src/lib/server/member.ts`
- [Supabase access](https://github.com/el-hash97/leader-team-control/blob/main/src/lib/server/db.ts): `src/lib/server/db.ts`

### Domain and persistence

- [Client state](https://github.com/el-hash97/leader-team-control/blob/main/src/lib/store.tsx): `src/lib/store.tsx`
- [Business rules](https://github.com/el-hash97/leader-team-control/blob/main/src/lib/rules.ts): `src/lib/rules.ts`
- [Shared UI components](https://github.com/el-hash97/leader-team-control/blob/main/src/components/ui.tsx): `src/components/ui.tsx`
- [Database mapping](https://github.com/el-hash97/leader-team-control/blob/main/src/lib/db-map.ts): `src/lib/db-map.ts`
- [Plan metadata](https://github.com/el-hash97/leader-team-control/blob/main/src/components/plan-meta.ts): `src/components/plan-meta.ts`
- [Voice metadata](https://github.com/el-hash97/leader-team-control/blob/main/src/components/voice-meta.ts): `src/components/voice-meta.ts`

### Other components

- **Team leader**
- **Team member**
- **Supabase database**

## Connections

- Team leader → Dashboard KPIs: views (evidence: `README.md`)
- Team leader → Member records: manages (evidence: `README.md`)
- Team leader → Skill map: reviews skills (evidence: `README.md`)
- Team leader → Upgrade plans: plans upgrades (evidence: `README.md`)
- Team leader → Training matrix: reviews training (evidence: `README.md`)
- Team leader → Daily attendance: records (evidence: `README.md`)
- Team leader → Reports and CSV: exports (evidence: `README.md`)
- Team leader → Team settings: configures (evidence: `README.md`)
- Team leader → Leave decisions: decides leave (evidence: `README.md`)
- Team leader → Voice inbox: reviews voice (evidence: `README.md`)
- Team member → Member home: opens portal (evidence: `src/app/me/page.tsx`)
- Team member → My skills: views skills (evidence: `README.md`)
- Team member → Leave requests: requests leave (evidence: `README.md`)
- Team member → Member voice: sends feedback (evidence: `README.md`)
- Team member → Member account: manages account (evidence: `src/app/me/akun/page.tsx`)
- Dashboard KPIs → Client state: reads state (evidence: `src/app/(app)/dashboard/page.tsx`)
- Member records → Client state: reads state (evidence: `src/app/(app)/members/page.tsx`)
- Member profile → Client state: reads state (evidence: `src/app/(app)/members/[id]/page.tsx`)
- Skill map → Client state: reads state (evidence: `src/app/(app)/skill-map/page.tsx`)
- Upgrade plans → Client state: reads state (evidence: `src/app/(app)/plans/page.tsx`)
- Training matrix → Client state: reads state (evidence: `src/app/(app)/trainings/page.tsx`)
- Daily attendance → Client state: reads state (evidence: `src/app/(app)/attendance/page.tsx`)
- Reports and CSV → Client state: reads state (evidence: `src/app/(app)/reports/page.tsx`)
- Team settings → Client state: reads state (evidence: `src/app/(app)/settings/page.tsx`)
- Client state → Server actions: persists changes (evidence: `src/lib/store.tsx`)
- Client state → Server actions: loads state (evidence: `src/lib/store.tsx`)
- Server actions → Session security: checks session (evidence: `src/app/actions.ts`)
- Server actions → Supabase access: loads and writes (evidence: `src/app/actions.ts`)
- Member access → Session security: reads member session (evidence: `src/lib/server/member.ts`)
- Member access → Supabase access: loads portal data (evidence: `src/lib/server/member.ts`)
- Server actions → Member access: requires member (evidence: `src/app/actions.ts`)
- Inbox actions → Session security: checks leader session (evidence: `src/app/inbox-actions.ts`)
- Inbox actions → Member access: requires member (evidence: `src/app/inbox-actions.ts`)
- Inbox actions → Supabase access: reads and updates (evidence: `src/app/inbox-actions.ts`)
- Supabase access → Supabase database: queries (evidence: `README.md`)
- Supabase access → Database mapping: maps rows (evidence: `src/lib/server/db.ts`)
- Database mapping → Business rules: uses rules (evidence: `src/lib/db-map.ts`)
- Client state → Database mapping: maps state (evidence: `src/lib/store.tsx`)
- Client state → Business rules: calculates derived state (evidence: `src/lib/store.tsx`)
- Daily attendance → Business rules: calculates attendance (evidence: `src/app/(app)/attendance/page.tsx`)
- Member home → Member access: loads portal (evidence: `src/app/me/page.tsx`)
- Member home → Inbox actions: loads leaves and voices (evidence: `src/app/me/page.tsx`)
- My skills → Member access: loads member data (evidence: `src/app/me/skill/page.tsx`)
- Leave requests → Inbox actions: submits leave
- Member voice → Inbox actions: sends voice
- Member account → Server actions: updates account (evidence: `src/app/me/akun/page.tsx`)
- Member home → Member UI components: renders header (evidence: `src/app/me/page.tsx`)
- Dashboard KPIs → Shared UI components: renders components (evidence: `src/app/(app)/dashboard/page.tsx`)
