# freakingcoderr/honey-vault architecture

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

- Interactive diagram: https://gitdiagram.com/freakingcoderr/honey-vault
- Repository: https://github.com/freakingcoderr/honey-vault

## Overview

Honey-Vault is a deception-based access system: a user signs in, the frontend gathers a device fingerprint, and the backend evaluates trust signals to route the session to the real or decoy vault. The decoy vault records activity and offers honeytoken downloads; administrators monitor threat logs and manage IP blacklists. The graph captures documented and excerpted interactions. Other README-described capabilities, such as real-time alerts and geolocation, are shown where documented, but their unsampled implementation details are not inferred.

Main entry points: [`honey-vault-backend/routers/auth.py`](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-backend/routers/auth.py) (Login & Blacklist), [`honey-vault-frontend/src/App.jsx`](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/App.jsx) (Route App), [`honey-vault-frontend/src/pages/HoneyVault.jsx`](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/pages/HoneyVault.jsx) (Honey Vault UI), [`honey-vault-frontend/src/pages/AdminDashboard.jsx`](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/pages/AdminDashboard.jsx) (Admin Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_app["Route App<br/>[App.jsx]"]
  node_login["Login<br/>[login.jsx]"]
  node_fingerprint["Canvas Fingerprint<br/>[fingerprint.js]"]
  node_real_ui["Real Vault UI<br/>[RealVault.jsx]"]
  node_firebase_client["Firebase Client<br/>[firebase.js]"]
end

subgraph group_decision["Access Decision"]
  node_backend["FastAPI App<br/>[main.py]"]
  node_auth_route["Login &amp; Blacklist<br/>[auth.py]"]
  node_trust["Trust Scoring<br/>[trust_score.py]"]
  node_geo_service["IP Geolocation"]
end

subgraph group_deception["Decoy Vault"]
  node_honey_ui["Honey Vault UI<br/>[HoneyVault.jsx]"]
  node_honey_route["Honeytoken Downloads<br/>[honeytokens.py]"]
  node_decoy_files["Honeytoken Files"]
end

subgraph group_monitoring["Threat Monitoring"]
  node_admin_ui["Admin Dashboard<br/>[AdminDashboard.jsx]"]
  node_cloud_functions["Alert Functions<br/>[index.js]"]
end

node_user(("User"))
node_firebase_auth["Firebase Authentication"]
node_firestore[("Firestore")]
node_real_data[("Real Vault Data")]
node_honey_data[("Honey Vault Data")]
node_threat_logs[("Threat Logs")]
node_failed_attempts[("Failed Attempts")]
node_blacklist[("IP Blacklist")]
node_ip_api["IP Geolocation API"]

node_user -->|"opens"| node_app
node_app -->|"routes"| node_login
node_app -->|"routes"| node_real_ui
node_app -->|"routes"| node_honey_ui
node_app -->|"routes"| node_admin_ui
node_login -->|"generates ID"| node_fingerprint
node_login -->|"authenticates"| node_firebase_auth
node_login -->|"requests route"| node_backend
node_backend -->|"routes login"| node_auth_route
node_backend -->|"routes downloads"| node_honey_route
node_auth_route -->|"calculates score"| node_trust
node_auth_route -->|"reads and writes"| node_firestore
node_auth_route -->|"checks and updates"| node_blacklist
node_auth_route -->|"tracks failures"| node_failed_attempts
node_trust -->|"queries location"| node_ip_api
node_trust -->|"uses IP signals"| node_geo_service
node_real_ui -->|"reads config"| node_firebase_client
node_honey_ui -->|"reads config"| node_firebase_client
node_admin_ui -->|"reads config"| node_firebase_client
node_firebase_client -->|"initializes"| node_firebase_auth
node_real_ui -->|"reads records"| node_real_data
node_honey_ui -->|"reads decoys"| node_honey_data
node_honey_ui -->|"logs activity"| node_threat_logs
node_honey_ui -->|"requests download"| node_honey_route
node_honey_route -->|"logs file access"| node_threat_logs
node_honey_route -->|"serves files"| node_decoy_files
node_admin_ui -->|"streams feed"| node_threat_logs
node_admin_ui -->|"manages entries"| node_blacklist
node_cloud_functions -.->|"alerts admins"| node_admin_ui
node_auth_route -->|"middleware checks"| node_blacklist

click node_app "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/App.jsx"
click node_login "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/pages/login.jsx"
click node_fingerprint "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/utils/fingerprint.js"
click node_real_ui "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/pages/RealVault.jsx"
click node_honey_ui "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/pages/HoneyVault.jsx"
click node_admin_ui "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/pages/AdminDashboard.jsx"
click node_firebase_client "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/firebase.js"
click node_backend "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-backend/main.py"
click node_auth_route "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-backend/routers/auth.py"
click node_trust "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-backend/services/trust_score.py"
click node_honey_route "https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-backend/routers/honeytokens.py"
click node_decoy_files "https://github.com/freakingcoderr/honey-vault/tree/main/honey-vault-backend/honeytokens"
click node_cloud_functions "https://github.com/freakingcoderr/honey-vault/blob/main/functions/index.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_app,node_login,node_fingerprint,node_real_ui,node_firebase_client,node_user toneBlue
class node_backend,node_auth_route,node_trust,node_geo_service,node_firestore,node_real_data,node_honey_data,node_threat_logs,node_failed_attempts,node_blacklist toneAmber
class node_honey_ui,node_honey_route,node_decoy_files,node_ip_api toneMint
class node_admin_ui,node_cloud_functions toneRose
class node_firebase_auth toneIndigo
```

## Components

### Frontend

- [Route App](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/App.jsx): `honey-vault-frontend/src/App.jsx`
- [Login](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/pages/login.jsx): `honey-vault-frontend/src/pages/login.jsx`
- [Canvas Fingerprint](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/utils/fingerprint.js): `honey-vault-frontend/src/utils/fingerprint.js`
- [Real Vault UI](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/pages/RealVault.jsx): `honey-vault-frontend/src/pages/RealVault.jsx`
- [Firebase Client](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/firebase.js): `honey-vault-frontend/src/firebase.js`

### Access Decision

- [FastAPI App](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-backend/main.py): `honey-vault-backend/main.py`
- [Login & Blacklist](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-backend/routers/auth.py): `honey-vault-backend/routers/auth.py`
- [Trust Scoring](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-backend/services/trust_score.py): `honey-vault-backend/services/trust_score.py`
- **IP Geolocation**

### Decoy Vault

- [Honey Vault UI](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/pages/HoneyVault.jsx): `honey-vault-frontend/src/pages/HoneyVault.jsx`
- [Honeytoken Downloads](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-backend/routers/honeytokens.py): `honey-vault-backend/routers/honeytokens.py`
- [Honeytoken Files](https://github.com/freakingcoderr/honey-vault/tree/main/honey-vault-backend/honeytokens): `honey-vault-backend/honeytokens`

### Threat Monitoring

- [Admin Dashboard](https://github.com/freakingcoderr/honey-vault/blob/main/honey-vault-frontend/src/pages/AdminDashboard.jsx): `honey-vault-frontend/src/pages/AdminDashboard.jsx`
- [Alert Functions](https://github.com/freakingcoderr/honey-vault/blob/main/functions/index.js): `functions/index.js`

### Other components

- **User**
- **Firebase Authentication**
- **Firestore**
- **Real Vault Data**
- **Honey Vault Data**
- **Threat Logs**
- **Failed Attempts**
- **IP Blacklist**
- **IP Geolocation API**

## Connections

- User → Route App: opens (evidence: `README.md`)
- Route App → Login: routes (evidence: `honey-vault-frontend/src/App.jsx`)
- Route App → Real Vault UI: routes (evidence: `honey-vault-frontend/src/App.jsx`)
- Route App → Honey Vault UI: routes (evidence: `honey-vault-frontend/src/App.jsx`)
- Route App → Admin Dashboard: routes (evidence: `honey-vault-frontend/src/App.jsx`)
- Login → Canvas Fingerprint: generates ID (evidence: `honey-vault-frontend/src/pages/login.jsx`)
- Login → Firebase Authentication: authenticates (evidence: `honey-vault-frontend/src/pages/login.jsx`)
- Login → FastAPI App: requests route (evidence: `honey-vault-frontend/src/pages/login.jsx`)
- FastAPI App → Login & Blacklist: routes login (evidence: `honey-vault-backend/main.py`)
- FastAPI App → Honeytoken Downloads: routes downloads (evidence: `honey-vault-backend/main.py`)
- Login & Blacklist → Trust Scoring: calculates score (evidence: `honey-vault-backend/routers/auth.py`)
- Login & Blacklist → Firestore: reads and writes (evidence: `honey-vault-backend/routers/auth.py`)
- Login & Blacklist → IP Blacklist: checks and updates (evidence: `honey-vault-backend/routers/auth.py`)
- Login & Blacklist → Failed Attempts: tracks failures (evidence: `honey-vault-backend/routers/auth.py`)
- Trust Scoring → IP Geolocation API: queries location (evidence: `honey-vault-backend/services/trust_score.py`)
- Trust Scoring → IP Geolocation: uses IP signals (evidence: `README.md`)
- Real Vault UI → Firebase Client: reads config (evidence: `honey-vault-frontend/src/pages/RealVault.jsx`)
- Honey Vault UI → Firebase Client: reads config (evidence: `honey-vault-frontend/src/pages/HoneyVault.jsx`)
- Admin Dashboard → Firebase Client: reads config (evidence: `honey-vault-frontend/src/pages/AdminDashboard.jsx`)
- Firebase Client → Firebase Authentication: initializes (evidence: `honey-vault-frontend/src/firebase.js`)
- Real Vault UI → Real Vault Data: reads records (evidence: `honey-vault-frontend/src/pages/RealVault.jsx`)
- Honey Vault UI → Honey Vault Data: reads decoys (evidence: `honey-vault-frontend/src/pages/HoneyVault.jsx`)
- Honey Vault UI → Threat Logs: logs activity (evidence: `honey-vault-frontend/src/pages/HoneyVault.jsx`)
- Honey Vault UI → Honeytoken Downloads: requests download (evidence: `honey-vault-frontend/src/pages/HoneyVault.jsx`)
- Honeytoken Downloads → Threat Logs: logs file access (evidence: `honey-vault-backend/routers/honeytokens.py`)
- Honeytoken Downloads → Honeytoken Files: serves files (evidence: `honey-vault-backend/routers/honeytokens.py`)
- Admin Dashboard → Threat Logs: streams feed (evidence: `honey-vault-frontend/src/pages/AdminDashboard.jsx`)
- Admin Dashboard → IP Blacklist: manages entries (evidence: `honey-vault-frontend/src/pages/AdminDashboard.jsx`)
- Alert Functions → Admin Dashboard: alerts admins (evidence: `README.md`)
- Login & Blacklist → IP Blacklist: middleware checks
