How alsaifybashar/synosec-buildathon works
SynoSec is an AI-assisted security discovery and orchestration platform. An analyst configures targets and workflows in the dashboard, starts a run through the backend, and receives streamed execution progress plus evidence-backed findings, coverage, reports, and attack paths. The backend reasons over observations, selects and brokers tools, and can dispatch execution through a remote connector; findings and relationships are persisted for review. The graph emphasizes documented product stages and indexed modules; unsampled subsystem links are included only where the README documents them.
Main entry points: workflow-execution.service.ts Workflow execution · App.tsx Security dashboard · tool-broker.ts Policy and tool broker · workflows.routes.ts Workflow run API
Components 23
Analyst experience
- Security dashboard
apps/frontend/src/app/App.tsx - Target management
apps/frontend/src/features/targets/page.tsx - Workflow console
apps/frontend/src/features/workflows/page.tsx - Reports and attack map
apps/frontend/src/features/execution-reports/page.tsx
Backend orchestration
- Backend API
apps/backend/src/app/register-routes.ts - Workflow run API
apps/backend/src/modules/workflows/workflows.routes.ts - Workflow execution
apps/backend/src/engine/workflow/workflow-execution.service.ts - Agent reasoning
apps/backend/src/engine/workflow - Target records
apps/backend/src/modules/targets
Tool execution
- AI tool registry
apps/backend/src/modules/ai-tools/ai-tools.routes.ts - Tool runtime
apps/backend/src/modules/ai-tools/tool-runtime.ts - AI tool runner
apps/backend/src/modules/ai-tools/ai-tool-runner.ts - Security tool catalog
apps/backend/src/engine/tools/tool-catalog.ts - Policy and tool broker
apps/backend/src/engine/workflow/broker/tool-broker.ts - Local tool execution
apps/backend/src/engine/tools/script-executor.ts - Remote connector
apps/connector/src/main.ts
Evidence and reporting
- Scan and evidence state
apps/backend/src/engine/scans/scan-store.ts - Evidence confidence
apps/backend/src/engine/workflow/broker/confidence-engine.ts - Attack-path correlation
apps/backend/src/engine/findings/cross-host-lateral-routes.ts - Execution reports
apps/backend/src/modules/execution-reports/execution-reports.service.ts
Shared contracts
- Shared schemas
packages/contracts/src/resources.ts
Other components
- Security analyst
- Authorized target
Connections 28
- Security analyst → Security dashboard: uses
- Security dashboard → Backend API: calls API
- Security dashboard → Target management: manages targets
- Security dashboard → Workflow console: configures runs
- Security dashboard → Reports and attack map: reviews results
- Backend API → Workflow run API: registers routes
- Workflow run API → Workflow execution: starts run
apps/backend/src/modules/workflows/workflows.routes.ts - Workflow execution → Agent reasoning: coordinates
- Workflow execution → Security tool catalog: selects tools
- Workflow execution → Policy and tool broker: dispatches requests
- Workflow execution → Scan and evidence state: records scan
- Workflow execution → Attack-path correlation: correlates findings
- Target management → Target records: manages records
- AI tool registry → Tool runtime: resolves tools
apps/backend/src/modules/ai-tools/ai-tools.routes.ts - Tool runtime → AI tool runner: runs tool
apps/backend/src/modules/ai-tools/ai-tools.routes.ts - AI tool runner → Tool runtime: uses runtime
apps/backend/src/modules/ai-tools/ai-tool-runner.ts - Policy and tool broker → Local tool execution: dispatches locally
- Policy and tool broker → Remote connector: dispatches remotely
- Local tool execution → Authorized target: probes
- Remote connector → Authorized target: executes tools
- Policy and tool broker → Scan and evidence state: records observations
- Scan and evidence state → Evidence confidence: supplies observations
- Workflow execution → Execution reports: produces reports
- Execution reports → Reports and attack map: serves reports
- Attack-path correlation → Reports and attack map: presents attack paths
- Workflow run API → Shared schemas: validates payloads
apps/backend/src/modules/workflows/workflows.routes.ts - AI tool registry → Shared schemas: validates tool data
apps/backend/src/modules/ai-tools/ai-tools.routes.ts - Security dashboard → Shared schemas: uses shared types