How mahialaraf/last-signal works
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 Flask routes · search_spacecraft.py Spacecraft search · Data.py Spacecraft archive · chatbot.py Story generation
Components 18
Web experience
- Web pages
templates - Flask routes
app.py - Story loader
static/js/spacecraft.js - Profile card
static/js/profile.js - Page presentation
templates/base.html - SVG icons
icons.py
Discovery and stories
- Spacecraft search
search_spacecraft.py - Question recommender
get_story.py - Story generation
chatbot.py
Archive and progression
- Spacecraft archive
Data.py - Content matching
Content_data.py - Levels and profiles
tools.py
Terminal interface
- Terminal menu
main.py
Other components
- Visitor
- Wikipedia
- NASA image library
- NASA mission pages
- Google Gemini
Connections 28
- Visitor → Web pages: uses
README.md - Web pages → Flask routes: submits requests
README.md - Flask routes → Spacecraft search: uses search
app.py - Flask routes → Content matching: looks up content
app.py - Flask routes → Story generation: requests stories
app.py - Flask routes → Levels and profiles: manages profiles
app.py - Flask routes → Spacecraft archive: reads facts
app.py - Flask routes → Story loader: serves story data
README.md - Flask routes → Page presentation: renders pages
README.md - Flask routes → SVG icons: registers icons
app.py - Web pages → Profile card: uses profile card
README.md - Spacecraft search → Story generation: generates story
search_spacecraft.py - Spacecraft search → Content matching: fetches details
search_spacecraft.py - Spacecraft search → Spacecraft archive: reads archive
search_spacecraft.py - Spacecraft search → Wikipedia: fetches summary
search_spacecraft.py - Spacecraft search → NASA image library: searches images
search_spacecraft.py - Spacecraft search → NASA mission pages: reads mission page
search_spacecraft.py - Story generation → Google Gemini: generates text
README.md - Story generation → Spacecraft archive: uses story facts
chatbot.py - Story generation → Content matching: matches names
chatbot.py - Content matching → Spacecraft archive: matches archive
Content_data.py - Question recommender → Content matching: selects matches
get_story.py - Question recommender → Spacecraft search: opens selection
get_story.py - Question recommender → Spacecraft archive: scores tags
get_story.py - Terminal menu → Spacecraft search: offers search
main.py - Terminal menu → Question recommender: starts discovery
main.py - Terminal menu → Levels and profiles: manages profiles
main.py - Levels and profiles → Spacecraft archive: reads levels
tools.py