How hei-school/vola works
Vola records application payments against a payment-service provider (currently Orange Money Madagascar), verifies them asynchronously, and exposes payment lookup and reporting APIs. Its Orange workflows also retrieve daily transactions for reconciliation and accept spreadsheet imports; payments can be exported as CSV. The graph shows the sampled controller, service, provider, and persistence calls. Event-consumer dispatch wiring and several paths listed in the tree were not sampled, so their links are omitted rather than inferred.
Main entry points: PaymentService.java Payment Service · PaymentController.java Payment Controller · OrangeSyncService.java Orange Sync · PaymentRepository.java Payment Repository
Components 21
Payment API
- Payment Controller
src/main/java/school/hei/vola/endpoint/rest/controller/PaymentController.java - API Authorization
src/main/java/school/hei/vola/endpoint/rest/security - Multipart Converter
src/main/java/school/hei/vola/service/MultipartFileConverter.java
Payment Workflows
- Payment Service
src/main/java/school/hei/vola/service/PaymentService.java - Payment Verification
src/main/java/school/hei/vola/service/event/PaymentVerificationRequestedService.java - Event Producer
src/main/java/school/hei/vola/endpoint/event/EventProducer.java - Event Consumer
src/main/java/school/hei/vola/endpoint/event/consumer/EventConsumer.java - Mailbox Handler
src/main/java/school/hei/vola/handler/MailboxEventHandler.java - Excel Parser
src/main/java/school/hei/vola/service/utils/ExcelParser.java - CSV Export
src/main/java/school/hei/vola/service/PaymentService.java
Orange Integration
- Orange Sync
src/main/java/school/hei/vola/service/OrangeSyncService.java - Daily Retrieval
src/main/java/school/hei/vola/service/event/OrangeDailyTransactionsRetrievalRequestedService.java - Orange API Client
src/main/java/school/hei/vola/model/psp/orange/OrangeApiClient.java - Orange PSP Provider
src/main/java/school/hei/vola/service/psp/PspProvider.java
Persistence
- Payment Repository
src/main/java/school/hei/vola/repository/PaymentRepository.java - Orange Payment Repository
src/main/java/school/hei/vola/repository/OrangePaymentRepository.java - Payment Database
src/main/java/school/hei/vola/repository/jpa/model/JPayment.java - Orange Transaction Database
src/main/java/school/hei/vola/repository/jpa/model/JOrangeTransaction.java - Transaction File Bucket
src/main/java/school/hei/vola/file/bucket/BucketComponent.java
Other components
- API Client
- Orange Money
Connections 24
- API Client → Payment Controller: calls API
src/main/java/school/hei/vola/endpoint/rest/controller/PaymentController.java - Payment Controller → API Authorization: authorizes
src/main/java/school/hei/vola/endpoint/rest/controller/PaymentController.java - Payment Controller → Payment Service: delegates to
src/main/java/school/hei/vola/endpoint/rest/controller/PaymentController.java - Payment Controller → Orange Sync: starts sync
src/main/java/school/hei/vola/endpoint/rest/controller/PaymentController.java - Payment Controller → Multipart Converter: converts upload
src/main/java/school/hei/vola/endpoint/rest/controller/PaymentController.java - Payment Service → Payment Repository: reads and writes
src/main/java/school/hei/vola/service/PaymentService.java - Payment Service → Event Producer: publishes events
src/main/java/school/hei/vola/service/PaymentService.java - Payment Service → Transaction File Bucket: uploads file
src/main/java/school/hei/vola/service/PaymentService.java - Payment Service → Excel Parser: delegates import
src/main/java/school/hei/vola/service/PaymentService.java - Payment Service → CSV Export: builds export
src/main/java/school/hei/vola/service/PaymentService.java - Payment Repository → Payment Database: persists payments
src/main/java/school/hei/vola/repository/PaymentRepository.java - Orange Sync → Orange API Client: fetches transactions
src/main/java/school/hei/vola/service/OrangeSyncService.java - Orange Sync → Orange Payment Repository: persists transactions
src/main/java/school/hei/vola/service/OrangeSyncService.java - Orange Sync → Payment Repository: finds payments
src/main/java/school/hei/vola/service/OrangeSyncService.java - Orange Sync → Payment Verification: triggers verification
src/main/java/school/hei/vola/service/OrangeSyncService.java - Daily Retrieval → Orange API Client: fetches transactions
src/main/java/school/hei/vola/service/event/OrangeDailyTransactionsRetrievalRequestedService.java - Daily Retrieval → Orange Transaction Database: saves transactions
src/main/java/school/hei/vola/service/event/OrangeDailyTransactionsRetrievalRequestedService.java - Daily Retrieval → Payment Repository: looks up payments
src/main/java/school/hei/vola/service/event/OrangeDailyTransactionsRetrievalRequestedService.java - Daily Retrieval → Payment Verification: triggers verification
src/main/java/school/hei/vola/service/event/OrangeDailyTransactionsRetrievalRequestedService.java - Orange Payment Repository → Orange Transaction Database: reads and writes
src/main/java/school/hei/vola/repository/OrangePaymentRepository.java - Payment Verification → Payment Repository: saves result
src/main/java/school/hei/vola/service/event/PaymentVerificationRequestedService.java - Payment Verification → Orange PSP Provider: selects provider
src/main/java/school/hei/vola/service/event/PaymentVerificationRequestedService.java - Orange API Client → Orange Money: requests transactions
src/main/java/school/hei/vola/model/psp/orange/OrangeApiClient.java - Mailbox Handler → Event Consumer: invokes consumer
src/main/java/school/hei/vola/handler/MailboxEventHandler.java