# rxplxcxd/it-hilfe-schubert-pos architecture

> Architecture diagram of the GitHub repository rxplxcxd/it-hilfe-schubert-pos, 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/rxplxcxd/it-hilfe-schubert-pos
- Repository: https://github.com/rxplxcxd/it-hilfe-schubert-pos

## Overview

IT-Hilfe Schubert is a self-hosted POS and business-management application for staff and administrators, with a public appointment-booking flow and public quote acceptance. Logged-in users enter the app shell and use customer, order, finance, ticket, and administration views; API routes enforce access and persist business records. The README identifies Supabase for authentication, database, and storage, and Resend for email. Relationships below are limited to README statements and SOURCE INDEX references; several major UI and API implementations were not sampled.

Main entry points: [`components/app-shell.tsx`](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/app-shell.tsx) (POS workspace), [`app/api/tickets/route.ts`](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/api/tickets/route.ts) (Ticket API), [`lib/prisma.ts`](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/prisma.ts) (Application database), [`app/api/appointments/route.ts`](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/api/appointments/route.ts) (Appointment API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and access"]
  node_login["Login and registration<br/>[page.tsx]"]
  node_access["Access control<br/>[access.ts]"]
  node_app["POS workspace<br/>[app-shell.tsx]"]
end

subgraph group_operations["Business operations"]
  node_customers["Customer management"]
  node_orders["Orders and products"]
  node_appointments["Appointment management"]
  node_tickets["Support tickets<br/>[tickets-view.tsx]"]
  node_team["Team administration"]
  node_operations_api["Business APIs"]
  node_ticket_api["Ticket API<br/>[route.ts]"]
end

subgraph group_finance["Finance and insight"]
  node_finance_ui["Finance workspace<br/>[finances-view.tsx]"]
  node_finance_api["Finance and analytics APIs<br/>[route.ts]"]
  node_dashboard["Dashboard insights<br/>[dashboard-view.tsx]"]
end

subgraph group_public["Public services"]
  node_booking["Public booking<br/>[termin-buchung.tsx]"]
  node_appointment_api["Appointment API<br/>[route.ts]"]
  node_quote_accept["Public quote acceptance<br/>[route.ts]"]
end

subgraph group_shared["Shared services"]
  node_database[("Application database<br/>[prisma.ts]")]
  node_supabase["Supabase auth<br/>[client.ts]"]
  node_server_supabase["Server auth client<br/>[server.ts]"]
  node_email["Email delivery<br/>[email.ts]"]
  node_templates["Email templates<br/>[email-templates.ts]"]
  node_case_number["Ticket numbering<br/>[case-number.ts]"]
end

node_user(("Staff or admin"))

node_user -->|"signs in"| node_login
node_login -->|"authenticates with"| node_supabase
node_user -->|"uses"| node_app
node_app -->|"renders"| node_customers
node_app -->|"renders"| node_finance_ui
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_tickets
node_app -->|"renders"| node_appointments
node_app -->|"renders"| node_orders
node_access -->|"reads session"| node_server_supabase
node_access -->|"looks up users"| node_database
node_operations_api -->|"reads and writes"| node_database
node_ticket_api -->|"checks access"| node_access
node_ticket_api -->|"reads and writes"| node_database
node_ticket_api -->|"gets ticket number"| node_case_number
node_ticket_api -->|"sends notice"| node_email
node_ticket_api -->|"uses template"| node_templates
node_finance_api -->|"gets data scope"| node_access
node_finance_api -->|"queries records"| node_database
node_dashboard -.->|"loads insights"| node_finance_api
node_finance_ui -.->|"loads finance data"| node_finance_api
node_user -->|"books appointment"| node_booking
node_booking -->|"submits booking"| node_appointment_api
node_appointment_api -->|"checks and creates"| node_database
node_appointment_api -->|"sends confirmations"| node_email
node_appointment_api -->|"uses templates"| node_templates
node_user -->|"accepts quote"| node_quote_accept

click node_login "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/login/page.tsx"
click node_access "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/access.ts"
click node_app "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/app-shell.tsx"
click node_customers "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/customer-detail-view.tsx"
click node_orders "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/order-detail-view.tsx"
click node_appointments "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/appointments-view.tsx"
click node_tickets "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/tickets-view.tsx"
click node_team "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/employee-management.tsx"
click node_operations_api "https://github.com/rxplxcxd/it-hilfe-schubert-pos/tree/main/app/api/customers"
click node_ticket_api "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/api/tickets/route.ts"
click node_finance_ui "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/finances-view.tsx"
click node_finance_api "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/api/analytics/route.ts"
click node_dashboard "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/dashboard-view.tsx"
click node_booking "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/termin/termin-buchung.tsx"
click node_appointment_api "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/api/appointments/route.ts"
click node_quote_accept "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/api/quotes/%5Bid%5D/public-accept/route.ts"
click node_database "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/prisma.ts"
click node_supabase "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/supabase/client.ts"
click node_server_supabase "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/supabase/server.ts"
click node_email "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/email.ts"
click node_templates "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/email-templates.ts"
click node_case_number "https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/case-number.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_login,node_access,node_app toneBlue
class node_customers,node_orders,node_appointments,node_tickets,node_team,node_operations_api,node_ticket_api toneAmber
class node_finance_ui,node_finance_api,node_dashboard toneMint
class node_booking,node_appointment_api,node_quote_accept toneRose
class node_database,node_supabase,node_server_supabase,node_email,node_templates,node_case_number,node_user toneIndigo
```

## Components

### Entry and access

- [Login and registration](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Access control](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/access.ts): `lib/access.ts`
- [POS workspace](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/app-shell.tsx): `components/app-shell.tsx`

### Business operations

- [Customer management](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/customer-detail-view.tsx): `components/views/customer-detail-view.tsx`
- [Orders and products](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/order-detail-view.tsx): `components/views/order-detail-view.tsx`
- [Appointment management](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/appointments-view.tsx): `components/views/appointments-view.tsx`
- [Support tickets](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/tickets-view.tsx): `components/views/tickets-view.tsx`
- [Team administration](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/employee-management.tsx): `components/views/employee-management.tsx`
- [Business APIs](https://github.com/rxplxcxd/it-hilfe-schubert-pos/tree/main/app/api/customers): `app/api/customers`
- [Ticket API](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/api/tickets/route.ts): `app/api/tickets/route.ts`

### Finance and insight

- [Finance workspace](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/finances-view.tsx): `components/views/finances-view.tsx`
- [Finance and analytics APIs](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/api/analytics/route.ts): `app/api/analytics/route.ts`
- [Dashboard insights](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/components/views/dashboard-view.tsx): `components/views/dashboard-view.tsx`

### Public services

- [Public booking](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/termin/termin-buchung.tsx): `app/termin/termin-buchung.tsx`
- [Appointment API](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/api/appointments/route.ts): `app/api/appointments/route.ts`
- [Public quote acceptance](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/app/api/quotes/%5Bid%5D/public-accept/route.ts): `app/api/quotes/[id]/public-accept/route.ts`

### Shared services

- [Application database](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/prisma.ts): `lib/prisma.ts`
- [Supabase auth](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/supabase/client.ts): `lib/supabase/client.ts`
- [Server auth client](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/supabase/server.ts): `lib/supabase/server.ts`
- [Email delivery](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/email.ts): `lib/email.ts`
- [Email templates](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/email-templates.ts): `lib/email-templates.ts`
- [Ticket numbering](https://github.com/rxplxcxd/it-hilfe-schubert-pos/blob/main/lib/case-number.ts): `lib/case-number.ts`

### Other components

- **Staff or admin**

## Connections

- Staff or admin → Login and registration: signs in
- Login and registration → Supabase auth: authenticates with (evidence: `app/login/page.tsx`)
- Staff or admin → POS workspace: uses
- POS workspace → Customer management: renders (evidence: `components/app-shell.tsx`)
- POS workspace → Finance workspace: renders (evidence: `components/app-shell.tsx`)
- POS workspace → Dashboard insights: renders (evidence: `components/app-shell.tsx`)
- POS workspace → Support tickets: renders (evidence: `components/app-shell.tsx`)
- POS workspace → Appointment management: renders (evidence: `components/app-shell.tsx`)
- POS workspace → Orders and products: renders (evidence: `components/app-shell.tsx`)
- Access control → Server auth client: reads session (evidence: `lib/access.ts`)
- Access control → Application database: looks up users (evidence: `lib/access.ts`)
- Business APIs → Application database: reads and writes
- Ticket API → Access control: checks access (evidence: `app/api/tickets/route.ts`)
- Ticket API → Application database: reads and writes (evidence: `app/api/tickets/route.ts`)
- Ticket API → Ticket numbering: gets ticket number (evidence: `app/api/tickets/route.ts`)
- Ticket API → Email delivery: sends notice (evidence: `app/api/tickets/route.ts`)
- Ticket API → Email templates: uses template (evidence: `app/api/tickets/route.ts`)
- Finance and analytics APIs → Access control: gets data scope (evidence: `app/api/analytics/route.ts`)
- Finance and analytics APIs → Application database: queries records (evidence: `app/api/analytics/route.ts`)
- Dashboard insights → Finance and analytics APIs: loads insights
- Finance workspace → Finance and analytics APIs: loads finance data
- Staff or admin → Public booking: books appointment
- Public booking → Appointment API: submits booking
- Appointment API → Application database: checks and creates (evidence: `app/api/appointments/route.ts`)
- Appointment API → Email delivery: sends confirmations (evidence: `app/api/appointments/route.ts`)
- Appointment API → Email templates: uses templates (evidence: `app/api/appointments/route.ts`)
- Staff or admin → Public quote acceptance: accepts quote
