How jack26-bit/iko works
IKO is documented as a Flutter productivity RPG backed by a FastAPI service. The principal evidenced workflow is a client request reaching the API, resolving a user and database session, then creating or completing a quest; completion awards XP and coins and updates the user’s streak. The supplied tree contains no Flutter/Dart application sources, so the client is shown only as an external actor. Other README capabilities are represented as documented product scope, not as verified implementations. Evidence is limited to the README and excerpted backend files.
Main entry points: quests.py Quest endpoints · database.py SQLAlchemy database · users.py User endpoints · main.py FastAPI application
Components 13
API runtime
- FastAPI application
backend/main.py
User and identity
- User endpoints
backend/api/endpoints/users.py - Password auth
backend/services/auth.py - Current user dependency
backend/api/deps.py - User schemas
backend/schemas/user.py
Quest progression
- Quest endpoints
backend/api/endpoints/quests.py - Quest schemas
backend/schemas/quest.py - XP and streak engine
backend/services/rpg_engine.py - Other documented game features
backend
Domain state
- User model
backend/models/user.py - Quest model
backend/models/quest.py - SQLAlchemy database
backend/database/database.py
Other components
- Mobile app user
Connections 21
- Mobile app user → FastAPI application: sends requests
- FastAPI application → User endpoints: registers routes
backend/main.py - FastAPI application → Quest endpoints: registers routes
backend/main.py - FastAPI application → SQLAlchemy database: initializes schema
backend/main.py - User endpoints → Password auth: hashes credentials
backend/api/endpoints/users.py - User endpoints → Current user dependency: resolves profile
backend/api/endpoints/users.py - User endpoints → User schemas: validates responses
backend/api/endpoints/users.py - User endpoints → SQLAlchemy database: queries and updates
backend/api/endpoints/users.py - Current user dependency → SQLAlchemy database: opens session
backend/api/deps.py - Current user dependency → User model: loads user
backend/api/deps.py - Quest endpoints → Current user dependency: resolves user
backend/api/endpoints/quests.py - Quest endpoints → Quest schemas: validates payloads
backend/api/endpoints/quests.py - Quest endpoints → Quest model: queries and writes
backend/api/endpoints/quests.py - Quest endpoints → User model: updates user
backend/api/endpoints/quests.py - Quest endpoints → XP and streak engine: awards progression
backend/api/endpoints/quests.py - Quest endpoints → SQLAlchemy database: uses session
backend/api/endpoints/quests.py - XP and streak engine → User model: changes RPG state
backend/services/rpg_engine.py - XP and streak engine → SQLAlchemy database: commits updates
backend/services/rpg_engine.py - Quest model → SQLAlchemy database: uses ORM base
backend/models/quest.py - User model → SQLAlchemy database: uses ORM base
backend/models/user.py - Quest schemas → Quest model: uses difficulty type
backend/schemas/quest.py