# Vito Business OS

## Docs

- [AI](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/ai.md): AI-powered business profile generation and optimization. All operations are asynchronous.
- [Analytics](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/analytics.md): Track page views, interactions, and conversion events for tenant storefronts.
- [Auth endpoints](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/auth.md): Register, OTP generation and verification, social login, and current user profile.
- [Authentication](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/authentication.md): How to authenticate requests to the Vito Business OS API using Laravel Sanctum bearer tokens.
- [Coupons & Checkout](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/coupons.md): Verify coupon codes, list available discounts, manage cart coupon state, and hold inventory during checkout.
- [gRPC proto](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/grpc-proto.md): Protocol Buffer definition for the Identity service used in service-to-service communication.
- [JSON schemas](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/json-schemas.md): JSON Schema contracts for domain events and API response shapes in Vito Business OS.
- [Notifications](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/notifications.md): List, count, and mark notifications as read. Manage browser push subscriptions.
- [Orders](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/orders.md): Create orders through the public checkout and manage tenant orders with full status lifecycle.
- [API Reference](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/overview.md): Complete reference for the Vito Business OS REST API v1.
- [Products](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/products.md): Public product catalog endpoints with tenant scoping and 600-second response caching.
- [Rate limiting](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/rate-limiting.md): Named throttle groups, their limits, and how to handle 429 responses.
- [Reports & exports](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/reports.md): Generate sales, inventory, and kitchen reports. Download files via signed URLs.
- [TypeScript types](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/typescript-types.md): Auto-generated TypeScript type definitions derived from PHP enums and domain objects.
- [Webhooks](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/api/webhooks.md): Inbound payment webhook endpoint, signature verification, supported events, and idempotency handling.
- [Bounded contexts](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/architecture/bounded-contexts.md): All fifteen bounded contexts in Vito Business OS: what each one owns, which domain events it emits, and how contexts communicate.
- [Modular monolith](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/architecture/modular-monolith.md): Why Vito Business OS chose a modular monolith over microservices, how each layer is structured, and the four rules that keep it clean.
- [Architecture overview](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/architecture/overview.md): How Vito Business OS is structured: four strict layers, screaming architecture, and unidirectional dependency flow.
- [Request lifecycle](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/architecture/request-lifecycle.md): The Golden Path for a write operation in Vito Business OS — from HTTP request to committed database state and dispatched domain event.
- [API authentication](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/auth/api-auth.md): Sanctum token authentication for the REST API, including token issuance, protected routes, and push subscription management.
- [One-time passwords](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/auth/otp.md): Passwordless authentication via OTP — generate a code to an email or phone, then verify it to receive a session token.
- [Authentication overview](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/auth/overview.md): How Vito Business OS handles identity across two distinct auth surfaces: browser sessions and API tokens.
- [Roles and permissions](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/auth/roles-permissions.md): Role-based access control using Spatie Permission, tenant ownership isolation, and admin impersonation.
- [Social login](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/auth/social-login.md): Authenticate users through OAuth providers (Google, Facebook, Apple, GitHub, Twitter) via a single API endpoint.
- [Web authentication](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/auth/web-auth.md): Session-based authentication for the Inertia React UI, including registration, login, password reset, email verification, and profile management.
- [AI Enrichment](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/features/ai-enrichment.md): AI-powered business profile optimization with budget enforcement, credit tracking, and a full audit log of AI consumption.
- [Analytics](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/features/analytics.md): Visitor tracking, interaction counting, API endpoints for event ingestion, aggregation jobs, and exportable reports.
- [Bookings](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/features/bookings.md): Service definitions, provider schedules, availability slot calculation, appointment confirmation, and reminder notifications.
- [Product Catalog](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/features/catalog.md): How Vito Business OS structures products, menu sections, modifiers, media, and the public catalog API.
- [Loyalty](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/features/loyalty.md): Points-based loyalty programs with earn ratios, redeemable rewards, and an append-only ledger for full audit trails.
- [Marketing](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/features/marketing.md): Coupons, campaigns, announcements, lead capture, follower tracking, and interaction analytics for tenant growth.
- [Multi-Tenancy](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/features/multi-tenancy.md): How Vito Business OS isolates each business into its own tenant with path-based or subdomain routing, data scoping, and plan-gated capabilities.
- [Orders](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/features/orders.md): Order lifecycle, state machine, real-time notifications, PDF receipts, and transactional consistency for the Vito Business OS sales flow.
- [Installation](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/installation.md): Full installation guide covering MySQL, Redis, storage, queues, WebSockets, and production setup.
- [Vito Business OS](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/introduction.md): An open-source multi-tenant SaaS platform built with Laravel, React, and Filament to empower small and medium businesses in developing regions.
- [Deployment](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/operations/deployment.md): Server requirements, Nginx configuration, Supervisor processes, and deployment steps for Vito Business OS.
- [Health Checks](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/operations/health-checks.md): Spatie Health integration, the /health endpoint, available checks, and the Architecture Health dashboard in the super-admin panel.
- [Queues & Jobs](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/operations/queues-jobs.md): Queue configuration, background job catalog, Supervisor worker setup, the transactional outbox pattern, and failed job handling.
- [Scheduler](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/operations/scheduler.md): All scheduled tasks, their schedules, and how to configure the Laravel cron entry for Vito Business OS.
- [Security](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/operations/security.md): Rate limiting, idempotency, signed URLs, RBAC, tenant isolation, impersonation audit trail, webhook verification, and input validation in Vito Business OS.
- [Super admin panel](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/panels/super-admin-panel.md): The Filament-powered platform management panel at /admin and /admin/{tenant}, restricted to super_admin users for tenant governance, billing, and system health.
- [Tenant panel](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/panels/tenant-panel.md): The Filament-powered business operations panel at /app and /app/{tenant}, where business owners manage their catalog, orders, marketing, and settings.
- [Quickstart](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/quickstart.md): Get a working local environment running in minutes using SQLite.
- [Broadcasting](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/realtime/broadcasting.md): Real-time WebSocket broadcasting with Laravel Reverb and Laravel Echo.
- [Push notifications](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/realtime/push-notifications.md): Web Push notifications via VAPID keys and the laravel-notification-channels/webpush package.
- [Progressive Web App](https://mintlify.wiki/AugustoMelara-Dev/Vito-Business-OS/realtime/pwa.md): PWA configuration, service worker, offline capability, and home screen installation.