How td-synnex/edge-beacon works
EDGE Beacon is an authenticated workspace for Cisco practice teams, spanning discovery, searchable program knowledge, customer context, learning, labs, and approvals. A signed-in user explores the UI and can submit a guided/AI discovery request or use Beacon features; the API verifies identity and routes requests to matching or narrow Jev judgments. The README documents major product branches not all sampled in source. Edges below are limited to visible imports/calls or explicit README statements; several feature-to-data relationships are documented rather than verified from implementation excerpts.
Main entry points: beacon-api.ts Beacon routes · main.ts Workspace controller · api.ts API router · views Practice views
Components 24
Workspace UI
- Workspace controller
src/main.ts - Beacon search
src/components/atlas-bar.ts - Customer context
src/components/context-pane.ts - Lab terminal
src/components/terminal.ts - Practice views
src/views
Practice Data
- Solutions and use cases
shared/catalog.ts - Workspace records
shared/edge-data.ts - Search index
shared/beacon-index.ts - Guided matching
shared/matcher.ts - Shared contracts
shared/edge-types.ts
API and Judgments
- API router
server/api.ts - Beacon routes
server/beacon-api.ts - Worker entry
server/worker.ts - Jev client
server/jev/client.ts - Search judgments
server/jev/search.ts - Discovery judgments
server/jev/match.ts - Inbox triage
server/jev/inbox.ts - Lab grading
server/jev/lab.ts - Opportunity checks
server/jev/opportunities.ts
Identity
- Sign-in client
src/auth.ts - Token verification
server/auth.ts
Other components
- Practice team
- Cognito
- TypeSafe System One
Connections 35
- Practice team → Workspace controller: uses
- Workspace controller → Sign-in client: signs in
src/main.ts - Workspace controller → Practice views: renders
src/main.ts - Workspace controller → Guided matching: uses matching
src/main.ts - Workspace controller → API router: posts discovery
src/main.ts - Workspace controller → Beacon search: mounts
src/main.ts - Practice views → Customer context: opens details
src/views/home-view.ts - Practice views → Lab terminal: uses lab console
src/views/develop-view.ts - Beacon search → Search index: searches
- Beacon search → Beacon routes: requests search
src/components/atlas-bar.ts - Customer context → Beacon routes: checks opportunities
src/components/context-pane.ts - Lab terminal → Beacon routes: requests grading
src/components/terminal.ts - Search index → Solutions and use cases: indexes
shared/beacon-index.ts - Search index → Workspace records: indexes
shared/beacon-index.ts - Guided matching → Solutions and use cases: matches against
shared/matcher.ts - Worker entry → API router: dispatches
server/worker.ts - API router → Token verification: verifies requests
server/api.ts - API router → Beacon routes: routes Beacon
server/api.ts - API router → Cognito: verifies token
- Beacon routes → Search judgments: dispatches
server/beacon-api.ts - Beacon routes → Discovery judgments: dispatches
server/beacon-api.ts - Beacon routes → Inbox triage: dispatches
server/beacon-api.ts - Beacon routes → Lab grading: dispatches
server/beacon-api.ts - Beacon routes → Opportunity checks: dispatches
server/beacon-api.ts - Search judgments → Search index: retrieves records
server/jev/search.ts - Search judgments → Jev client: asks judgments
server/jev/search.ts - Inbox triage → Jev client: asks judgments
server/jev/inbox.ts - Lab grading → Jev client: asks judgments
server/jev/lab.ts - Opportunity checks → Jev client: asks judgments
server/jev/opportunities.ts - Jev client → TypeSafe System One: queries
server/jev/client.ts - Beacon routes → Workspace records: uses workspace data
server/beacon-api.ts - Practice views → Workspace records: presents features
src/views/develop-view.ts - Practice views → Solutions and use cases: presents solutions
- API router → Solutions and use cases: discovery catalog
server/api.ts - Sign-in client → Cognito: signs in