How trunganhlaptrinh/mini-agritrace works
Mini AgriTrace is a consortium ledger application for signed agricultural batch histories. Organization users submit lifecycle and governance transactions; shipment proposals add a sender/carrier endorsement handoff. Services route submissions into the pending pool and block production, while nodes validate and synchronize ledger data. Public visitors can read allowlisted batch traces and open them via QR links. The graph also includes authentication, persistence, and offline consortium bootstrap. Most servlet, network, and projection details are represented at package level because their implementations were not sampled.
Main entry points: controller HTTP servlets · TransactionService.java Transaction submission · Blockchain.java Chain replay and fork choice · PeerLedgerService.java Peer synchronization
Components 25
Web access
- HTTP servlets
src/main/java/controller - Security filters
src/main/java/security - Browser UI
src/main/webapp/js/app.js
Application workflows
- Authentication
src/main/java/service/AuthenticationService.java - Batch workflows
src/main/java/service/BatchService.java - Shipment handoff
src/main/java/service/ShipmentProposalService.java - Public trace
src/main/java/service/TraceabilityService.java - Governance workflows
src/main/java/service/GovernanceService.java - Transaction submission
src/main/java/service/TransactionService.java
Ledger and governance
- Pending pool
src/main/java/blockchain/TransactionPool.java - Block production
src/main/java/blockchain/BlockProducer.java - Chain replay and fork choice
src/main/java/blockchain/Blockchain.java - Block validation
src/main/java/blockchain/BlockValidator.java - Validation context
src/main/java/blockchain/BlockValidationContext.java - Canonical governance state
src/main/java/blockchain/GovernanceRegistry.java - Block repository
src/main/java/blockchain/BlockRepository.java
Consortium operations
- Peer synchronization
src/main/java/service/PeerLedgerService.java - Peer transport and relays
src/main/java/network - Offline bootstrap
src/main/java/bootstrap/ConsortiumBootstrapService.java
Persistence
- Transaction persistence
src/main/java/dal/TransactionDAO.java - Block persistence
src/main/java/dal/BlockDAO.java - Account persistence
src/main/java/dal/UserDAO.java - MySQL node database
Other components
- Users and visitors
- Consortium peers
Connections 31
- Users and visitors → Browser UI: uses
- Browser UI → HTTP servlets: calls
- HTTP servlets → Security filters: passes through
src/main/java/controller/AuthenticationSessionServlet.java - HTTP servlets → Authentication: invokes
src/main/java/controller/AuthenticationSessionServlet.java - HTTP servlets → Batch workflows: invokes
- HTTP servlets → Shipment handoff: invokes
- HTTP servlets → Public trace: invokes
- HTTP servlets → Governance workflows: invokes
- Batch workflows → Transaction submission: submits events
src/main/java/service/BatchService.java - Governance workflows → Transaction submission: submits changes
src/main/java/service/GovernanceService.java - Shipment handoff → Chain replay and fork choice: checks canonical state
src/main/java/service/ShipmentProposalService.java - Shipment handoff → Transaction submission: submits endorsed event
src/main/java/service/ShipmentProposalService.java - Public trace → Chain replay and fork choice: reads chain state
src/main/java/service/TraceabilityService.java - Authentication → Account persistence: reads accounts
src/main/java/service/AuthenticationService.java - Transaction submission → Pending pool: submits transactions
src/main/java/service/TransactionService.java - Transaction submission → Block production: produces block
src/main/java/service/TransactionService.java - Transaction submission → Transaction persistence: reads status
src/main/java/service/TransactionService.java - Chain replay and fork choice → Block repository: loads and stores blocks
src/main/java/blockchain/Blockchain.java - Chain replay and fork choice → Block validation: validates blocks
src/main/java/blockchain/Blockchain.java - Block validation → Validation context: uses context
src/main/java/blockchain/BlockValidationContext.java - Consortium peers → Peer transport and relays: exchanges ledger data
- Peer transport and relays → Peer synchronization: delivers peer data
src/main/java/network/PeerClient.java - Peer synchronization → Chain replay and fork choice: processes blocks
src/main/java/service/PeerLedgerService.java - Peer synchronization → Transaction submission: submits transactions
src/main/java/service/PeerLedgerService.java - Peer synchronization → Transaction persistence: accesses pending data
src/main/java/service/PeerLedgerService.java - Offline bootstrap → Chain replay and fork choice: validates ledger
src/main/java/bootstrap/ConsortiumBootstrapService.java - Offline bootstrap → Block persistence: initializes blocks
src/main/java/bootstrap/ConsortiumBootstrapService.java - Offline bootstrap → Account persistence: creates admin account
src/main/java/bootstrap/ConsortiumBootstrapService.java - Transaction persistence → MySQL node database: persists transactions
- Block persistence → MySQL node database: persists blocks
- Account persistence → MySQL node database: persists accounts