# abiram-kumaran/thisiswater architecture

> Architecture diagram of the GitHub repository abiram-kumaran/thisiswater, 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/abiram-kumaran/thisiswater
- Repository: https://github.com/abiram-kumaran/thisiswater

## Overview

WAter is a Flask social application: people register and verify email, then use a feed, profiles, a friends graph, and friend-to-friend direct messaging; administrators separately manage application data. The graph captures the app factory, authentication, social routes, admin controls, shared relational models, and documented visual effects. README-described routes are represented at their owning module even where route bodies were not sampled; edges are limited to relationships shown in excerpts or documented by the README.

Main entry points: [`website/admin.py`](https://github.com/abiram-kumaran/thisiswater/blob/main/website/admin.py) (Admin panel), [`website/views.py`](https://github.com/abiram-kumaran/thisiswater/blob/main/website/views.py) (Direct messaging), [`website/auth.py`](https://github.com/abiram-kumaran/thisiswater/blob/main/website/auth.py) (Authentication and OTP), [`website/__init__.py`](https://github.com/abiram-kumaran/thisiswater/blob/main/website/__init__.py) (Flask app factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Core"]
  node_flask_app["Flask app factory<br/>[__init__.py]"]
  node_authentication["Authentication and OTP<br/>[auth.py]"]
end

subgraph group_social["Social Features"]
  node_social_routes["Feed and profiles<br/>[views.py]"]
  node_social_graph["Friend network<br/>[views.py]"]
  node_messaging["Direct messaging<br/>[views.py]"]
end

subgraph group_admin["Administration"]
  node_admin_console["Admin panel<br/>[admin.py]"]
  node_admin_views["Admin screens"]
end

subgraph group_data["Persistence"]
  node_user_records[("User records<br/>[models.py]")]
  node_social_records[("Posts and interactions<br/>[models.py]")]
  node_friend_records[("Friend requests<br/>[models.py]")]
  node_message_records[("Message records<br/>[models.py]")]
end

subgraph group_experience["Visual Experience"]
  node_page_effects["Page backgrounds<br/>[page-bg.js]"]
  node_dm_effects["DM visual effects<br/>[dm-effects.js]"]
  node_dot_field["Animated dot field<br/>[dot-field.js]"]
  node_cursor_effect["Blob cursor<br/>[blob-cursor.js]"]
  node_other_effects["Navigation and motion"]
end

node_visitor(("Site visitor"))
node_member(("Registered member"))
node_admin_user(("Administrator"))
node_mail_service{{"SMTP email service"}}
node_uploads[("Uploaded media")]

node_visitor -->|"opens site"| node_flask_app
node_member -->|"signs in"| node_authentication
node_visitor -->|"registers"| node_authentication
node_authentication -->|"creates and queries"| node_user_records
node_authentication -->|"sends OTP"| node_mail_service
node_flask_app -->|"registers blueprint"| node_authentication
node_flask_app -->|"registers blueprint"| node_social_routes
node_flask_app -->|"registers blueprint"| node_admin_console
node_social_routes -->|"queries users"| node_user_records
node_social_routes -.->|"creates and queries"| node_social_records
node_member -->|"uses feed and profiles"| node_social_routes
node_social_routes -.->|"provides friend features"| node_social_graph
node_social_graph -.->|"manages requests"| node_friend_records
node_member -->|"messages friends"| node_messaging
node_messaging -->|"checks friendship"| node_friend_records
node_messaging -->|"looks up recipient"| node_user_records
node_messaging -.->|"stores messages"| node_message_records
node_messaging -.->|"accepts attachments"| node_uploads
node_admin_user -->|"manages data"| node_admin_console
node_admin_console -->|"renders screens"| node_admin_views
node_admin_console -->|"queries and edits"| node_user_records
node_admin_console -->|"manages content"| node_social_records
node_admin_console -->|"manages requests"| node_friend_records
node_admin_console -->|"manages messages"| node_message_records
node_page_effects -.->|"renders background"| node_visitor
node_dm_effects -.->|"styles messaging"| node_member
node_dot_field -.->|"animates interface"| node_member
node_cursor_effect -.->|"animates cursor"| node_visitor
node_other_effects -.->|"enhances navigation"| node_member

click node_flask_app "https://github.com/abiram-kumaran/thisiswater/blob/main/website/__init__.py"
click node_authentication "https://github.com/abiram-kumaran/thisiswater/blob/main/website/auth.py"
click node_user_records "https://github.com/abiram-kumaran/thisiswater/blob/main/website/models.py"
click node_social_routes "https://github.com/abiram-kumaran/thisiswater/blob/main/website/views.py"
click node_social_graph "https://github.com/abiram-kumaran/thisiswater/blob/main/website/views.py"
click node_messaging "https://github.com/abiram-kumaran/thisiswater/blob/main/website/views.py"
click node_social_records "https://github.com/abiram-kumaran/thisiswater/blob/main/website/models.py"
click node_friend_records "https://github.com/abiram-kumaran/thisiswater/blob/main/website/models.py"
click node_message_records "https://github.com/abiram-kumaran/thisiswater/blob/main/website/models.py"
click node_admin_console "https://github.com/abiram-kumaran/thisiswater/blob/main/website/admin.py"
click node_admin_views "https://github.com/abiram-kumaran/thisiswater/tree/main/website/templates/admin"
click node_page_effects "https://github.com/abiram-kumaran/thisiswater/blob/main/website/static/effects/page-bg.js"
click node_dm_effects "https://github.com/abiram-kumaran/thisiswater/blob/main/website/static/effects/dm-effects.js"
click node_dot_field "https://github.com/abiram-kumaran/thisiswater/blob/main/website/static/effects/dot-field.js"
click node_cursor_effect "https://github.com/abiram-kumaran/thisiswater/blob/main/website/static/effects/blob-cursor.js"
click node_other_effects "https://github.com/abiram-kumaran/thisiswater/tree/main/website/static/effects"

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_flask_app,node_authentication toneBlue
class node_social_routes,node_social_graph,node_messaging,node_uploads toneAmber
class node_admin_console,node_admin_views toneMint
class node_user_records,node_social_records,node_friend_records,node_message_records toneRose
class node_page_effects,node_dm_effects,node_dot_field,node_cursor_effect,node_other_effects,node_visitor,node_member,node_admin_user,node_mail_service toneIndigo
```

## Components

### Application Core

- [Flask app factory](https://github.com/abiram-kumaran/thisiswater/blob/main/website/__init__.py): `website/__init__.py`
- [Authentication and OTP](https://github.com/abiram-kumaran/thisiswater/blob/main/website/auth.py): `website/auth.py`

### Social Features

- [Feed and profiles](https://github.com/abiram-kumaran/thisiswater/blob/main/website/views.py): `website/views.py`
- [Friend network](https://github.com/abiram-kumaran/thisiswater/blob/main/website/views.py): `website/views.py`
- [Direct messaging](https://github.com/abiram-kumaran/thisiswater/blob/main/website/views.py): `website/views.py`

### Administration

- [Admin panel](https://github.com/abiram-kumaran/thisiswater/blob/main/website/admin.py): `website/admin.py`
- [Admin screens](https://github.com/abiram-kumaran/thisiswater/tree/main/website/templates/admin): `website/templates/admin`

### Persistence

- [User records](https://github.com/abiram-kumaran/thisiswater/blob/main/website/models.py): `website/models.py`
- [Posts and interactions](https://github.com/abiram-kumaran/thisiswater/blob/main/website/models.py): `website/models.py`
- [Friend requests](https://github.com/abiram-kumaran/thisiswater/blob/main/website/models.py): `website/models.py`
- [Message records](https://github.com/abiram-kumaran/thisiswater/blob/main/website/models.py): `website/models.py`

### Visual Experience

- [Page backgrounds](https://github.com/abiram-kumaran/thisiswater/blob/main/website/static/effects/page-bg.js): `website/static/effects/page-bg.js`
- [DM visual effects](https://github.com/abiram-kumaran/thisiswater/blob/main/website/static/effects/dm-effects.js): `website/static/effects/dm-effects.js`
- [Animated dot field](https://github.com/abiram-kumaran/thisiswater/blob/main/website/static/effects/dot-field.js): `website/static/effects/dot-field.js`
- [Blob cursor](https://github.com/abiram-kumaran/thisiswater/blob/main/website/static/effects/blob-cursor.js): `website/static/effects/blob-cursor.js`
- [Navigation and motion](https://github.com/abiram-kumaran/thisiswater/tree/main/website/static/effects): `website/static/effects`

### Other components

- **Site visitor**
- **Registered member**
- **Administrator**
- **SMTP email service**
- **Uploaded media**

## Connections

- Site visitor → Flask app factory: opens site (evidence: `README.md`)
- Registered member → Authentication and OTP: signs in (evidence: `README.md`)
- Site visitor → Authentication and OTP: registers (evidence: `README.md`)
- Authentication and OTP → User records: creates and queries (evidence: `website/auth.py`)
- Authentication and OTP → SMTP email service: sends OTP (evidence: `website/auth.py`)
- Flask app factory → Authentication and OTP: registers blueprint (evidence: `website/__init__.py`)
- Flask app factory → Feed and profiles: registers blueprint (evidence: `website/__init__.py`)
- Flask app factory → Admin panel: registers blueprint (evidence: `website/__init__.py`)
- Feed and profiles → User records: queries users (evidence: `website/views.py`)
- Feed and profiles → Posts and interactions: creates and queries (evidence: `README.md`)
- Registered member → Feed and profiles: uses feed and profiles (evidence: `README.md`)
- Feed and profiles → Friend network: provides friend features (evidence: `README.md`)
- Friend network → Friend requests: manages requests (evidence: `README.md`)
- Registered member → Direct messaging: messages friends (evidence: `README.md`)
- Direct messaging → Friend requests: checks friendship (evidence: `website/views.py`)
- Direct messaging → User records: looks up recipient (evidence: `website/views.py`)
- Direct messaging → Message records: stores messages (evidence: `README.md`)
- Direct messaging → Uploaded media: accepts attachments (evidence: `README.md`)
- Administrator → Admin panel: manages data (evidence: `README.md`)
- Admin panel → Admin screens: renders screens (evidence: `website/admin.py`)
- Admin panel → User records: queries and edits (evidence: `website/admin.py`)
- Admin panel → Posts and interactions: manages content (evidence: `website/admin.py`)
- Admin panel → Friend requests: manages requests (evidence: `website/admin.py`)
- Admin panel → Message records: manages messages (evidence: `website/admin.py`)
- Page backgrounds → Site visitor: renders background
- DM visual effects → Registered member: styles messaging
- Animated dot field → Registered member: animates interface
- Blob cursor → Site visitor: animates cursor
- Navigation and motion → Registered member: enhances navigation (evidence: `README.md`)
