# drsenku05/akp-n-p architecture

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

- Interactive diagram: https://gitdiagram.com/drsenku05/akp-n-p
- Repository: https://github.com/drsenku05/akp-n-p

## Overview

This repository implements an administrative commerce and operations application: administrators sign in, navigate module pages, and manage business records, settings, reports, audit activity, and database backups. The central UI is a slug-based module view; the sampled records API and data helpers show server-side authorization and business-data access. Separate routes cover reporting, audit logs, payments, and backup operations. The README describes the repository as a Next.js/HeroUI template, so product capabilities here are inferred from the source tree and excerpts rather than README product documentation; unsampled UI-to-API wiring is not asserted.

Main entry points: [`lib/supabase/server.ts`](https://github.com/drsenku05/akp-n-p/blob/main/lib/supabase/server.ts) (Server client), [`lib/admin-database-backups.ts`](https://github.com/drsenku05/akp-n-p/blob/main/lib/admin-database-backups.ts) (Backup service), [`prisma/prisma.ts`](https://github.com/drsenku05/akp-n-p/blob/main/prisma/prisma.ts) (Prisma database client), [`app/api/admin/records/route.ts`](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/records/route.ts) (Record operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin_ui["Admin experience"]
  node_admin_shell["Admin shell<br/>[admin-frame.tsx]"]
  node_module_view["Module workspace<br/>[module-page.tsx]"]
  node_auth_ui["Sign-in and recovery<br/>[auth-screen.tsx]"]
end

subgraph group_business_ops["Business operations"]
  node_admin_data["Business data access<br/>[admin-database.ts]"]
  node_records_api["Record operations<br/>[route.ts]"]
  node_inventory_settings["Inventory settings<br/>[route.ts]"]
  node_payment_proof["Payment proof<br/>[route.ts]"]
end

subgraph group_insights_config["Insights and settings"]
  node_payment_settings["Payment settings<br/>[route.ts]"]
  node_public_payment_settings["Public payment settings<br/>[route.ts]"]
  node_store_settings["Store settings<br/>[route.ts]"]
  node_reports_api["Business reports<br/>[route.ts]"]
  node_audit_api["Audit history<br/>[route.ts]"]
  node_notifications_api["Notifications<br/>[route.ts]"]
end

subgraph group_backup["Backup operations"]
  node_backup_api["Backup management<br/>[route.ts]"]
  node_backup_item_api["Backup actions<br/>[route.ts]"]
  node_backup_download["Backup download<br/>[route.ts]"]
  node_backup_restore["Backup restore<br/>[route.ts]"]
  node_backup_schedule["Backup automation<br/>[route.ts]"]
  node_backup_cron["Scheduled backup job<br/>[route.ts]"]
  node_backup_service["Backup service"]
end

subgraph group_data_auth["Data and identity"]
  node_supabase_server["Server client<br/>[server.ts]"]
  node_supabase_browser["Browser client<br/>[client.ts]"]
  node_prisma["Prisma database client<br/>[prisma.ts]"]
  node_postgres[("PostgreSQL")]
  node_supabase["Supabase services"]
end

node_administrator(("Administrator"))

node_administrator -->|"signs in"| node_auth_ui
node_auth_ui -->|"authenticates with"| node_supabase_browser
node_administrator -.->|"uses"| node_admin_shell
node_admin_shell -.->|"displays"| node_module_view
node_module_view -->|"reads settings"| node_supabase_browser
node_module_view -->|"loads module data"| node_admin_data
node_records_api -->|"checks admin access"| node_supabase_server
node_records_api -->|"manages accounts"| node_supabase
node_admin_data -->|"creates server client"| node_supabase_server
node_admin_data -->|"queries records"| node_prisma
node_records_api -->|"creates server client"| node_supabase_server
node_inventory_settings -->|"reads settings"| node_supabase_server
node_payment_proof -->|"uses server client"| node_supabase_server
node_payment_settings -->|"uses server client"| node_supabase_server
node_public_payment_settings -->|"uses server client"| node_supabase_server
node_store_settings -->|"uses server client"| node_supabase_server
node_reports_api -->|"checks admin access"| node_supabase_server
node_reports_api -->|"queries report data"| node_prisma
node_audit_api -->|"checks admin access"| node_supabase_server
node_audit_api -->|"reads audit records"| node_prisma
node_notifications_api -->|"uses server client"| node_supabase_server
node_notifications_api -->|"uses database client"| node_prisma
node_backup_api -->|"delegates backup work"| node_backup_service
node_backup_item_api -->|"delegates backup work"| node_backup_service
node_backup_download -->|"reads backup"| node_backup_service
node_backup_restore -->|"restores backup"| node_backup_service
node_backup_schedule -->|"configures automation"| node_backup_service
node_backup_cron -->|"runs scheduled work"| node_backup_service
node_backup_service -->|"verifies admin"| node_supabase_server
node_prisma -->|"connects to"| node_postgres
node_supabase_server -->|"creates session client"| node_supabase
node_supabase_browser -->|"creates browser client"| node_supabase

click node_admin_shell "https://github.com/drsenku05/akp-n-p/blob/main/components/admin/admin-frame.tsx"
click node_module_view "https://github.com/drsenku05/akp-n-p/blob/main/components/admin/module-page.tsx"
click node_auth_ui "https://github.com/drsenku05/akp-n-p/blob/main/components/admin/auth-screen.tsx"
click node_admin_data "https://github.com/drsenku05/akp-n-p/blob/main/lib/admin-database.ts"
click node_records_api "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/records/route.ts"
click node_inventory_settings "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/inventory-settings/route.ts"
click node_payment_proof "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/payment-proof/route.ts"
click node_payment_settings "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/payment-settings/route.ts"
click node_public_payment_settings "https://github.com/drsenku05/akp-n-p/blob/main/app/api/public/payment-settings/route.ts"
click node_store_settings "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/store-settings/route.ts"
click node_reports_api "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/reports/route.ts"
click node_audit_api "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/audit-logs/route.ts"
click node_notifications_api "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/notifications/route.ts"
click node_backup_api "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/database-backups/route.ts"
click node_backup_item_api "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/database-backups/%5Bid%5D/route.ts"
click node_backup_download "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/database-backups/%5Bid%5D/download/route.ts"
click node_backup_restore "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/database-backups/%5Bid%5D/restore/route.ts"
click node_backup_schedule "https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/backup-automation/route.ts"
click node_backup_cron "https://github.com/drsenku05/akp-n-p/blob/main/app/api/cron/database-backups/route.ts"
click node_backup_service "https://github.com/drsenku05/akp-n-p/blob/main/lib/admin-database-backups.ts"
click node_supabase_server "https://github.com/drsenku05/akp-n-p/blob/main/lib/supabase/server.ts"
click node_supabase_browser "https://github.com/drsenku05/akp-n-p/blob/main/lib/supabase/client.ts"
click node_prisma "https://github.com/drsenku05/akp-n-p/blob/main/prisma/prisma.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_admin_shell,node_module_view,node_auth_ui toneBlue
class node_admin_data,node_records_api,node_inventory_settings,node_payment_proof toneAmber
class node_payment_settings,node_public_payment_settings,node_store_settings,node_reports_api,node_audit_api,node_notifications_api toneMint
class node_backup_api,node_backup_item_api,node_backup_download,node_backup_restore,node_backup_schedule,node_backup_cron,node_backup_service toneRose
class node_supabase_server,node_supabase_browser,node_prisma,node_postgres,node_supabase,node_administrator toneIndigo
```

## Components

### Admin experience

- [Admin shell](https://github.com/drsenku05/akp-n-p/blob/main/components/admin/admin-frame.tsx): `components/admin/admin-frame.tsx`
- [Module workspace](https://github.com/drsenku05/akp-n-p/blob/main/components/admin/module-page.tsx): `components/admin/module-page.tsx`
- [Sign-in and recovery](https://github.com/drsenku05/akp-n-p/blob/main/components/admin/auth-screen.tsx): `components/admin/auth-screen.tsx`

### Business operations

- [Business data access](https://github.com/drsenku05/akp-n-p/blob/main/lib/admin-database.ts): `lib/admin-database.ts`
- [Record operations](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/records/route.ts): `app/api/admin/records/route.ts`
- [Inventory settings](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/inventory-settings/route.ts): `app/api/admin/inventory-settings/route.ts`
- [Payment proof](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/payment-proof/route.ts): `app/api/admin/payment-proof/route.ts`

### Insights and settings

- [Payment settings](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/payment-settings/route.ts): `app/api/admin/payment-settings/route.ts`
- [Public payment settings](https://github.com/drsenku05/akp-n-p/blob/main/app/api/public/payment-settings/route.ts): `app/api/public/payment-settings/route.ts`
- [Store settings](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/store-settings/route.ts): `app/api/admin/store-settings/route.ts`
- [Business reports](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/reports/route.ts): `app/api/admin/reports/route.ts`
- [Audit history](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/audit-logs/route.ts): `app/api/admin/audit-logs/route.ts`
- [Notifications](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/notifications/route.ts): `app/api/admin/notifications/route.ts`

### Backup operations

- [Backup management](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/database-backups/route.ts): `app/api/admin/database-backups/route.ts`
- [Backup actions](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/database-backups/%5Bid%5D/route.ts): `app/api/admin/database-backups/[id]/route.ts`
- [Backup download](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/database-backups/%5Bid%5D/download/route.ts): `app/api/admin/database-backups/[id]/download/route.ts`
- [Backup restore](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/database-backups/%5Bid%5D/restore/route.ts): `app/api/admin/database-backups/[id]/restore/route.ts`
- [Backup automation](https://github.com/drsenku05/akp-n-p/blob/main/app/api/admin/backup-automation/route.ts): `app/api/admin/backup-automation/route.ts`
- [Scheduled backup job](https://github.com/drsenku05/akp-n-p/blob/main/app/api/cron/database-backups/route.ts): `app/api/cron/database-backups/route.ts`
- [Backup service](https://github.com/drsenku05/akp-n-p/blob/main/lib/admin-database-backups.ts): `lib/admin-database-backups.ts`

### Data and identity

- [Server client](https://github.com/drsenku05/akp-n-p/blob/main/lib/supabase/server.ts): `lib/supabase/server.ts`
- [Browser client](https://github.com/drsenku05/akp-n-p/blob/main/lib/supabase/client.ts): `lib/supabase/client.ts`
- [Prisma database client](https://github.com/drsenku05/akp-n-p/blob/main/prisma/prisma.ts): `prisma/prisma.ts`
- **PostgreSQL**
- **Supabase services**

### Other components

- **Administrator**

## Connections

- Administrator → Sign-in and recovery: signs in
- Sign-in and recovery → Browser client: authenticates with (evidence: `components/admin/auth-screen.tsx`)
- Administrator → Admin shell: uses
- Admin shell → Module workspace: displays
- Module workspace → Browser client: reads settings (evidence: `components/admin/module-page.tsx`)
- Module workspace → Business data access: loads module data (evidence: `app/[slug]/page.tsx`)
- Record operations → Server client: checks admin access (evidence: `app/api/admin/records/route.ts`)
- Record operations → Supabase services: manages accounts (evidence: `app/api/admin/records/route.ts`)
- Business data access → Server client: creates server client (evidence: `lib/admin-database.ts`)
- Business data access → Prisma database client: queries records (evidence: `lib/admin-database.ts`)
- Record operations → Server client: creates server client (evidence: `app/api/admin/records/route.ts`)
- Inventory settings → Server client: reads settings (evidence: `app/api/admin/inventory-settings/route.ts`)
- Payment proof → Server client: uses server client (evidence: `app/api/admin/payment-proof/route.ts`)
- Payment settings → Server client: uses server client (evidence: `app/api/admin/payment-settings/route.ts`)
- Public payment settings → Server client: uses server client (evidence: `app/api/public/payment-settings/route.ts`)
- Store settings → Server client: uses server client (evidence: `app/api/admin/store-settings/route.ts`)
- Business reports → Server client: checks admin access (evidence: `app/api/admin/reports/route.ts`)
- Business reports → Prisma database client: queries report data (evidence: `app/api/admin/reports/route.ts`)
- Audit history → Server client: checks admin access (evidence: `app/api/admin/audit-logs/route.ts`)
- Audit history → Prisma database client: reads audit records (evidence: `app/api/admin/audit-logs/route.ts`)
- Notifications → Server client: uses server client (evidence: `app/api/admin/notifications/route.ts`)
- Notifications → Prisma database client: uses database client (evidence: `app/api/admin/notifications/route.ts`)
- Backup management → Backup service: delegates backup work (evidence: `app/api/admin/database-backups/route.ts`)
- Backup actions → Backup service: delegates backup work (evidence: `app/api/admin/database-backups/[id]/route.ts`)
- Backup download → Backup service: reads backup (evidence: `app/api/admin/database-backups/[id]/download/route.ts`)
- Backup restore → Backup service: restores backup (evidence: `app/api/admin/database-backups/[id]/restore/route.ts`)
- Backup automation → Backup service: configures automation (evidence: `app/api/admin/backup-automation/route.ts`)
- Scheduled backup job → Backup service: runs scheduled work (evidence: `app/api/cron/database-backups/route.ts`)
- Backup service → Server client: verifies admin (evidence: `lib/admin-database-backups.ts`)
- Prisma database client → PostgreSQL: connects to (evidence: `prisma/prisma.ts`)
- Server client → Supabase services: creates session client (evidence: `lib/supabase/server.ts`)
- Browser client → Supabase services: creates browser client (evidence: `lib/supabase/client.ts`)
