# devsaravana2007/nanmuthalvan-pocketsmart-ai architecture

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

- Interactive diagram: https://gitdiagram.com/devsaravana2007/nanmuthalvan-pocketsmart-ai
- Repository: https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai

## Overview

PocketSmart AI is a web-based budget planner. Users register or sign in, choose a home, party, or jewelry planner, submit a budget (and optionally an outfit image for jewelry), and receive recommendations with shopping links; authenticated users can revisit recommendation history. The sampled routes show home and party generation and history handling; the README documents jewelry planning and replay. The app imports a MongoDB client, but the excerpts do not show it being used for application data. Some template and jewelry-route wiring is therefore represented only where documented or left unlinked.

Main entry points: [`app.py`](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/app.py) (Web routes), [`gemini_utils.py`](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/gemini_utils.py) (Home planner), [`database.py`](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/database.py) (MongoDB client), [`templates`](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/tree/main/templates) (Planner pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Experience"]
  node_routes["Web routes<br/>[app.py]"]
  node_pages["Planner pages"]
  node_styles["Page styles<br/>[styles.css]"]
end

subgraph group_identity["Accounts and History"]
  node_auth["Authentication<br/>[app.py]"]
  node_history[("Recommendation history<br/>[app.py]")]
end

subgraph group_planning["Budget Planning"]
  node_home["Home planner<br/>[gemini_utils.py]"]
  node_party["Party planner<br/>[gemini_utils.py]"]
  node_jewelry["Jewelry planner<br/>[gemini_utils.py]"]
  node_shopping["Shopping link builder<br/>[gemini_utils.py]"]
end

subgraph group_integrations["External Services"]
  node_mongo[("MongoDB client<br/>[database.py]")]
  node_mongodb[("MongoDB")]
  node_gemini["Gemini API"]
end

node_user(("Planner user"))

node_user -->|"uses"| node_routes
node_routes -->|"renders"| node_pages
node_routes -->|"serves"| node_styles
node_routes -->|"checks sessions"| node_auth
node_routes -->|"requests plans"| node_home
node_routes -->|"requests plans"| node_party
node_routes -.->|"requests plans"| node_jewelry
node_routes -->|"saves plans"| node_history
node_routes -->|"reads plans"| node_history
node_home -->|"builds links"| node_shopping
node_party -->|"builds links"| node_shopping
node_jewelry -->|"builds links"| node_shopping
node_home -.->|"generates recommendations"| node_gemini
node_party -.->|"generates recommendations"| node_gemini
node_jewelry -.->|"matches image"| node_gemini
node_mongo -->|"connects to"| node_mongodb

click node_routes "https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/app.py"
click node_pages "https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/tree/main/templates"
click node_styles "https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/static/styles.css"
click node_auth "https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/app.py"
click node_history "https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/app.py"
click node_home "https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/gemini_utils.py"
click node_party "https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/gemini_utils.py"
click node_jewelry "https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/gemini_utils.py"
click node_shopping "https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/gemini_utils.py"
click node_mongo "https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/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_routes,node_pages,node_styles,node_user toneBlue
class node_auth,node_history toneAmber
class node_home,node_party,node_jewelry,node_shopping toneMint
class node_mongo,node_mongodb,node_gemini toneRose
```

## Components

### Web Experience

- [Web routes](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/app.py): `app.py`
- [Planner pages](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/tree/main/templates): `templates`
- [Page styles](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/static/styles.css): `static/styles.css`

### Accounts and History

- [Authentication](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/app.py): `app.py`
- [Recommendation history](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/app.py): `app.py`

### Budget Planning

- [Home planner](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/gemini_utils.py): `gemini_utils.py`
- [Party planner](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/gemini_utils.py): `gemini_utils.py`
- [Jewelry planner](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/gemini_utils.py): `gemini_utils.py`
- [Shopping link builder](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/gemini_utils.py): `gemini_utils.py`

### External Services

- [MongoDB client](https://github.com/devsaravana2007/nanmuthalvan-pocketsmart-ai/blob/main/database.py): `database.py`
- **MongoDB**
- **Gemini API**

### Other components

- **Planner user**

## Connections

- Planner user → Web routes: uses (evidence: `README.md`)
- Web routes → Planner pages: renders (evidence: `app.py`)
- Web routes → Page styles: serves (evidence: `app.py`)
- Web routes → Authentication: checks sessions (evidence: `app.py`)
- Web routes → Home planner: requests plans (evidence: `app.py`)
- Web routes → Party planner: requests plans (evidence: `app.py`)
- Web routes → Jewelry planner: requests plans (evidence: `app.py`)
- Web routes → Recommendation history: saves plans (evidence: `app.py`)
- Web routes → Recommendation history: reads plans (evidence: `app.py`)
- Home planner → Shopping link builder: builds links (evidence: `gemini_utils.py`)
- Party planner → Shopping link builder: builds links (evidence: `gemini_utils.py`)
- Jewelry planner → Shopping link builder: builds links (evidence: `gemini_utils.py`)
- Home planner → Gemini API: generates recommendations
- Party planner → Gemini API: generates recommendations
- Jewelry planner → Gemini API: matches image
- MongoDB client → MongoDB: connects to (evidence: `database.py`)
