# prvisitacion-ayaa/cccs106-group06-showcase architecture

> Architecture diagram of the GitHub repository prvisitacion-ayaa/cccs106-group06-showcase, 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/prvisitacion-ayaa/cccs106-group06-showcase
- Repository: https://github.com/prvisitacion-ayaa/cccs106-group06-showcase

## Overview

Learn2Earn is a Flet student note-sharing and rewards prototype. Students register or sign in, then reach student or administrator screens; the student interface presents browsing, uploads, LearnPoints, and an AI-assistant prototype, while administrators see user and submission-management views. The sampled implementation establishes account persistence and screen routing, but does not establish persistence or processing for the broader resource, moderation, rewards, or AI capabilities documented in the README. The repository also contains an older standalone UI prototype; it is shown separately from the active app.

Main entry points: [`main.py`](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/main.py) (Application entry), [`LEARN2EARN_PROTOTYPE_UI/main.py`](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/main.py) (Prototype entry), [`app/backend/auth.py`](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/backend/auth.py) (Account authentication), [`app/ui/admin.py`](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/admin.py) (Administrator dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry and routing"]
  node_app_entry["Application entry<br/>[main.py]"]
end

subgraph group_accounts["Accounts and persistence"]
  node_login["Login screen<br/>[login.py]"]
  node_registration["Registration screen<br/>[register.py]"]
  node_auth["Account authentication<br/>[auth.py]"]
  node_user_data["User operations<br/>[users.py]"]
  node_database[("SQLite store<br/>[database.py]")]
end

subgraph group_student["Student learning"]
  node_student_ui["Student dashboard<br/>[student.py]"]
  node_shared_ui["Shared UI components<br/>[components.py]"]
  node_resource_workflow["Resource sharing<br/>[student.py]"]
  node_rewards["LearnPoints and rewards<br/>[student.py]"]
  node_ai_assistant["AI note assistant<br/>[student.py]"]
end

subgraph group_admin["Administration"]
  node_admin_ui["Administrator dashboard<br/>[admin.py]"]
end

subgraph group_legacy["Standalone UI prototype"]
  node_legacy_entry["Prototype entry<br/>[main.py]"]
  node_legacy_login["Prototype login<br/>[login.py]"]
  node_legacy_registration["Prototype registration<br/>[register.py]"]
  node_legacy_student["Prototype student UI<br/>[student.py]"]
  node_legacy_admin["Prototype admin UI<br/>[admin.py]"]
  node_legacy_components["Prototype components<br/>[components.py]"]
end

node_student_actor(("Student"))
node_admin_actor(("Administrator"))

node_student_actor -->|"opens"| node_app_entry
node_admin_actor -->|"opens"| node_app_entry
node_app_entry -->|"initializes tables"| node_database
node_app_entry -->|"shows"| node_login
node_app_entry -->|"routes to"| node_registration
node_app_entry -->|"routes to"| node_student_ui
node_app_entry -->|"routes to"| node_admin_ui
node_login -->|"calls login"| node_auth
node_registration -->|"calls register"| node_auth
node_auth -->|"reads and writes"| node_database
node_user_data -->|"reads and writes"| node_database
node_student_ui -->|"uses components"| node_shared_ui
node_admin_ui -->|"uses components"| node_shared_ui
node_student_actor -->|"shares and explores"| node_resource_workflow
node_student_actor -->|"views and redeems"| node_rewards
node_student_actor -->|"uses"| node_ai_assistant
node_admin_actor -->|"manages"| node_admin_ui
node_legacy_entry -->|"shows"| node_legacy_login
node_legacy_entry -->|"routes to"| node_legacy_registration
node_legacy_entry -->|"routes to"| node_legacy_student
node_legacy_entry -->|"routes to"| node_legacy_admin
node_legacy_student -->|"uses components"| node_legacy_components
node_legacy_admin -->|"uses components"| node_legacy_components

click node_app_entry "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/main.py"
click node_login "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/login.py"
click node_registration "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/register.py"
click node_auth "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/backend/auth.py"
click node_user_data "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/backend/users.py"
click node_database "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/database/database.py"
click node_student_ui "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/student.py"
click node_shared_ui "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/components.py"
click node_resource_workflow "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/student.py"
click node_rewards "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/student.py"
click node_ai_assistant "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/student.py"
click node_admin_ui "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/admin.py"
click node_legacy_entry "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/main.py"
click node_legacy_login "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/login.py"
click node_legacy_registration "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/register.py"
click node_legacy_student "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/student.py"
click node_legacy_admin "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/admin.py"
click node_legacy_components "https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/components.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_app_entry toneBlue
class node_login,node_registration,node_auth,node_user_data,node_database toneAmber
class node_student_ui,node_shared_ui,node_resource_workflow,node_rewards,node_ai_assistant toneMint
class node_admin_ui toneRose
class node_legacy_entry,node_legacy_login,node_legacy_registration,node_legacy_student,node_legacy_admin,node_legacy_components,node_student_actor,node_admin_actor toneIndigo
```

## Components

### App entry and routing

- [Application entry](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/main.py): `main.py`

### Accounts and persistence

- [Login screen](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/login.py): `app/ui/login.py`
- [Registration screen](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/register.py): `app/ui/register.py`
- [Account authentication](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/backend/auth.py): `app/backend/auth.py`
- [User operations](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/backend/users.py): `app/backend/users.py`
- [SQLite store](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/database/database.py): `app/database/database.py`

### Student learning

- [Student dashboard](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/student.py): `app/ui/student.py`
- [Shared UI components](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/components.py): `app/ui/components.py`
- [Resource sharing](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/student.py): `app/ui/student.py`
- [LearnPoints and rewards](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/student.py): `app/ui/student.py`
- [AI note assistant](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/student.py): `app/ui/student.py`

### Administration

- [Administrator dashboard](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/app/ui/admin.py): `app/ui/admin.py`

### Standalone UI prototype

- [Prototype entry](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/main.py): `LEARN2EARN_PROTOTYPE_UI/main.py`
- [Prototype login](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/login.py): `LEARN2EARN_PROTOTYPE_UI/login.py`
- [Prototype registration](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/register.py): `LEARN2EARN_PROTOTYPE_UI/register.py`
- [Prototype student UI](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/student.py): `LEARN2EARN_PROTOTYPE_UI/student.py`
- [Prototype admin UI](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/admin.py): `LEARN2EARN_PROTOTYPE_UI/admin.py`
- [Prototype components](https://github.com/prvisitacion-ayaa/cccs106-group06-showcase/blob/main/LEARN2EARN_PROTOTYPE_UI/components.py): `LEARN2EARN_PROTOTYPE_UI/components.py`

### Other components

- **Student**
- **Administrator**

## Connections

- Student → Application entry: opens (evidence: `README.md`)
- Administrator → Application entry: opens (evidence: `README.md`)
- Application entry → SQLite store: initializes tables (evidence: `main.py`)
- Application entry → Login screen: shows (evidence: `main.py`)
- Application entry → Registration screen: routes to (evidence: `main.py`)
- Application entry → Student dashboard: routes to (evidence: `main.py`)
- Application entry → Administrator dashboard: routes to (evidence: `main.py`)
- Login screen → Account authentication: calls login (evidence: `app/ui/login.py`)
- Registration screen → Account authentication: calls register (evidence: `app/ui/register.py`)
- Account authentication → SQLite store: reads and writes (evidence: `app/backend/auth.py`)
- User operations → SQLite store: reads and writes (evidence: `app/backend/users.py`)
- Student dashboard → Shared UI components: uses components (evidence: `app/ui/student.py`)
- Administrator dashboard → Shared UI components: uses components (evidence: `app/ui/admin.py`)
- Student → Resource sharing: shares and explores (evidence: `README.md`)
- Student → LearnPoints and rewards: views and redeems (evidence: `README.md`)
- Student → AI note assistant: uses (evidence: `README.md`)
- Administrator → Administrator dashboard: manages (evidence: `README.md`)
- Prototype entry → Prototype login: shows (evidence: `LEARN2EARN_PROTOTYPE_UI/main.py`)
- Prototype entry → Prototype registration: routes to (evidence: `LEARN2EARN_PROTOTYPE_UI/main.py`)
- Prototype entry → Prototype student UI: routes to (evidence: `LEARN2EARN_PROTOTYPE_UI/main.py`)
- Prototype entry → Prototype admin UI: routes to (evidence: `LEARN2EARN_PROTOTYPE_UI/main.py`)
- Prototype student UI → Prototype components: uses components (evidence: `LEARN2EARN_PROTOTYPE_UI/student.py`)
- Prototype admin UI → Prototype components: uses components (evidence: `LEARN2EARN_PROTOTYPE_UI/admin.py`)
