How robungid/stashify works
Stashify is an async Telegram knowledge-resource manager. Users register and browse, search, view, rate, and favorite learning resources; administrators and managers maintain resources, categories, quizzes, and users. The shown search path runs from a Telegram update through the registered bot router, resource service, repository abstraction, and SQL-backed persistence. The README documents additional capabilities, but unsampled routers and providers limit verification of their internal call paths; those branches are represented without asserting unshown calls.
Main entry points: main.py Bot runtime · services/resource_item.py Resource service · sql/resource_item.py Resource SQL repository · search_resource.py Resource search
Components 21
Telegram interaction
- Bot runtime
app/main.py - Resource search
app/application/routers/search_resource.py - Resource browsing
app/application/routers/resources.py - Resource management
app/application/routers/manage_resources.py - Category management
app/application/routers/manage_categories.py - Quiz management
app/application/routers/manage_quizes.py - User management
app/application/routers/manage_users.py - Main menu
app/application/routers/menu.py
Resource and quiz domain
- Resource entities
app/domain/entities/resource_item.py - Category entities
app/domain/entities/category_item.py - Quiz entities
app/domain/entities/quiz_question.py - Repository contracts
app/domain/repositories/resource_item.py
Application services
- Resource service
app/application/services/resource_item.py - Service providers
app/application/containers/providers/services.py
SQL persistence
- Resource SQL repository
app/infrastructure/repositories/sql/resource_item.py - Resource mapper
app/infrastructure/mappers/resource_item.py - Resource table model
app/infrastructure/models/resource_item.py - Category SQL repository
app/infrastructure/repositories/sql/category_item.py - Database setup
app/database/init.py
Other components
- Telegram user
- PostgreSQL
Connections 23
- Telegram user → Bot runtime: sends updates
- Bot runtime → Resource search: registers router
app/main.py - Bot runtime → Resource browsing: registers router
app/main.py - Bot runtime → Resource management: registers router
app/main.py - Bot runtime → Category management: registers router
app/main.py - Bot runtime → Quiz management: registers router
app/main.py - Bot runtime → User management: registers router
app/main.py - Bot runtime → Main menu: registers router
app/main.py - Resource search → Resource service: queries resources
app/application/routers/search_resource.py - Resource service → Repository contracts: uses contract
app/application/services/resource_item.py - Service providers → Resource service: provides service
app/application/containers/providers/services.py - Resource SQL repository → Repository contracts: implements contract
app/infrastructure/repositories/sql/resource_item.py - Resource SQL repository → Resource mapper: maps records
app/infrastructure/repositories/sql/resource_item.py - Resource mapper → Resource table model: converts model
app/infrastructure/mappers/resource_item.py - Category SQL repository → Category entities: maps categories
app/infrastructure/repositories/sql/category_item.py - Bot runtime → Database setup: initializes models
app/main.py - Database setup → PostgreSQL: uses database
- Resource browsing → Resource service: queries resources
- Resource management → Resource service: manages resources
app/application/routers/manage_resources.py - Category management → Category SQL repository: persists categories
- Quiz management → Quiz entities: manages quizzes
- User management → Bot runtime: administers users
app/main.py - Resource table model → PostgreSQL: stored in