# infynuxsolutionsadmin/infypos-product architecture

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

- Interactive diagram: https://gitdiagram.com/infynuxsolutionsadmin/infypos-product
- Repository: https://github.com/infynuxsolutionsadmin/infypos-product

## Overview

INFYPOS is a multi-tenant retail EPOS and SaaS management platform. A cashier signs in, opens a shift, records sales and returns, and can work offline before queued events synchronize; tenant administrators manage catalog, stock, purchasing, customers, staff, and reporting. The repository contains an admin dashboard, an Electron-capable POS terminal, and NestJS backend code; duplicate backend trees are present, so the graph uses the sampled `backend/` implementation. Most domain modules are unsampled, so their existence is represented without speculative call chains.

Main entry points: [`backend/src/database/prisma.service.ts`](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/database/prisma.service.ts) (PostgreSQL data), [`INFEPOS_FRONTEND/admin-dashboard/src/routes/AppRoutes.tsx`](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/routes/AppRoutes.tsx) (Admin routes), [`backend/src/modules/auth/auth.service.ts`](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/auth/auth.service.ts) (Authentication), [`INFEPOS_FRONTEND/pos-terminal/src/routes/AppRoutes.tsx`](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/routes/AppRoutes.tsx) (POS routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Admin dashboard"]
  node_admin_routes["Admin routes<br/>[AppRoutes.tsx]"]
  node_admin_landing["Landing and signup<br/>[LandingPage.tsx]"]
  node_admin_signup["Subscription signup"]
  node_admin_auth["Admin auth state<br/>[authStore.ts]"]
  node_admin_ops["Retail operations"]
  node_admin_reports["Reports and dashboard<br/>[ReportsPage.tsx]"]
end

subgraph group_terminal["POS terminal"]
  node_pos_routes["POS routes<br/>[AppRoutes.tsx]"]
  node_pos_login["POS sign-in<br/>[LoginPage.tsx]"]
  node_pos_checkout["Checkout and shifts<br/>[POSPage.tsx]"]
  node_pos_sync["Offline sync manager<br/>[useSyncManager.ts]"]
  node_pos_local[("Local event store<br/>[localDb.ts]")]
  node_sync_api["Sync API client<br/>[sync.api.ts]"]
end

subgraph group_api["Backend API"]
  node_backend_api["NestJS API<br/>[main.ts]"]
  node_products["Product catalog"]
  node_inventory["Inventory management"]
  node_sales["Sales and VAT"]
  node_purchasing["Purchasing and receipts"]
  node_stock_ops["Stock adjustments and transfers"]
  node_customers["Customer management"]
  node_shifts["Shift management"]
  node_reports["Business intelligence"]
  node_database[("PostgreSQL data<br/>[prisma.service.ts]")]
end

subgraph group_security["Identity and access"]
  node_auth_service["Authentication<br/>[auth.service.ts]"]
  node_permissions["Permission guard"]
  node_rbac["Roles and permissions"]
end

subgraph group_platform["SaaS platform"]
  node_tenant_admin["Tenant and store admin"]
  node_billing["Subscription billing"]
  node_portal["Customer portal"]
end

node_admin_actor(("Administrator"))
node_cashier(("Cashier"))
node_stripe["Stripe"]

node_admin_actor -->|"uses"| node_admin_routes
node_admin_routes -->|"routes to"| node_admin_landing
node_admin_routes -->|"routes to"| node_admin_ops
node_admin_routes -->|"routes to"| node_admin_reports
node_admin_landing -.->|"offers signup"| node_admin_signup
node_cashier -->|"uses"| node_pos_routes
node_pos_routes -->|"routes to"| node_pos_login
node_pos_routes -->|"routes to"| node_pos_checkout
node_pos_sync -->|"reads and updates"| node_pos_local
node_pos_sync -->|"submits events"| node_sync_api
node_pos_login -.->|"authenticates via API"| node_auth_service
node_pos_checkout -.->|"records sales"| node_sales
node_pos_checkout -.->|"operates shifts"| node_shifts
node_sync_api -.->|"sends sync requests"| node_backend_api
node_backend_api -.->|"dispatches auth"| node_auth_service
node_auth_service -->|"reads and writes"| node_database
node_products -.->|"manages catalog"| node_database
node_inventory -.->|"manages stock"| node_database
node_products -.->|"persists products"| node_database
node_reports -.->|"aggregates data"| node_database
node_reports -->|"serves reports"| node_backend_api
node_permissions -->|"loads permissions"| node_auth_service
node_rbac -.->|"defines access rules"| node_permissions
node_billing -->|"creates billing sessions"| node_stripe
node_admin_signup -.->|"starts subscription"| node_billing

click node_admin_routes "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/routes/AppRoutes.tsx"
click node_admin_landing "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/pages/LandingPage.tsx"
click node_admin_signup "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/pages/auth/components/SubscriptionSignupModal.tsx"
click node_admin_auth "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/stores/authStore.ts"
click node_admin_ops "https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/INFEPOS_FRONTEND/admin-dashboard/src/pages"
click node_admin_reports "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/pages/reports/ReportsPage.tsx"
click node_pos_routes "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/routes/AppRoutes.tsx"
click node_pos_login "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/pages/LoginPage.tsx"
click node_pos_checkout "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/pages/POSPage.tsx"
click node_pos_sync "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/offline/useSyncManager.ts"
click node_pos_local "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/services/localDb.ts"
click node_sync_api "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/api/sync.api.ts"
click node_backend_api "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/main.ts"
click node_auth_service "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/auth/auth.service.ts"
click node_permissions "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/common/guards/permissions.guard.ts"
click node_products "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/products/products.controller.ts"
click node_inventory "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/inventory/inventory.controller.ts"
click node_sales "https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/sales"
click node_purchasing "https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/purchases"
click node_stock_ops "https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/stock-transfers"
click node_customers "https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/customers"
click node_shifts "https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/shifts"
click node_reports "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/reports/reports.controller.ts"
click node_rbac "https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/roles"
click node_tenant_admin "https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/tenants"
click node_billing "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/billing/billing.controller.ts"
click node_portal "https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/customer-portal"
click node_database "https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/database/prisma.service.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_routes,node_admin_landing,node_admin_signup,node_admin_auth,node_admin_ops,node_admin_reports toneBlue
class node_pos_routes,node_pos_login,node_pos_checkout,node_pos_sync,node_pos_local,node_sync_api toneAmber
class node_backend_api,node_products,node_inventory,node_sales,node_purchasing,node_stock_ops,node_customers,node_shifts,node_reports,node_database toneMint
class node_auth_service,node_permissions,node_rbac toneRose
class node_tenant_admin,node_billing,node_portal,node_admin_actor,node_cashier,node_stripe toneIndigo
```

## Components

### Admin dashboard

- [Admin routes](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/routes/AppRoutes.tsx): `INFEPOS_FRONTEND/admin-dashboard/src/routes/AppRoutes.tsx`
- [Landing and signup](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/pages/LandingPage.tsx): `INFEPOS_FRONTEND/admin-dashboard/src/pages/LandingPage.tsx`
- [Subscription signup](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/pages/auth/components/SubscriptionSignupModal.tsx): `INFEPOS_FRONTEND/admin-dashboard/src/pages/auth/components/SubscriptionSignupModal.tsx`
- [Admin auth state](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/stores/authStore.ts): `INFEPOS_FRONTEND/admin-dashboard/src/stores/authStore.ts`
- [Retail operations](https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/INFEPOS_FRONTEND/admin-dashboard/src/pages): `INFEPOS_FRONTEND/admin-dashboard/src/pages`
- [Reports and dashboard](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/admin-dashboard/src/pages/reports/ReportsPage.tsx): `INFEPOS_FRONTEND/admin-dashboard/src/pages/reports/ReportsPage.tsx`

### POS terminal

- [POS routes](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/routes/AppRoutes.tsx): `INFEPOS_FRONTEND/pos-terminal/src/routes/AppRoutes.tsx`
- [POS sign-in](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/pages/LoginPage.tsx): `INFEPOS_FRONTEND/pos-terminal/src/pages/LoginPage.tsx`
- [Checkout and shifts](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/pages/POSPage.tsx): `INFEPOS_FRONTEND/pos-terminal/src/pages/POSPage.tsx`
- [Offline sync manager](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/offline/useSyncManager.ts): `INFEPOS_FRONTEND/pos-terminal/src/offline/useSyncManager.ts`
- [Local event store](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/services/localDb.ts): `INFEPOS_FRONTEND/pos-terminal/src/services/localDb.ts`
- [Sync API client](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/INFEPOS_FRONTEND/pos-terminal/src/api/sync.api.ts): `INFEPOS_FRONTEND/pos-terminal/src/api/sync.api.ts`

### Backend API

- [NestJS API](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/main.ts): `backend/src/main.ts`
- [Product catalog](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/products/products.controller.ts): `backend/src/modules/products/products.controller.ts`
- [Inventory management](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/inventory/inventory.controller.ts): `backend/src/modules/inventory/inventory.controller.ts`
- [Sales and VAT](https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/sales): `backend/src/modules/sales`
- [Purchasing and receipts](https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/purchases): `backend/src/modules/purchases`
- [Stock adjustments and transfers](https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/stock-transfers): `backend/src/modules/stock-transfers`
- [Customer management](https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/customers): `backend/src/modules/customers`
- [Shift management](https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/shifts): `backend/src/modules/shifts`
- [Business intelligence](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/reports/reports.controller.ts): `backend/src/modules/reports/reports.controller.ts`
- [PostgreSQL data](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/database/prisma.service.ts): `backend/src/database/prisma.service.ts`

### Identity and access

- [Authentication](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [Permission guard](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/common/guards/permissions.guard.ts): `backend/src/common/guards/permissions.guard.ts`
- [Roles and permissions](https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/roles): `backend/src/modules/roles`

### SaaS platform

- [Tenant and store admin](https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/tenants): `backend/src/modules/tenants`
- [Subscription billing](https://github.com/infynuxsolutionsadmin/infypos-product/blob/main/backend/src/modules/billing/billing.controller.ts): `backend/src/modules/billing/billing.controller.ts`
- [Customer portal](https://github.com/infynuxsolutionsadmin/infypos-product/tree/main/backend/src/modules/customer-portal): `backend/src/modules/customer-portal`

### Other components

- **Administrator**
- **Cashier**
- **Stripe**

## Connections

- Administrator → Admin routes: uses (evidence: `INFEPOS_FRONTEND/admin-dashboard/src/routes/AppRoutes.tsx`)
- Admin routes → Landing and signup: routes to (evidence: `INFEPOS_FRONTEND/admin-dashboard/src/routes/AppRoutes.tsx`)
- Admin routes → Retail operations: routes to (evidence: `INFEPOS_FRONTEND/admin-dashboard/src/routes/AppRoutes.tsx`)
- Admin routes → Reports and dashboard: routes to (evidence: `INFEPOS_FRONTEND/admin-dashboard/src/routes/AppRoutes.tsx`)
- Landing and signup → Subscription signup: offers signup (evidence: `INFEPOS_FRONTEND/admin-dashboard/src/pages/LandingPage.tsx`)
- Cashier → POS routes: uses (evidence: `INFEPOS_FRONTEND/pos-terminal/src/routes/AppRoutes.tsx`)
- POS routes → POS sign-in: routes to (evidence: `INFEPOS_FRONTEND/pos-terminal/src/routes/AppRoutes.tsx`)
- POS routes → Checkout and shifts: routes to (evidence: `INFEPOS_FRONTEND/pos-terminal/src/routes/AppRoutes.tsx`)
- Offline sync manager → Local event store: reads and updates (evidence: `INFEPOS_FRONTEND/pos-terminal/src/offline/useSyncManager.ts`)
- Offline sync manager → Sync API client: submits events (evidence: `INFEPOS_FRONTEND/pos-terminal/src/offline/useSyncManager.ts`)
- POS sign-in → Authentication: authenticates via API
- Checkout and shifts → Sales and VAT: records sales
- Checkout and shifts → Shift management: operates shifts
- Sync API client → NestJS API: sends sync requests
- NestJS API → Authentication: dispatches auth
- Authentication → PostgreSQL data: reads and writes (evidence: `backend/src/modules/auth/auth.service.ts`)
- Product catalog → PostgreSQL data: manages catalog
- Inventory management → PostgreSQL data: manages stock
- Product catalog → PostgreSQL data: persists products
- Business intelligence → PostgreSQL data: aggregates data
- Business intelligence → NestJS API: serves reports (evidence: `backend/src/modules/reports/reports.controller.ts`)
- Permission guard → Authentication: loads permissions (evidence: `backend/src/common/guards/permissions.guard.ts`)
- Roles and permissions → Permission guard: defines access rules
- Subscription billing → Stripe: creates billing sessions (evidence: `backend/src/modules/billing/billing.controller.ts`)
- Subscription signup → Subscription billing: starts subscription
