# hieungoc0981-vi/vi_uni_test architecture

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

- Interactive diagram: https://gitdiagram.com/hieungoc0981-vi/vi_uni_test
- Repository: https://github.com/hieungoc0981-vi/vi_uni_test

## Overview

Ví Uni is a Flask personal-finance app for students. Users sign in, record and review personal finances, set budgets and savings goals, and can manage shared group funds; the app stores data in PostgreSQL when configured or local SQLite otherwise. The graph separates the app’s documented domain capabilities while keeping their implementation path at main.py. The excerpts show app setup, database initialization, template rendering, and parts of transaction, savings, and group handling; broader capability links rely on the README, not unsampled route code.

Main entry points: [`main.py`](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py) (Flask app), [`templates/index.html`](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/templates/index.html) (Overview page), [`templates/auth.html`](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/templates/auth.html) (Auth page), [`database/schema.sql`](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/database/schema.sql) (Database schema)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and views"]
  node_flask_app["Flask app<br/>[main.py]"]
  node_auth["Account access<br/>[main.py]"]
  node_dashboard["Finance overview<br/>[main.py]"]
  node_dashboard_template["Overview page<br/>[index.html]"]
  node_auth_template["Auth page<br/>[auth.html]"]
end

subgraph group_personal["Personal finance"]
  node_transactions["Transactions<br/>[main.py]"]
  node_categories_wallets["Categories and wallets<br/>[main.py]"]
  node_budgets["Budgets and alerts<br/>[main.py]"]
  node_savings["Savings goals<br/>[main.py]"]
end

subgraph group_shared["Group finance"]
  node_group_funds["Group funds<br/>[main.py]"]
  node_group_membership["Group membership<br/>[main.py]"]
  node_group_entries["Shared entries<br/>[main.py]"]
  node_group_settlement["Settlement advice<br/>[main.py]"]
  node_activity_log["Group activity log<br/>[main.py]"]
end

subgraph group_storage["Persistence"]
  node_database_access["Database access<br/>[main.py]"]
  node_schema["Database schema<br/>[schema.sql]"]
  node_database[("Finance data")]
end

node_student(("Student"))

node_student -->|"uses"| node_flask_app
node_flask_app -->|"handles accounts"| node_auth
node_auth -->|"renders"| node_auth_template
node_flask_app -->|"serves overview"| node_dashboard
node_dashboard -->|"renders"| node_dashboard_template
node_flask_app -->|"manages records"| node_transactions
node_flask_app -->|"manages"| node_categories_wallets
node_flask_app -->|"sets limits"| node_budgets
node_flask_app -->|"tracks goals"| node_savings
node_flask_app -->|"creates funds"| node_group_funds
node_flask_app -->|"manages membership"| node_group_membership
node_flask_app -->|"records activity"| node_group_entries
node_flask_app -->|"records settlements"| node_group_settlement
node_flask_app -->|"logs activity"| node_activity_log
node_flask_app -->|"uses"| node_database_access
node_database_access -->|"reads and writes"| node_database
node_database_access -->|"initializes tables"| node_schema

click node_flask_app "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_auth "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_dashboard "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_dashboard_template "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/templates/index.html"
click node_auth_template "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/templates/auth.html"
click node_transactions "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_categories_wallets "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_budgets "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_savings "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_group_funds "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_group_membership "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_group_entries "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_group_settlement "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_activity_log "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_database_access "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py"
click node_schema "https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/database/schema.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_flask_app,node_auth,node_dashboard,node_dashboard_template,node_auth_template toneBlue
class node_transactions,node_categories_wallets,node_budgets,node_savings toneAmber
class node_group_funds,node_group_membership,node_group_entries,node_group_settlement,node_activity_log toneMint
class node_database_access,node_schema,node_database toneRose
class node_student toneIndigo
```

## Components

### Access and views

- [Flask app](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Account access](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Finance overview](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Overview page](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/templates/index.html): `templates/index.html`
- [Auth page](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/templates/auth.html): `templates/auth.html`

### Personal finance

- [Transactions](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Categories and wallets](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Budgets and alerts](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Savings goals](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`

### Group finance

- [Group funds](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Group membership](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Shared entries](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Settlement advice](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Group activity log](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`

### Persistence

- [Database access](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/main.py): `main.py`
- [Database schema](https://github.com/hieungoc0981-vi/vi_uni_test/blob/main/database/schema.sql): `database/schema.sql`
- **Finance data**

### Other components

- **Student**

## Connections

- Student → Flask app: uses (evidence: `README.md`)
- Flask app → Account access: handles accounts (evidence: `README.md`)
- Account access → Auth page: renders (evidence: `main.py`)
- Flask app → Finance overview: serves overview (evidence: `main.py`)
- Finance overview → Overview page: renders (evidence: `main.py`)
- Flask app → Transactions: manages records (evidence: `README.md`)
- Flask app → Categories and wallets: manages (evidence: `README.md`)
- Flask app → Budgets and alerts: sets limits (evidence: `README.md`)
- Flask app → Savings goals: tracks goals (evidence: `main.py`)
- Flask app → Group funds: creates funds (evidence: `README.md`)
- Flask app → Group membership: manages membership (evidence: `README.md`)
- Flask app → Shared entries: records activity (evidence: `main.py`)
- Flask app → Settlement advice: records settlements (evidence: `README.md`)
- Flask app → Group activity log: logs activity (evidence: `README.md`)
- Flask app → Database access: uses (evidence: `main.py`)
- Database access → Finance data: reads and writes (evidence: `main.py`)
- Database access → Database schema: initializes tables (evidence: `main.py`)
