How datle04/know-vault works
KnowVault turns saved technical articles into reviewable knowledge: users save from the browser extension or web app, the API stores and processes articles, and users revisit generated questions and concept connections. The README documents the processing stages; sampled source confirms extension save messaging, authentication, embedding persistence, and the review flow. Other processing, search, and concept features are represented only where supported by the README and tree; their internal wiring was not sampled.
Main entry points: ai.module.ts AI providers · app Web dashboard · article-processor.service.ts Article processor · reviews.service.ts Review workflow
Components 24
User clients
- Web dashboard
apps/web/src/app - Extension popup
apps/extension/src/popup/App.tsx - Extension worker
apps/extension/src/background/service-worker.ts - Page extraction
apps/extension/src/content/content-script.ts
API workflows
- Authentication
apps/api/src/modules/auth/auth.service.ts - Article endpoints
apps/api/src/modules/articles/articles.controller.ts - Quick-save endpoints
apps/api/src/modules/extension/extension.controller.ts - Article workflow
apps/api/src/modules/articles/articles.service.ts - Concept connections
apps/api/src/modules/concepts/concepts.service.ts - Review endpoints
apps/api/src/modules/reviews/reviews.controller.ts - Review workflow
apps/api/src/modules/reviews/reviews.service.ts
Knowledge processing
- Article processor
apps/api/src/modules/articles/article-processor.service.ts - Content and concepts
apps/api/src/modules/ai/prompt-templates/extract-concept.v1.ts - Question generation
apps/api/src/modules/ai/prompt-templates/generate-questions.v1.ts - Concept embeddings
apps/api/src/modules/concepts/concept-embedding.service.ts - Semantic search
apps/api/src/modules/concepts - Answer evaluation
apps/api/src/modules/reviews/answer-evaluation.service.ts - AI providers
apps/api/src/modules/ai/providers/ai.module.ts
Domain and persistence
- SM-2 scheduling
apps/api/src/domain/review/sm2.service.ts - Prisma repositories
apps/api/src/infrastructure/persistence - PostgreSQL
apps/api/src/infrastructure/persistence/prisma.service.ts - AI usage log
apps/api/src/modules/concepts/concept-embedding.service.ts
Other components
- Learner
- AI services
Connections 32
- Learner → Web dashboard: uses
- Learner → Extension popup: saves and reviews
- Extension popup → Authentication: logs in
- Extension popup → Extension worker: sends messages
- Extension worker → Page extraction: extracts page
- Extension worker → Quick-save endpoints: checks and saves
- Web dashboard → Authentication: authenticates
- Web dashboard → Article endpoints: manages articles
- Web dashboard → Review endpoints: reviews knowledge
- Web dashboard → Concept connections: explores concepts
- Article endpoints → Article workflow: dispatches
- Quick-save endpoints → Article workflow: dispatches
- Article workflow → Prisma repositories: stores article
- Article workflow → Article processor: starts processing
- Article processor → Content and concepts: extracts concepts
- Article processor → Question generation: generates questions
- Article processor → Concept embeddings: embeds concepts
- Article processor → AI providers: requests generation
- Content and concepts → AI providers: requests extraction
- Question generation → AI providers: requests generation
- Concept embeddings → AI providers: requests vectors
- Concept embeddings → PostgreSQL: writes vectors
- Concept embeddings → AI usage log: records usage
- Concept connections → Prisma repositories: reads and writes
- Semantic search → PostgreSQL: searches content
- Review endpoints → Review workflow: dispatches
- Review workflow → Prisma repositories: loads and saves reviews
- Review workflow → Answer evaluation: evaluates answers
- Review workflow → SM-2 scheduling: records attempt
- Answer evaluation → AI providers: requests grading
- AI providers → AI services: calls providers
- Prisma repositories → PostgreSQL: reads and writes