# priteshdate/neighbourhood-code-crew architecture

> Architecture diagram of the GitHub repository priteshdate/neighbourhood-code-crew, 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/priteshdate/neighbourhood-code-crew
- Repository: https://github.com/priteshdate/neighbourhood-code-crew

## Overview

This is a neighborhood-help platform: residents create accounts, sign in, and use a dashboard intended to coordinate nearby help. The sampled dashboard initializes local mock state, while the backend excerpts show email-based signup/login, JWT authentication, and profile management. Schemas and ORM models indicate broader request, chat, notification, rating, trust, and moderation capabilities, but their endpoint implementations and wiring were not sampled; those branches are therefore represented without speculative call flows.

Main entry points: [`backend/schemas.py`](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/schemas.py) (API schemas), [`backend/auth.py`](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/auth.py) (Signup and login), [`backend/models.py`](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/models.py) (Domain models), [`frontend/JS/Signup.js`](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/frontend/JS/Signup.js) (Signup form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_login["Login form<br/>[Login.js]"]
  node_signup["Signup form<br/>[Signup.js]"]
  node_landing["Community landing<br/>[index.js]"]
  node_dashboard["Help dashboard<br/>[main.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth["Signup and login<br/>[auth.py]"]
  node_security["Password and JWT<br/>[security.py]"]
  node_dependencies["Auth dependencies<br/>[deps.py]"]
  node_profiles["User profiles<br/>[user.py]"]
end

subgraph group_domain["Help platform domain"]
  node_schemas["API schemas<br/>[schemas.py]"]
  node_help_requests["Help requests"]
  node_messaging["Request chat"]
  node_notifications["Notifications"]
  node_trust["Ratings and trust"]
  node_moderation["Reports and admin"]
end

subgraph group_data["Persistence"]
  node_models["Domain models<br/>[models.py]"]
  node_database["Database sessions<br/>[database.py]"]
  node_sql_store[("SQL database")]
end

node_resident(("Resident"))
node_browser_geo["Browser geolocation"]
node_api_service["HTTP API"]

node_resident -->|"submits credentials"| node_login
node_resident -->|"submits signup"| node_signup
node_resident -->|"explores community"| node_landing
node_resident -.->|"uses dashboard"| node_dashboard
node_signup -->|"requests location"| node_browser_geo
node_login -->|"posts login"| node_api_service
node_signup -->|"posts signup"| node_api_service
node_api_service -.->|"may route"| node_auth
node_dashboard -.->|"may call API"| node_api_service
node_auth -->|"hashes and signs"| node_security
node_auth -->|"builds profile"| node_profiles
node_auth -->|"queries and creates"| node_models
node_dependencies -->|"decodes token"| node_security
node_dependencies -->|"gets session"| node_database
node_profiles -->|"reads and updates"| node_models
node_database -->|"creates engine"| node_sql_store
node_database -->|"registers metadata"| node_models
node_help_requests -.->|"uses request schemas"| node_schemas
node_messaging -.->|"uses chat schemas"| node_schemas
node_notifications -.->|"uses notification schemas"| node_schemas
node_trust -.->|"uses trust schemas"| node_schemas
node_moderation -.->|"uses report schemas"| node_schemas
node_models -.->|"persists entities"| node_sql_store

click node_login "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/frontend/JS/Login.js"
click node_signup "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/frontend/JS/Signup.js"
click node_landing "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/frontend/JS/index.js"
click node_dashboard "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/frontend/JS/main.js"
click node_auth "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/auth.py"
click node_security "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/security.py"
click node_dependencies "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/deps.py"
click node_profiles "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/user.py"
click node_schemas "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/schemas.py"
click node_help_requests "https://github.com/priteshdate/neighbourhood-code-crew/tree/main/backend"
click node_messaging "https://github.com/priteshdate/neighbourhood-code-crew/tree/main/backend"
click node_notifications "https://github.com/priteshdate/neighbourhood-code-crew/tree/main/backend"
click node_trust "https://github.com/priteshdate/neighbourhood-code-crew/tree/main/backend"
click node_moderation "https://github.com/priteshdate/neighbourhood-code-crew/tree/main/backend"
click node_models "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/models.py"
click node_database "https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/database.py"

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_signup,node_landing,node_dashboard,node_browser_geo toneBlue
class node_auth,node_security,node_dependencies,node_profiles toneAmber
class node_schemas,node_help_requests,node_messaging,node_notifications,node_trust,node_moderation,node_api_service toneMint
class node_models,node_database,node_sql_store toneRose
class node_resident toneIndigo
```

## Components

### Web experience

- [Login form](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/frontend/JS/Login.js): `frontend/JS/Login.js`
- [Signup form](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/frontend/JS/Signup.js): `frontend/JS/Signup.js`
- [Community landing](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/frontend/JS/index.js): `frontend/JS/index.js`
- [Help dashboard](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/frontend/JS/main.js): `frontend/JS/main.js`

### Identity and profiles

- [Signup and login](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/auth.py): `backend/auth.py`
- [Password and JWT](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/security.py): `backend/security.py`
- [Auth dependencies](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/deps.py): `backend/deps.py`
- [User profiles](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/user.py): `backend/user.py`

### Help platform domain

- [API schemas](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/schemas.py): `backend/schemas.py`
- [Help requests](https://github.com/priteshdate/neighbourhood-code-crew/tree/main/backend): `backend`
- [Request chat](https://github.com/priteshdate/neighbourhood-code-crew/tree/main/backend): `backend`
- [Notifications](https://github.com/priteshdate/neighbourhood-code-crew/tree/main/backend): `backend`
- [Ratings and trust](https://github.com/priteshdate/neighbourhood-code-crew/tree/main/backend): `backend`
- [Reports and admin](https://github.com/priteshdate/neighbourhood-code-crew/tree/main/backend): `backend`

### Persistence

- [Domain models](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/models.py): `backend/models.py`
- [Database sessions](https://github.com/priteshdate/neighbourhood-code-crew/blob/main/backend/database.py): `backend/database.py`
- **SQL database**

### Other components

- **Resident**
- **Browser geolocation**
- **HTTP API**

## Connections

- Resident → Login form: submits credentials (evidence: `frontend/JS/Login.js`)
- Resident → Signup form: submits signup (evidence: `frontend/JS/Signup.js`)
- Resident → Community landing: explores community (evidence: `frontend/JS/index.js`)
- Resident → Help dashboard: uses dashboard
- Signup form → Browser geolocation: requests location (evidence: `frontend/JS/Signup.js`)
- Login form → HTTP API: posts login (evidence: `frontend/JS/Login.js`)
- Signup form → HTTP API: posts signup (evidence: `frontend/JS/Signup.js`)
- HTTP API → Signup and login: may route
- Help dashboard → HTTP API: may call API
- Signup and login → Password and JWT: hashes and signs (evidence: `backend/auth.py`)
- Signup and login → User profiles: builds profile (evidence: `backend/auth.py`)
- Signup and login → Domain models: queries and creates (evidence: `backend/auth.py`)
- Auth dependencies → Password and JWT: decodes token (evidence: `backend/deps.py`)
- Auth dependencies → Database sessions: gets session (evidence: `backend/deps.py`)
- User profiles → Domain models: reads and updates (evidence: `backend/user.py`)
- Database sessions → SQL database: creates engine (evidence: `backend/database.py`)
- Database sessions → Domain models: registers metadata (evidence: `backend/database.py`)
- Help requests → API schemas: uses request schemas
- Request chat → API schemas: uses chat schemas
- Notifications → API schemas: uses notification schemas
- Ratings and trust → API schemas: uses trust schemas
- Reports and admin → API schemas: uses report schemas
- Domain models → SQL database: persists entities
