How emaaadev/knova_hub works
Knova Hub is an enterprise knowledge-management platform: staff use a JavaScript web client to manage company knowledge and ask natural-language questions; the API applies company and role context, retrieves eligible indexed document text, asks Claude, and returns an answer with source documents. The backend separates API, application services, domain contracts/entities, and infrastructure. The README also describes automated organization and proactive recommendations, but their implementation and wiring were not sampled, so those branches are represented without guessed call paths.
Main entry points: DocumentService.cs Document management · QueryService.cs Question answering · app.js Web interface · auth.js Sign-in UI
Components 20
Web client
- Web interface
Client-Js/dashboard/js/app.js - Sign-in UI
Client-Js/auth/js/auth.js
API and access
- Authentication API
Knova Hub/Knova_Hub/KnovaHub.API/Controllers/AuthController.cs - Department API
Knova Hub/Knova_Hub/KnovaHub.API/Controllers/DepartmentsController.cs - Document API
Knova Hub/Knova_Hub/KnovaHub.API/Controllers/DocumentsController.cs - AI query API
Knova Hub/Knova_Hub/KnovaHub.API/Controllers/AiController.cs - Access policies
Knova Hub/Knova_Hub/KnovaHub.API/Authorization/DepartmentAccessHandler.cs
Knowledge services
- Auth service
Knova Hub/Knova_Hub/KnovaHub.ApplicationLayer/Services/AuthService.cs - Document management
Knova Hub/Knova_Hub/KnovaHub.ApplicationLayer/Services/DocumentService.cs - Document discovery
Knova Hub/Knova_Hub/KnovaHub.ApplicationLayer/Services/DocumentService.Discovery.cs - Question answering
Knova Hub/Knova_Hub/KnovaHub.ApplicationLayer/Services/QueryService.cs - Knowledge organization
Knova Hub/Knova_Hub/KnovaHub.ApplicationLayer/Services/CategoryService.cs - Proactive suggestions
Knova Hub/Knova_Hub/KnovaHub.ApplicationLayer/DTOs/DocumentSuggestionDto.cs - File storage
Knova Hub/Knova_Hub/KnovaHub.ApplicationLayer/Services/LocalFileStorage.cs
Infrastructure
- Text extraction
Knova Hub/Knova_Hub/KnovaHub.InfrastructureLayer/Services/DocumentTextExtractor.cs - Claude integration
Knova Hub/Knova_Hub/KnovaHub.InfrastructureLayer/Services/ClaudeAiService.cs - Query history
Knova Hub/Knova_Hub/KnovaHub.InfrastructureLayer/Repositories/QueryLogRepository.cs
Domain and persistence
- Application database
Knova Hub/Knova_Hub/KnovaHub.InfrastructureLayer/DbContext/KnovaHubDbContext.cs
Other components
- Staff user
- Anthropic Claude
Connections 18
- Staff user → Web interface: uses
- Staff user → Sign-in UI: signs in
- Web interface → Document API: manages documents
- Sign-in UI → Authentication API: authenticates
- Authentication API → Auth service: delegates to
Knova Hub/Knova_Hub/KnovaHub.API/Controllers/AuthController.cs - Department API → Access policies: checks access
Knova Hub/Knova_Hub/KnovaHub.API/Controllers/DepartmentsController.cs - Document API → Document management: delegates to
Knova Hub/Knova_Hub/KnovaHub.API/Controllers/DocumentsController.cs - AI query API → Question answering: dispatches query
- Document management → File storage: stores files
- Document management → Text extraction: extracts text
- Document management → Document discovery: supports discovery
- Staff user → AI query API: asks questions
- Question answering → Claude integration: requests answer
Knova Hub/Knova_Hub/KnovaHub.ApplicationLayer/Services/QueryService.cs - Claude integration → Anthropic Claude: calls API
- Question answering → Query history: records query
Knova Hub/Knova_Hub/KnovaHub.ApplicationLayer/Services/QueryService.cs - Query history → Application database: writes logs
Knova Hub/Knova_Hub/KnovaHub.InfrastructureLayer/Repositories/QueryLogRepository.cs - Knowledge organization → Staff user: organizes knowledge
- Proactive suggestions → Staff user: suggests resources