How konetipraneethkumar/unified-knowledge-hub works
This is a personal knowledge-management and search product: users connect sources, manage indexed knowledge, and search it; accounts and device pairing support access and source management. The backend exposes authentication, connector, device, knowledge-item, search, and agent APIs, with hybrid retrieval and vector storage as internal layers. The React frontend presents chat and workspace views, but the sampled chat uses a local mock search service rather than the backend API. Backend ingestion details and several API implementations were not sampled, so uncertain connections are omitted or marked unverified.
Main entry points: main.py FastAPI app · knowledge_items.py Knowledge service · router.tsx Page router · search.py Search API
Components 27
Web application
- Web app
frontend/src/app/App.tsx - Page router
frontend/src/app/router.tsx - App layout
frontend/src/app/layouts/AppLayout.tsx - Search chat
frontend/src/features/chat/components/ChatPage.tsx - Chat window
frontend/src/features/chat/components/ChatWindow.tsx - Mock search
frontend/src/features/chat/services/mockSearchService.ts - Demo knowledge
frontend/src/features/chat/data/mockKnowledge.ts - Workspace pages
frontend/src/features/workspace/WorkspacePages.tsx
Backend API
- FastAPI app
backend/app/main.py - Authentication API
backend/app/api/auth.py - Connector API
backend/app/api/connectors.py - Device API
backend/app/api/devices.py - Knowledge API
backend/app/api/knowledge_items.py - Search API
backend/app/api/search.py - Agent API
backend/app/api/agent.py - Agent orchestrator
backend/app/agents/orchestrator.py - Agent tools
backend/app/agents/tools.py
Knowledge and retrieval
- Knowledge service
backend/app/services/knowledge_items.py - Hybrid retrieval
backend/app/retrieval/hybrid.py - Embedding service
backend/app/services/embeddings.py - Vector storage
backend/app/services/vector_storage.py - Document extraction
backend/app/services/document_extraction.py - Local file connector
backend/app/services/local_filesystem.py
Identity and persistence
- Session security
backend/app/core/security.py - Database sessions
backend/app/core/database.py - Domain models
backend/app/models/models.py
Other components
- User
Connections 32
- User → Web app: uses
- Web app → Page router: loads
frontend/src/app/App.tsx - Page router → App layout: renders
frontend/src/app/router.tsx - Page router → Search chat: routes to
frontend/src/app/router.tsx - Page router → Workspace pages: routes to
frontend/src/app/router.tsx - Search chat → Chat window: renders
frontend/src/features/chat/components/ChatPage.tsx - Search chat → Mock search: calls
frontend/src/features/chat/components/ChatPage.tsx - Mock search → Demo knowledge: searches
frontend/src/features/chat/services/mockSearchService.ts - FastAPI app → Authentication API: registers
backend/app/main.py - FastAPI app → Connector API: registers
backend/app/main.py - FastAPI app → Device API: registers
backend/app/main.py - FastAPI app → Knowledge API: registers
backend/app/main.py - FastAPI app → Search API: registers
backend/app/main.py - FastAPI app → Agent API: registers
backend/app/main.py - Search API → Hybrid retrieval: calls
backend/app/api/search.py - Search API → Knowledge service: calls
backend/app/api/search.py - Search API → Embedding service: uses
backend/app/api/search.py - Hybrid retrieval → Knowledge service: uses
backend/app/retrieval/hybrid.py - Hybrid retrieval → Embedding service: uses
backend/app/retrieval/hybrid.py - Hybrid retrieval → Vector storage: uses
backend/app/retrieval/hybrid.py - Knowledge API → Knowledge service: calls
backend/app/api/knowledge_items.py - Agent API → Agent orchestrator: calls
backend/app/api/agent.py - Agent API → Agent tools: uses
backend/app/api/agent.py - Authentication API → Session security: authenticates
backend/app/api/auth.py - Authentication API → Database sessions: uses
backend/app/api/auth.py - Session security → Database sessions: uses
backend/app/core/security.py - Session security → Domain models: checks credentials
backend/app/core/security.py - Database sessions → Domain models: persists
- Connector API → Local file connector: may dispatch
- Local file connector → Document extraction: may extract
- Document extraction → Knowledge service: may index
- Knowledge service → Vector storage: may store vectors