How saykat-source/my-project works
The repository combines a street-based business website security assessment application with a broader tenant-scoped realtime defense and evidence-review system. The visible user workflow starts at the CLI, discovers businesses, scans websites, assesses findings, and produces reports and a dashboard. Realtime defense includes event correlation, investigation and operational subsystems, while memory and API modules provide tenant-scoped evidence storage and access control. The README is empty, and many realtime modules were not sampled; those subsystems are represented without speculative call edges.
Main entry points: coordinator.py Assessment Coordinator · authenticated_experience_verification_service.py Authenticated Review API · dashboard_generator.py Dashboard · internal_experience_access_coordinator.py Experience Access Coordinator
Components 30
Website Assessment
- CLI Entry
main.py - Assessment Coordinator
coordinator.py - Business Discovery
agents/discovery_agent.py - Online Discovery
agents/online_discovery.py - URL Validation
url_validator.py - Website Scanner
agents/scanner_agent.py - Secure Transport
secure_transport.py - Risk Analysis
agents/analysis_agent.py - Explanation Agent
agents/llm_agent.py - Explanation Validation
agents/explanation_validator.py - Assessment Report
agents/report_agent.py - Assessment Integrity
assessment_integrity_validator.py - Dashboard
dashboard_generator.py
Realtime Defense
- Defense Runtime
realtime_defense - WAF Correlation
realtime_defense/correlation_engine.py - Investigation Workflow
realtime_defense - Network Sensor Identity
realtime_defense/network_identity
Tenant Access
- Internal Authorization
api/internal_administrative_authorization.py - Identity Provider
api/identity_provider.py - Tenant Authorization
api/tenant_authorization.py - Authenticated Review API
api/authenticated_experience_verification_service.py - Experience Access Coordinator
api/internal_experience_access_coordinator.py - Tenant Membership
api/tenant_membership_provider.py
Evidence Memory
- Tenant Context
realtime_defense/memory/tenant_context.py - Experience Review
realtime_defense/memory/experience_review_service.py - Experience Store
realtime_defense/memory/experience_store.py - Verification Store
realtime_defense/memory/experience_verification_store.py - Security Memory
realtime_defense/memory/memory_store.py - Storage Configuration
realtime_defense/memory/experience_storage_config.py
Other components
- Street User
Connections 28
- Street User → CLI Entry: enters street
main.py - CLI Entry → Assessment Coordinator: runs assessment
main.py - Assessment Coordinator → Business Discovery: discovers businesses
coordinator.py - Business Discovery → Online Discovery: uses online lookup
agents/discovery_agent.py - Assessment Coordinator → URL Validation: validates website
coordinator.py - Assessment Coordinator → Website Scanner: scans website
coordinator.py - Website Scanner → Secure Transport: uses transport
agents/scanner_agent.py - Assessment Coordinator → Risk Analysis: assesses findings
coordinator.py - Risk Analysis → Explanation Agent: requests explanation
agents/analysis_agent.py - Explanation Agent → Explanation Validation: builds safe explanation
agents/llm_agent.py - Assessment Coordinator → Assessment Report: generates report
coordinator.py - Assessment Report → Assessment Integrity: checks integrity
agents/report_agent.py - Assessment Coordinator → Dashboard: generates dashboard
coordinator.py - Dashboard → Assessment Integrity: validates assessment
dashboard_generator.py - Dashboard → Assessment Integrity: validates scan evidence
dashboard_generator.py - WAF Correlation → Tenant Context: requires tenant context
realtime_defense/correlation_engine.py - Experience Review → Verification Store: retrieves history
realtime_defense/memory/experience_review_service.py - Experience Review → Tenant Context: checks tenant context
realtime_defense/memory/experience_review_service.py - Verification Store → Experience Store: reuses database path
realtime_defense/memory/experience_verification_store.py - Experience Store → Security Memory: uses memory database
realtime_defense/memory/experience_store.py - Authenticated Review API → Experience Access Coordinator: authorizes review
api/authenticated_experience_verification_service.py - Authenticated Review API → Verification Store: saves verification
api/authenticated_experience_verification_service.py - Authenticated Review API → Storage Configuration: checks configuration
api/authenticated_experience_verification_service.py - Experience Access Coordinator → Identity Provider: uses identity provider
api/internal_experience_access_coordinator.py - Experience Access Coordinator → Internal Authorization: checks authorization
api/internal_experience_access_coordinator.py - Identity Provider → Tenant Authorization: uses tenant authorization
api/identity_provider.py - Tenant Authorization → Tenant Context: creates tenant context
api/tenant_authorization.py - Tenant Membership → Tenant Authorization: supports membership check
api/tenant_membership_provider.py