How wolneydev/northloom-laravel works
Hospitable is a Laravel API for project planning, calendar tasks, project finances, reporting, and Telegram reminders, with REST and MCP interfaces over shared domain services. The main user workflow is an authenticated client or MCP tool requesting a project/task/financial action, which reaches domain logic and persistence; chat users can invoke MCP tools through the AI agent. The README documents these shared layers and capabilities. Source excerpts confirm selected controller, allocation, task-persistence, and dependency-binding behavior; other links are shown only where the README documents them.
Main entry points: Api REST API · Tools MCP Server Tools · Eloquent Eloquent Repositories · Services Task Service
Components 22
Client Interfaces
- REST API
app/Http/Controllers/Api - MCP Server Tools
app/Mcp/Tools - MCP Server
app/Mcp/Servers/HospitableServer.php
Domain Services
- Project Service
app/Domain/Projects/Services - Task Service
app/Domain/Tasks/Services - Financial Services
app/Domain/Financials/Services - Report Service
app/Domain/Reports/Services/ReportService.php - User Service
app/Domain/Users/Services/UserService.php - Creation Ideas
app/Domain/CreationIdeas/Services - Aggregated Reports
app/Domain/Reports/Services/ReportService.php
Persistence
- Eloquent Repositories
app/Infrastructure/Persistence/Eloquent - Domain Models
app/Models - Database
- Service Bindings
app/Providers/AppServiceProvider.php
Chat and Notifications
- Conversation Service
app/Domain/Conversations/Services/ConversationService.php - Chat Controller
app/Http/Controllers/Api/ChatController.php - Chat Agent
app/Ai/Agents/HospitableChatAgent.php - Task Notifications
app/Domain/Tasks/Services/TaskNotificationService.php - Telegram Delivery
app/Infrastructure/Telegram/TelegramNotificationService.php
Other components
- HTTP Client
- MCP Client
- Chat User
Connections 28
- HTTP Client → REST API: calls
- REST API → Project Service: delegates to
app/Http/Controllers/Api/ProjectController.php - REST API → Task Service: delegates to
app/Http/Controllers/Api/TaskController.php - REST API → Financial Services: delegates to
- REST API → Report Service: requests reports
- REST API → User Service: manages users
- REST API → Creation Ideas: requests ideas
- MCP Client → MCP Server: connects via stdio
- MCP Server → MCP Server Tools: exposes tools
- MCP Server Tools → Project Service: delegates to
- MCP Server Tools → Task Service: delegates to
- MCP Server Tools → Financial Services: delegates to
- MCP Server Tools → Report Service: requests reports
- MCP Server Tools → Creation Ideas: suggests ideas
- Chat User → Chat Controller: sends message
- Chat Controller → Chat Agent: invokes agent
app/Http/Controllers/Api/ChatController.php - Chat Agent → MCP Server: uses local MCP
- REST API → Chat Controller: serves chat API
- Task Service → Task Notifications: schedules reminders
- Task Notifications → Telegram Delivery: delivers via
app/Infrastructure/Telegram/TelegramNotificationService.php - Project Service → Eloquent Repositories: persists through
- Task Service → Eloquent Repositories: persists through
- Financial Services → Eloquent Repositories: persists through
- Eloquent Repositories → Domain Models: queries and updates
app/Infrastructure/Persistence/Eloquent/EloquentTaskRepository.php - Domain Models → Database: stores records
- Service Bindings → Eloquent Repositories: binds implementations
app/Providers/AppServiceProvider.php - Service Bindings → Telegram Delivery: binds delivery
app/Providers/AppServiceProvider.php - Report Service → Aggregated Reports: produces