# aminebouzid007/seniors_care architecture

> Architecture diagram of the GitHub repository aminebouzid007/seniors_care, 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/aminebouzid007/seniors_care
- Repository: https://github.com/aminebouzid007/seniors_care

## Overview

Senior Care Tunisia is a public-facing care-services and booking site with an authenticated administration panel. The principal visitor workflow is to browse services, submit a booking, and have the request stored with client and service details; visitors can also send contact messages. Administrators manage bookings, clients, messages, services and activities, and review reports or export booking data. The graph reflects the sampled booking handler and indexed module references; several page-to-form/API connections are not shown in the excerpts, so those links are marked unverified.

Main entry points: [`src/lib/queries.ts`](https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/queries.ts) (Domain queries), [`src/app/api/bookings/route.ts`](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/api/bookings/route.ts) (Booking endpoint), [`src/app/admin/actions.ts`](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/admin/actions.ts) (Admin actions), [`src/lib/db.ts`](https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/db.ts) (Neon database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public site"]
  node_public_pages["Public pages"]
  node_service_page["Services page<br/>[page.tsx]"]
  node_activity_page["Activities page<br/>[page.tsx]"]
end

subgraph group_intake["Booking and contact"]
  node_booking_page["Booking page<br/>[page.tsx]"]
  node_booking_form["Booking form<br/>[booking-form.tsx]"]
  node_booking_api["Booking endpoint<br/>[route.ts]"]
  node_contact_page["Contact page<br/>[page.tsx]"]
  node_contact_form["Contact form<br/>[contact-form.tsx]"]
  node_contact_api["Contact endpoint<br/>[route.ts]"]
end

subgraph group_admin["Administration"]
  node_admin_pages["Admin pages"]
  node_admin_actions["Admin actions<br/>[actions.ts]"]
  node_admin_login["Admin login<br/>[page.tsx]"]
  node_export_api["Booking export<br/>[route.ts]"]
end

subgraph group_data["Data and identity"]
  node_auth["Admin authorization<br/>[auth.ts]"]
  node_session["Session tokens<br/>[session.ts]"]
  node_queries["Domain queries<br/>[queries.ts]"]
  node_database[("Neon database<br/>[db.ts]")]
  node_schema["Domain schema<br/>[schema.ts]"]
  node_validation["Request validation<br/>[validation.ts]"]
  node_phone_utils["Phone utilities<br/>[utils.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_public_pages
node_visitor -.->|"starts booking"| node_booking_page
node_service_page -->|"loads services"| node_queries
node_activity_page -->|"loads activities"| node_queries
node_booking_page -->|"loads services"| node_queries
node_booking_page -->|"renders"| node_booking_form
node_booking_form -.->|"submits to"| node_booking_api
node_booking_api -->|"validates with"| node_validation
node_booking_api -->|"normalizes phone"| node_phone_utils
node_booking_api -->|"reads and writes"| node_database
node_booking_api -->|"uses tables"| node_schema
node_visitor -.->|"sends message"| node_contact_page
node_contact_page -->|"renders"| node_contact_form
node_contact_form -.->|"submits to"| node_contact_api
node_contact_api -->|"validates with"| node_validation
node_contact_api -->|"writes to"| node_database
node_contact_api -->|"uses tables"| node_schema
node_admin_login -->|"invokes login"| node_admin_actions
node_admin_actions -->|"starts and ends sessions"| node_auth
node_auth -->|"signs and verifies"| node_session
node_admin_pages -->|"requires admin"| node_auth
node_admin_pages -->|"loads admin data"| node_queries
node_admin_pages -->|"invokes mutations"| node_admin_actions
node_admin_actions -->|"updates records"| node_database
node_admin_actions -->|"uses tables"| node_schema
node_export_api -->|"requires admin"| node_auth
node_export_api -->|"loads export data"| node_queries
node_queries -->|"queries"| node_database
node_queries -->|"uses tables"| node_schema
node_database -->|"configures ORM"| node_schema

click node_public_pages "https://github.com/aminebouzid007/seniors_care/tree/main/src/app/(site)"
click node_service_page "https://github.com/aminebouzid007/seniors_care/blob/main/src/app/(site)/services/page.tsx"
click node_activity_page "https://github.com/aminebouzid007/seniors_care/blob/main/src/app/(site)/activities/page.tsx"
click node_booking_page "https://github.com/aminebouzid007/seniors_care/blob/main/src/app/(site)/booking/page.tsx"
click node_booking_form "https://github.com/aminebouzid007/seniors_care/blob/main/src/components/booking-form.tsx"
click node_booking_api "https://github.com/aminebouzid007/seniors_care/blob/main/src/app/api/bookings/route.ts"
click node_contact_page "https://github.com/aminebouzid007/seniors_care/blob/main/src/app/(site)/contact/page.tsx"
click node_contact_form "https://github.com/aminebouzid007/seniors_care/blob/main/src/components/contact-form.tsx"
click node_contact_api "https://github.com/aminebouzid007/seniors_care/blob/main/src/app/api/contact/route.ts"
click node_admin_pages "https://github.com/aminebouzid007/seniors_care/tree/main/src/app/admin/(panel)"
click node_admin_actions "https://github.com/aminebouzid007/seniors_care/blob/main/src/app/admin/actions.ts"
click node_admin_login "https://github.com/aminebouzid007/seniors_care/blob/main/src/app/admin/login/page.tsx"
click node_export_api "https://github.com/aminebouzid007/seniors_care/blob/main/src/app/api/admin/export/route.ts"
click node_auth "https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/auth.ts"
click node_session "https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/session.ts"
click node_queries "https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/queries.ts"
click node_database "https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/db.ts"
click node_schema "https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/schema.ts"
click node_validation "https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/validation.ts"
click node_phone_utils "https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/utils.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_public_pages,node_service_page,node_activity_page toneBlue
class node_booking_page,node_booking_form,node_booking_api,node_contact_page,node_contact_form,node_contact_api toneAmber
class node_admin_pages,node_admin_actions,node_admin_login,node_export_api toneMint
class node_auth,node_session,node_queries,node_database,node_schema,node_validation,node_phone_utils toneRose
class node_visitor toneIndigo
```

## Components

### Public site

- [Public pages](https://github.com/aminebouzid007/seniors_care/tree/main/src/app/(site)): `src/app/(site)`
- [Services page](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/(site)/services/page.tsx): `src/app/(site)/services/page.tsx`
- [Activities page](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/(site)/activities/page.tsx): `src/app/(site)/activities/page.tsx`

### Booking and contact

- [Booking page](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/(site)/booking/page.tsx): `src/app/(site)/booking/page.tsx`
- [Booking form](https://github.com/aminebouzid007/seniors_care/blob/main/src/components/booking-form.tsx): `src/components/booking-form.tsx`
- [Booking endpoint](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/api/bookings/route.ts): `src/app/api/bookings/route.ts`
- [Contact page](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/(site)/contact/page.tsx): `src/app/(site)/contact/page.tsx`
- [Contact form](https://github.com/aminebouzid007/seniors_care/blob/main/src/components/contact-form.tsx): `src/components/contact-form.tsx`
- [Contact endpoint](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/api/contact/route.ts): `src/app/api/contact/route.ts`

### Administration

- [Admin pages](https://github.com/aminebouzid007/seniors_care/tree/main/src/app/admin/(panel)): `src/app/admin/(panel)`
- [Admin actions](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/admin/actions.ts): `src/app/admin/actions.ts`
- [Admin login](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/admin/login/page.tsx): `src/app/admin/login/page.tsx`
- [Booking export](https://github.com/aminebouzid007/seniors_care/blob/main/src/app/api/admin/export/route.ts): `src/app/api/admin/export/route.ts`

### Data and identity

- [Admin authorization](https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Session tokens](https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/session.ts): `src/lib/session.ts`
- [Domain queries](https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/queries.ts): `src/lib/queries.ts`
- [Neon database](https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Domain schema](https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/schema.ts): `src/lib/schema.ts`
- [Request validation](https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/validation.ts): `src/lib/validation.ts`
- [Phone utilities](https://github.com/aminebouzid007/seniors_care/blob/main/src/lib/utils.ts): `src/lib/utils.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Public pages: browses (evidence: `src/app/(site)/page.tsx`)
- Visitor → Booking page: starts booking
- Services page → Domain queries: loads services (evidence: `src/app/(site)/services/page.tsx`)
- Activities page → Domain queries: loads activities (evidence: `src/app/(site)/activities/page.tsx`)
- Booking page → Domain queries: loads services (evidence: `src/app/(site)/booking/page.tsx`)
- Booking page → Booking form: renders (evidence: `src/app/(site)/booking/page.tsx`)
- Booking form → Booking endpoint: submits to
- Booking endpoint → Request validation: validates with (evidence: `src/app/api/bookings/route.ts`)
- Booking endpoint → Phone utilities: normalizes phone (evidence: `src/app/api/bookings/route.ts`)
- Booking endpoint → Neon database: reads and writes (evidence: `src/app/api/bookings/route.ts`)
- Booking endpoint → Domain schema: uses tables (evidence: `src/app/api/bookings/route.ts`)
- Visitor → Contact page: sends message
- Contact page → Contact form: renders (evidence: `src/app/(site)/contact/page.tsx`)
- Contact form → Contact endpoint: submits to
- Contact endpoint → Request validation: validates with (evidence: `src/app/api/contact/route.ts`)
- Contact endpoint → Neon database: writes to (evidence: `src/app/api/contact/route.ts`)
- Contact endpoint → Domain schema: uses tables (evidence: `src/app/api/contact/route.ts`)
- Admin login → Admin actions: invokes login (evidence: `src/app/admin/login/page.tsx`)
- Admin actions → Admin authorization: starts and ends sessions (evidence: `src/app/admin/actions.ts`)
- Admin authorization → Session tokens: signs and verifies (evidence: `src/lib/auth.ts`)
- Admin pages → Admin authorization: requires admin (evidence: `src/app/admin/(panel)/bookings/page.tsx`)
- Admin pages → Domain queries: loads admin data (evidence: `src/app/admin/(panel)/bookings/page.tsx`)
- Admin pages → Admin actions: invokes mutations (evidence: `src/app/admin/(panel)/activities/page.tsx`)
- Admin actions → Neon database: updates records (evidence: `src/app/admin/actions.ts`)
- Admin actions → Domain schema: uses tables (evidence: `src/app/admin/actions.ts`)
- Booking export → Admin authorization: requires admin (evidence: `src/app/api/admin/export/route.ts`)
- Booking export → Domain queries: loads export data (evidence: `src/app/api/admin/export/route.ts`)
- Domain queries → Neon database: queries (evidence: `src/lib/queries.ts`)
- Domain queries → Domain schema: uses tables (evidence: `src/lib/queries.ts`)
- Neon database → Domain schema: configures ORM (evidence: `src/lib/db.ts`)
