# dragon731012/ente-admin architecture

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

## Overview

Ente Admin UI is a PHP admin panel for a self-hosted Ente instance. An administrator logs in, then views dashboard storage metrics, lists users and their usage, edits quotas or subscription expiry, and views captured verification codes. The graph separates authentication, user management, metrics, and OTP capture/display, with shared database access as an internal layer. Relationships are limited to calls, reads, and writes shown in excerpts or README; unsampled runtime wiring is not inferred.

Main entry points: [`auth.php`](https://github.com/dragon731012/ente-admin/blob/main/auth.php) (Session checks), [`manage.php`](https://github.com/dragon731012/ente-admin/blob/main/manage.php) (Quota and expiry), [`db.php`](https://github.com/dragon731012/ente-admin/blob/main/db.php) (Ente database access), [`login.php`](https://github.com/dragon731012/ente-admin/blob/main/login.php) (Admin login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Admin access"]
  node_login["Admin login<br/>[login.php]"]
  node_session["Session checks<br/>[auth.php]"]
end

subgraph group_users["User management"]
  node_user_list["User listing<br/>[users.php]"]
  node_user_edit["Quota and expiry<br/>[manage.php]"]
  node_browser["Panel interactions<br/>[app.js]"]
end

subgraph group_metrics["Storage metrics"]
  node_dashboard["Storage dashboard<br/>[index.php]"]
end

subgraph group_otp["Verification codes"]
  node_mail_capture["SMTP code capture<br/>[mail.py]"]
  node_otp_view["Code viewer<br/>[otp.php]"]
  node_otp_store["Code file"]
end

subgraph group_shared["Shared infrastructure"]
  node_headers["Security headers<br/>[headers.php]"]
  node_db_access["Ente database access<br/>[db.php]"]
  node_ente_db[("Ente PostgreSQL")]
end

node_admin(("Administrator"))

node_admin -->|"submits credentials"| node_login
node_login -->|"loads headers"| node_headers
node_login -.->|"starts session"| node_session
node_admin -.->|"opens panel"| node_dashboard
node_dashboard -->|"checks session"| node_session
node_user_list -->|"checks session"| node_session
node_user_edit -->|"checks session"| node_session
node_otp_view -->|"checks session"| node_session
node_session -->|"loads headers"| node_headers
node_dashboard -->|"queries metrics"| node_db_access
node_user_list -->|"queries users"| node_db_access
node_user_edit -->|"reads and updates"| node_db_access
node_db_access -->|"reads and writes"| node_ente_db
node_admin -.->|"views users"| node_user_list
node_browser -->|"submits changes"| node_user_edit
node_admin -.->|"edits user"| node_user_edit
node_admin -.->|"views codes"| node_otp_view
node_mail_capture -->|"writes codes"| node_otp_store
node_otp_view -->|"reads codes"| node_otp_store
node_admin -.->|"configures Ente SMTP"| node_mail_capture

click node_login "https://github.com/dragon731012/ente-admin/blob/main/login.php"
click node_session "https://github.com/dragon731012/ente-admin/blob/main/auth.php"
click node_headers "https://github.com/dragon731012/ente-admin/blob/main/headers.php"
click node_user_list "https://github.com/dragon731012/ente-admin/blob/main/users.php"
click node_user_edit "https://github.com/dragon731012/ente-admin/blob/main/manage.php"
click node_browser "https://github.com/dragon731012/ente-admin/blob/main/app.js"
click node_dashboard "https://github.com/dragon731012/ente-admin/blob/main/index.php"
click node_mail_capture "https://github.com/dragon731012/ente-admin/blob/main/mail.py"
click node_otp_view "https://github.com/dragon731012/ente-admin/blob/main/otp.php"
click node_db_access "https://github.com/dragon731012/ente-admin/blob/main/db.php"

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_session toneBlue
class node_user_list,node_user_edit,node_browser toneAmber
class node_dashboard toneMint
class node_mail_capture,node_otp_view,node_otp_store toneRose
class node_headers,node_db_access,node_ente_db,node_admin toneIndigo
```

## Components

### Admin access

- [Admin login](https://github.com/dragon731012/ente-admin/blob/main/login.php): `login.php`
- [Session checks](https://github.com/dragon731012/ente-admin/blob/main/auth.php): `auth.php`

### User management

- [User listing](https://github.com/dragon731012/ente-admin/blob/main/users.php): `users.php`
- [Quota and expiry](https://github.com/dragon731012/ente-admin/blob/main/manage.php): `manage.php`
- [Panel interactions](https://github.com/dragon731012/ente-admin/blob/main/app.js): `app.js`

### Storage metrics

- [Storage dashboard](https://github.com/dragon731012/ente-admin/blob/main/index.php): `index.php`

### Verification codes

- [SMTP code capture](https://github.com/dragon731012/ente-admin/blob/main/mail.py): `mail.py`
- [Code viewer](https://github.com/dragon731012/ente-admin/blob/main/otp.php): `otp.php`
- **Code file**

### Shared infrastructure

- [Security headers](https://github.com/dragon731012/ente-admin/blob/main/headers.php): `headers.php`
- [Ente database access](https://github.com/dragon731012/ente-admin/blob/main/db.php): `db.php`
- **Ente PostgreSQL**

### Other components

- **Administrator**

## Connections

- Administrator → Admin login: submits credentials (evidence: `login.php`)
- Admin login → Security headers: loads headers (evidence: `login.php`)
- Admin login → Session checks: starts session
- Administrator → Storage dashboard: opens panel
- Storage dashboard → Session checks: checks session (evidence: `index.php`)
- User listing → Session checks: checks session (evidence: `users.php`)
- Quota and expiry → Session checks: checks session (evidence: `manage.php`)
- Code viewer → Session checks: checks session (evidence: `otp.php`)
- Session checks → Security headers: loads headers (evidence: `auth.php`)
- Storage dashboard → Ente database access: queries metrics (evidence: `index.php`)
- User listing → Ente database access: queries users (evidence: `users.php`)
- Quota and expiry → Ente database access: reads and updates (evidence: `manage.php`)
- Ente database access → Ente PostgreSQL: reads and writes (evidence: `db.php`)
- Administrator → User listing: views users
- Panel interactions → Quota and expiry: submits changes (evidence: `app.js`)
- Administrator → Quota and expiry: edits user
- Administrator → Code viewer: views codes
- SMTP code capture → Code file: writes codes (evidence: `mail.py`)
- Code viewer → Code file: reads codes (evidence: `otp.php`)
- Administrator → SMTP code capture: configures Ente SMTP (evidence: `README.md`)
