# aayaneth/curly-admin-panel architecture

> Architecture diagram of the GitHub repository aayaneth/curly-admin-panel, 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/aayaneth/curly-admin-panel
- Repository: https://github.com/aayaneth/curly-admin-panel

## Overview

This is a face-access administration product: an administrator signs in, manages personnel, and views service and activity information. The primary TypeScript/Alpine frontend uses Firebase for sign-in and access-log reads, and calls a FastAPI proxy for health, personnel, and dashboard stats. The proxy derives stats and forwards admin operations to the Face Access API. A separate JavaScript client also exposes personnel operations and registry reload. The README is empty; unsampled UI and backend behavior are not inferred.

Main entry points: [`curly-ts-admin/src/main.ts`](https://github.com/aayaneth/curly-admin-panel/blob/main/curly-ts-admin/src/main.ts) (Admin dashboard), [`backend_admin_panel/main.py`](https://github.com/aayaneth/curly-admin-panel/blob/main/backend_admin_panel/main.py) (Admin proxy API), [`backend_admin_panel/admin_panel.js`](https://github.com/aayaneth/curly-admin-panel/blob/main/backend_admin_panel/admin_panel.js) (API example client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Admin frontend"]
  node_webapp["Admin dashboard<br/>[main.ts]"]
  node_browserstorage[("Browser key storage")]
  node_legacyclient["API example client<br/>[admin_panel.js]"]
end

subgraph group_proxy["Proxy service"]
  node_proxyapi["Admin proxy API<br/>[main.py]"]
  node_stats["Dashboard stats<br/>[main.py]"]
  node_localactivity[("Local activity log<br/>[main.py]")]
end

subgraph group_integrations["External services"]
  node_auth["Google sign-in"]
  node_firestore[("Access logs")]
  node_faceapi["Face Access API"]
end

node_admin(("Administrator"))

node_admin -->|"uses"| node_webapp
node_webapp -->|"signs in"| node_auth
node_webapp -->|"reads and writes"| node_browserstorage
node_webapp -->|"queries logs"| node_firestore
node_webapp -->|"requests health and personnel"| node_proxyapi
node_webapp -->|"requests stats"| node_stats
node_proxyapi -->|"proxies admin requests"| node_faceapi
node_stats -->|"queries personnel"| node_faceapi
node_proxyapi -->|"records mutations"| node_localactivity
node_admin -.->|"uses"| node_legacyclient
node_legacyclient -->|"requests personnel and reload"| node_proxyapi

click node_webapp "https://github.com/aayaneth/curly-admin-panel/blob/main/curly-ts-admin/src/main.ts"
click node_proxyapi "https://github.com/aayaneth/curly-admin-panel/blob/main/backend_admin_panel/main.py"
click node_stats "https://github.com/aayaneth/curly-admin-panel/blob/main/backend_admin_panel/main.py"
click node_localactivity "https://github.com/aayaneth/curly-admin-panel/blob/main/backend_admin_panel/main.py"
click node_legacyclient "https://github.com/aayaneth/curly-admin-panel/blob/main/backend_admin_panel/admin_panel.js"

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_webapp,node_browserstorage,node_legacyclient toneBlue
class node_proxyapi,node_stats,node_localactivity toneAmber
class node_auth,node_firestore,node_faceapi toneMint
class node_admin toneIndigo
```

## Components

### Admin frontend

- [Admin dashboard](https://github.com/aayaneth/curly-admin-panel/blob/main/curly-ts-admin/src/main.ts): `curly-ts-admin/src/main.ts`
- **Browser key storage**
- [API example client](https://github.com/aayaneth/curly-admin-panel/blob/main/backend_admin_panel/admin_panel.js): `backend_admin_panel/admin_panel.js`

### Proxy service

- [Admin proxy API](https://github.com/aayaneth/curly-admin-panel/blob/main/backend_admin_panel/main.py): `backend_admin_panel/main.py`
- [Dashboard stats](https://github.com/aayaneth/curly-admin-panel/blob/main/backend_admin_panel/main.py): `backend_admin_panel/main.py`
- [Local activity log](https://github.com/aayaneth/curly-admin-panel/blob/main/backend_admin_panel/main.py): `backend_admin_panel/main.py`

### External services

- **Google sign-in**
- **Access logs**
- **Face Access API**

### Other components

- **Administrator**

## Connections

- Administrator → Admin dashboard: uses
- Admin dashboard → Google sign-in: signs in (evidence: `curly-ts-admin/src/main.ts`)
- Admin dashboard → Browser key storage: reads and writes (evidence: `curly-ts-admin/src/main.ts`)
- Admin dashboard → Access logs: queries logs (evidence: `curly-ts-admin/src/main.ts`)
- Admin dashboard → Admin proxy API: requests health and personnel (evidence: `curly-ts-admin/src/main.ts`)
- Admin dashboard → Dashboard stats: requests stats (evidence: `curly-ts-admin/src/main.ts`)
- Admin proxy API → Face Access API: proxies admin requests (evidence: `backend_admin_panel/main.py`)
- Dashboard stats → Face Access API: queries personnel (evidence: `backend_admin_panel/main.py`)
- Admin proxy API → Local activity log: records mutations (evidence: `backend_admin_panel/main.py`)
- Administrator → API example client: uses
- API example client → Admin proxy API: requests personnel and reload (evidence: `backend_admin_panel/admin_panel.js`)
