# sgxtract/pmis-core architecture

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

- Interactive diagram: https://gitdiagram.com/sgxtract/pmis-core
- Repository: https://github.com/sgxtract/pmis-core

## Overview

PMIS is a procurement information system for public procurement discovery and authenticated request management. The public workflow lets visitors search and inspect requests; authorized staff create and manage requests through stage changes, attachments, cancellation, and restoration. Staff also use dashboards, reports, profile settings, and administration tools. Supabase provides authentication and persistence. The graph reflects sampled code and source-index references; several management forms and action implementations were not sampled, so their detailed behavior is not inferred.

Main entry points: [`lib/supabase/server.ts`](https://github.com/sgxtract/pmis-core/blob/main/lib/supabase/server.ts) (Server client), [`app/(auth)/purchased-requests/[id]/page.tsx`](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/page.tsx) (Request detail), [`app/(auth)/profile/page.tsx`](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/profile/page.tsx) (Profile settings), [`lib/auth/require-user-manager.ts`](https://github.com/sgxtract/pmis-core/blob/main/lib/auth/require-user-manager.ts) (Manager authorization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public procurement"]
  node_home["Public home<br/>[page.tsx]"]
  node_public_search["Public search<br/>[page.tsx]"]
  node_public_detail["Public request detail<br/>[page.tsx]"]
end

subgraph group_operations["Request operations"]
  node_requests["Request list<br/>[page.tsx]"]
  node_request_create["Request creation"]
  node_request_detail["Request detail<br/>[page.tsx]"]
  node_stage_history["Stage history<br/>[StageHistory.tsx]"]
  node_stage_advance["Advance stage"]
  node_attachments["Attachments"]
  node_request_edit["Request editing"]
  node_request_cancel["Request cancellation<br/>[CancelPRForm.tsx]"]
  node_request_restore["Request restoration<br/>[RestorePRForm.tsx]"]
end

subgraph group_insight["Staff insight"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_reports["Reports<br/>[page.tsx]"]
  node_report_filters["Report filters<br/>[ReportFilters.tsx]"]
  node_report_charts["Report charts"]
end

subgraph group_identity["Identity and access"]
  node_login["Login<br/>[page.tsx]"]
  node_login_form["Login form<br/>[LoginForm.tsx]"]
  node_active_user["Active-user check"]
  node_user_manager["Manager authorization"]
  node_admin_check["Admin authorization<br/>[require-admin.ts]"]
  node_admin["Administration<br/>[page.tsx]"]
  node_user_admin["User management"]
  node_audit["Audit logs<br/>[page.tsx]"]
  node_profile["Profile settings<br/>[page.tsx]"]
  node_profile_activity["Profile activity"]
  node_profile_editor["Profile editor<br/>[EditProfile.tsx]"]
  node_profile_provider["Activity provider"]
end

subgraph group_data["Data services"]
  node_server_client["Server client<br/>[server.ts]"]
  node_browser_client["Browser client<br/>[client.ts]"]
  node_supabase[("Supabase")]
end

node_visitor(("Visitor"))
node_staff(("Staff user"))

node_visitor -->|"opens"| node_home
node_visitor -->|"searches"| node_public_search
node_public_search -.->|"opens request"| node_public_detail
node_home -->|"creates client"| node_server_client
node_public_search -->|"creates client"| node_server_client
node_public_detail -->|"creates client"| node_server_client
node_visitor -->|"signs in"| node_login
node_login -->|"renders"| node_login_form
node_login_form -->|"uses"| node_browser_client
node_active_user -->|"creates client"| node_server_client
node_user_manager -->|"checks user"| node_active_user
node_user_manager -->|"queries role"| node_server_client
node_admin_check -->|"checks user"| node_active_user
node_dashboard -->|"queries data"| node_server_client
node_reports -->|"queries data"| node_server_client
node_reports -->|"renders"| node_report_filters
node_reports -->|"renders"| node_report_charts
node_admin -->|"requires admin"| node_admin_check
node_user_admin -->|"requires manager"| node_user_manager
node_audit -->|"requires manager"| node_user_manager
node_audit -->|"queries logs"| node_server_client
node_profile -->|"loads profile"| node_server_client
node_profile -->|"renders"| node_profile_activity
node_profile -->|"renders"| node_profile_editor
node_profile -->|"wraps"| node_profile_provider
node_profile_activity -->|"uses"| node_profile_provider
node_profile_editor -->|"uses"| node_profile_provider
node_staff -->|"manages requests"| node_requests
node_requests -->|"queries requests"| node_server_client
node_staff -.->|"creates request"| node_request_create
node_request_detail -->|"loads request"| node_server_client
node_request_detail -->|"renders"| node_stage_history
node_request_detail -->|"renders"| node_stage_advance
node_request_detail -->|"renders"| node_attachments
node_request_detail -->|"renders"| node_request_cancel
node_request_detail -->|"renders"| node_request_restore
node_staff -.->|"edits request"| node_request_edit
node_server_client -->|"connects"| node_supabase
node_browser_client -->|"connects"| node_supabase

click node_home "https://github.com/sgxtract/pmis-core/blob/main/app/page.tsx"
click node_public_search "https://github.com/sgxtract/pmis-core/blob/main/app/procurements/page.tsx"
click node_public_detail "https://github.com/sgxtract/pmis-core/blob/main/app/procurements/%5Bid%5D/page.tsx"
click node_login "https://github.com/sgxtract/pmis-core/blob/main/app/login/page.tsx"
click node_login_form "https://github.com/sgxtract/pmis-core/blob/main/components/auth/LoginForm.tsx"
click node_active_user "https://github.com/sgxtract/pmis-core/blob/main/lib/auth/require-active-user.ts"
click node_user_manager "https://github.com/sgxtract/pmis-core/blob/main/lib/auth/require-user-manager.ts"
click node_admin_check "https://github.com/sgxtract/pmis-core/blob/main/lib/auth/require-admin.ts"
click node_dashboard "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/dashboard/page.tsx"
click node_reports "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/reports/page.tsx"
click node_report_filters "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/reports/ReportFilters.tsx"
click node_report_charts "https://github.com/sgxtract/pmis-core/tree/main/app/(auth)/reports"
click node_admin "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/administration/page.tsx"
click node_user_admin "https://github.com/sgxtract/pmis-core/tree/main/app/(auth)/administration/users"
click node_audit "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/administration/audit-logs/page.tsx"
click node_profile "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/profile/page.tsx"
click node_profile_activity "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/profile/AccountActivity.tsx"
click node_profile_editor "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/profile/EditProfile.tsx"
click node_profile_provider "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/profile/ProfileActivityProvider.tsx"
click node_requests "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/page.tsx"
click node_request_create "https://github.com/sgxtract/pmis-core/tree/main/app/(auth)/purchased-requests/new"
click node_request_detail "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/page.tsx"
click node_stage_history "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/StageHistory.tsx"
click node_stage_advance "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/advance-stage/AdvanceStageForm.tsx"
click node_attachments "https://github.com/sgxtract/pmis-core/tree/main/app/(auth)/purchased-requests/%5Bid%5D/attachments"
click node_request_edit "https://github.com/sgxtract/pmis-core/tree/main/app/(auth)/purchased-requests/%5Bid%5D/edit"
click node_request_cancel "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/cancel/CancelPRForm.tsx"
click node_request_restore "https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/restore/RestorePRForm.tsx"
click node_server_client "https://github.com/sgxtract/pmis-core/blob/main/lib/supabase/server.ts"
click node_browser_client "https://github.com/sgxtract/pmis-core/blob/main/lib/supabase/client.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_home,node_public_search,node_public_detail,node_staff toneBlue
class node_requests,node_request_create,node_request_detail,node_stage_history,node_stage_advance,node_attachments,node_request_edit,node_request_cancel,node_request_restore toneAmber
class node_dashboard,node_reports,node_report_filters,node_report_charts toneMint
class node_login,node_login_form,node_active_user,node_user_manager,node_admin_check,node_admin,node_user_admin,node_audit,node_profile,node_profile_activity,node_profile_editor,node_profile_provider toneRose
class node_server_client,node_browser_client,node_supabase,node_visitor toneIndigo
```

## Components

### Public procurement

- [Public home](https://github.com/sgxtract/pmis-core/blob/main/app/page.tsx): `app/page.tsx`
- [Public search](https://github.com/sgxtract/pmis-core/blob/main/app/procurements/page.tsx): `app/procurements/page.tsx`
- [Public request detail](https://github.com/sgxtract/pmis-core/blob/main/app/procurements/%5Bid%5D/page.tsx): `app/procurements/[id]/page.tsx`

### Request operations

- [Request list](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/page.tsx): `app/(auth)/purchased-requests/page.tsx`
- [Request creation](https://github.com/sgxtract/pmis-core/tree/main/app/(auth)/purchased-requests/new): `app/(auth)/purchased-requests/new`
- [Request detail](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/page.tsx): `app/(auth)/purchased-requests/[id]/page.tsx`
- [Stage history](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/StageHistory.tsx): `app/(auth)/purchased-requests/[id]/StageHistory.tsx`
- [Advance stage](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/advance-stage/AdvanceStageForm.tsx): `app/(auth)/purchased-requests/[id]/advance-stage/AdvanceStageForm.tsx`
- [Attachments](https://github.com/sgxtract/pmis-core/tree/main/app/(auth)/purchased-requests/%5Bid%5D/attachments): `app/(auth)/purchased-requests/[id]/attachments`
- [Request editing](https://github.com/sgxtract/pmis-core/tree/main/app/(auth)/purchased-requests/%5Bid%5D/edit): `app/(auth)/purchased-requests/[id]/edit`
- [Request cancellation](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/cancel/CancelPRForm.tsx): `app/(auth)/purchased-requests/[id]/cancel/CancelPRForm.tsx`
- [Request restoration](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/purchased-requests/%5Bid%5D/restore/RestorePRForm.tsx): `app/(auth)/purchased-requests/[id]/restore/RestorePRForm.tsx`

### Staff insight

- [Dashboard](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/dashboard/page.tsx): `app/(auth)/dashboard/page.tsx`
- [Reports](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/reports/page.tsx): `app/(auth)/reports/page.tsx`
- [Report filters](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/reports/ReportFilters.tsx): `app/(auth)/reports/ReportFilters.tsx`
- [Report charts](https://github.com/sgxtract/pmis-core/tree/main/app/(auth)/reports): `app/(auth)/reports`

### Identity and access

- [Login](https://github.com/sgxtract/pmis-core/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Login form](https://github.com/sgxtract/pmis-core/blob/main/components/auth/LoginForm.tsx): `components/auth/LoginForm.tsx`
- [Active-user check](https://github.com/sgxtract/pmis-core/blob/main/lib/auth/require-active-user.ts): `lib/auth/require-active-user.ts`
- [Manager authorization](https://github.com/sgxtract/pmis-core/blob/main/lib/auth/require-user-manager.ts): `lib/auth/require-user-manager.ts`
- [Admin authorization](https://github.com/sgxtract/pmis-core/blob/main/lib/auth/require-admin.ts): `lib/auth/require-admin.ts`
- [Administration](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/administration/page.tsx): `app/(auth)/administration/page.tsx`
- [User management](https://github.com/sgxtract/pmis-core/tree/main/app/(auth)/administration/users): `app/(auth)/administration/users`
- [Audit logs](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/administration/audit-logs/page.tsx): `app/(auth)/administration/audit-logs/page.tsx`
- [Profile settings](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/profile/page.tsx): `app/(auth)/profile/page.tsx`
- [Profile activity](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/profile/AccountActivity.tsx): `app/(auth)/profile/AccountActivity.tsx`
- [Profile editor](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/profile/EditProfile.tsx): `app/(auth)/profile/EditProfile.tsx`
- [Activity provider](https://github.com/sgxtract/pmis-core/blob/main/app/(auth)/profile/ProfileActivityProvider.tsx): `app/(auth)/profile/ProfileActivityProvider.tsx`

### Data services

- [Server client](https://github.com/sgxtract/pmis-core/blob/main/lib/supabase/server.ts): `lib/supabase/server.ts`
- [Browser client](https://github.com/sgxtract/pmis-core/blob/main/lib/supabase/client.ts): `lib/supabase/client.ts`
- **Supabase**

### Other components

- **Visitor**
- **Staff user**

## Connections

- Visitor → Public home: opens (evidence: `app/page.tsx`)
- Visitor → Public search: searches (evidence: `app/procurements/page.tsx`)
- Public search → Public request detail: opens request
- Public home → Server client: creates client (evidence: `app/page.tsx`)
- Public search → Server client: creates client (evidence: `app/procurements/page.tsx`)
- Public request detail → Server client: creates client (evidence: `app/procurements/[id]/page.tsx`)
- Visitor → Login: signs in (evidence: `app/login/page.tsx`)
- Login → Login form: renders (evidence: `app/login/page.tsx`)
- Login form → Browser client: uses (evidence: `components/auth/LoginForm.tsx`)
- Active-user check → Server client: creates client (evidence: `lib/auth/require-active-user.ts`)
- Manager authorization → Active-user check: checks user (evidence: `lib/auth/require-user-manager.ts`)
- Manager authorization → Server client: queries role (evidence: `lib/auth/require-user-manager.ts`)
- Admin authorization → Active-user check: checks user (evidence: `lib/auth/require-admin.ts`)
- Dashboard → Server client: queries data (evidence: `app/(auth)/dashboard/page.tsx`)
- Reports → Server client: queries data (evidence: `app/(auth)/reports/page.tsx`)
- Reports → Report filters: renders (evidence: `app/(auth)/reports/page.tsx`)
- Reports → Report charts: renders (evidence: `app/(auth)/reports/page.tsx`)
- Administration → Admin authorization: requires admin (evidence: `app/(auth)/administration/page.tsx`)
- User management → Manager authorization: requires manager (evidence: `app/(auth)/administration/users/page.tsx`)
- Audit logs → Manager authorization: requires manager (evidence: `app/(auth)/administration/audit-logs/page.tsx`)
- Audit logs → Server client: queries logs (evidence: `app/(auth)/administration/audit-logs/page.tsx`)
- Profile settings → Server client: loads profile (evidence: `app/(auth)/profile/page.tsx`)
- Profile settings → Profile activity: renders (evidence: `app/(auth)/profile/page.tsx`)
- Profile settings → Profile editor: renders (evidence: `app/(auth)/profile/page.tsx`)
- Profile settings → Activity provider: wraps (evidence: `app/(auth)/profile/page.tsx`)
- Profile activity → Activity provider: uses (evidence: `app/(auth)/profile/AccountActivity.tsx`)
- Profile editor → Activity provider: uses (evidence: `app/(auth)/profile/EditProfile.tsx`)
- Staff user → Request list: manages requests (evidence: `app/(auth)/purchased-requests/page.tsx`)
- Request list → Server client: queries requests (evidence: `app/(auth)/purchased-requests/page.tsx`)
- Staff user → Request creation: creates request
- Request detail → Server client: loads request (evidence: `app/(auth)/purchased-requests/[id]/page.tsx`)
- Request detail → Stage history: renders (evidence: `app/(auth)/purchased-requests/[id]/page.tsx`)
- Request detail → Advance stage: renders (evidence: `app/(auth)/purchased-requests/[id]/page.tsx`)
- Request detail → Attachments: renders (evidence: `app/(auth)/purchased-requests/[id]/page.tsx`)
- Request detail → Request cancellation: renders (evidence: `app/(auth)/purchased-requests/[id]/page.tsx`)
- Request detail → Request restoration: renders (evidence: `app/(auth)/purchased-requests/[id]/page.tsx`)
- Staff user → Request editing: edits request
- Server client → Supabase: connects (evidence: `lib/supabase/server.ts`)
- Browser client → Supabase: connects (evidence: `lib/supabase/client.ts`)
