Quotes

Overview (C4 Component)

Black-box description of components

Component	Responsibility	Provided Interface(s)	Consumed Interface(s)
QuoteController	Entry point for quote CRUD & status updates.	REST /api/v1/quotes/** (OpenAPI)	—
QuoteService	Implements all quote use-cases; assigns numbers, authorises, validates; coordinates sub-services; fires domain events.	Java/Spring service (called only by the controller)	Repos, Status Service, Number Generator, Mapper, DomainEventPublisher, RequestForQuotationStatusService
QuoteRepository	Persistence of Quote aggregate.	Spring-Data JPA	MySQL via JDBC
QuoteNumberGenerator	Creates sequential numbers using a per-year QuoteNumberSequence.	Java class	QuoteNumberSequenceRepository
QuoteStatusService	Pure domain logic: legal status transitions & side-effects.	Java class	QuoteRepository, RequestForQuotationStatusService
QuoteMapper / QuoteMapperResolver	MapStruct mappers + helper to resolve Provider & Truck.	Java interface / component	ProviderService, TruckService
DomainEventPublisher	Publishes Spring events (QuoteCreatedEvent, QuoteStatusChangedEvent, QuoteCancelledByEsUserEvent).	Spring ApplicationEventPublisher	—
QuoteNotificationListener	Listens to quote events, calls NotificationService (external) to push e-mail + WebSocket.	Spring event listener	Domain events
QuoteNumberSequenceRepository	Persists per-year numeric sequence.	Spring-Data JPA	MySQL
Entities (Quote, QuoteNumberSequence)	ORM mapping of aggregates and sequence table.	JPA	—

Important internal interfaces

Name	Signature / Protocol	Notes
provideQuote	POST /api/v1/requestForQuotationsItems/{rfqItemId}/quotes – body QuoteCreateRequest	Provider-only; validates provider is assigned to RFQ.
listQuotesForItem	GET /api/v1/requestForQuotationsItems/{rfqItemId}/quotes	ES staff see all, providers see only their own.
updateQuote	PUT /api/v1/quotes/{number}	Allowed for ES staff or quote author while status = PENDING.
patchQuoteStatus	PATCH /api/v1/quotes/{number} – body {status}	Uses QuoteStatusService.changeStatus(...); can trigger cascaded status changes.
Quote-created event	QuoteCreatedEvent { quoteId }	Translates into notification & RFQ item status recalculation.
Quote-status-changed event	QuoteStatusChangedEvent { quoteId, newStatus }	Same consumer flow.
Quote-cancelled-by-staff event	QuoteCancelledByEsUserEvent { quoteId }	Triggered when ES user withdraws a quote.