How aeron-marc/kaayos works
KaAyos is a Tuy, Batangas home-services marketplace. Clients discover workers and book services; workers manage jobs and schedules; administrators oversee verification, disputes, and reporting. Laravel routes requests into role-specific controllers and persists marketplace records through Eloquent models, while Reverb supports realtime updates and a separate FastAPI service provides matching and geospatial capabilities. The README documents major capabilities not represented by sampled implementation excerpts; those branches are included as documented subsystems, with relationships cited to the README where appropriate.
Main entry points: web.php Web routes · Models Marketplace records · ClientController.php Client bookings · SearchController.php Search and map
Components 30
Worker Discovery
- Search and map
kaayos/app/Http/Controllers/SearchController.php - Worker profiles
kaayos/app/Http/Controllers/Client/WorkerController.php - Local geospatial data
kaayos/app/Support/TuyBarangays.php
Booking and Work
- Client bookings
kaayos/app/Http/Controllers/Client/ClientController.php - Booking lifecycle
kaayos/app/Models/Booking.php - Worker job dashboard
kaayos/app/Http/Controllers/Worker/WorkerDashboardController.php - Worker services and schedule
kaayos/app/Http/Controllers/Worker/WorkerController.php - Travel and scheduling
kaayos/app/Services/GeoTravelService.php - Expired booking cancellation
kaayos/app/Console/Commands/CancelExpiredBookings.php
Accounts and Operations
- Authentication and profiles
kaayos/app/Http/Controllers/Auth/RegisterController.php - Worker verification
kaayos/app/Http/Controllers/Admin/VerificationController.php - Admin operations
kaayos/app/Http/Controllers/Admin/BookingController.php - Reports and exports
kaayos/app/Http/Controllers/Admin/ReportController.php
Realtime and AI
- Messaging
kaayos/app/Models/Message.php - Realtime events
kaayos/app/Events/BookingStatusUpdated.php - AI assistant
kaayos/app/Services/ChatBotService.php - Worker suggestions
kaayos/app/Http/Controllers/Api/SuggestionController.php - Matching microservice
ml_service/main.py
Application Core
- Web routes
kaayos/routes/web.php - API routes
kaayos/routes/api.php - Marketplace records
kaayos/app/Models - User and worker profile
kaayos/app/Models/User.php - Service catalog
kaayos/app/Models/Service.php - Reviews and testimonials
kaayos/app/Models/Review.php
Other components
- Client or visitor
- Worker
- Administrator
- Browser client
- Laravel Reverb
- OpenRouter
Connections 45
- Client or visitor → Web routes: requests pages
README.md - Worker → Web routes: manages work
README.md - Administrator → Web routes: administers platform
README.md - Web routes → Search and map: routes search
kaayos/routes/web.php - Web routes → Worker profiles: routes profiles
kaayos/routes/web.php - Web routes → Client bookings: routes bookings
kaayos/routes/web.php - Web routes → Worker job dashboard: routes worker jobs
kaayos/routes/web.php - Web routes → Worker services and schedule: routes worker tools
kaayos/routes/web.php - Web routes → Authentication and profiles: routes authentication
kaayos/routes/web.php - Web routes → Worker verification: routes verification
kaayos/routes/web.php - Web routes → Admin operations: routes admin operations
kaayos/routes/web.php - Web routes → Reports and exports: routes reporting
kaayos/routes/web.php - Client or visitor → API routes: calls assistant API
README.md - API routes → Worker suggestions: routes suggestions
- Search and map → Marketplace records: queries workers
kaayos/app/Http/Controllers/SearchController.php - Search and map → Service catalog: filters categories
kaayos/app/Http/Controllers/SearchController.php - Search and map → Local geospatial data: uses barangays
kaayos/app/Http/Controllers/SearchController.php - Worker profiles → Local geospatial data: uses barangays
kaayos/app/Http/Controllers/Client/WorkerController.php - Client bookings → Booking lifecycle: creates bookings
kaayos/app/Http/Controllers/Client/ClientController.php - Client bookings → Marketplace records: reads and writes records
kaayos/app/Http/Controllers/Client/ClientController.php - Client bookings → Realtime events: broadcasts status
kaayos/app/Http/Controllers/Client/ClientController.php - Client bookings → Messaging: posts booking messages
kaayos/app/Http/Controllers/Client/ClientController.php - Client bookings → Reviews and testimonials: submits reviews
README.md - Worker job dashboard → Booking lifecycle: updates status
kaayos/app/Http/Controllers/Worker/WorkerDashboardController.php - Worker job dashboard → Realtime events: broadcasts status
kaayos/app/Http/Controllers/Worker/WorkerDashboardController.php - Worker job dashboard → Messaging: posts booking messages
kaayos/app/Http/Controllers/Worker/WorkerDashboardController.php - Worker services and schedule → Travel and scheduling: builds routes
kaayos/app/Http/Controllers/Worker/WorkerController.php - Worker services and schedule → Marketplace records: reads worker records
kaayos/app/Http/Controllers/Worker/WorkerController.php - Client bookings → Travel and scheduling: checks feasibility
kaayos/app/Http/Controllers/Client/ClientController.php - Expired booking cancellation → Booking lifecycle: cancels stale bookings
README.md - Authentication and profiles → User and worker profile: creates accounts
- Worker verification → User and worker profile: verifies workers
README.md - Admin operations → Marketplace records: manages marketplace data
README.md - Reports and exports → Marketplace records: reports on activity
kaayos/app/Http/Controllers/Admin/ReportController.php - Reports and exports → Reviews and testimonials: includes review reports
README.md - Worker suggestions → AI assistant: requests assistant reply
kaayos/app/Http/Controllers/Api/SuggestionController.php - Worker suggestions → User and worker profile: finds matching workers
kaayos/app/Http/Controllers/Api/SuggestionController.php - Worker suggestions → Matching microservice: requests matching
- AI assistant → OpenRouter: calls AI provider
README.md - Browser client → Laravel Reverb: receives live updates
README.md - Realtime events → Laravel Reverb: publishes events
README.md - Marketplace records → User and worker profile: stores domain records
kaayos/app/Models/Booking.php - Booking lifecycle → Marketplace records: persists booking state
README.md - Service catalog → Marketplace records: stores catalog data
kaayos/app/Models/ServiceCategory.php - Reviews and testimonials → Marketplace records: stores feedback
kaayos/app/Models/User.php