How kajmus/zaquj.to works
ZaQuj.to is a learning app with a working flashcard path and a simple home/session flow; the home screen also advertises quizzes, which are disabled. The backend serves flashcards by listing, topic, or ID, retrieves question records, and maps them to response schemas. The frontend has routes for home, flashcards, and a demo page. The excerpts do not show the flashcard page’s network calls, so the frontend-to-backend connection is marked unverified; the README is empty.
Main entry points: App.tsx App router · flashcards.py Flashcard endpoints · api.py API router · FlashcardsPage.tsx Flashcards page
Components 31
Frontend
- App router
frontend/src/app/App.tsx - Home and session
frontend/src/features/home/HomePage.tsx - Flashcards page
frontend/src/features/flashcards/FlashcardsPage.tsx - Flashcard view
frontend/src/features/flashcards/Flashcard.tsx - Text fitting
frontend/src/features/flashcards/fit-text.ts - Session storage
frontend/src/lib/session.ts
Backend API
- FastAPI app
backend/app/main.py - API router
backend/app/api/v1/api.py - Flashcard endpoints
backend/app/api/v1/endpoints/flashcards.py - Question endpoints
backend/app/api/v1/endpoints/questions.py - User endpoints
backend/app/api/v1/endpoints/users.py - DB dependency
backend/app/dependencies.py
Questions and data
- Question retrieval
backend/app/crud/abcd_question.py - Flashcard mapping
backend/app/services/flashcard_service.py - Flashcard schemas
backend/app/schemas/flashcards.py - ABCD question
backend/app/models/abcd_question.py - Topic model
backend/app/models/topic.py - Category access
backend/app/crud/category.py - Category model
backend/app/models/category.py - User access
backend/app/crud/user.py - User model
backend/app/models/user.py - Question results
backend/app/models/result.py - Database sessions
backend/app/core/database.py
Demo state
- Dummy page
frontend/src/features/dummy/DummyPage.tsx - State demo
frontend/src/features/state-demo/StateDemo.tsx - Counter provider
frontend/src/features/state-demo/CounterContext.tsx - Counter context
frontend/src/features/state-demo/counter-context.ts - Counter hook
frontend/src/features/state-demo/use-counter.ts - Cookie helper
frontend/src/lib/cookies.ts
Other components
- Learner
- SQL database
Connections 30
- Learner → App router: uses
frontend/src/app/App.tsx - App router → Home and session: routes to
frontend/src/app/App.tsx - App router → Flashcards page: routes to
frontend/src/app/App.tsx - App router → Dummy page: routes to
frontend/src/app/App.tsx - App router → Counter provider: wraps routes
frontend/src/app/App.tsx - Home and session → Session storage: reads and starts
frontend/src/features/home/HomePage.tsx - Flashcards page → Flashcard view: renders
frontend/src/features/flashcards/FlashcardsPage.tsx - Flashcard view → Text fitting: uses
frontend/src/features/flashcards/Flashcard.tsx - Flashcards page → Flashcard endpoints: requests cards
- FastAPI app → API router: mounts
backend/app/main.py - API router → Flashcard endpoints: registers
backend/app/api/v1/api.py - API router → Question endpoints: registers
backend/app/api/v1/api.py - API router → User endpoints: registers
backend/app/api/v1/api.py - Flashcard endpoints → DB dependency: injects session
backend/app/api/v1/endpoints/flashcards.py - DB dependency → Database sessions: gets session
backend/app/dependencies.py - Flashcard endpoints → Question retrieval: retrieves questions
backend/app/api/v1/endpoints/flashcards.py - Flashcard endpoints → Flashcard mapping: maps questions
backend/app/api/v1/endpoints/flashcards.py - Question retrieval → ABCD question: queries
backend/app/crud/abcd_question.py - Flashcard mapping → ABCD question: reads fields
backend/app/services/flashcard_service.py - Flashcard mapping → Flashcard schemas: builds responses
backend/app/services/flashcard_service.py - Flashcard schemas → ABCD question: types from
backend/app/schemas/flashcards.py - Database sessions → SQL database: connects
backend/app/core/database.py - Category access → Category model: queries
backend/app/crud/category.py - Category access → Topic model: queries
backend/app/crud/category.py - User access → User model: queries
backend/app/crud/user.py - Dummy page → State demo: renders
frontend/src/features/dummy/DummyPage.tsx - State demo → Counter hook: uses
frontend/src/features/state-demo/StateDemo.tsx - State demo → Cookie helper: uses
frontend/src/features/state-demo/StateDemo.tsx - Counter provider → Counter context: provides value
frontend/src/features/state-demo/CounterContext.tsx - Counter hook → Counter context: reads
frontend/src/features/state-demo/use-counter.ts