# pallavi-gonepalli/social-network-security architecture

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

- Interactive diagram: https://gitdiagram.com/pallavi-gonepalli/social-network-security
- Repository: https://github.com/pallavi-gonepalli/social-network-security

## Overview

Social-Network-Security is a Flask web application for OTP-assisted registration and face-based login. Its main workflow collects registration details, verifies an email OTP, captures and stores face features, then checks a login capture before granting dashboard access. The sampled code shows face detection and feature comparison, MySQL persistence, email delivery, and session handling. The README provides only the project title, so additional capabilities are not documented; templates and the SQL schema are present in the tree but were not sampled.

Main entry points: [`main.py`](https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py) (Route handlers), [`face_auth_db.sql`](https://github.com/pallavi-gonepalli/social-network-security/blob/main/face_auth_db.sql) (User records), [`static/js/main.js`](https://github.com/pallavi-gonepalli/social-network-security/blob/main/static/js/main.js) (Camera client), [`templates`](https://github.com/pallavi-gonepalli/social-network-security/tree/main/templates) (Web pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_pages["Web pages"]
  node_frontend["Camera client<br/>[main.js]"]
end

subgraph group_app["Flask workflows"]
  node_flask["Route handlers<br/>[main.py]"]
  node_registration["Registration details<br/>[main.py]"]
  node_otp["OTP verification<br/>[main.py]"]
  node_dashboard["Session dashboard<br/>[main.py]"]
end

subgraph group_face["Face authentication"]
  node_facecapture["Face capture<br/>[main.py]"]
  node_featurematch["Feature comparison<br/>[main.py]"]
end

subgraph group_services["External services"]
  node_database[("User records<br/>[face_auth_db.sql]")]
  node_mail["Email service"]
end

node_visitor(("Visitor"))
node_browser["Browser camera"]

node_visitor -->|"visits"| node_pages
node_browser -->|"provides video"| node_frontend
node_frontend -->|"posts captures"| node_flask
node_flask -->|"renders pages"| node_pages
node_flask -->|"handles signup"| node_registration
node_registration -->|"checks duplicates"| node_database
node_registration -->|"sends code"| node_otp
node_otp -->|"sends email"| node_mail
node_flask -->|"processes image"| node_facecapture
node_facecapture -->|"stores features"| node_database
node_flask -->|"checks login face"| node_featurematch
node_flask -->|"loads features"| node_database
node_featurematch -->|"sets login session"| node_dashboard
node_visitor -.->|"requests routes"| node_flask

click node_pages "https://github.com/pallavi-gonepalli/social-network-security/tree/main/templates"
click node_frontend "https://github.com/pallavi-gonepalli/social-network-security/blob/main/static/js/main.js"
click node_flask "https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py"
click node_registration "https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py"
click node_otp "https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py"
click node_facecapture "https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py"
click node_featurematch "https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py"
click node_dashboard "https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py"
click node_database "https://github.com/pallavi-gonepalli/social-network-security/blob/main/face_auth_db.sql"

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_pages,node_frontend,node_browser toneBlue
class node_flask,node_registration,node_otp,node_dashboard toneAmber
class node_facecapture,node_featurematch toneMint
class node_database,node_mail toneRose
class node_visitor toneIndigo
```

## Components

### Web interface

- [Web pages](https://github.com/pallavi-gonepalli/social-network-security/tree/main/templates): `templates`
- [Camera client](https://github.com/pallavi-gonepalli/social-network-security/blob/main/static/js/main.js): `static/js/main.js`

### Flask workflows

- [Route handlers](https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py): `main.py`
- [Registration details](https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py): `main.py`
- [OTP verification](https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py): `main.py`
- [Session dashboard](https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py): `main.py`

### Face authentication

- [Face capture](https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py): `main.py`
- [Feature comparison](https://github.com/pallavi-gonepalli/social-network-security/blob/main/main.py): `main.py`

### External services

- [User records](https://github.com/pallavi-gonepalli/social-network-security/blob/main/face_auth_db.sql): `face_auth_db.sql`
- **Email service**

### Other components

- **Visitor**
- **Browser camera**

## Connections

- Visitor → Web pages: visits
- Browser camera → Camera client: provides video (evidence: `static/js/main.js`)
- Camera client → Route handlers: posts captures (evidence: `static/js/main.js`)
- Route handlers → Web pages: renders pages (evidence: `main.py`)
- Route handlers → Registration details: handles signup (evidence: `main.py`)
- Registration details → User records: checks duplicates (evidence: `main.py`)
- Registration details → OTP verification: sends code (evidence: `main.py`)
- OTP verification → Email service: sends email (evidence: `main.py`)
- Route handlers → Face capture: processes image (evidence: `main.py`)
- Face capture → User records: stores features (evidence: `main.py`)
- Route handlers → Feature comparison: checks login face (evidence: `main.py`)
- Route handlers → User records: loads features (evidence: `main.py`)
- Feature comparison → Session dashboard: sets login session (evidence: `main.py`)
- Visitor → Route handlers: requests routes
