# rayanem-dev/pointage-app architecture

> Architecture diagram of the GitHub repository rayanem-dev/pointage-app, 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/rayanem-dev/pointage-app
- Repository: https://github.com/rayanem-dev/pointage-app

## Overview

Sijil is a personnel time-and-rotation management application: users access its Apps Script interface directly or through an installable static PWA, then view or update attendance, submit requests, and manage contract and billing work. Google Sheets is the documented data store; the product also covers document handling, client review, prospect trials, exports, and multilingual display. The README documents the PWA and storage design, but most server and UI source was not sampled, so unverified runtime connections are omitted or shown as dashed.

Main entry points: [`appscript/Main.gs`](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Main.gs) (Apps Script application), [`appscript/App.html`](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/App.html) (Application interface), [`index.html`](https://github.com/rayanem-dev/pointage-app/blob/main/index.html) (Installable PWA), [`appscript/Store.gs`](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Store.gs) (Store and cache)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Access and interface"]
  node_pwa["Installable PWA<br/>[index.html]"]
  node_appui["Application interface<br/>[App.html]"]
  node_backend["Apps Script application<br/>[Main.gs]"]
  node_languages["French Arabic English<br/>[I18n.html]"]
end

subgraph group_workforce["Workforce operations"]
  node_agents["Agent records<br/>[Agents.gs]"]
  node_attendance["Attendance tracking<br/>[Pointage.gs]"]
  node_rotation["Rotation calendar<br/>[Cycle.gs]"]
  node_requests["Staff requests<br/>[Demandes.gs]"]
  node_documents["Staff documents<br/>[Documents.gs]"]
end

subgraph group_contracts["Contracts and billing"]
  node_contracts["Contract setup<br/>[Contrats.gs]"]
  node_bordereau["Price schedule import<br/>[Bordereau.gs]"]
  node_export["Attendance and billing exports<br/>[Export.gs]"]
  node_comments["Client remarks<br/>[Remarques.gs]"]
end

subgraph group_platform["Tenant and platform services"]
  node_auth["Authentication and roles<br/>[Auth.gs]"]
  node_sheets[("Google Sheets store")]
  node_store["Store and cache<br/>[Store.gs]"]
  node_tenant["Client workspaces<br/>[Tenants.gs]"]
  node_prospects["Prospect trials<br/>[Prospects.gs]"]
end

node_users(("Personnel and managers"))
node_admin(("Administrator"))
node_clientuser(("Client user"))
node_google["Google services"]

node_users -->|"open app"| node_pwa
node_pwa -->|"displays"| node_appui
node_users -.->|"use directly"| node_appui
node_admin -.->|"administer"| node_appui
node_clientuser -.->|"review attendance"| node_appui
node_appui -.->|"send actions"| node_backend
node_backend -.->|"authorize"| node_auth
node_backend -.->|"read and write"| node_store
node_store -->|"cache-backed storage"| node_sheets
node_backend -.->|"manage clients"| node_tenant
node_backend -.->|"manage agents"| node_agents
node_backend -.->|"record attendance"| node_attendance
node_backend -.->|"show forecasts"| node_rotation
node_backend -.->|"handle requests"| node_requests
node_backend -.->|"manage documents"| node_documents
node_backend -.->|"configure contracts"| node_contracts
node_backend -.->|"read price schedules"| node_bordereau
node_backend -.->|"export billing"| node_export
node_backend -.->|"record client remarks"| node_comments
node_backend -.->|"create trials"| node_prospects
node_appui -.->|"display translations"| node_languages
node_backend -.->|"send notifications"| node_google

click node_pwa "https://github.com/rayanem-dev/pointage-app/blob/main/index.html"
click node_appui "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/App.html"
click node_backend "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Main.gs"
click node_auth "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Auth.gs"
click node_store "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Store.gs"
click node_tenant "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Tenants.gs"
click node_agents "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Agents.gs"
click node_attendance "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Pointage.gs"
click node_rotation "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Cycle.gs"
click node_requests "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Demandes.gs"
click node_documents "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Documents.gs"
click node_contracts "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Contrats.gs"
click node_bordereau "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Bordereau.gs"
click node_export "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Export.gs"
click node_comments "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Remarques.gs"
click node_prospects "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Prospects.gs"
click node_languages "https://github.com/rayanem-dev/pointage-app/blob/main/appscript/I18n.html"

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_pwa,node_appui,node_backend,node_languages,node_clientuser toneBlue
class node_agents,node_attendance,node_rotation,node_requests,node_documents toneAmber
class node_contracts,node_bordereau,node_export,node_comments toneMint
class node_auth,node_sheets,node_store,node_tenant,node_prospects toneRose
class node_users,node_admin,node_google toneIndigo
```

## Components

### Access and interface

- [Installable PWA](https://github.com/rayanem-dev/pointage-app/blob/main/index.html): `index.html`
- [Application interface](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/App.html): `appscript/App.html`
- [Apps Script application](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Main.gs): `appscript/Main.gs`
- [French Arabic English](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/I18n.html): `appscript/I18n.html`

### Workforce operations

- [Agent records](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Agents.gs): `appscript/Agents.gs`
- [Attendance tracking](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Pointage.gs): `appscript/Pointage.gs`
- [Rotation calendar](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Cycle.gs): `appscript/Cycle.gs`
- [Staff requests](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Demandes.gs): `appscript/Demandes.gs`
- [Staff documents](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Documents.gs): `appscript/Documents.gs`

### Contracts and billing

- [Contract setup](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Contrats.gs): `appscript/Contrats.gs`
- [Price schedule import](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Bordereau.gs): `appscript/Bordereau.gs`
- [Attendance and billing exports](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Export.gs): `appscript/Export.gs`
- [Client remarks](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Remarques.gs): `appscript/Remarques.gs`

### Tenant and platform services

- [Authentication and roles](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Auth.gs): `appscript/Auth.gs`
- **Google Sheets store**
- [Store and cache](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Store.gs): `appscript/Store.gs`
- [Client workspaces](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Tenants.gs): `appscript/Tenants.gs`
- [Prospect trials](https://github.com/rayanem-dev/pointage-app/blob/main/appscript/Prospects.gs): `appscript/Prospects.gs`

### Other components

- **Personnel and managers**
- **Administrator**
- **Client user**
- **Google services**

## Connections

- Personnel and managers → Installable PWA: open app (evidence: `README.md`)
- Installable PWA → Application interface: displays (evidence: `README.md`)
- Personnel and managers → Application interface: use directly
- Administrator → Application interface: administer
- Client user → Application interface: review attendance (evidence: `README.md`)
- Application interface → Apps Script application: send actions
- Apps Script application → Authentication and roles: authorize
- Apps Script application → Store and cache: read and write
- Store and cache → Google Sheets store: cache-backed storage (evidence: `README.md`)
- Apps Script application → Client workspaces: manage clients (evidence: `README.md`)
- Apps Script application → Agent records: manage agents (evidence: `README.md`)
- Apps Script application → Attendance tracking: record attendance (evidence: `README.md`)
- Apps Script application → Rotation calendar: show forecasts (evidence: `README.md`)
- Apps Script application → Staff requests: handle requests (evidence: `README.md`)
- Apps Script application → Staff documents: manage documents (evidence: `README.md`)
- Apps Script application → Contract setup: configure contracts (evidence: `README.md`)
- Apps Script application → Price schedule import: read price schedules (evidence: `README.md`)
- Apps Script application → Attendance and billing exports: export billing (evidence: `README.md`)
- Apps Script application → Client remarks: record client remarks (evidence: `README.md`)
- Apps Script application → Prospect trials: create trials (evidence: `README.md`)
- Application interface → French Arabic English: display translations (evidence: `README.md`)
- Apps Script application → Google services: send notifications (evidence: `README.md`)
