How aestheticsuraj234/chaibook-llm-build works
This appears to be a workspace-based knowledge assistant: users manage workspaces and add text, PDF, website, or YouTube sources, then chat using retrieved workspace context. The server separates HTTP controllers, domain services, persistence, and AI/source-processing integrations. The excerpts show source and workspace routing and chat orchestration; the README is empty, and the client page and several integrations were not sampled, so client-to-API wiring and some internal event flows are not asserted.
Main entry points: source.services.ts Source Services · chat.services.ts Chat Services · source-processing.services.ts Source Processing · workspace.services.ts Workspace Services
Components 25
Client
- Web App
client/app/page.tsx - App Layout
client/app/layout.tsx
Workspace Management
- Workspace Routes
server/src/routes/workspace.routes.ts - Workspace Controller
server/src/controllers/workspace.controller.ts - Workspace Services
server/src/services/workspace.services.ts
Knowledge Sources
- Source Routes
server/src/routes/source.routes.ts - Source Controller
server/src/controllers/source.controller.ts - Source Services
server/src/services/source.services.ts - Source Processing
server/src/services/source-processing.services.ts - Text Chunking
server/src/lib/chunking.ts - PDF Handling
server/src/lib/pdf.ts - Website Import
server/src/lib/firecrawl.ts - YouTube Import
server/src/lib/youtube.ts
Chat and Retrieval
- Chat Services
server/src/services/chat.services.ts - RAG Retrieval
server/src/lib/rag/retrieve.ts
Persistence and Integrations
- Workspace Repository
server/src/repository/workspace.repository.ts - Source Repository
server/src/repository/source.repository.ts - File Storage
server/src/lib/cloudinary.ts - Vector Index
server/src/lib/pinecone.ts - Conversation Repository
server/src/repository/conversation.repository.ts - Message Repository
server/src/repository/message.repository.ts - OpenAI Models
server/src/lib/openai.ts - Web Search
server/src/lib/tavily.ts - Conversation Events
server/src/lib/conversation-events.ts
Other components
- User
Connections 27
- User → Web App: uses
- Web App → App Layout: renders within
- Workspace Routes → Workspace Controller: routes to
server/src/routes/workspace.routes.ts - Workspace Controller → Workspace Services: calls
server/src/controllers/workspace.controller.ts - Workspace Services → Workspace Repository: reads and writes
server/src/services/workspace.services.ts - Workspace Services → Vector Index: deletes vectors
server/src/services/workspace.services.ts - Source Routes → Source Controller: routes to
server/src/routes/source.routes.ts - Source Controller → Source Services: calls
server/src/controllers/source.controller.ts - Source Services → Source Repository: reads and writes
server/src/services/source.services.ts - Source Services → Workspace Services: checks workspace
server/src/services/source.services.ts - Source Services → PDF Handling: handles PDFs
server/src/services/source.services.ts - Source Services → Website Import: imports websites
server/src/services/source.services.ts - Source Services → YouTube Import: imports videos
server/src/services/source.services.ts - Source Services → File Storage: stores files
server/src/services/source.services.ts - Source Services → Source Processing: starts processing
- Source Processing → Text Chunking: splits text
server/src/services/source-processing.services.ts - Source Processing → PDF Handling: extracts text
server/src/services/source-processing.services.ts - Source Processing → OpenAI Models: embeds chunks
server/src/services/source-processing.services.ts - Source Processing → Vector Index: indexes chunks
server/src/services/source-processing.services.ts - Chat Services → Workspace Services: checks workspace
server/src/services/chat.services.ts - Chat Services → RAG Retrieval: retrieves context
server/src/services/chat.services.ts - RAG Retrieval → Vector Index: searches vectors
server/src/lib/rag/retrieve.ts - Chat Services → Conversation Repository: manages conversations
server/src/services/chat.services.ts - Chat Services → Message Repository: persists messages
server/src/services/chat.services.ts - Chat Services → Web Search: searches web
server/src/services/chat.services.ts - Chat Services → OpenAI Models: streams responses
- Chat Services → Conversation Events: queues summaries
server/src/services/chat.services.ts