# rakshit096/vehicle_service_tracker architecture

> Architecture diagram of the GitHub repository rakshit096/vehicle_service_tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rakshit096/vehicle_service_tracker
- Repository: https://github.com/rakshit096/vehicle_service_tracker

## Overview

This is a Rails API for tracking vehicle servicing: registration and odometer records provide the context for service completion, due-target calculation, and alerts. The principal workflow visible in the sampled code validates a vehicle, agent, service type, and reading; resolves due rules; then records the odometer and service transactionally and can resolve a matching alert. Other service modules indicate account, reporting, invoicing, and scheduled-check capabilities. Routes expose only Rails’ health check in the sampled tree, so the public request path and job dispatch wiring are not established.

Main entry points: [`app/services/service_completion_service.rb`](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/service_completion_service.rb) (Service completion), [`config/application.rb`](https://github.com/rakshit096/vehicle_service_tracker/blob/main/config/application.rb) (Rails API), [`app/services/due_service_checker.rb`](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/due_service_checker.rb) (Schedule due checks), [`config/boot.rb`](https://github.com/rakshit096/vehicle_service_tracker/blob/main/config/boot.rb) (Boot setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_app["Rails API<br/>[application.rb]"]
  node_boot["Boot setup<br/>[boot.rb]"]
  node_database[("Application database<br/>[schema.rb]")]
end

subgraph group_accounts["Accounts and vehicles"]
  node_records["Vehicle records<br/>[vehicle.rb]"]
  node_accounts_ops["Account services<br/>[signup_service.rb]"]
  node_registration["Vehicle registration"]
end

subgraph group_servicing["Service lifecycle"]
  node_completion["Service completion"]
  node_rule_resolver["Rule resolver"]
  node_rule_strategies["Rule strategies<br/>[base_strategy.rb]"]
  node_service_data["Service records<br/>[service_record.rb]"]
  node_odometer["Odometer logs<br/>[odometer_log.rb]"]
  node_reports["Service reports"]
  node_invoices["Invoice recording"]
  node_result["Operation result<br/>[service_result.rb]"]
end

subgraph group_alerts["Due checks and alerts"]
  node_due_checker["Schedule due checks"]
  node_due_v2["Alternate due checks"]
  node_general_check["General checks"]
  node_target_strategies["Due-target strategies"]
  node_alert_generator["Alert generation<br/>[alert_generator.rb]"]
  node_alert_dismiss["Alert dismissal<br/>[alert_dismisser.rb]"]
  node_alerts_data["Alert records<br/>[alert.rb]"]
end

node_user(("API client"))

node_app -->|"requires"| node_boot
node_user -.->|"API requests"| node_app
node_completion -->|"resolves rules"| node_rule_resolver
node_completion -->|"looks up vehicle"| node_records
node_completion -->|"creates record"| node_service_data
node_completion -->|"writes reading"| node_odometer
node_completion -->|"checks and resolves"| node_alerts_data
node_due_checker -->|"generates alerts"| node_alert_generator

click node_app "https://github.com/rakshit096/vehicle_service_tracker/blob/main/config/application.rb"
click node_boot "https://github.com/rakshit096/vehicle_service_tracker/blob/main/config/boot.rb"
click node_records "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/models/vehicle.rb"
click node_accounts_ops "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/signup_service.rb"
click node_registration "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/vehicle_registrar.rb"
click node_completion "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/service_completion_service.rb"
click node_rule_resolver "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/service_rule_resolver.rb"
click node_rule_strategies "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/stage_strategies/base_strategy.rb"
click node_service_data "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/models/service_record.rb"
click node_odometer "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/models/odometer_log.rb"
click node_reports "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/service_report_recorder.rb"
click node_invoices "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/invoice_recorder.rb"
click node_result "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/service_result.rb"
click node_due_checker "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/due_service_checker.rb"
click node_due_v2 "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/due_service_checker_v2.rb"
click node_general_check "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/general_service_checker.rb"
click node_target_strategies "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/due_target_strategies/model_schedule_strategy.rb"
click node_alert_generator "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/alert_generator.rb"
click node_alert_dismiss "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/alert_dismisser.rb"
click node_alerts_data "https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/models/alert.rb"
click node_database "https://github.com/rakshit096/vehicle_service_tracker/blob/main/db/schema.rb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_boot,node_database,node_user toneBlue
class node_records,node_accounts_ops,node_registration toneAmber
class node_completion,node_rule_resolver,node_rule_strategies,node_service_data,node_odometer,node_reports,node_invoices,node_result toneMint
class node_due_checker,node_due_v2,node_general_check,node_target_strategies,node_alert_generator,node_alert_dismiss,node_alerts_data toneRose
```

## Components

### API runtime

- [Rails API](https://github.com/rakshit096/vehicle_service_tracker/blob/main/config/application.rb): `config/application.rb`
- [Boot setup](https://github.com/rakshit096/vehicle_service_tracker/blob/main/config/boot.rb): `config/boot.rb`
- [Application database](https://github.com/rakshit096/vehicle_service_tracker/blob/main/db/schema.rb): `db/schema.rb`

### Accounts and vehicles

- [Vehicle records](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/models/vehicle.rb): `app/models/vehicle.rb`
- [Account services](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/signup_service.rb): `app/services/signup_service.rb`
- [Vehicle registration](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/vehicle_registrar.rb): `app/services/vehicle_registrar.rb`

### Service lifecycle

- [Service completion](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/service_completion_service.rb): `app/services/service_completion_service.rb`
- [Rule resolver](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/service_rule_resolver.rb): `app/services/service_rule_resolver.rb`
- [Rule strategies](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/stage_strategies/base_strategy.rb): `app/services/stage_strategies/base_strategy.rb`
- [Service records](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/models/service_record.rb): `app/models/service_record.rb`
- [Odometer logs](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/models/odometer_log.rb): `app/models/odometer_log.rb`
- [Service reports](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/service_report_recorder.rb): `app/services/service_report_recorder.rb`
- [Invoice recording](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/invoice_recorder.rb): `app/services/invoice_recorder.rb`
- [Operation result](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/service_result.rb): `app/services/service_result.rb`

### Due checks and alerts

- [Schedule due checks](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/due_service_checker.rb): `app/services/due_service_checker.rb`
- [Alternate due checks](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/due_service_checker_v2.rb): `app/services/due_service_checker_v2.rb`
- [General checks](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/general_service_checker.rb): `app/services/general_service_checker.rb`
- [Due-target strategies](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/due_target_strategies/model_schedule_strategy.rb): `app/services/due_target_strategies/model_schedule_strategy.rb`
- [Alert generation](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/alert_generator.rb): `app/services/alert_generator.rb`
- [Alert dismissal](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/services/alert_dismisser.rb): `app/services/alert_dismisser.rb`
- [Alert records](https://github.com/rakshit096/vehicle_service_tracker/blob/main/app/models/alert.rb): `app/models/alert.rb`

### Other components

- **API client**

## Connections

- Rails API → Boot setup: requires (evidence: `config/application.rb`)
- API client → Rails API: API requests
- Service completion → Rule resolver: resolves rules (evidence: `app/services/service_completion_service.rb`)
- Service completion → Vehicle records: looks up vehicle (evidence: `app/services/service_completion_service.rb`)
- Service completion → Service records: creates record (evidence: `app/services/service_completion_service.rb`)
- Service completion → Odometer logs: writes reading (evidence: `app/services/service_completion_service.rb`)
- Service completion → Alert records: checks and resolves (evidence: `app/services/service_completion_service.rb`)
- Schedule due checks → Alert generation: generates alerts (evidence: `app/services/due_service_checker.rb`)
