How itemka/nodejs-backend-mastery works
This is a Node.js learning monorepo: runnable applications and AI-engineering examples demonstrate backend patterns, alongside shared libraries. Users interact through web apps or CLIs; the examples then invoke their domain services and produce pages, streamed answers, search results, or evaluation reports. The graph emphasizes active apps and documented examples, with an internal implementation layer where source evidence supports it. Several README-listed capabilities have no sampled implementation excerpts, so their nodes are linked only where documentation or the source index supports the relationship.
Main entry points: main.ts LLM Chat CLI · app.ts Playground API · retriever.ts Hybrid Retriever · provider-factory.ts Provider-Neutral LLM Client
Components 33
Runnable Apps
- Shop MVC
workspaces/apps/shop-mvc-express/src/app.ts - Shop Routes
workspaces/apps/shop-mvc-express/src/routes/index.ts - Product Routes
workspaces/apps/shop-mvc-express/src/routes/shop/products.routes.ts - Product Controller
workspaces/apps/shop-mvc-express/src/controllers/products.controller.ts - Product Views
workspaces/apps/shop-mvc-express/src/views/products/productsPage.ts - Playground UI
workspaces/apps/local-llm-playground/client/src/App.tsx - Playground API
workspaces/apps/local-llm-playground/backend/src/app.ts - Chat Endpoint
workspaces/apps/local-llm-playground/backend/src/routes/chat-router.ts - Compare Endpoint
workspaces/apps/local-llm-playground/backend/src/routes/compare-router.ts - Checker Endpoint
workspaces/apps/local-llm-playground/backend/src/routes/llm-checker-router.ts
AI Examples
- LLM Chat CLI
workspaces/ai-engineering/llm-chat/src/main.ts - Chat Service
workspaces/ai-engineering/llm-chat/src/chat/service.ts - RAG Search Client
workspaces/ai-engineering/llm-chat/src/tools/search-docs-client.ts - RAG Service
workspaces/ai-engineering/rag-pipeline/src/app.ts - Document Ingest
workspaces/ai-engineering/rag-pipeline/src/routes/ingest-router.ts - Search Endpoint
workspaces/ai-engineering/rag-pipeline/src/routes/search-router.ts - Embedding Provider
workspaces/ai-engineering/rag-pipeline/src/embeddings/embedding-provider.ts - MCP Chat CLI
workspaces/ai-engineering/mcp-chat/src/cli/main.ts - MCP Tool Manager
workspaces/ai-engineering/mcp-chat/src/chat/mcp-tool-manager.ts - MCP Client
workspaces/ai-engineering/mcp-chat/src/client/mcp-client.ts - Document MCP Server
workspaces/ai-engineering/mcp-chat/src/server/document-mcp-server.ts - Claude Scenarios
workspaces/ai-engineering/claude-capabilities-lab/src/main.ts - Scenario Arguments
workspaces/ai-engineering/claude-capabilities-lab/src/cli/args.ts - Prompt Evaluation CLI
workspaces/ai-engineering/prompt-eval-lab/src/cli/run-eval.ts
Shared Libraries
- Provider-Neutral LLM Client
workspaces/packages/llm-client/src/provider-factory.ts - CLI Output Theme
workspaces/packages/cli-output/index.js
Domain Internals
- In-Memory Products
workspaces/apps/shop-mvc-express/src/controllers/products.controller.ts - Model Service
workspaces/apps/local-llm-playground/backend/src/services/model-service.ts - Checker Service
workspaces/apps/local-llm-playground/backend/src/services/llm-checker-service.ts - Hybrid Retriever
workspaces/ai-engineering/rag-pipeline/src/retrieval/retriever.ts - Search Indexes
workspaces/ai-engineering/rag-pipeline/src/indexes/in-memory-vector-index.ts
Other components
- Browser User
- Ollama Runtime
Connections 35
- Browser User → Shop MVC: submits requests
README.md - Shop MVC → Shop Routes: mounts routes
workspaces/apps/shop-mvc-express/src/app.ts - Shop Routes → Product Routes: routes products
workspaces/apps/shop-mvc-express/src/routes/shop/products.routes.ts - Product Routes → Product Controller: calls handlers
workspaces/apps/shop-mvc-express/src/routes/shop/products.routes.ts - Product Controller → In-Memory Products: reads and writes
workspaces/apps/shop-mvc-express/src/controllers/products.controller.ts - Product Controller → Product Views: renders pages
workspaces/apps/shop-mvc-express/src/controllers/products.controller.ts - Browser User → Playground UI: uses playground
README.md - Playground UI → Playground API: calls API
workspaces/apps/local-llm-playground/client/src/App.tsx - Playground API → Chat Endpoint: mounts endpoints
workspaces/apps/local-llm-playground/backend/src/app.ts - Playground API → Compare Endpoint: mounts endpoints
workspaces/apps/local-llm-playground/backend/src/app.ts - Playground API → Checker Endpoint: mounts endpoints
workspaces/apps/local-llm-playground/backend/src/app.ts - Playground API → Model Service: configures service
workspaces/apps/local-llm-playground/backend/src/app.ts - Checker Endpoint → Checker Service: runs checks
workspaces/apps/local-llm-playground/backend/src/routes/llm-checker-router.ts - Checker Service → Ollama Runtime: checks runtime
- LLM Chat CLI → Chat Service: creates service
workspaces/ai-engineering/llm-chat/src/main.ts - LLM Chat CLI → RAG Search Client: configures search
workspaces/ai-engineering/llm-chat/src/main.ts - LLM Chat CLI → Provider-Neutral LLM Client: creates provider
workspaces/ai-engineering/llm-chat/src/main.ts - LLM Chat CLI → Search Endpoint: searches remotely
- RAG Service → Document Ingest: mounts endpoint
workspaces/ai-engineering/rag-pipeline/src/app.ts - RAG Service → Search Endpoint: mounts endpoint
workspaces/ai-engineering/rag-pipeline/src/app.ts - RAG Service → Hybrid Retriever: configures indexes
workspaces/ai-engineering/rag-pipeline/src/app.ts - Document Ingest → Hybrid Retriever: ingests chunks
workspaces/ai-engineering/rag-pipeline/src/routes/ingest-router.ts - Search Endpoint → Hybrid Retriever: retrieves matches
- Hybrid Retriever → Search Indexes: queries indexes
- Hybrid Retriever → Embedding Provider: creates embeddings
- MCP Chat CLI → MCP Client: connects server
workspaces/ai-engineering/mcp-chat/src/cli/main.ts - MCP Chat CLI → MCP Tool Manager: registers tools
workspaces/ai-engineering/mcp-chat/src/cli/main.ts - MCP Chat CLI → Provider-Neutral LLM Client: creates provider
workspaces/ai-engineering/mcp-chat/src/cli/main.ts - MCP Tool Manager → MCP Client: calls tools
workspaces/ai-engineering/mcp-chat/src/chat/mcp-tool-manager.ts - MCP Client → Document MCP Server: connects over stdio
- Claude Scenarios → Scenario Arguments: parses flags
workspaces/ai-engineering/claude-capabilities-lab/src/main.ts - Claude Scenarios → Provider-Neutral LLM Client: uses provider
- Prompt Evaluation CLI → Provider-Neutral LLM Client: evaluates prompts
- LLM Chat CLI → CLI Output Theme: formats output
- Claude Scenarios → CLI Output Theme: formats output