# mystrident/antivirus-details-sender architecture

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

- Interactive diagram: https://gitdiagram.com/mystrident/antivirus-details-sender
- Repository: https://github.com/mystrident/antivirus-details-sender

## Overview

The product is an endpoint antivirus telemetry system: Windows and macOS agents gather vendor-specific antivirus and endpoint data, submit a shared payload over authenticated HTTPS, and a backend validates, stores, alerts, and reports on it. Native Windows and macOS service/tray components supervise and control their agents. The README documents the major runtime capabilities; source excerpts and the SOURCE INDEX show selected wiring, so unsampled internal links are limited to documented relationships.

Main entry points: [`backend/src/controllers/telemetry.controller.ts`](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/controllers/telemetry.controller.ts) (Telemetry controller), [`avendpoint/src/collectors/vendors`](https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/avendpoint/src/collectors/vendors) (Windows vendor collectors), [`backend/src/server.ts`](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/server.ts) (Telemetry API server), [`avendpoint/src/scheduler/scheduler.ts`](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/scheduler/scheduler.ts) (Windows scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agents["Endpoint agents"]
  node_win_entry["Windows agent entry<br/>[index.ts]"]
  node_win_schedule["Windows scheduler<br/>[scheduler.ts]"]
  node_win_av["Windows AV collection"]
  node_win_vendor["Windows vendor collectors"]
  node_win_endpoint["Windows endpoint data<br/>[endpoint.ts]"]
  node_win_telemetry["Windows telemetry services"]
  node_win_transport["Windows HTTPS transport<br/>[api.ts]"]
  node_win_db["Windows AV database access<br/>[database.ts]"]
  node_win_files["Windows file access<br/>[file-io.ts]"]
  node_mac_entry["macOS agent entry<br/>[index.ts]"]
  node_mac_schedule["macOS scheduler<br/>[scheduler.ts]"]
  node_mac_av["macOS AV collection<br/>[antivirus.macos.ts]"]
  node_mac_vendor["macOS Norton collector"]
  node_mac_endpoint["macOS endpoint data<br/>[endpoint.ts]"]
  node_mac_telemetry["macOS telemetry services"]
  node_mac_transport["macOS HTTPS transport<br/>[api.ts]"]
end

subgraph group_windows["Windows management"]
  node_windows_service["Windows service supervisor<br/>[AgentService.cs]"]
  node_windows_process["Windows process manager<br/>[ProcessManager.cs]"]
  node_windows_pipe["Windows pipe server<br/>[PipeServer.cs]"]
  node_windows_tray["Windows tray UI<br/>[TrayForm.cs]"]
  node_windows_pipeclient["Windows pipe client<br/>[PipeClient.cs]"]
end

subgraph group_macos["macOS management"]
  node_mac_service["macOS launch service<br/>[main.swift]"]
  node_mac_process["macOS process manager"]
end

subgraph group_backend["Telemetry backend"]
  node_server["Telemetry API server<br/>[server.ts]"]
  node_routes["Telemetry routes and auth"]
  node_controller["Telemetry controller"]
  node_validator["Payload validation"]
  node_repository["Endpoint persistence"]
  node_postgres[("PostgreSQL")]
end

subgraph group_operations["Alerts and reporting"]
  node_alerts["Alert synchronization"]
  node_jobs["Scheduled jobs"]
  node_reports["CSV reports<br/>[csv.service.ts]"]
  node_email["Email delivery<br/>[email.service.ts]"]
end

node_collector_sources(("OS and AV data"))

node_win_entry -->|"starts"| node_win_schedule
node_win_schedule -->|"schedules"| node_win_telemetry
node_win_schedule -->|"uses"| node_win_transport
node_win_telemetry -.->|"collects"| node_win_av
node_win_telemetry -.->|"collects"| node_win_endpoint
node_win_av -.->|"dispatches"| node_win_vendor
node_win_vendor -.->|"reads local data"| node_win_db
node_win_vendor -.->|"reads files"| node_win_files
node_collector_sources -.->|"provides AV data"| node_win_vendor
node_collector_sources -.->|"provides metadata"| node_win_endpoint
node_win_transport -.->|"submits HTTPS"| node_server
node_mac_entry -->|"starts"| node_mac_schedule
node_mac_schedule -->|"schedules"| node_mac_telemetry
node_mac_schedule -->|"uses"| node_mac_transport
node_mac_telemetry -.->|"collects"| node_mac_av
node_mac_telemetry -.->|"collects"| node_mac_endpoint
node_mac_av -.->|"dispatches"| node_mac_vendor
node_collector_sources -.->|"provides AV data"| node_mac_vendor
node_collector_sources -.->|"provides metadata"| node_mac_endpoint
node_mac_transport -.->|"submits HTTPS"| node_server
node_server -->|"mounts"| node_routes
node_routes -->|"routes to"| node_controller
node_routes -->|"authenticates"| node_validator
node_controller -.->|"validates"| node_validator
node_controller -.->|"upserts"| node_repository
node_repository -.->|"persists"| node_postgres
node_controller -.->|"synchronizes"| node_alerts
node_server -->|"starts"| node_jobs
node_jobs -.->|"generates"| node_reports
node_jobs -.->|"sends reports"| node_email
node_alerts -.->|"updates alerts"| node_postgres
node_windows_service -->|"manages"| node_windows_process
node_windows_service -->|"starts"| node_windows_pipe
node_windows_pipe -->|"controls"| node_windows_process
node_windows_tray -->|"sends commands"| node_windows_pipeclient
node_windows_pipeclient -.->|"communicates"| node_windows_pipe
node_mac_service -->|"manages"| node_mac_process

click node_win_entry "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/index.ts"
click node_win_schedule "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/scheduler/scheduler.ts"
click node_win_av "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/collectors/antivirus.windows.ts"
click node_win_vendor "https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/avendpoint/src/collectors/vendors"
click node_win_endpoint "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/collectors/endpoint.ts"
click node_win_telemetry "https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/avendpoint/src/services"
click node_win_transport "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/transport/api.ts"
click node_win_db "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/utils/database.ts"
click node_win_files "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/utils/file-io.ts"
click node_mac_entry "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/index.ts"
click node_mac_schedule "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/scheduler/scheduler.ts"
click node_mac_av "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/collectors/antivirus.macos.ts"
click node_mac_vendor "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/collectors/vendors/norton.collector.ts"
click node_mac_endpoint "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/collectors/endpoint.ts"
click node_mac_telemetry "https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/avendpoint-macos/src/services"
click node_mac_transport "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/transport/api.ts"
click node_server "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/server.ts"
click node_routes "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/routes/telemetry.routes.ts"
click node_controller "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/controllers/telemetry.controller.ts"
click node_validator "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/validators/telemetry.validator.ts"
click node_repository "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/repositories/avstat.repository.ts"
click node_alerts "https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/backend/src/services"
click node_jobs "https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/backend/src/jobs"
click node_reports "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/services/csv.service.ts"
click node_email "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/services/email.service.ts"
click node_windows_service "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/windows-service/AgentService.cs"
click node_windows_process "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/windows-service/ProcessManager.cs"
click node_windows_pipe "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/windows-service/PipeServer.cs"
click node_windows_tray "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/tray-manager/TrayForm.cs"
click node_windows_pipeclient "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/tray-manager/PipeClient.cs"
click node_mac_service "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/EndpointAgentService/Sources/EndpointAgentService/main.swift"
click node_mac_process "https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/EndpointAgentService/Sources/EndpointAgentService/ProcessManager.swift"

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_win_entry,node_win_schedule,node_win_av,node_win_vendor,node_win_endpoint,node_win_telemetry,node_win_transport,node_win_db,node_win_files,node_mac_entry,node_mac_schedule,node_mac_av,node_mac_vendor,node_mac_endpoint,node_mac_telemetry,node_mac_transport toneBlue
class node_windows_service,node_windows_process,node_windows_pipe,node_windows_tray,node_windows_pipeclient toneAmber
class node_mac_service,node_mac_process toneMint
class node_server,node_routes,node_controller,node_validator,node_repository,node_postgres toneRose
class node_alerts,node_jobs,node_reports,node_email,node_collector_sources toneIndigo
```

## Components

### Endpoint agents

- [Windows agent entry](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/index.ts): `avendpoint/src/index.ts`
- [Windows scheduler](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/scheduler/scheduler.ts): `avendpoint/src/scheduler/scheduler.ts`
- [Windows AV collection](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/collectors/antivirus.windows.ts): `avendpoint/src/collectors/antivirus.windows.ts`
- [Windows vendor collectors](https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/avendpoint/src/collectors/vendors): `avendpoint/src/collectors/vendors`
- [Windows endpoint data](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/collectors/endpoint.ts): `avendpoint/src/collectors/endpoint.ts`
- [Windows telemetry services](https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/avendpoint/src/services): `avendpoint/src/services`
- [Windows HTTPS transport](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/transport/api.ts): `avendpoint/src/transport/api.ts`
- [Windows AV database access](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/utils/database.ts): `avendpoint/src/utils/database.ts`
- [Windows file access](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/src/utils/file-io.ts): `avendpoint/src/utils/file-io.ts`
- [macOS agent entry](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/index.ts): `avendpoint-macos/src/index.ts`
- [macOS scheduler](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/scheduler/scheduler.ts): `avendpoint-macos/src/scheduler/scheduler.ts`
- [macOS AV collection](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/collectors/antivirus.macos.ts): `avendpoint-macos/src/collectors/antivirus.macos.ts`
- [macOS Norton collector](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/collectors/vendors/norton.collector.ts): `avendpoint-macos/src/collectors/vendors/norton.collector.ts`
- [macOS endpoint data](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/collectors/endpoint.ts): `avendpoint-macos/src/collectors/endpoint.ts`
- [macOS telemetry services](https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/avendpoint-macos/src/services): `avendpoint-macos/src/services`
- [macOS HTTPS transport](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/src/transport/api.ts): `avendpoint-macos/src/transport/api.ts`

### Windows management

- [Windows service supervisor](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/windows-service/AgentService.cs): `avendpoint/windows-service/AgentService.cs`
- [Windows process manager](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/windows-service/ProcessManager.cs): `avendpoint/windows-service/ProcessManager.cs`
- [Windows pipe server](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/windows-service/PipeServer.cs): `avendpoint/windows-service/PipeServer.cs`
- [Windows tray UI](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/tray-manager/TrayForm.cs): `avendpoint/tray-manager/TrayForm.cs`
- [Windows pipe client](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint/tray-manager/PipeClient.cs): `avendpoint/tray-manager/PipeClient.cs`

### macOS management

- [macOS launch service](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/EndpointAgentService/Sources/EndpointAgentService/main.swift): `avendpoint-macos/EndpointAgentService/Sources/EndpointAgentService/main.swift`
- [macOS process manager](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/avendpoint-macos/EndpointAgentService/Sources/EndpointAgentService/ProcessManager.swift): `avendpoint-macos/EndpointAgentService/Sources/EndpointAgentService/ProcessManager.swift`

### Telemetry backend

- [Telemetry API server](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/server.ts): `backend/src/server.ts`
- [Telemetry routes and auth](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/routes/telemetry.routes.ts): `backend/src/routes/telemetry.routes.ts`
- [Telemetry controller](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/controllers/telemetry.controller.ts): `backend/src/controllers/telemetry.controller.ts`
- [Payload validation](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/validators/telemetry.validator.ts): `backend/src/validators/telemetry.validator.ts`
- [Endpoint persistence](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/repositories/avstat.repository.ts): `backend/src/repositories/avstat.repository.ts`
- **PostgreSQL**

### Alerts and reporting

- [Alert synchronization](https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/backend/src/services): `backend/src/services`
- [Scheduled jobs](https://github.com/mystrident/antivirus-details-sender/tree/mcafee-support/backend/src/jobs): `backend/src/jobs`
- [CSV reports](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/services/csv.service.ts): `backend/src/services/csv.service.ts`
- [Email delivery](https://github.com/mystrident/antivirus-details-sender/blob/mcafee-support/backend/src/services/email.service.ts): `backend/src/services/email.service.ts`

### Other components

- **OS and AV data**

## Connections

- Windows agent entry → Windows scheduler: starts (evidence: `avendpoint/src/index.ts`)
- Windows scheduler → Windows telemetry services: schedules (evidence: `avendpoint/src/scheduler/scheduler.ts`)
- Windows scheduler → Windows HTTPS transport: uses (evidence: `avendpoint/src/scheduler/scheduler.ts`)
- Windows telemetry services → Windows AV collection: collects (evidence: `README.md`)
- Windows telemetry services → Windows endpoint data: collects (evidence: `README.md`)
- Windows AV collection → Windows vendor collectors: dispatches (evidence: `README.md`)
- Windows vendor collectors → Windows AV database access: reads local data (evidence: `README.md`)
- Windows vendor collectors → Windows file access: reads files (evidence: `README.md`)
- OS and AV data → Windows vendor collectors: provides AV data (evidence: `README.md`)
- OS and AV data → Windows endpoint data: provides metadata (evidence: `README.md`)
- Windows HTTPS transport → Telemetry API server: submits HTTPS (evidence: `README.md`)
- macOS agent entry → macOS scheduler: starts (evidence: `avendpoint-macos/src/index.ts`)
- macOS scheduler → macOS telemetry services: schedules (evidence: `avendpoint-macos/src/scheduler/scheduler.ts`)
- macOS scheduler → macOS HTTPS transport: uses (evidence: `avendpoint-macos/src/scheduler/scheduler.ts`)
- macOS telemetry services → macOS AV collection: collects (evidence: `README.md`)
- macOS telemetry services → macOS endpoint data: collects (evidence: `README.md`)
- macOS AV collection → macOS Norton collector: dispatches (evidence: `README.md`)
- OS and AV data → macOS Norton collector: provides AV data (evidence: `README.md`)
- OS and AV data → macOS endpoint data: provides metadata (evidence: `README.md`)
- macOS HTTPS transport → Telemetry API server: submits HTTPS (evidence: `README.md`)
- Telemetry API server → Telemetry routes and auth: mounts (evidence: `backend/src/server.ts`)
- Telemetry routes and auth → Telemetry controller: routes to (evidence: `backend/src/routes/telemetry.routes.ts`)
- Telemetry routes and auth → Payload validation: authenticates (evidence: `backend/src/routes/telemetry.routes.ts`)
- Telemetry controller → Payload validation: validates (evidence: `README.md`)
- Telemetry controller → Endpoint persistence: upserts (evidence: `README.md`)
- Endpoint persistence → PostgreSQL: persists (evidence: `README.md`)
- Telemetry controller → Alert synchronization: synchronizes (evidence: `README.md`)
- Telemetry API server → Scheduled jobs: starts (evidence: `backend/src/server.ts`)
- Scheduled jobs → CSV reports: generates (evidence: `README.md`)
- Scheduled jobs → Email delivery: sends reports (evidence: `README.md`)
- Alert synchronization → PostgreSQL: updates alerts (evidence: `README.md`)
- Windows service supervisor → Windows process manager: manages (evidence: `avendpoint/windows-service/AgentService.cs`)
- Windows service supervisor → Windows pipe server: starts (evidence: `avendpoint/windows-service/AgentService.cs`)
- Windows pipe server → Windows process manager: controls (evidence: `avendpoint/windows-service/PipeServer.cs`)
- Windows tray UI → Windows pipe client: sends commands (evidence: `avendpoint/tray-manager/TrayForm.cs`)
- Windows pipe client → Windows pipe server: communicates (evidence: `README.md`)
- macOS launch service → macOS process manager: manages (evidence: `avendpoint-macos/EndpointAgentService/Sources/EndpointAgentService/main.swift`)
