How razdeep/openconsignment works
OpenConsignment is a JavaFX desktop application for consignment accounting. Its principal workflow is entering bills and their lorry-receipt details, then recording buyer collections and supplier payments against pending bills; users can review history and generate buyer, supplier, and transport ledgers, including agewise reports. The code is organized around feature controllers, domain services, and JDBC repositories, with local SQLite storage and JasperReports PDF generation. Some feature links and subsystem details are documented in the README or indicated by the SOURCE INDEX; unsampled implementation calls are not asserted.
Main entry points: BuyerService.java Buyer service · SupplierService.java Supplier service · CollectionService.java Collection service · PaymentService.java Payment service
Components 25
Desktop interface
- Main navigation
src/main/java/openconsignment/controller/MainController.java - View loader
src/main/java/openconsignment/common/ViewLoader.java - Master data screens
src/main/java/openconsignment/controller/master - Bill entry and history
src/main/java/openconsignment/controller/entry/bill - Collection screens
src/main/java/openconsignment/controller/entry/collection - Payment screens
src/main/java/openconsignment/controller/entry/payment - Transaction history
src/main/java/openconsignment/controller/history - Ledger screens
src/main/java/openconsignment/controller/report
Consignment operations
- Bill service
src/main/java/openconsignment/service/BillService.java - Collection service
src/main/java/openconsignment/service/CollectionService.java - Payment service
src/main/java/openconsignment/service/PaymentService.java - Buyer service
src/main/java/openconsignment/service/BuyerService.java - Supplier service
src/main/java/openconsignment/service/SupplierService.java - Transport service
src/main/java/openconsignment/service/TransportService.java
Ledgers and reports
- PDF generation
src/main/java/openconsignment/common/Utils.java
Domain and persistence
- Transaction entities
src/main/java/openconsignment/entity - Ledger read models
src/main/java/openconsignment/model - Bill repository
src/main/java/openconsignment/repository/BillRepository.java - Collection repository
src/main/java/openconsignment/repository/CollectionRepository.java - Payment repository
src/main/java/openconsignment/repository/PaymentRepository.java - Buyer repository
src/main/java/openconsignment/repository/BuyerRepository.java - Supplier repository
src/main/java/openconsignment/repository/SupplierRepository.java - Transport repository
src/main/java/openconsignment/repository/TransportRepository.java
Other components
- User
- SQLite database
Connections 29
- User → Main navigation: uses
- Main navigation → View loader: loads views
src/main/java/openconsignment/controller/MainController.java - Bill entry and history → Bill service: calls
src/main/java/openconsignment/controller/entry/bill/AddBillController.java - Collection screens → Collection service: calls
src/main/java/openconsignment/controller/entry/collection/AddCollectionController.java - Payment screens → Payment service: calls
src/main/java/openconsignment/controller/entry/payment/AddPaymentController.java - Master data screens → Buyer service: manages buyers
src/main/java/openconsignment/controller/master/SupplierController.java - Master data screens → Supplier service: manages suppliers
src/main/java/openconsignment/controller/master/SupplierController.java - Master data screens → Transport service: manages transports
src/main/java/openconsignment/controller/master/TransportController.java - Ledger screens → Buyer service: requests ledgers
src/main/java/openconsignment/controller/report/SupplierLedgerController.java - Ledger screens → Supplier service: requests ledgers
src/main/java/openconsignment/controller/report/SupplierLedgerController.java - Ledger screens → Transport service: requests ledgers
src/main/java/openconsignment/controller/report/TransportLedgerController.java - Transaction history → Bill service: reads history
src/main/java/openconsignment/controller/history/BillHistoryController.java - Bill service → Bill repository: delegates
src/main/java/openconsignment/service/BillService.java - Collection service → Collection repository: delegates
src/main/java/openconsignment/service/CollectionService.java - Payment service → Payment repository: delegates
src/main/java/openconsignment/service/PaymentService.java - Buyer service → Buyer repository: delegates
src/main/java/openconsignment/service/BuyerService.java - Supplier service → Supplier repository: delegates
src/main/java/openconsignment/service/SupplierService.java - Bill repository → SQLite database: reads and writes
- Collection repository → SQLite database: reads and writes
- Payment repository → SQLite database: reads and writes
- Buyer repository → SQLite database: reads and writes
- Supplier repository → SQLite database: reads and writes
- Transport repository → SQLite database: reads and writes
- Buyer service → Collection service: fetches collection data
src/main/java/openconsignment/service/BuyerService.java - Supplier service → Payment service: fetches payment data
src/main/java/openconsignment/service/SupplierService.java - Buyer service → PDF generation: generates ledger PDF
src/main/java/openconsignment/service/BuyerService.java - Supplier service → PDF generation: generates ledger PDF
src/main/java/openconsignment/service/SupplierService.java - Collection service → PDF generation: generates voucher PDF
src/main/java/openconsignment/service/CollectionService.java - Payment service → PDF generation: generates voucher PDF
src/main/java/openconsignment/service/PaymentService.java