How leblanc-simon/lotor works
Lotor is a self-hosted, multi-organization software-inventory and vulnerability-management service. Host and repository agents produce SBOMs; the server receives and analyzes them, then exposes cross-project search, findings, history, triage/VEX, license and policy decisions, and notifications. The README documents the main product capabilities; sampled source confirms API ingestion and key service responsibilities. Some internal wiring is unsampled, so uncertain subsystem links are omitted.
Main entry points: router.go Web routes · analyze.go Finding analysis · main.go Server runtime · search.go Cross-project search
Components 21
Inventory agents
- Host agent
internal/hostagent/agent.go - Repository agent
internal/repoagent/agent.go
Server intake
- Server runtime
cmd/lotor-server/main.go - Agent ingest API
internal/api/ingest.go - SBOM ingestion
internal/ingest/ingest.go - PostgreSQL
Analysis and inventory
- Projects
internal/project/project.go - Snapshots and history
internal/inventory/retention.go - Finding analysis
internal/finding/analyze.go - Vulnerability database
internal/vuln/manager.go
Risk response
- License policy
internal/license/service.go - Triage and VEX
internal/triage/service.go - CEL policies
internal/policy/service.go - Notifications
internal/notify/service.go - Audit log
internal/audit/audit.go
User experience
- Web routes
internal/web/router.go - Dashboard
internal/dashboard/read.go - Cross-project search
internal/search/search.go - Organizations and teams
internal/org/org.go - Signup
internal/signup/signup.go
Other components
- Operator
Connections 29
- Operator → Web routes: uses
- Operator → Host agent: installs
- Operator → Repository agent: configures
- Host agent → Agent ingest API: uploads SBOMs
- Repository agent → Agent ingest API: uploads SBOMs
- Repository agent → Repository agent: receives forge pushes
- Agent ingest API → SBOM ingestion: receives SBOM
internal/api/ingest.go - Server runtime → PostgreSQL: starts database
cmd/lotor-server/main.go - Server runtime → Web routes: starts services
- Server runtime → Finding analysis: configures analysis
- Server runtime → Vulnerability database: configures imports
- SBOM ingestion → PostgreSQL: stores ingestions
- SBOM ingestion → Projects: associates inventory
internal/ingest/ingest.go - Finding analysis → Snapshots and history: analyzes snapshots
internal/finding/analyze.go - Finding analysis → Vulnerability database: checks vulnerabilities
internal/finding/analyze.go - Vulnerability database → Finding analysis: reanalysis enables
- Web routes → Dashboard: serves dashboard
- Web routes → Cross-project search: serves search
- Web routes → Triage and VEX: serves triage
- Web routes → CEL policies: serves policies
- Cross-project search → Snapshots and history: searches history
internal/search/search.go - Cross-project search → Finding analysis: searches findings
internal/search/search.go - Cross-project search → License policy: searches licenses
internal/search/search.go - Triage and VEX → Audit log: records decisions
internal/triage/service.go - CEL policies → Notifications: routes alerts
- CEL policies → Audit log: records changes
internal/policy/service.go - License policy → Snapshots and history: evaluates components
internal/license/service.go - Signup → Organizations and teams: creates organization
internal/signup/signup.go - Organizations and teams → PostgreSQL: stores organization data
internal/org/org.go