How mtaha-23/scrumupdate works
ScrumUpdate combines a web workspace and Teams bot with services for Jira synchronization, worklog management, AI-assisted scrum reporting, and team analytics. A typical flow starts with a team member or manager using the Angular application or Teams; backend services use Jira and calendar data, persist synchronized data in PostgreSQL, and provide dashboards or generated summaries. The README documents the broad service relationships; source excerpts are partial, so links between individual unsampled modules are not asserted.
Main entry points: agile Business API · KGSDbContext.cs PostgreSQL · app Angular workspace · main.py Analytics API
Components 22
User experience
- Angular workspace
src/khoji-angular/angular/src/app - Teams bot
src/Kgs/KhojiGenAIServer/Chat/Teams - Analytics dashboards
src/khoji-angular/angular/src/app/analysis
Business services
- Business API
src/khoji-business-server/khoji_agile_server/src/main/java/uk/co/uworx/khoji/agile - Worklog services
src/khoji-business-server/khoji_agile_server/src/main/java/uk/co/uworx/khoji/agile/service/business/WorkLogService.java - Admin services
src/khoji-business-server/khoji_agile_server/src/main/java/uk/co/uworx/khoji/agile/service/AdminService.java - Calendar integration
src/khoji-business-server/khoji_agile_server/src/main/java/uk/co/uworx/khoji/agile/service/business/integration/IntegrationsService.java - Sync coordinator
src/khoji-business-server/khoji_agile_server/src/main/java/uk/co/uworx/khoji/agile/service/business/instance/SyncService.java
AI and analytics
- AI server
src/Kgs/KhojiGenAIServer - AI workflows
src/Kgs/KhojiGenAIServer/Analytics/WorkflowEngine.cs - Scrum AI features
src/Kgs/KhojiGenAIServer/Features/Kia - Analytics API
src/khoji-analytics/backend/app/main.py - Analytics engine
src/khoji-analytics/backend/app/core/engine.py
Integration and sync
- Jira sync service
src/kss - Tenant manager
src/kss/multi_tenant_manager.py
Data platform
- PostgreSQL
src/Kgs/KhojiGenAIServer/Data/KGSDbContext.cs
Other components
- Team member
- Team leader
- Jira
- Outlook calendar
- Microsoft Teams
- LLM provider
Connections 26
- Team member → Angular workspace: uses
- Team leader → Angular workspace: uses
- Team member → Microsoft Teams: uses
- Angular workspace → Business API: requests
- Business API → Worklog services: manages
src/khoji-business-server/khoji_agile_server/src/main/java/uk/co/uworx/khoji/agile/service/business/WorkLogService.java - Business API → Admin services: manages
src/khoji-business-server/khoji_agile_server/src/main/java/uk/co/uworx/khoji/agile/service/AdminService.java - Business API → Calendar integration: manages
src/khoji-business-server/khoji_agile_server/src/main/java/uk/co/uworx/khoji/agile/service/business/integration/IntegrationsService.java - Business API → Sync coordinator: coordinates
- Teams bot → Microsoft Teams: interacts
- Teams bot → Worklog services: supports submissions
- Teams bot → Scrum AI features: serves summaries
- Sync coordinator → Jira sync service: submits sync requests
src/khoji-business-server/khoji_agile_server/src/main/java/uk/co/uworx/khoji/agile/service/business/instance/SyncService.java - Jira sync service → Jira: syncs data
- Calendar integration → Outlook calendar: fetches calendar data
src/khoji-business-server/khoji_agile_server/src/main/java/uk/co/uworx/khoji/agile/service/business/integration/IntegrationsService.java - Tenant manager → PostgreSQL: manages tenant schemas
- Jira sync service → PostgreSQL: stores synchronized data
- Business API → PostgreSQL: persists business data
- Worklog services → Analytics API: provides worklog data
- PostgreSQL → Analytics API: supplies analytics data
- Analytics API → Analytics engine: dispatches analytics
src/khoji-analytics/backend/app/main.py - Analytics engine → PostgreSQL: queries datasets
- Analytics engine → LLM provider: requests contextual insights
- AI workflows → LLM provider: requests completions
src/Kgs/KhojiGenAIServer/Analytics/WorkflowEngine.cs - Scrum AI features → AI workflows: uses workflows
- Angular workspace → Analytics dashboards: renders
- Analytics API → Analytics dashboards: provides metrics