# mahialaraf/last-signal architecture

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

- Interactive diagram: https://gitdiagram.com/mahialaraf/last-signal
- Repository: https://github.com/mahialaraf/last-signal

## Overview

Last Signal is a Flask app for discovering abandoned spacecraft, reading level-tailored stories, viewing NASA imagery, and earning points through quizzes. The main web journey runs from profile setup or spacecraft search, through discovery and story delivery, to a quiz and progress updates; a question-based recommender offers another route to spacecraft. The repository also includes a terminal interface. Edges reflect shown imports, calls, or README descriptions; several route and frontend details are only documented, so unsampled implementation links are omitted.

Main entry points: [`app.py`](https://github.com/mahialaraf/last-signal/blob/main/app.py) (Flask routes), [`search_spacecraft.py`](https://github.com/mahialaraf/last-signal/blob/main/search_spacecraft.py) (Spacecraft search), [`Data.py`](https://github.com/mahialaraf/last-signal/blob/main/Data.py) (Spacecraft archive), [`chatbot.py`](https://github.com/mahialaraf/last-signal/blob/main/chatbot.py) (Story generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_browser["Web pages"]
  node_web_routes["Flask routes<br/>[app.py]"]
  node_story_client["Story loader<br/>[spacecraft.js]"]
  node_profile_client["Profile card<br/>[profile.js]"]
  node_presentation["Page presentation<br/>[base.html]"]
  node_icons["SVG icons<br/>[icons.py]"]
end

subgraph group_discovery["Discovery and stories"]
  node_spacecraft_search["Spacecraft search"]
  node_recommender["Question recommender<br/>[get_story.py]"]
  node_story_generation["Story generation<br/>[chatbot.py]"]
end

subgraph group_domain["Archive and progression"]
  node_spacecraft_data[("Spacecraft archive<br/>[Data.py]")]
  node_content_lookup["Content matching<br/>[Content_data.py]"]
  node_progress_tools["Levels and profiles<br/>[tools.py]"]
end

subgraph group_terminal["Terminal interface"]
  node_terminal_app["Terminal menu<br/>[main.py]"]
end

node_visitor(("Visitor"))
node_wikipedia["Wikipedia"]
node_nasa_library["NASA image library"]
node_nasa_missions["NASA mission pages"]
node_gemini["Google Gemini"]

node_visitor -->|"uses"| node_browser
node_browser -.->|"submits requests"| node_web_routes
node_web_routes -->|"uses search"| node_spacecraft_search
node_web_routes -->|"looks up content"| node_content_lookup
node_web_routes -->|"requests stories"| node_story_generation
node_web_routes -->|"manages profiles"| node_progress_tools
node_web_routes -->|"reads facts"| node_spacecraft_data
node_web_routes -->|"serves story data"| node_story_client
node_web_routes -->|"renders pages"| node_presentation
node_web_routes -->|"registers icons"| node_icons
node_browser -.->|"uses profile card"| node_profile_client
node_spacecraft_search -->|"generates story"| node_story_generation
node_spacecraft_search -->|"fetches details"| node_content_lookup
node_spacecraft_search -->|"reads archive"| node_spacecraft_data
node_spacecraft_search -->|"fetches summary"| node_wikipedia
node_spacecraft_search -->|"searches images"| node_nasa_library
node_spacecraft_search -->|"reads mission page"| node_nasa_missions
node_story_generation -->|"generates text"| node_gemini
node_story_generation -->|"uses story facts"| node_spacecraft_data
node_story_generation -->|"matches names"| node_content_lookup
node_content_lookup -->|"matches archive"| node_spacecraft_data
node_recommender -->|"selects matches"| node_content_lookup
node_recommender -->|"opens selection"| node_spacecraft_search
node_recommender -->|"scores tags"| node_spacecraft_data
node_terminal_app -->|"offers search"| node_spacecraft_search
node_terminal_app -->|"starts discovery"| node_recommender
node_terminal_app -->|"manages profiles"| node_progress_tools
node_progress_tools -->|"reads levels"| node_spacecraft_data

click node_browser "https://github.com/mahialaraf/last-signal/tree/main/templates"
click node_web_routes "https://github.com/mahialaraf/last-signal/blob/main/app.py"
click node_story_client "https://github.com/mahialaraf/last-signal/blob/main/static/js/spacecraft.js"
click node_profile_client "https://github.com/mahialaraf/last-signal/blob/main/static/js/profile.js"
click node_presentation "https://github.com/mahialaraf/last-signal/blob/main/templates/base.html"
click node_icons "https://github.com/mahialaraf/last-signal/blob/main/icons.py"
click node_spacecraft_search "https://github.com/mahialaraf/last-signal/blob/main/search_spacecraft.py"
click node_recommender "https://github.com/mahialaraf/last-signal/blob/main/get_story.py"
click node_story_generation "https://github.com/mahialaraf/last-signal/blob/main/chatbot.py"
click node_spacecraft_data "https://github.com/mahialaraf/last-signal/blob/main/Data.py"
click node_content_lookup "https://github.com/mahialaraf/last-signal/blob/main/Content_data.py"
click node_progress_tools "https://github.com/mahialaraf/last-signal/blob/main/tools.py"
click node_terminal_app "https://github.com/mahialaraf/last-signal/blob/main/main.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_browser,node_web_routes,node_story_client,node_profile_client,node_presentation,node_icons toneBlue
class node_spacecraft_search,node_recommender,node_story_generation toneAmber
class node_spacecraft_data,node_content_lookup,node_progress_tools toneMint
class node_terminal_app toneRose
class node_visitor,node_wikipedia,node_nasa_library,node_nasa_missions,node_gemini toneIndigo
```

## Components

### Web experience

- [Web pages](https://github.com/mahialaraf/last-signal/tree/main/templates): `templates`
- [Flask routes](https://github.com/mahialaraf/last-signal/blob/main/app.py): `app.py`
- [Story loader](https://github.com/mahialaraf/last-signal/blob/main/static/js/spacecraft.js): `static/js/spacecraft.js`
- [Profile card](https://github.com/mahialaraf/last-signal/blob/main/static/js/profile.js): `static/js/profile.js`
- [Page presentation](https://github.com/mahialaraf/last-signal/blob/main/templates/base.html): `templates/base.html`
- [SVG icons](https://github.com/mahialaraf/last-signal/blob/main/icons.py): `icons.py`

### Discovery and stories

- [Spacecraft search](https://github.com/mahialaraf/last-signal/blob/main/search_spacecraft.py): `search_spacecraft.py`
- [Question recommender](https://github.com/mahialaraf/last-signal/blob/main/get_story.py): `get_story.py`
- [Story generation](https://github.com/mahialaraf/last-signal/blob/main/chatbot.py): `chatbot.py`

### Archive and progression

- [Spacecraft archive](https://github.com/mahialaraf/last-signal/blob/main/Data.py): `Data.py`
- [Content matching](https://github.com/mahialaraf/last-signal/blob/main/Content_data.py): `Content_data.py`
- [Levels and profiles](https://github.com/mahialaraf/last-signal/blob/main/tools.py): `tools.py`

### Terminal interface

- [Terminal menu](https://github.com/mahialaraf/last-signal/blob/main/main.py): `main.py`

### Other components

- **Visitor**
- **Wikipedia**
- **NASA image library**
- **NASA mission pages**
- **Google Gemini**

## Connections

- Visitor → Web pages: uses (evidence: `README.md`)
- Web pages → Flask routes: submits requests (evidence: `README.md`)
- Flask routes → Spacecraft search: uses search (evidence: `app.py`)
- Flask routes → Content matching: looks up content (evidence: `app.py`)
- Flask routes → Story generation: requests stories (evidence: `app.py`)
- Flask routes → Levels and profiles: manages profiles (evidence: `app.py`)
- Flask routes → Spacecraft archive: reads facts (evidence: `app.py`)
- Flask routes → Story loader: serves story data (evidence: `README.md`)
- Flask routes → Page presentation: renders pages (evidence: `README.md`)
- Flask routes → SVG icons: registers icons (evidence: `app.py`)
- Web pages → Profile card: uses profile card (evidence: `README.md`)
- Spacecraft search → Story generation: generates story (evidence: `search_spacecraft.py`)
- Spacecraft search → Content matching: fetches details (evidence: `search_spacecraft.py`)
- Spacecraft search → Spacecraft archive: reads archive (evidence: `search_spacecraft.py`)
- Spacecraft search → Wikipedia: fetches summary (evidence: `search_spacecraft.py`)
- Spacecraft search → NASA image library: searches images (evidence: `search_spacecraft.py`)
- Spacecraft search → NASA mission pages: reads mission page (evidence: `search_spacecraft.py`)
- Story generation → Google Gemini: generates text (evidence: `README.md`)
- Story generation → Spacecraft archive: uses story facts (evidence: `chatbot.py`)
- Story generation → Content matching: matches names (evidence: `chatbot.py`)
- Content matching → Spacecraft archive: matches archive (evidence: `Content_data.py`)
- Question recommender → Content matching: selects matches (evidence: `get_story.py`)
- Question recommender → Spacecraft search: opens selection (evidence: `get_story.py`)
- Question recommender → Spacecraft archive: scores tags (evidence: `get_story.py`)
- Terminal menu → Spacecraft search: offers search (evidence: `main.py`)
- Terminal menu → Question recommender: starts discovery (evidence: `main.py`)
- Terminal menu → Levels and profiles: manages profiles (evidence: `main.py`)
- Levels and profiles → Spacecraft archive: reads levels (evidence: `tools.py`)
