How d4m13n-d3v/mechanicbuddy works
MechanicBuddy is workshop-management software with a customer-facing web app and a separate SaaS control plane. The shop workflow runs from authenticated staff using the web UI, through the backend API, to managing clients, vehicles, work orders, inventory, and pricing; estimates and invoices can be rendered as PDFs and emailed. The management portal handles tenant operations such as provisioning and billing. The README documents the major capabilities and deployment modes; source excerpts confirm selected API, domain, and tenant-service relationships, but most feature-controller wiring was not sampled.
Main entry points: MechanicBuddy.Http.Api/Program.cs Workshop API · MechanicBuddy.Management.Api/Program.cs Management API · TenantService.cs Tenant operations · MechanicBuddy.Core.Domain Domain model
Components 24
Workshop web app
- Shop web UI
frontend/src/app/home - Web API client
frontend/src/_lib/server/query-api.ts
Workshop backend
- Workshop API
backend/src/MechanicBuddy.Http.Api/Program.cs - Authentication
backend/src/MechanicBuddy.Core.Application/Authorization - Clients and vehicles
backend/src/MechanicBuddy.Core.Domain/Clients/Client.cs - Work orders
backend/src/MechanicBuddy.Core.Domain/Work/Work.cs - Parts and inventory
backend/src/MechanicBuddy.Core.Domain/Storage.cs - Estimates and invoices
backend/src/MechanicBuddy.Core.Domain/Pricings/Pricing.cs - PDF and email
backend/src/MechanicBuddy.Core.Application/Services/PdfGenerator.cs - Domain model
backend/src/MechanicBuddy.Core.Domain
Workshop persistence
- Repositories
backend/src/MechanicBuddy.Core.Persistence.Postgres/GenericRepository.cs - Tenant databases
backend/src/MechanicBuddy.Core.Persistence.Postgres/NHibernate/MultiTenancyConnectionDriver.cs
SaaS control plane
- Management API
backend/src/MechanicBuddy.Management.Api/Program.cs - Tenant operations
backend/src/MechanicBuddy.Management.Api/Services/TenantService.cs - Tenant records
backend/src/MechanicBuddy.Management.Api/Repositories/TenantRepository.cs - Tenant provisioning
backend/src/MechanicBuddy.Management.Api/Services/TenantProvisioningService.cs - Billing
backend/src/MechanicBuddy.Management.Api/Services/BillingService.cs - Platform analytics
backend/src/MechanicBuddy.Management.Api/Services/AnalyticsService.cs - Deployment services
backend/src/MechanicBuddy.Management.Api/Infrastructure/KubernetesClient.cs
Management portal
- Management portal
management-portal/src/app/dashboard
Other components
- Shop staff
- SaaS operators
- Cloud infrastructure
- SMTP mail
Connections 25
- Shop staff → Shop web UI: uses
README.md - Shop web UI → Web API client: requests data
- Web API client → Workshop API: calls API
README.md - Workshop API → Authentication: authorizes
- Workshop API → Clients and vehicles: manages
- Workshop API → Work orders: manages
- Workshop API → Parts and inventory: manages
- Workshop API → Estimates and invoices: manages
- Workshop API → Repositories: uses
- Workshop API → Tenant databases: queries
- Repositories → Tenant databases: persists
README.md - Clients and vehicles → Domain model: models
backend/src/MechanicBuddy.Core.Domain/Clients/Client.cs - Work orders → Domain model: models
backend/src/MechanicBuddy.Core.Domain/Pricings/Estimate.cs - Parts and inventory → Domain model: models
backend/src/MechanicBuddy.Core.Domain/Storage.cs - Estimates and invoices → PDF and email: generates documents
README.md - PDF and email → SMTP mail: emails PDFs
README.md - SaaS operators → Management portal: uses
- Management portal → Management API: calls API
- Management API → Tenant operations: routes tenant operations
backend/src/MechanicBuddy.Management.Api/Program.cs - Tenant operations → Tenant records: reads and writes
backend/src/MechanicBuddy.Management.Api/Services/TenantService.cs - Tenant operations → Tenant provisioning: provisions tenants
README.md - Tenant operations → Deployment services: manages deployments
backend/src/MechanicBuddy.Management.Api/Services/TenantService.cs - Management API → Billing: supports billing
README.md - Management API → Platform analytics: supports analytics
README.md - Deployment services → Cloud infrastructure: deploys infrastructure
README.md