# oumar2025/ets-fofana-exam architecture

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

- Interactive diagram: https://gitdiagram.com/oumar2025/ets-fofana-exam
- Repository: https://github.com/oumar2025/ets-fofana-exam

## Overview

This repository implements a confectionery business dashboard backed by Netlify functions and shared PostgreSQL state. The principal workflow is an authenticated user loading and updating shared business data; account registration and sign-in establish access, while visitors can retrieve a restricted public view. The state layer also protects account data during synchronization. AI generation and email delivery are separate integrations. The README is empty and the frontend is bundled, so its screens and detailed business workflows are not verifiable from the available excerpts.

Main entry points: [`netlify/functions/_lib/state.mts`](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/state.mts) (State and Account Rules), [`netlify/functions/_lib/session.mts`](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/session.mts) (Cookie Sessions), [`netlify/functions/login.mts`](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/login.mts) (Sign In), [`netlify/functions/_lib/http.mts`](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/http.mts) (HTTP Helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Identity and Access"]
  node_login["Sign In<br/>[login.mts]"]
  node_register["Customer Registration<br/>[register.mts]"]
  node_session_api["Session Check<br/>[session.mts]"]
  node_logout["Sign Out<br/>[logout.mts]"]
  node_session["Cookie Sessions<br/>[session.mts]"]
  node_password["Password Verification<br/>[password.mts]"]
end

subgraph group_data["Shared Business State"]
  node_state["State and Account Rules<br/>[state.mts]"]
  node_defaults["Built-in Accounts<br/>[default-users.mts]"]
  node_database[("Shared PostgreSQL<br/>[db.mts]")]
end

subgraph group_api["API Functions"]
  node_business_api["State API<br/>[state.mts]"]
  node_public_api["Public State API<br/>[public-state.mts]"]
  node_http["HTTP Helpers<br/>[http.mts]"]
end

subgraph group_integrations["External Integrations"]
  node_ai_api["AI Endpoint<br/>[ai.mts]"]
  node_email_api["Email Endpoint<br/>[send-email.mts]"]
end

node_user(("Staff or Customer"))
node_visitor(("Public Visitor"))
node_gemini{{"Google Gemini"}}
node_smtp{{"SMTP Service"}}

node_user -->|"signs in"| node_login
node_user -->|"registers"| node_register
node_user -->|"checks session"| node_session_api
node_user -->|"reads or updates"| node_business_api
node_user -->|"signs out"| node_logout
node_visitor -->|"requests public data"| node_public_api
node_login -->|"loads and saves accounts"| node_state
node_login -->|"verifies password"| node_password
node_login -->|"creates cookie"| node_session
node_register -->|"loads and saves accounts"| node_state
node_register -->|"checks credentials"| node_password
node_session_api -->|"reads cookie"| node_session
node_session_api -->|"loads user"| node_state
node_logout -->|"clears cookie"| node_session
node_business_api -->|"checks access"| node_session
node_business_api -->|"reads and writes"| node_state
node_public_api -->|"reads public data"| node_state
node_state -->|"queries shared state"| node_database
node_session -->|"loads signing secret"| node_database
node_state -->|"repairs account directory"| node_defaults
node_login -->|"formats requests"| node_http
node_register -->|"formats requests"| node_http
node_session_api -->|"formats responses"| node_http
node_business_api -->|"formats requests"| node_http
node_public_api -->|"formats responses"| node_http
node_ai_api -->|"checks access"| node_session
node_ai_api -->|"generates content"| node_gemini
node_email_api -->|"sends email"| node_smtp

click node_login "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/login.mts"
click node_register "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/register.mts"
click node_session_api "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/session.mts"
click node_logout "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/logout.mts"
click node_session "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/session.mts"
click node_password "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/password.mts"
click node_business_api "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/state.mts"
click node_public_api "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/public-state.mts"
click node_state "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/state.mts"
click node_defaults "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/default-users.mts"
click node_database "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/db.mts"
click node_http "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/http.mts"
click node_ai_api "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/ai.mts"
click node_email_api "https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/send-email.mts"

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_register,node_session_api,node_logout,node_session,node_password toneBlue
class node_state,node_defaults,node_database toneAmber
class node_business_api,node_public_api,node_http toneMint
class node_ai_api,node_email_api toneRose
class node_user,node_visitor,node_gemini,node_smtp toneIndigo
```

## Components

### Identity and Access

- [Sign In](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/login.mts): `netlify/functions/login.mts`
- [Customer Registration](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/register.mts): `netlify/functions/register.mts`
- [Session Check](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/session.mts): `netlify/functions/session.mts`
- [Sign Out](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/logout.mts): `netlify/functions/logout.mts`
- [Cookie Sessions](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/session.mts): `netlify/functions/_lib/session.mts`
- [Password Verification](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/password.mts): `netlify/functions/_lib/password.mts`

### Shared Business State

- [State and Account Rules](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/state.mts): `netlify/functions/_lib/state.mts`
- [Built-in Accounts](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/default-users.mts): `netlify/functions/_lib/default-users.mts`
- [Shared PostgreSQL](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/db.mts): `netlify/functions/_lib/db.mts`

### API Functions

- [State API](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/state.mts): `netlify/functions/state.mts`
- [Public State API](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/public-state.mts): `netlify/functions/public-state.mts`
- [HTTP Helpers](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/_lib/http.mts): `netlify/functions/_lib/http.mts`

### External Integrations

- [AI Endpoint](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/ai.mts): `netlify/functions/ai.mts`
- [Email Endpoint](https://github.com/oumar2025/ets-fofana-exam/blob/main/netlify/functions/send-email.mts): `netlify/functions/send-email.mts`

### Other components

- **Staff or Customer**
- **Public Visitor**
- **Google Gemini**
- **SMTP Service**

## Connections

- Staff or Customer → Sign In: signs in (evidence: `netlify/functions/login.mts`)
- Staff or Customer → Customer Registration: registers (evidence: `netlify/functions/register.mts`)
- Staff or Customer → Session Check: checks session (evidence: `netlify/functions/session.mts`)
- Staff or Customer → State API: reads or updates (evidence: `netlify/functions/state.mts`)
- Staff or Customer → Sign Out: signs out (evidence: `netlify/functions/logout.mts`)
- Public Visitor → Public State API: requests public data (evidence: `netlify/functions/public-state.mts`)
- Sign In → State and Account Rules: loads and saves accounts (evidence: `netlify/functions/login.mts`)
- Sign In → Password Verification: verifies password (evidence: `netlify/functions/login.mts`)
- Sign In → Cookie Sessions: creates cookie (evidence: `netlify/functions/login.mts`)
- Customer Registration → State and Account Rules: loads and saves accounts (evidence: `netlify/functions/register.mts`)
- Customer Registration → Password Verification: checks credentials (evidence: `netlify/functions/register.mts`)
- Session Check → Cookie Sessions: reads cookie (evidence: `netlify/functions/session.mts`)
- Session Check → State and Account Rules: loads user (evidence: `netlify/functions/session.mts`)
- Sign Out → Cookie Sessions: clears cookie (evidence: `netlify/functions/logout.mts`)
- State API → Cookie Sessions: checks access (evidence: `netlify/functions/state.mts`)
- State API → State and Account Rules: reads and writes (evidence: `netlify/functions/state.mts`)
- Public State API → State and Account Rules: reads public data (evidence: `netlify/functions/public-state.mts`)
- State and Account Rules → Shared PostgreSQL: queries shared state (evidence: `netlify/functions/_lib/state.mts`)
- Cookie Sessions → Shared PostgreSQL: loads signing secret (evidence: `netlify/functions/_lib/session.mts`)
- State and Account Rules → Built-in Accounts: repairs account directory (evidence: `netlify/functions/_lib/state.mts`)
- Sign In → HTTP Helpers: formats requests (evidence: `netlify/functions/login.mts`)
- Customer Registration → HTTP Helpers: formats requests (evidence: `netlify/functions/register.mts`)
- Session Check → HTTP Helpers: formats responses (evidence: `netlify/functions/session.mts`)
- State API → HTTP Helpers: formats requests (evidence: `netlify/functions/state.mts`)
- Public State API → HTTP Helpers: formats responses (evidence: `netlify/functions/public-state.mts`)
- AI Endpoint → Cookie Sessions: checks access (evidence: `netlify/functions/ai.mts`)
- AI Endpoint → Google Gemini: generates content (evidence: `netlify/functions/ai.mts`)
- Email Endpoint → SMTP Service: sends email (evidence: `netlify/functions/send-email.mts`)
