# saykat-source/my-project architecture

> Architecture diagram of the GitHub repository saykat-source/my-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saykat-source/my-project
- Repository: https://github.com/saykat-source/my-project

## Overview

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`](https://github.com/saykat-source/my-project/blob/main/coordinator.py) (Assessment Coordinator), [`api/authenticated_experience_verification_service.py`](https://github.com/saykat-source/my-project/blob/main/api/authenticated_experience_verification_service.py) (Authenticated Review API), [`dashboard_generator.py`](https://github.com/saykat-source/my-project/blob/main/dashboard_generator.py) (Dashboard), [`api/internal_experience_access_coordinator.py`](https://github.com/saykat-source/my-project/blob/main/api/internal_experience_access_coordinator.py) (Experience Access Coordinator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assessment["Website Assessment"]
  node_cli["CLI Entry<br/>[main.py]"]
  node_coordinator["Assessment Coordinator<br/>[coordinator.py]"]
  node_discovery["Business Discovery<br/>[discovery_agent.py]"]
  node_online_discovery["Online Discovery"]
  node_url_validation["URL Validation<br/>[url_validator.py]"]
  node_scanner["Website Scanner<br/>[scanner_agent.py]"]
  node_secure_transport["Secure Transport"]
  node_analysis["Risk Analysis<br/>[analysis_agent.py]"]
  node_llm["Explanation Agent<br/>[llm_agent.py]"]
  node_explanation_validator["Explanation Validation"]
  node_report["Assessment Report<br/>[report_agent.py]"]
  node_integrity["Assessment Integrity"]
  node_dashboard["Dashboard"]
end

subgraph group_defense["Realtime Defense"]
  node_defense_runtime["Defense Runtime"]
  node_correlation["WAF Correlation"]
  node_investigation["Investigation Workflow"]
  node_network_identity["Network Sensor Identity"]
end

subgraph group_access["Tenant Access"]
  node_internal_auth["Internal Authorization"]
  node_identity_provider["Identity Provider"]
  node_tenant_auth["Tenant Authorization"]
  node_authenticated_review["Authenticated Review API"]
  node_review_coordinator["Experience Access Coordinator"]
  node_membership_provider["Tenant Membership"]
end

subgraph group_memory["Evidence Memory"]
  node_tenant_context["Tenant Context<br/>[tenant_context.py]"]
  node_experience_review["Experience Review"]
  node_experience_store[("Experience Store")]
  node_verification_store[("Verification Store")]
  node_memory_store[("Security Memory<br/>[memory_store.py]")]
  node_storage_config["Storage Configuration"]
end

node_user(("Street User"))

node_user -->|"enters street"| node_cli
node_cli -->|"runs assessment"| node_coordinator
node_coordinator -->|"discovers businesses"| node_discovery
node_discovery -->|"uses online lookup"| node_online_discovery
node_coordinator -->|"validates website"| node_url_validation
node_coordinator -->|"scans website"| node_scanner
node_scanner -->|"uses transport"| node_secure_transport
node_coordinator -->|"assesses findings"| node_analysis
node_analysis -->|"requests explanation"| node_llm
node_llm -->|"builds safe explanation"| node_explanation_validator
node_coordinator -->|"generates report"| node_report
node_report -->|"checks integrity"| node_integrity
node_coordinator -->|"generates dashboard"| node_dashboard
node_dashboard -->|"validates assessment"| node_integrity
node_dashboard -->|"validates scan evidence"| node_integrity
node_correlation -->|"requires tenant context"| node_tenant_context
node_experience_review -->|"retrieves history"| node_verification_store
node_experience_review -->|"checks tenant context"| node_tenant_context
node_verification_store -->|"reuses database path"| node_experience_store
node_experience_store -->|"uses memory database"| node_memory_store
node_authenticated_review -->|"authorizes review"| node_review_coordinator
node_authenticated_review -->|"saves verification"| node_verification_store
node_authenticated_review -->|"checks configuration"| node_storage_config
node_review_coordinator -->|"uses identity provider"| node_identity_provider
node_review_coordinator -->|"checks authorization"| node_internal_auth
node_identity_provider -->|"uses tenant authorization"| node_tenant_auth
node_tenant_auth -->|"creates tenant context"| node_tenant_context
node_membership_provider -->|"supports membership check"| node_tenant_auth

click node_cli "https://github.com/saykat-source/my-project/blob/main/main.py"
click node_coordinator "https://github.com/saykat-source/my-project/blob/main/coordinator.py"
click node_discovery "https://github.com/saykat-source/my-project/blob/main/agents/discovery_agent.py"
click node_online_discovery "https://github.com/saykat-source/my-project/blob/main/agents/online_discovery.py"
click node_url_validation "https://github.com/saykat-source/my-project/blob/main/url_validator.py"
click node_scanner "https://github.com/saykat-source/my-project/blob/main/agents/scanner_agent.py"
click node_secure_transport "https://github.com/saykat-source/my-project/blob/main/secure_transport.py"
click node_analysis "https://github.com/saykat-source/my-project/blob/main/agents/analysis_agent.py"
click node_llm "https://github.com/saykat-source/my-project/blob/main/agents/llm_agent.py"
click node_explanation_validator "https://github.com/saykat-source/my-project/blob/main/agents/explanation_validator.py"
click node_report "https://github.com/saykat-source/my-project/blob/main/agents/report_agent.py"
click node_integrity "https://github.com/saykat-source/my-project/blob/main/assessment_integrity_validator.py"
click node_dashboard "https://github.com/saykat-source/my-project/blob/main/dashboard_generator.py"
click node_defense_runtime "https://github.com/saykat-source/my-project/tree/main/realtime_defense"
click node_correlation "https://github.com/saykat-source/my-project/blob/main/realtime_defense/correlation_engine.py"
click node_investigation "https://github.com/saykat-source/my-project/tree/main/realtime_defense"
click node_network_identity "https://github.com/saykat-source/my-project/tree/main/realtime_defense/network_identity"
click node_internal_auth "https://github.com/saykat-source/my-project/blob/main/api/internal_administrative_authorization.py"
click node_identity_provider "https://github.com/saykat-source/my-project/blob/main/api/identity_provider.py"
click node_tenant_auth "https://github.com/saykat-source/my-project/blob/main/api/tenant_authorization.py"
click node_tenant_context "https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/tenant_context.py"
click node_experience_review "https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/experience_review_service.py"
click node_experience_store "https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/experience_store.py"
click node_verification_store "https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/experience_verification_store.py"
click node_memory_store "https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/memory_store.py"
click node_storage_config "https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/experience_storage_config.py"
click node_authenticated_review "https://github.com/saykat-source/my-project/blob/main/api/authenticated_experience_verification_service.py"
click node_review_coordinator "https://github.com/saykat-source/my-project/blob/main/api/internal_experience_access_coordinator.py"
click node_membership_provider "https://github.com/saykat-source/my-project/blob/main/api/tenant_membership_provider.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_coordinator,node_discovery,node_online_discovery,node_url_validation,node_scanner,node_secure_transport,node_analysis,node_llm,node_explanation_validator,node_report,node_integrity,node_dashboard,node_user toneBlue
class node_defense_runtime,node_correlation,node_investigation,node_network_identity toneAmber
class node_internal_auth,node_identity_provider,node_tenant_auth,node_authenticated_review,node_review_coordinator,node_membership_provider toneMint
class node_tenant_context,node_experience_review,node_experience_store,node_verification_store,node_memory_store,node_storage_config toneRose
```

## Components

### Website Assessment

- [CLI Entry](https://github.com/saykat-source/my-project/blob/main/main.py): `main.py`
- [Assessment Coordinator](https://github.com/saykat-source/my-project/blob/main/coordinator.py): `coordinator.py`
- [Business Discovery](https://github.com/saykat-source/my-project/blob/main/agents/discovery_agent.py): `agents/discovery_agent.py`
- [Online Discovery](https://github.com/saykat-source/my-project/blob/main/agents/online_discovery.py): `agents/online_discovery.py`
- [URL Validation](https://github.com/saykat-source/my-project/blob/main/url_validator.py): `url_validator.py`
- [Website Scanner](https://github.com/saykat-source/my-project/blob/main/agents/scanner_agent.py): `agents/scanner_agent.py`
- [Secure Transport](https://github.com/saykat-source/my-project/blob/main/secure_transport.py): `secure_transport.py`
- [Risk Analysis](https://github.com/saykat-source/my-project/blob/main/agents/analysis_agent.py): `agents/analysis_agent.py`
- [Explanation Agent](https://github.com/saykat-source/my-project/blob/main/agents/llm_agent.py): `agents/llm_agent.py`
- [Explanation Validation](https://github.com/saykat-source/my-project/blob/main/agents/explanation_validator.py): `agents/explanation_validator.py`
- [Assessment Report](https://github.com/saykat-source/my-project/blob/main/agents/report_agent.py): `agents/report_agent.py`
- [Assessment Integrity](https://github.com/saykat-source/my-project/blob/main/assessment_integrity_validator.py): `assessment_integrity_validator.py`
- [Dashboard](https://github.com/saykat-source/my-project/blob/main/dashboard_generator.py): `dashboard_generator.py`

### Realtime Defense

- [Defense Runtime](https://github.com/saykat-source/my-project/tree/main/realtime_defense): `realtime_defense`
- [WAF Correlation](https://github.com/saykat-source/my-project/blob/main/realtime_defense/correlation_engine.py): `realtime_defense/correlation_engine.py`
- [Investigation Workflow](https://github.com/saykat-source/my-project/tree/main/realtime_defense): `realtime_defense`
- [Network Sensor Identity](https://github.com/saykat-source/my-project/tree/main/realtime_defense/network_identity): `realtime_defense/network_identity`

### Tenant Access

- [Internal Authorization](https://github.com/saykat-source/my-project/blob/main/api/internal_administrative_authorization.py): `api/internal_administrative_authorization.py`
- [Identity Provider](https://github.com/saykat-source/my-project/blob/main/api/identity_provider.py): `api/identity_provider.py`
- [Tenant Authorization](https://github.com/saykat-source/my-project/blob/main/api/tenant_authorization.py): `api/tenant_authorization.py`
- [Authenticated Review API](https://github.com/saykat-source/my-project/blob/main/api/authenticated_experience_verification_service.py): `api/authenticated_experience_verification_service.py`
- [Experience Access Coordinator](https://github.com/saykat-source/my-project/blob/main/api/internal_experience_access_coordinator.py): `api/internal_experience_access_coordinator.py`
- [Tenant Membership](https://github.com/saykat-source/my-project/blob/main/api/tenant_membership_provider.py): `api/tenant_membership_provider.py`

### Evidence Memory

- [Tenant Context](https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/tenant_context.py): `realtime_defense/memory/tenant_context.py`
- [Experience Review](https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/experience_review_service.py): `realtime_defense/memory/experience_review_service.py`
- [Experience Store](https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/experience_store.py): `realtime_defense/memory/experience_store.py`
- [Verification Store](https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/experience_verification_store.py): `realtime_defense/memory/experience_verification_store.py`
- [Security Memory](https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/memory_store.py): `realtime_defense/memory/memory_store.py`
- [Storage Configuration](https://github.com/saykat-source/my-project/blob/main/realtime_defense/memory/experience_storage_config.py): `realtime_defense/memory/experience_storage_config.py`

### Other components

- **Street User**

## Connections

- Street User → CLI Entry: enters street (evidence: `main.py`)
- CLI Entry → Assessment Coordinator: runs assessment (evidence: `main.py`)
- Assessment Coordinator → Business Discovery: discovers businesses (evidence: `coordinator.py`)
- Business Discovery → Online Discovery: uses online lookup (evidence: `agents/discovery_agent.py`)
- Assessment Coordinator → URL Validation: validates website (evidence: `coordinator.py`)
- Assessment Coordinator → Website Scanner: scans website (evidence: `coordinator.py`)
- Website Scanner → Secure Transport: uses transport (evidence: `agents/scanner_agent.py`)
- Assessment Coordinator → Risk Analysis: assesses findings (evidence: `coordinator.py`)
- Risk Analysis → Explanation Agent: requests explanation (evidence: `agents/analysis_agent.py`)
- Explanation Agent → Explanation Validation: builds safe explanation (evidence: `agents/llm_agent.py`)
- Assessment Coordinator → Assessment Report: generates report (evidence: `coordinator.py`)
- Assessment Report → Assessment Integrity: checks integrity (evidence: `agents/report_agent.py`)
- Assessment Coordinator → Dashboard: generates dashboard (evidence: `coordinator.py`)
- Dashboard → Assessment Integrity: validates assessment (evidence: `dashboard_generator.py`)
- Dashboard → Assessment Integrity: validates scan evidence (evidence: `dashboard_generator.py`)
- WAF Correlation → Tenant Context: requires tenant context (evidence: `realtime_defense/correlation_engine.py`)
- Experience Review → Verification Store: retrieves history (evidence: `realtime_defense/memory/experience_review_service.py`)
- Experience Review → Tenant Context: checks tenant context (evidence: `realtime_defense/memory/experience_review_service.py`)
- Verification Store → Experience Store: reuses database path (evidence: `realtime_defense/memory/experience_verification_store.py`)
- Experience Store → Security Memory: uses memory database (evidence: `realtime_defense/memory/experience_store.py`)
- Authenticated Review API → Experience Access Coordinator: authorizes review (evidence: `api/authenticated_experience_verification_service.py`)
- Authenticated Review API → Verification Store: saves verification (evidence: `api/authenticated_experience_verification_service.py`)
- Authenticated Review API → Storage Configuration: checks configuration (evidence: `api/authenticated_experience_verification_service.py`)
- Experience Access Coordinator → Identity Provider: uses identity provider (evidence: `api/internal_experience_access_coordinator.py`)
- Experience Access Coordinator → Internal Authorization: checks authorization (evidence: `api/internal_experience_access_coordinator.py`)
- Identity Provider → Tenant Authorization: uses tenant authorization (evidence: `api/identity_provider.py`)
- Tenant Authorization → Tenant Context: creates tenant context (evidence: `api/tenant_authorization.py`)
- Tenant Membership → Tenant Authorization: supports membership check (evidence: `api/tenant_membership_provider.py`)
