How fayizzbanday/beehive.fsoc works
Beehive.fsoc is a beekeeping digital-twin and honey-traceability application. Beekeepers register apiaries and hives, submit hive video scans for risk assessment, and record harvest batches; shoppers verify a jar’s public passport, while authorities review risk and tamper alerts. The graph separates the web experience, Worker domain services, analysis engines, and proof infrastructure. The README documents the end-to-end product flow, but the Worker router and several domain modules were not excerpted, so those links are shown as unverified rather than asserted calls.
Main entry points: App.tsx Web routes · api.ts API client · index.ts API router · scans.ts Scan handling
Components 32
Web experience
- Web routes
beehive-main/apps/web/src/App.tsx - Video scan
beehive-main/apps/web/src/pages/Scan.tsx - Hive management
beehive-main/apps/web/src/pages/Hives.tsx - Batch creation
beehive-main/apps/web/src/pages/BatchWizard.tsx - Public verification
beehive-main/apps/web/src/pages/Verify.tsx - Authority console
beehive-main/apps/web/src/pages/Authority.tsx - Tamper review
beehive-main/apps/web/src/pages/Tamper.tsx - Forecasting
beehive-main/apps/web/src/pages/Forecast.tsx - Hive dashboard
beehive-main/apps/web/src/pages/Dashboard.tsx - Batch records
beehive-main/apps/web/src/pages/Batches.tsx - API client
beehive-main/apps/web/src/lib/api.ts
Worker services
- API router
beehive-main/apps/worker/src/index.ts - Sessions and roles
beehive-main/apps/worker/src/auth.ts - Hive records
beehive-main/apps/worker/src/hives.ts - Scan handling
beehive-main/apps/worker/src/scans.ts - Batch records
beehive-main/apps/worker/src/batches.ts - Evidence documents
beehive-main/apps/worker/src/documents.ts - Oversight services
beehive-main/apps/worker/src/authority.ts - Proof verification
beehive-main/apps/worker/src/verify.ts
Analysis engines
- Scan analysis
beehive-main/packages/scan-engine/src/index.ts - Forecast engine
beehive-main/packages/scan-engine/src/forecast.ts - Risk assessment
beehive-main/packages/risk-engine/src/index.ts
Proof and records
- Domain schemas
beehive-main/packages/shared/src/index.ts - Record proofs
beehive-main/apps/worker/src/proofs.ts - Canonical hashing
beehive-main/packages/shared/src/canonical.ts - Blockchain client
beehive-main/packages/blockchain/src/index.ts - Registry interface
beehive-main/packages/blockchain/src/abi.ts
Other components
- Beekeeper
- Shopper
- Authority user
- Ethereum network
- Worker database
Connections 48
- Web routes → Video scan: routes to
beehive-main/apps/web/src/App.tsx - Web routes → Hive management: routes to
beehive-main/apps/web/src/App.tsx - Web routes → Batch creation: routes to
beehive-main/apps/web/src/App.tsx - Web routes → Public verification: routes to
beehive-main/apps/web/src/App.tsx - Web routes → Authority console: routes to
beehive-main/apps/web/src/App.tsx - Web routes → Tamper review: routes to
beehive-main/apps/web/src/App.tsx - Web routes → Forecasting: routes to
beehive-main/apps/web/src/App.tsx - Web routes → Hive dashboard: routes to
beehive-main/apps/web/src/App.tsx - Web routes → Batch records: routes to
beehive-main/apps/web/src/App.tsx - Beekeeper → Video scan: submits video
- Beekeeper → Hive management: manages colonies
- Beekeeper → Batch creation: records harvest
- Shopper → Public verification: scans jar
- Authority user → Authority console: reviews alerts
- Video scan → API client: requests scans
beehive-main/apps/web/src/pages/Scan.tsx - Hive management → API client: requests records
beehive-main/apps/web/src/pages/Hives.tsx - Batch creation → API client: submits batch
beehive-main/apps/web/src/pages/BatchWizard.tsx - Public verification → API client: requests proof
beehive-main/apps/web/src/pages/Verify.tsx - Authority console → API client: requests oversight
beehive-main/apps/web/src/pages/Authority.tsx - Tamper review → API client: requests alerts
beehive-main/apps/web/src/pages/Tamper.tsx - Forecasting → API client: requests forecast
beehive-main/apps/web/src/pages/Forecast.tsx - Hive dashboard → API client: requests summaries
beehive-main/apps/web/src/pages/Dashboard.tsx - Batch records → API client: requests batches
beehive-main/apps/web/src/pages/Batches.tsx - API client → API router: calls API
- API router → Sessions and roles: dispatches auth
- API router → Hive records: dispatches hive routes
- API router → Scan handling: dispatches scan routes
- API router → Batch records: dispatches batch routes
- API router → Evidence documents: dispatches documents
- API router → Oversight services: dispatches oversight
- API router → Proof verification: dispatches verification
- Scan handling → Scan analysis: analyzes frames
- Scan analysis → Risk assessment: uses classification
beehive-main/packages/scan-engine/src/index.ts - Forecasting → Forecast engine: renders forecast
- Batch records → Risk assessment: assesses metadata
- Scan handling → Worker database: stores scan
- Hive records → Worker database: stores hive
- Batch records → Worker database: stores batch
- Oversight services → Worker database: reads alerts
- Proof verification → Record proofs: checks proof
- Record proofs → Canonical hashing: hashes record
- Record proofs → Blockchain client: anchors record
- Proof verification → Blockchain client: reads anchor
- Blockchain client → Registry interface: uses ABI
beehive-main/packages/blockchain/src/index.ts - Blockchain client → Ethereum network: reads and writes
- Scan handling → Domain schemas: uses schemas
- Batch records → Domain schemas: uses schemas
- Risk assessment → Domain schemas: uses domain types
beehive-main/packages/risk-engine/src/index.ts