How shivangis04/vigilant works
VIGILANT turns Ring activity into home-specific behavioral patterns, scores them with MOTIF, persists events and baselines, and presents flagged patterns and activity analytics in a polling dashboard. Flagged patterns can receive Bedrock explanations and optional Alexa announcements. The graph also preserves Ring account linking and security capabilities documented by the project. Edges reflect shown calls or README statements; unsampled implementation details are not inferred.
Main entry points: routes.py Dashboard API · pipeline.py Event Pipeline · App.jsx Dashboard · repository.py Data Repository
Components 26
Ring Integration
- Account Linking
backend/ring_integration/oauth.py - Partner API
backend/ring_integration/official_client.py - Webhook Security
backend/ring_integration/security.py - Event Normalization
backend/ring_integration/normalization.py - Event Simulator
backend/ring_integration/api_client.py
Pattern Analysis
- MOTIF Scoring
backend/motif_engine/motif_core.py - Event Pipeline
backend/ring_integration/pipeline.py - Explanations
backend/bedrock_integration/explanation_generator.py
Persistence
- Domain Records
backend/database/models.py - Data Repository
backend/database/repository.py - Database Sessions
backend/database/session.py
API and Alerts
- Dashboard API
backend/api/routes.py - Alexa Notifier
backend/alexa_integration/client.py - Alexa Lambda Handler
backend/alexa_integration/lambda_handler.py
Dashboard
- Dashboard
frontend/src/App.jsx - Polling Hooks
frontend/src/hooks/useEvents.js - Frontend API Client
frontend/src/utils/api.js - Pattern Views
frontend/src/components/PatternCard.jsx - Pattern Detail
frontend/src/components/PatternDetail.jsx - Event Timeline
frontend/src/components/EventTimeline.jsx - Baseline Analytics
frontend/src/components/BaselineComparison.jsx
Other components
- Ring Service
- Homeowner
- AWS Bedrock
- AWS Lambda
- SQL Database
Connections 31
- Ring Service → Dashboard API: sends webhooks
backend/api/routes.py - Dashboard API → Webhook Security: verifies requests
backend/api/routes.py - Dashboard API → Event Normalization: normalizes events
backend/api/routes.py - Dashboard API → Account Linking: handles linking
backend/api/routes.py - Account Linking → Partner API: exchanges tokens
backend/ring_integration/oauth.py - Account Linking → Data Repository: stores credentials
backend/ring_integration/oauth.py - Event Simulator → Event Pipeline: feeds events
- Dashboard API → Event Pipeline: processes events
backend/api/routes.py - Event Pipeline → MOTIF Scoring: scores sequences
backend/ring_integration/pipeline.py - Event Pipeline → Explanations: explains flagged
backend/ring_integration/pipeline.py - Explanations → AWS Bedrock: requests explanation
README.md - Event Pipeline → Data Repository: saves patterns
backend/ring_integration/pipeline.py - Event Pipeline → Data Repository: updates baseline
backend/ring_integration/pipeline.py - Event Pipeline → MOTIF Scoring: learns baseline
backend/ring_integration/pipeline.py - Event Pipeline → Alexa Notifier: sends flagged alerts
backend/ring_integration/pipeline.py - Alexa Notifier → AWS Lambda: invokes function
backend/alexa_integration/client.py - AWS Lambda → Alexa Lambda Handler: runs handler
README.md - Dashboard API → Data Repository: queries and writes
backend/api/routes.py - Dashboard API → Database Sessions: opens sessions
backend/api/routes.py - Data Repository → Domain Records: maps records
backend/database/repository.py - Database Sessions → SQL Database: connects
backend/database/session.py - Homeowner → Dashboard: views activity
README.md - Dashboard → Polling Hooks: loads patterns
frontend/src/App.jsx - Dashboard → Pattern Views: renders list
frontend/src/App.jsx - Dashboard → Pattern Detail: renders selection
frontend/src/App.jsx - Dashboard → Event Timeline: renders events
frontend/src/App.jsx - Dashboard → Baseline Analytics: renders analytics
frontend/src/App.jsx - Polling Hooks → Frontend API Client: fetches data
frontend/src/hooks/useEvents.js - Frontend API Client → Dashboard API: requests dashboard data
README.md - Event Timeline → Polling Hooks: reads events
frontend/src/components/EventTimeline.jsx - Baseline Analytics → Frontend API Client: loads comparison
frontend/src/components/BaselineComparison.jsx