How roicgovz/tobeton_backend works
TobeTon is a study-companion REST backend. Users authenticate and organize folders/cards, study flashcards or quizzes, and receive saved progress and statistics; AI features generate learning material, summaries, suggestions, and retrieval-grounded chat. The graph separates API dispatch, domain handlers, AI/RAG processing, and persistent state. README capabilities are retained even where implementation was not excerpted; those edges are documented or marked unverified rather than inferred from module names.
Main entry points: server.js Express server · database.js SQLite database · retrieve.js Chunk retrieval · authMiddleware.js JWT verification
Components 32
API entry
- Express server
server.js - Auth routes
routes/auth.js - User routes
routes/users.js - Folder routes
routes/folder.js - Card routes
routes/cards.js - Flashcard routes
routes/flashcards.js - Quiz routes
routes/quiz.js - Statistics routes
routes/statisticsRoutes.js - JWT verification
middleware/authMiddleware.js
Study management
- Folder management
controllers/folderController.js - Card management
controllers/cardsController.js - Flashcard study
controllers/flashcardsController.js - Card persistence
services/cardService.js - Quiz workflow
controllers/quizzesController.js - Quiz persistence
services/quizSaveService.js
AI learning tools
- Flashcard generation
controllers/flashcardsGenerator.js - Quiz generation
controllers/quizGenerator.js - Summarization
controllers/summaryController.js - RAG chatbot
controllers/chatbotController.js - Chat response
services/chatbotService.js - Study suggestions
controllers/studySuggestionsController.js
Progress and identity
- Authentication
controllers/authController.js - Achievements
controllers/achievementController.js - Study statistics
controllers/statisticsController.js - SQLite database
db/database.js
Retrieval pipeline
- Notes ingestion
rag/ingestTXT.js - Text embeddings
rag/embed.js - Vector store
rag/vectorStore.js - Chunk retrieval
rag/retrieve.js - Context assembly
services/ragService.js
Other components
- Client
- Local AI models
Connections 48
- Client → Express server: sends requests
server.js - Express server → Auth routes: mounts auth
server.js - Express server → User routes: mounts users
server.js - Express server → Folder routes: mounts folders
server.js - Express server → Card routes: mounts cards
server.js - Express server → Flashcard routes: mounts flashcards
server.js - Express server → Quiz routes: mounts quizzes
server.js - Express server → Statistics routes: mounts statistics
server.js - Express server → RAG chatbot: mounts chatbot
server.js - Express server → Flashcard generation: mounts generator
server.js - Express server → Summarization: mounts summary
server.js - Express server → Study suggestions: mounts suggestions
server.js - Express server → Quiz generation: mounts generator
server.js - Express server → Notes ingestion: ingests notes
server.js - Auth routes → Authentication: dispatches
routes/auth.js - User routes → Authentication: dispatches
routes/users.js - Folder routes → JWT verification: checks token
routes/folder.js - Folder routes → Folder management: dispatches
routes/folder.js - Card routes → JWT verification: checks token
routes/cards.js - Card routes → Card management: dispatches
routes/cards.js - Flashcard routes → JWT verification: checks token
routes/flashcards.js - Flashcard routes → Flashcard study: dispatches
routes/flashcards.js - Quiz routes → JWT verification: checks token
routes/quiz.js - Quiz routes → Quiz workflow: dispatches
routes/quiz.js - Statistics routes → JWT verification: checks token
routes/statisticsRoutes.js - Statistics routes → Study statistics: dispatches
routes/statisticsRoutes.js - Authentication → SQLite database: reads and writes
controllers/authController.js - Folder management → SQLite database: reads and writes
controllers/folderController.js - Card management → SQLite database: reads and writes
controllers/cardsController.js - Flashcard study → SQLite database: reads and writes
controllers/flashcardsController.js - Flashcard study → Card persistence: saves cards
controllers/flashcardsController.js - Card persistence → SQLite database: writes cards
services/cardService.js - Quiz workflow → SQLite database: reads and writes
controllers/quizzesController.js - Quiz workflow → Quiz persistence: saves generated quizzes
controllers/quizzesController.js - Quiz persistence → SQLite database: writes quizzes
services/quizSaveService.js - Study statistics → SQLite database: reads and updates
controllers/statisticsController.js - Achievements → SQLite database: reads achievement data
controllers/achievementController.js - Notes ingestion → Text embeddings: embeds chunks
rag/ingestTXT.js - Notes ingestion → Vector store: stores vectors
rag/ingestTXT.js - Chunk retrieval → Text embeddings: embeds query
rag/retrieve.js - Chunk retrieval → Vector store: ranks chunks
rag/retrieve.js - RAG chatbot → Context assembly: gets context
controllers/chatbotController.js - Context assembly → Chunk retrieval: retrieves chunks
services/ragService.js - RAG chatbot → Chat response: generates reply
controllers/chatbotController.js - Flashcard generation → Chunk retrieval: uses note context
controllers/flashcardsGenerator.js - Quiz generation → Chunk retrieval: uses note context
controllers/quizGenerator.js - Summarization → Context assembly: uses context
- Study suggestions → SQLite database: personalizes suggestions