# anushaoli19/idea-vault architecture

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

- Interactive diagram: https://gitdiagram.com/anushaoli19/idea-vault
- Repository: https://github.com/anushaoli19/idea-vault

## Overview

NIE Idea Vault is a campus idea-sharing and team-matching portal. Students browse and submit project ideas; the Flask API checks submissions for similarity, serves ideas and supports engagement and collaboration, with SQLite holding application data. The frontend also presents profiles, notifications, settings and campus discovery screens. The README documents these capabilities, while the excerpts show the API, persistence and duplicate-detection implementation. Some frontend-to-API wiring and unsampled feature routes are not visible, so those relationships are omitted or marked unverified.

Main entry points: [`frontend/app.js`](https://github.com/anushaoli19/idea-vault/blob/main/frontend/app.js) (Campus portal), [`backend/database.py`](https://github.com/anushaoli19/idea-vault/blob/main/backend/database.py) (SQLite access), [`backend/app.py`](https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py) (REST API), [`frontend/index.html`](https://github.com/anushaoli19/idea-vault/blob/main/frontend/index.html) (Idea board)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Student experience"]
  node_web["Campus portal<br/>[app.js]"]
  node_idea_board["Idea board<br/>[index.html]"]
  node_post_idea["Post idea<br/>[idea.html]"]
  node_leaderboard_ui["Campus leaderboard<br/>[leaderboard.html]"]
  node_submissions_ui["Submissions dashboard<br/>[submissions.html]"]
  node_profile_ui["Student profile<br/>[profile.html]"]
  node_teammates_ui["Teammate matching<br/>[teammates.html]"]
  node_notifications_ui["Notifications<br/>[notifications.html]"]
  node_settings_ui["Student settings<br/>[settings.html]"]
end

subgraph group_api["Flask application"]
  node_api["REST API<br/>[app.py]"]
end

subgraph group_discovery["Idea discovery"]
  node_idea_routes["Idea routes<br/>[app.py]"]
  node_duplicate_check["Duplicate check<br/>[app.py]"]
  node_duplicate_engine["TF-IDF similarity"]
end

subgraph group_collaboration["Engagement and teams"]
  node_engagement["Voting and interest<br/>[app.py]"]
  node_team_roles["Open team roles<br/>[app.py]"]
  node_notifications["Notification service<br/>[app.py]"]
  node_profiles_settings["Profiles and settings<br/>[app.py]"]
end

subgraph group_persistence["Persistence and matching"]
  node_database_access["SQLite access<br/>[database.py]"]
  node_sqlite[("SQLite database")]
end

node_student(("Student"))

node_student -->|"uses"| node_web
node_web -.->|"renders"| node_idea_board
node_web -.->|"renders"| node_post_idea
node_web -.->|"renders"| node_leaderboard_ui
node_web -.->|"renders"| node_submissions_ui
node_web -.->|"renders"| node_profile_ui
node_web -.->|"renders"| node_teammates_ui
node_web -.->|"renders"| node_notifications_ui
node_web -.->|"renders"| node_settings_ui
node_web -->|"fetches ideas"| node_api
node_api -->|"routes requests"| node_idea_routes
node_api -->|"routes checks"| node_duplicate_check
node_duplicate_check -->|"evaluates similarity"| node_duplicate_engine
node_api -->|"opens connections"| node_database_access
node_idea_routes -->|"queries ideas"| node_database_access
node_duplicate_check -->|"loads existing ideas"| node_database_access
node_engagement -->|"stores votes and interest"| node_database_access
node_team_roles -->|"queries roles"| node_database_access
node_notifications -->|"reads and updates"| node_database_access
node_profiles_settings -->|"reads and updates"| node_database_access
node_database_access -->|"reads and writes"| node_sqlite

click node_web "https://github.com/anushaoli19/idea-vault/blob/main/frontend/app.js"
click node_idea_board "https://github.com/anushaoli19/idea-vault/blob/main/frontend/index.html"
click node_post_idea "https://github.com/anushaoli19/idea-vault/blob/main/frontend/idea.html"
click node_leaderboard_ui "https://github.com/anushaoli19/idea-vault/blob/main/frontend/leaderboard.html"
click node_submissions_ui "https://github.com/anushaoli19/idea-vault/blob/main/frontend/submissions.html"
click node_profile_ui "https://github.com/anushaoli19/idea-vault/blob/main/frontend/profile.html"
click node_teammates_ui "https://github.com/anushaoli19/idea-vault/blob/main/frontend/teammates.html"
click node_notifications_ui "https://github.com/anushaoli19/idea-vault/blob/main/frontend/notifications.html"
click node_settings_ui "https://github.com/anushaoli19/idea-vault/blob/main/frontend/settings.html"
click node_api "https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py"
click node_idea_routes "https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py"
click node_duplicate_check "https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py"
click node_duplicate_engine "https://github.com/anushaoli19/idea-vault/blob/main/backend/duplicate_detection.py"
click node_engagement "https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py"
click node_team_roles "https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py"
click node_notifications "https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py"
click node_profiles_settings "https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py"
click node_database_access "https://github.com/anushaoli19/idea-vault/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_web,node_idea_board,node_post_idea,node_leaderboard_ui,node_submissions_ui,node_profile_ui,node_teammates_ui,node_notifications_ui,node_settings_ui toneBlue
class node_api toneAmber
class node_idea_routes,node_duplicate_check,node_duplicate_engine toneMint
class node_engagement,node_team_roles,node_notifications,node_profiles_settings toneRose
class node_database_access,node_sqlite,node_student toneIndigo
```

## Components

### Student experience

- [Campus portal](https://github.com/anushaoli19/idea-vault/blob/main/frontend/app.js): `frontend/app.js`
- [Idea board](https://github.com/anushaoli19/idea-vault/blob/main/frontend/index.html): `frontend/index.html`
- [Post idea](https://github.com/anushaoli19/idea-vault/blob/main/frontend/idea.html): `frontend/idea.html`
- [Campus leaderboard](https://github.com/anushaoli19/idea-vault/blob/main/frontend/leaderboard.html): `frontend/leaderboard.html`
- [Submissions dashboard](https://github.com/anushaoli19/idea-vault/blob/main/frontend/submissions.html): `frontend/submissions.html`
- [Student profile](https://github.com/anushaoli19/idea-vault/blob/main/frontend/profile.html): `frontend/profile.html`
- [Teammate matching](https://github.com/anushaoli19/idea-vault/blob/main/frontend/teammates.html): `frontend/teammates.html`
- [Notifications](https://github.com/anushaoli19/idea-vault/blob/main/frontend/notifications.html): `frontend/notifications.html`
- [Student settings](https://github.com/anushaoli19/idea-vault/blob/main/frontend/settings.html): `frontend/settings.html`

### Flask application

- [REST API](https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py): `backend/app.py`

### Idea discovery

- [Idea routes](https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py): `backend/app.py`
- [Duplicate check](https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py): `backend/app.py`
- [TF-IDF similarity](https://github.com/anushaoli19/idea-vault/blob/main/backend/duplicate_detection.py): `backend/duplicate_detection.py`

### Engagement and teams

- [Voting and interest](https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py): `backend/app.py`
- [Open team roles](https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py): `backend/app.py`
- [Notification service](https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py): `backend/app.py`
- [Profiles and settings](https://github.com/anushaoli19/idea-vault/blob/main/backend/app.py): `backend/app.py`

### Persistence and matching

- [SQLite access](https://github.com/anushaoli19/idea-vault/blob/main/backend/database.py): `backend/database.py`
- **SQLite database**

### Other components

- **Student**

## Connections

- Student → Campus portal: uses (evidence: `README.md`)
- Campus portal → Idea board: renders
- Campus portal → Post idea: renders
- Campus portal → Campus leaderboard: renders
- Campus portal → Submissions dashboard: renders
- Campus portal → Student profile: renders
- Campus portal → Teammate matching: renders
- Campus portal → Notifications: renders
- Campus portal → Student settings: renders
- Campus portal → REST API: fetches ideas (evidence: `frontend/app.js`)
- REST API → Idea routes: routes requests (evidence: `backend/app.py`)
- REST API → Duplicate check: routes checks (evidence: `backend/app.py`)
- Duplicate check → TF-IDF similarity: evaluates similarity (evidence: `backend/app.py`)
- REST API → SQLite access: opens connections (evidence: `backend/app.py`)
- Idea routes → SQLite access: queries ideas (evidence: `backend/app.py`)
- Duplicate check → SQLite access: loads existing ideas (evidence: `backend/app.py`)
- Voting and interest → SQLite access: stores votes and interest (evidence: `backend/app.py`)
- Open team roles → SQLite access: queries roles (evidence: `backend/app.py`)
- Notification service → SQLite access: reads and updates (evidence: `backend/app.py`)
- Profiles and settings → SQLite access: reads and updates (evidence: `backend/app.py`)
- SQLite access → SQLite database: reads and writes (evidence: `backend/database.py`)
