# nyeb-b/lab-exercise-4-flask-intro-2026-bien architecture

> Architecture diagram of the GitHub repository nyeb-b/lab-exercise-4-flask-intro-2026-bien, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien
- Repository: https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien

## Overview

This is an introductory Flask portfolio and programming-tools site. Visitors browse portfolio pages or submit forms to interactive tools; the Flask route handlers validate inputs, calculate or dispatch operations, then render results. The tools cover text and area calculations, linked-list, stack and queue operations, and infix-to-postfix conversion. The algorithm layer is implemented in data_structures.py. Edges are based on the sampled app.py and data_structures.py; the README only broadly describes the portfolio and tools, so unsampled template behavior is not inferred.

Main entry points: [`app.py`](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py) (Flask routes), [`templates/home.html`](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/home.html) (Home page), [`templates/profile.html`](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/profile.html) (Profile page), [`templates/contact.html`](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/contact.html) (Contact page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio pages"]
  node_flask_routes["Flask routes<br/>[app.py]"]
  node_home["Home page<br/>[home.html]"]
  node_profile["Profile page<br/>[profile.html]"]
  node_contact["Contact page<br/>[contact.html]"]
end

subgraph group_tools["Interactive tools"]
  node_text_tool["Text converter<br/>[app.py]"]
  node_uppercase_view["Uppercase page<br/>[touppercase.html]"]
  node_area_tools["Area calculators<br/>[app.py]"]
  node_circle_view["Circle page<br/>[circle.html]"]
  node_triangle_view["Triangle page<br/>[triangle.html]"]
  node_list_handler["Linked-list handler<br/>[app.py]"]
  node_list_view["Linked-list page<br/>[linked_list.html]"]
  node_stack_handler["Stack handler<br/>[app.py]"]
  node_stack_view["Stack page<br/>[stack.html]"]
  node_queue_handler["Queue handler<br/>[app.py]"]
  node_queue_view["Queue page<br/>[queue.html]"]
  node_expression_handler["Expression handler<br/>[app.py]"]
  node_expression_view["Postfix page<br/>[infix_postfix.html]"]
end

subgraph group_algorithms["Data structures"]
  node_linked_list["Linked list<br/>[data_structures.py]"]
  node_stack["Stack<br/>[data_structures.py]"]
  node_queue["Queue<br/>[data_structures.py]"]
  node_postfix_converter["Infix converter<br/>[data_structures.py]"]
end

node_visitor(("Visitor"))

node_visitor -->|"requests pages"| node_flask_routes
node_flask_routes -->|"renders"| node_home
node_flask_routes -->|"renders"| node_profile
node_flask_routes -->|"renders"| node_contact
node_visitor -->|"submits text"| node_text_tool
node_text_tool -->|"renders result"| node_uppercase_view
node_visitor -->|"submits measures"| node_area_tools
node_area_tools -->|"renders result"| node_circle_view
node_area_tools -->|"renders result"| node_triangle_view
node_visitor -->|"submits actions"| node_list_handler
node_list_handler -->|"calls operations"| node_linked_list
node_list_handler -->|"renders state"| node_list_view
node_visitor -->|"submits actions"| node_stack_handler
node_stack_handler -->|"calls operations"| node_stack
node_stack_handler -->|"renders state"| node_stack_view
node_visitor -->|"submits actions"| node_queue_handler
node_queue_handler -->|"calls operations"| node_queue
node_queue_handler -->|"renders state"| node_queue_view
node_visitor -->|"submits expression"| node_expression_handler
node_expression_handler -->|"calls converter"| node_postfix_converter
node_expression_handler -->|"renders result"| node_expression_view

click node_flask_routes "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py"
click node_home "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/home.html"
click node_profile "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/profile.html"
click node_contact "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/contact.html"
click node_text_tool "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py"
click node_uppercase_view "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/touppercase.html"
click node_area_tools "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py"
click node_circle_view "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/circle.html"
click node_triangle_view "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/triangle.html"
click node_list_handler "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py"
click node_list_view "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/linked_list.html"
click node_stack_handler "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py"
click node_stack_view "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/stack.html"
click node_queue_handler "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py"
click node_queue_view "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/queue.html"
click node_expression_handler "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py"
click node_expression_view "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/infix_postfix.html"
click node_linked_list "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/data_structures.py"
click node_stack "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/data_structures.py"
click node_queue "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/data_structures.py"
click node_postfix_converter "https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/data_structures.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_flask_routes,node_home,node_profile,node_contact toneBlue
class node_text_tool,node_uppercase_view,node_area_tools,node_circle_view,node_triangle_view,node_list_handler,node_list_view,node_stack_handler,node_stack_view,node_queue_handler,node_queue_view,node_expression_handler,node_expression_view toneAmber
class node_linked_list,node_stack,node_queue,node_postfix_converter toneMint
class node_visitor toneIndigo
```

## Components

### Portfolio pages

- [Flask routes](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py): `app.py`
- [Home page](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/home.html): `templates/home.html`
- [Profile page](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/profile.html): `templates/profile.html`
- [Contact page](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/contact.html): `templates/contact.html`

### Interactive tools

- [Text converter](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py): `app.py`
- [Uppercase page](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/touppercase.html): `templates/touppercase.html`
- [Area calculators](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py): `app.py`
- [Circle page](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/circle.html): `templates/circle.html`
- [Triangle page](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/triangle.html): `templates/triangle.html`
- [Linked-list handler](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py): `app.py`
- [Linked-list page](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/linked_list.html): `templates/linked_list.html`
- [Stack handler](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py): `app.py`
- [Stack page](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/stack.html): `templates/stack.html`
- [Queue handler](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py): `app.py`
- [Queue page](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/queue.html): `templates/queue.html`
- [Expression handler](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/app.py): `app.py`
- [Postfix page](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/templates/infix_postfix.html): `templates/infix_postfix.html`

### Data structures

- [Linked list](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/data_structures.py): `data_structures.py`
- [Stack](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/data_structures.py): `data_structures.py`
- [Queue](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/data_structures.py): `data_structures.py`
- [Infix converter](https://github.com/nyeb-b/lab-exercise-4-flask-intro-2026-bien/blob/main/data_structures.py): `data_structures.py`

### Other components

- **Visitor**

## Connections

- Visitor → Flask routes: requests pages (evidence: `app.py`)
- Flask routes → Home page: renders (evidence: `app.py`)
- Flask routes → Profile page: renders (evidence: `app.py`)
- Flask routes → Contact page: renders (evidence: `app.py`)
- Visitor → Text converter: submits text (evidence: `app.py`)
- Text converter → Uppercase page: renders result (evidence: `app.py`)
- Visitor → Area calculators: submits measures (evidence: `app.py`)
- Area calculators → Circle page: renders result (evidence: `app.py`)
- Area calculators → Triangle page: renders result (evidence: `app.py`)
- Visitor → Linked-list handler: submits actions (evidence: `app.py`)
- Linked-list handler → Linked list: calls operations (evidence: `app.py`)
- Linked-list handler → Linked-list page: renders state (evidence: `app.py`)
- Visitor → Stack handler: submits actions (evidence: `app.py`)
- Stack handler → Stack: calls operations (evidence: `app.py`)
- Stack handler → Stack page: renders state (evidence: `app.py`)
- Visitor → Queue handler: submits actions (evidence: `app.py`)
- Queue handler → Queue: calls operations (evidence: `app.py`)
- Queue handler → Queue page: renders state (evidence: `app.py`)
- Visitor → Expression handler: submits expression (evidence: `app.py`)
- Expression handler → Infix converter: calls converter (evidence: `app.py`)
- Expression handler → Postfix page: renders result (evidence: `app.py`)
