# rzp1010/sewara-split architecture

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

- Interactive diagram: https://gitdiagram.com/rzp1010/sewara-split
- Repository: https://github.com/rzp1010/sewara-split

## Overview

Sewara is a rental-operations management product: staff use dashboard areas for bookings, inventory, members, payments, reporting, and administration; backend API routes provide corresponding domain capabilities. The sampled transaction service maps and saves transaction data through Supabase RPC, while admin-user operations manage accounts and audit actions. Both frontend and backend include R2 storage implementations. The tree indicates broader capabilities, but most route-to-UI wiring was not sampled; those relationships are omitted rather than inferred.

Main entry points: [`sewara-backend/lib/db/services/transactionServiceAtomic.ts`](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/db/services/transactionServiceAtomic.ts) (Atomic transaction save), [`sewara-backend/lib/services/admin-user.ts`](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/services/admin-user.ts) (Account management), [`sewara-backend/lib/db/services/transactionMappers.ts`](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/db/services/transactionMappers.ts) (Transaction mapping), [`sewara-backend/lib/db/helpers/eventHelper.ts`](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/db/helpers/eventHelper.ts) (Change notification)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Staff dashboard"]
  node_dashboard["Dashboard areas"]
  node_booking["Booking UI<br/>[page.js]"]
  node_inventory_ui["Inventory UI<br/>[page.js]"]
  node_status_ui["Transaction status<br/>[page.js]"]
  node_tracking_ui["Transaction tracking<br/>[page.js]"]
  node_frontend_storage["Frontend file storage<br/>[storage.js]"]
end

subgraph group_api["Backend API"]
  node_admin_api["Admin account API<br/>[route.ts]"]
  node_transactions_api["Transaction APIs<br/>[route.ts]"]
  node_inventory_api["Inventory APIs<br/>[route.ts]"]
  node_member_api["Member APIs<br/>[route.ts]"]
  node_payment_api["Payment operations<br/>[route.ts]"]
  node_webhook_api["Payment webhook<br/>[route.ts]"]
  node_dashboard_api["Dashboard data<br/>[route.ts]"]
end

subgraph group_services["Domain services"]
  node_admin_service["Account management<br/>[admin-user.ts]"]
  node_audit["Admin audit<br/>[audit.ts]"]
  node_tx_atomic["Atomic transaction save"]
  node_tx_mapping["Transaction mapping"]
  node_event_helper["Change notification<br/>[eventHelper.ts]"]
  node_backend_storage["Backend file storage<br/>[storage.ts]"]
end

subgraph group_integrations["Data and storage"]
  node_supabase[("Supabase")]
  node_r2[("Cloudflare R2")]
end

node_staff(("Staff user"))

node_staff -.->|"uses"| node_dashboard
node_admin_api -->|"delegates to"| node_admin_service
node_admin_service -->|"records actions"| node_audit
node_admin_service -->|"manages accounts"| node_supabase
node_tx_atomic -->|"maps fields"| node_tx_mapping
node_tx_atomic -->|"calls RPC"| node_supabase
node_tx_atomic -->|"signals changes"| node_event_helper
node_tx_mapping -->|"re-exports"| node_event_helper
node_backend_storage -->|"stores files"| node_r2
node_frontend_storage -->|"stores files"| node_r2

click node_dashboard "https://github.com/rzp1010/sewara-split/tree/main/sewara-frontend/src/app/dashboard"
click node_booking "https://github.com/rzp1010/sewara-split/blob/main/sewara-frontend/src/app/dashboard/booking/page.js"
click node_inventory_ui "https://github.com/rzp1010/sewara-split/blob/main/sewara-frontend/src/app/dashboard/inventaris/page.js"
click node_status_ui "https://github.com/rzp1010/sewara-split/blob/main/sewara-frontend/src/app/dashboard/status/page.js"
click node_tracking_ui "https://github.com/rzp1010/sewara-split/blob/main/sewara-frontend/src/app/dashboard/tracking/page.js"
click node_admin_api "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/admin/users/route.ts"
click node_transactions_api "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/transactions/route.ts"
click node_inventory_api "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/inventory/route.ts"
click node_member_api "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/members/route.ts"
click node_payment_api "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/pembayaran/reminder/route.ts"
click node_webhook_api "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/webhooks/payment/route.ts"
click node_dashboard_api "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/dashboard/route.ts"
click node_admin_service "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/services/admin-user.ts"
click node_audit "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/services/audit.ts"
click node_tx_atomic "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/db/services/transactionServiceAtomic.ts"
click node_tx_mapping "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/db/services/transactionMappers.ts"
click node_event_helper "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/db/helpers/eventHelper.ts"
click node_backend_storage "https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/storage.ts"
click node_frontend_storage "https://github.com/rzp1010/sewara-split/blob/main/sewara-frontend/src/lib/storage.js"

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_booking,node_inventory_ui,node_status_ui,node_tracking_ui,node_frontend_storage,node_staff toneBlue
class node_admin_api,node_transactions_api,node_inventory_api,node_member_api,node_payment_api,node_webhook_api,node_dashboard_api toneAmber
class node_admin_service,node_audit,node_tx_atomic,node_tx_mapping,node_event_helper,node_backend_storage toneMint
class node_supabase,node_r2 toneRose
```

## Components

### Staff dashboard

- [Dashboard areas](https://github.com/rzp1010/sewara-split/tree/main/sewara-frontend/src/app/dashboard): `sewara-frontend/src/app/dashboard`
- [Booking UI](https://github.com/rzp1010/sewara-split/blob/main/sewara-frontend/src/app/dashboard/booking/page.js): `sewara-frontend/src/app/dashboard/booking/page.js`
- [Inventory UI](https://github.com/rzp1010/sewara-split/blob/main/sewara-frontend/src/app/dashboard/inventaris/page.js): `sewara-frontend/src/app/dashboard/inventaris/page.js`
- [Transaction status](https://github.com/rzp1010/sewara-split/blob/main/sewara-frontend/src/app/dashboard/status/page.js): `sewara-frontend/src/app/dashboard/status/page.js`
- [Transaction tracking](https://github.com/rzp1010/sewara-split/blob/main/sewara-frontend/src/app/dashboard/tracking/page.js): `sewara-frontend/src/app/dashboard/tracking/page.js`
- [Frontend file storage](https://github.com/rzp1010/sewara-split/blob/main/sewara-frontend/src/lib/storage.js): `sewara-frontend/src/lib/storage.js`

### Backend API

- [Admin account API](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/admin/users/route.ts): `sewara-backend/app/api/admin/users/route.ts`
- [Transaction APIs](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/transactions/route.ts): `sewara-backend/app/api/transactions/route.ts`
- [Inventory APIs](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/inventory/route.ts): `sewara-backend/app/api/inventory/route.ts`
- [Member APIs](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/members/route.ts): `sewara-backend/app/api/members/route.ts`
- [Payment operations](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/pembayaran/reminder/route.ts): `sewara-backend/app/api/pembayaran/reminder/route.ts`
- [Payment webhook](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/webhooks/payment/route.ts): `sewara-backend/app/api/webhooks/payment/route.ts`
- [Dashboard data](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/app/api/dashboard/route.ts): `sewara-backend/app/api/dashboard/route.ts`

### Domain services

- [Account management](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/services/admin-user.ts): `sewara-backend/lib/services/admin-user.ts`
- [Admin audit](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/services/audit.ts): `sewara-backend/lib/services/audit.ts`
- [Atomic transaction save](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/db/services/transactionServiceAtomic.ts): `sewara-backend/lib/db/services/transactionServiceAtomic.ts`
- [Transaction mapping](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/db/services/transactionMappers.ts): `sewara-backend/lib/db/services/transactionMappers.ts`
- [Change notification](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/db/helpers/eventHelper.ts): `sewara-backend/lib/db/helpers/eventHelper.ts`
- [Backend file storage](https://github.com/rzp1010/sewara-split/blob/main/sewara-backend/lib/storage.ts): `sewara-backend/lib/storage.ts`

### Data and storage

- **Supabase**
- **Cloudflare R2**

### Other components

- **Staff user**

## Connections

- Staff user → Dashboard areas: uses
- Admin account API → Account management: delegates to (evidence: `sewara-backend/app/api/admin/users/route.ts`)
- Account management → Admin audit: records actions (evidence: `sewara-backend/lib/services/admin-user.ts`)
- Account management → Supabase: manages accounts (evidence: `sewara-backend/lib/services/admin-user.ts`)
- Atomic transaction save → Transaction mapping: maps fields (evidence: `sewara-backend/lib/db/services/transactionServiceAtomic.ts`)
- Atomic transaction save → Supabase: calls RPC (evidence: `sewara-backend/lib/db/services/transactionServiceAtomic.ts`)
- Atomic transaction save → Change notification: signals changes
- Transaction mapping → Change notification: re-exports (evidence: `sewara-backend/lib/db/services/transactionMappers.ts`)
- Backend file storage → Cloudflare R2: stores files (evidence: `sewara-backend/lib/storage.ts`)
- Frontend file storage → Cloudflare R2: stores files (evidence: `sewara-frontend/src/lib/storage.js`)
