How lakshay1509/mykaarma works
This is a vehicle-service appointment booking and reminder service. A dealer or booking UI submits an idempotent appointment request; the API validates and books it, persisting the appointment and its 24-hour and 2-hour reminder rows together. Workers claim due rows from PostgreSQL, send notifications, and record outcomes. The README documents cancellation, rescheduling, reminder lookup, retry and deduplication guarantees, and Prometheus monitoring. Source excerpts show the booking, API, claim, and send paths; less-detailed operational capabilities are linked only where documented.
Main entry points: AppointmentController.java Appointment endpoints · AppointmentService.java Booking lifecycle · Dispatcher.java Dispatcher workers · ReminderRepository.java Reminder queue repository
Components 20
Booking API
- Appointment endpoints
src/main/java/com/mykaarma/reminders/appointment/AppointmentController.java - Booking request
src/main/java/com/mykaarma/reminders/appointment/CreateAppointmentRequest.java - Appointment response
src/main/java/com/mykaarma/reminders/appointment/AppointmentResponse.java - Reminder response
src/main/java/com/mykaarma/reminders/reminder/ReminderResponse.java
Appointment domain
- Booking lifecycle
src/main/java/com/mykaarma/reminders/appointment/AppointmentService.java - Appointment
src/main/java/com/mykaarma/reminders/appointment/Appointment.java - Dealership
src/main/java/com/mykaarma/reminders/appointment/Dealership.java
Reminder delivery
- Reminder state
src/main/java/com/mykaarma/reminders/reminder/Reminder.java - Reminder timing
src/main/java/com/mykaarma/reminders/reminder/ReminderType.java - Dispatcher workers
src/main/java/com/mykaarma/reminders/reminder/Dispatcher.java - Notification payload
src/main/java/com/mykaarma/reminders/notification/NotificationPayload.java - Sender interface
src/main/java/com/mykaarma/reminders/notification/NotificationSender.java - Logging sender
src/main/java/com/mykaarma/reminders/notification/LoggingNotificationSender.java - Send outcome
src/main/java/com/mykaarma/reminders/notification/SendResult.java
PostgreSQL state
- Appointment repository
src/main/java/com/mykaarma/reminders/appointment/AppointmentRepository.java - Dealership lookup
src/main/java/com/mykaarma/reminders/appointment/DealershipRepository.java - Reminder queue repository
src/main/java/com/mykaarma/reminders/reminder/ReminderRepository.java - PostgreSQL
Other components
- Dealer / booking UI
- Prometheus
Connections 22
- Dealer / booking UI → Appointment endpoints: submits requests
README.md - Appointment endpoints → Booking request: accepts
src/main/java/com/mykaarma/reminders/appointment/AppointmentController.java - Appointment endpoints → Booking lifecycle: delegates booking
src/main/java/com/mykaarma/reminders/appointment/AppointmentController.java - Booking lifecycle → Dealership lookup: looks up dealership
src/main/java/com/mykaarma/reminders/appointment/AppointmentService.java - Booking lifecycle → Appointment repository: reads and saves
src/main/java/com/mykaarma/reminders/appointment/AppointmentService.java - Booking lifecycle → Reminder queue repository: writes reminders
src/main/java/com/mykaarma/reminders/appointment/AppointmentService.java - Booking lifecycle → Appointment: creates and updates
src/main/java/com/mykaarma/reminders/appointment/AppointmentService.java - Booking lifecycle → Reminder state: creates reminder rows
src/main/java/com/mykaarma/reminders/appointment/AppointmentService.java - Reminder state → Reminder timing: gets due time
src/main/java/com/mykaarma/reminders/reminder/Reminder.java - Appointment → Dealership: references
src/main/java/com/mykaarma/reminders/appointment/Appointment.java - Appointment endpoints → Appointment response: returns booking
src/main/java/com/mykaarma/reminders/appointment/AppointmentController.java - Appointment endpoints → Reminder queue repository: loads appointment reminders
src/main/java/com/mykaarma/reminders/appointment/AppointmentController.java - Appointment endpoints → Reminder response: returns reminder list
src/main/java/com/mykaarma/reminders/appointment/AppointmentController.java - Dispatcher workers → Reminder queue repository: claims and settles
src/main/java/com/mykaarma/reminders/reminder/Dispatcher.java - Dispatcher workers → Notification payload: builds payload
src/main/java/com/mykaarma/reminders/reminder/Dispatcher.java - Dispatcher workers → Sender interface: sends notification
src/main/java/com/mykaarma/reminders/reminder/Dispatcher.java - Sender interface → Logging sender: implemented by
README.md - Logging sender → Send outcome: returns outcome
src/main/java/com/mykaarma/reminders/notification/LoggingNotificationSender.java - Appointment repository → PostgreSQL: persists appointments
README.md - Dealership lookup → PostgreSQL: reads dealership data
README.md - Reminder queue repository → PostgreSQL: claims and stores queue
README.md - Prometheus → Dispatcher workers: scrapes metrics