How momakkawi/agentic_tracking_system works
Agentic Tracking System turns badge and attendance data into operational views and AI-generated intelligence. The main user workflow runs from the dashboard through the REST API to attendance, alert, group, and agent services; agent workflows can ingest and preprocess data, validate it, identify cohorts, and produce insights or answer natural-language questions. Shared utilities provide repositories, configuration, mappings, and model wrappers, while memory supports session-isolated conversational context. The README documents the broad service and agent relationships; sampled source confirms selected API, dashboard, memory, and utility details, but not every runtime call.
Main entry points: agent.py Orchestrator · main.py FastAPI App · App.jsx Dashboard · factory.py File Repositories
Components 22
User Interface
- Dashboard
dashboard/src/App.jsx - Attendance View
dashboard/src/pages/Attendance/index.jsx - Alerts View
dashboard/src/pages/Alerts/index.jsx - Groups View
dashboard/src/pages/Groups/index.jsx - Agent Chat
dashboard/src/pages/Agent/index.jsx - API Client
dashboard/src/services/api.js
API Backend
- FastAPI App
api/main.py - REST Routes
api/routers/attendance.py - Session Service
api/services/session_service.py - Alert Service
api/services/alert_service.py - Chat Service
api/services/chat_service.py - Event Scheduler
api/services/scheduler_service.py
Agent Workflows
- Orchestrator
agents/orchestrator/src/orchestrator/agent.py - Conversation Memory
agents/memory/short_term.py - Data Pipeline
agents/sub_agents/data_pipeline/src/data_pipeline/pipelines/processor.py - Data Validation
agents/sub_agents/data_validation/src/data_validation/validators/device_session.py - Cohort Clustering
agents/sub_agents/group_identification/src/group_identification/identifier/louvain.py - Knowledge Insights
agents/sub_agents/knowledge_insight/src/knowledge_insight/core/data_insighter.py
Shared Services
- File Repositories
utils/src/utils/storage/factory.py - Hot-Reload Config
utils/src/utils/config.py - AI Model Wrappers
utils/src/utils/models/gemini.py
Other components
- Administrator
Connections 25
- Administrator → Dashboard: uses
README.md - Dashboard → Attendance View: routes to
dashboard/src/App.jsx - Dashboard → Alerts View: routes to
dashboard/src/App.jsx - Dashboard → Groups View: routes to
dashboard/src/App.jsx - Dashboard → Agent Chat: routes to
dashboard/src/App.jsx - Dashboard → API Client: uses
- API Client → FastAPI App: HTTP requests
README.md - FastAPI App → REST Routes: registers
api/main.py - FastAPI App → Orchestrator: dispatches
README.md - FastAPI App → Session Service: provides services
- FastAPI App → Alert Service: provides services
- FastAPI App → Chat Service: provides services
- FastAPI App → Event Scheduler: provides services
- Session Service → File Repositories: reads sessions
api/services/session_service.py - Alert Service → File Repositories: reads alerts
api/services/alert_service.py - Chat Service → File Repositories: persists chats
api/services/chat_service.py - Event Scheduler → Orchestrator: triggers workflows
README.md - Orchestrator → Conversation Memory: consults
README.md - Orchestrator → Data Pipeline: coordinates
README.md - Orchestrator → Data Validation: coordinates
README.md - Orchestrator → Cohort Clustering: coordinates
README.md - Orchestrator → Knowledge Insights: coordinates
README.md - Data Pipeline → File Repositories: uses repositories
README.md - Orchestrator → Hot-Reload Config: uses
README.md - Orchestrator → AI Model Wrappers: uses