How prahalcoder/honeychain works
Honey Chain combines beekeeper and trader operations, KVIC oversight, hive monitoring, and public honey verification. The main traceability workflow records organization and harvest activity through the Keeper-facing API, persists business data, and exposes batch or jar verification to consumers. Admin provides jurisdictional approvals and inspections; trade and public purchasing are related product branches. The excerpts establish server startup, route mounting, database setup, and the IoT monitor’s telemetry and camera responsibilities; other subsystem links rely on README descriptions and are kept high-level.
Main entry points: server.js Express API · app.py Hive monitor API · src/App.jsx Keeper app · src/App.jsx KVIC Admin
Components 24
User workspaces
- Keeper app
APICtech/frontend/src/App.jsx - KVIC Admin
apictech-admin/src/App.jsx - Keeper trade workspace
APICtech/frontend/src/pages/trade/Market.jsx
API and domain
- Express API
APICtech/backend/src/server.js - Authentication
APICtech/backend/src/routes/auth.js - Organization routes
APICtech/backend/src/routes/org.js - Traceability routes
APICtech/backend/src/routes/traceability.js - Admin routes
APICtech/backend/src/routes/admin.js - Trade routes
APICtech/backend/src/routes/trade.js - Shop routes
APICtech/backend/src/routes/shop.js - QR verification
APICtech/backend/src/routes/traceability.js
Records and ledger
- Common and company data
APICtech/backend/src/database/database.js - Blockchain ledger
APICtech/backend/src/services/blockchain.js - Pinned documents
APICtech/backend/src/services/ipfs.js
Hive monitoring
- Hive monitor API
APICtech/beehive/python_app/app.py - Telemetry logs
APICtech/beehive/python_app/database.py - Camera capture
APICtech/beehive/python_app/camera_manager.py - Hive health insights
APICtech/beehive/python_app/insights.py
Public access
- Public website
honeychain-web/src/App.jsx - Verification panel
honeychain-web/src/Verify.jsx
Other components
- Beekeeper
- KVIC officer
- ESP32 hive sensors
- Honey buyer
Connections 24
- Beekeeper → Keeper app: uses
- KVIC officer → KVIC Admin: uses
- Keeper app → Express API: API requests
- KVIC Admin → Express API: API requests
- Express API → Authentication: mounts routes
- Express API → Organization routes: mounts routes
- Express API → Traceability routes: mounts routes
- Express API → Admin routes: mounts routes
- Express API → Trade routes: mounts routes
- Express API → Shop routes: mounts routes
- Express API → Common and company data: initializes
- Express API → Blockchain ledger: starts chain
- Express API → Blockchain ledger: seals pending block
- Keeper app → Keeper trade workspace: opens trade
- Keeper trade workspace → Express API: API requests
- Honey buyer → Public website: visits or scans QR
- Public website → Verification panel: renders verification
- Verification panel → Express API: verification request
- QR verification → Common and company data: reads registry
- ESP32 hive sensors → Hive monitor API: sends readings
- Hive monitor API → Telemetry logs: stores readings
- Hive monitor API → Camera capture: controls capture
- Hive monitor API → Telemetry logs: reads recent logs
- Hive monitor API → Hive health insights: analyzes readings