How minhdev-ops/xyphora works
Xyphora is represented here as an event-based shared-expense backend: users authenticate, create or join events, record and split expenses, then review balances and activity. API routes dispatch requests to focused controllers; Eloquent models provide the internal domain layer. The tree contains Flutter platform launchers but no application Dart sources, so frontend behavior is not mapped. Controller-to-model links follow the source index where excerpts are incomplete; integrations are shown only where the AuthController explicitly calls them.
Main entry points: ExpenseController.php Expense management · api.php API routes · DashboardController.php Dashboard · AuthController.php Authentication
Components 24
API entry
- Application bootstrap
backend/bootstrap/app.php - API routes
backend/routes/api.php
Identity
- Authentication
backend/app/Http/Controllers/AuthController.php - User accounts
backend/app/Models/User.php - OTP email
backend/app/Mail/OtpMail.php - User management
backend/app/Http/Controllers/UserController.php
Events
- Event management
backend/app/Http/Controllers/EventController.php
Expenses
- Expense management
backend/app/Http/Controllers/ExpenseController.php
Activity and insights
- Dashboard
backend/app/Http/Controllers/DashboardController.php - Statistics
backend/app/Http/Controllers/StatisticsController.php - Notification management
backend/app/Http/Controllers/NotificationController.php
Domain records
- Events
backend/app/Models/Event.php - Participants
backend/app/Models/Participant.php - Invitations
backend/app/Models/Invitation.php - Expenses
backend/app/Models/Expense.php - Categories
backend/app/Models/Category.php - Expense payers
backend/app/Models/ExpensePayer.php - Expense splits
backend/app/Models/ExpenseSplit.php - Expense history
backend/app/Models/ExpenseHistory.php - Photos
backend/app/Models/Photo.php - Notifications
backend/app/Models/Notification.php
Other components
- API client
- Google token service
- Mail service
Connections 35
- API client → API routes: sends requests
backend/routes/api.php - Application bootstrap → API routes: registers routes
backend/bootstrap/app.php - API routes → Authentication: dispatches
backend/routes/api.php - API routes → Event management: dispatches
backend/routes/api.php - API routes → Expense management: dispatches
backend/routes/api.php - API routes → Dashboard: dispatches
backend/routes/api.php - API routes → Statistics: dispatches
backend/routes/api.php - API routes → Notification management: dispatches
backend/routes/api.php - API routes → User management: dispatches
backend/routes/api.php - Authentication → User accounts: creates or updates
backend/app/Http/Controllers/AuthController.php - Authentication → Google token service: validates token
backend/app/Http/Controllers/AuthController.php - Authentication → OTP email: sends OTP mail
backend/app/Http/Controllers/AuthController.php - OTP email → Mail service: uses mail transport
- Event management → Events: manages
backend/app/Http/Controllers/EventController.php - Event management → Participants: manages
backend/app/Http/Controllers/EventController.php - Event management → Invitations: creates and checks
backend/app/Http/Controllers/EventController.php - Expense management → Expenses: creates and queries
backend/app/Http/Controllers/ExpenseController.php - Expense management → Events: checks event access
backend/app/Http/Controllers/ExpenseController.php - Expense management → Categories: queries categories
backend/app/Http/Controllers/ExpenseController.php - Expense management → Participants: checks participants
backend/app/Http/Controllers/ExpenseController.php - Expense management → Expense payers: records payments
backend/app/Http/Controllers/ExpenseController.php - Expense management → Expense splits: records allocations
backend/app/Http/Controllers/ExpenseController.php - Expense management → Expense history: records changes
backend/app/Http/Controllers/ExpenseController.php - Expense management → Notifications: creates alerts
backend/app/Http/Controllers/ExpenseController.php - Dashboard → Events: queries events
backend/app/Http/Controllers/DashboardController.php - Dashboard → Expenses: queries spending
backend/app/Http/Controllers/DashboardController.php - Dashboard → Expense payers: sums payments
backend/app/Http/Controllers/DashboardController.php - Dashboard → Expense splits: sums shares
backend/app/Http/Controllers/DashboardController.php - Dashboard → Participants: finds memberships
backend/app/Http/Controllers/DashboardController.php - Dashboard → Notifications: lists alerts
backend/app/Http/Controllers/DashboardController.php - Statistics → Events: queries event data
backend/app/Http/Controllers/StatisticsController.php - Statistics → Expenses: aggregates expenses
backend/app/Http/Controllers/StatisticsController.php - Statistics → Participants: checks membership
backend/app/Http/Controllers/StatisticsController.php - Notification management → Notifications: manages alerts
backend/app/Http/Controllers/NotificationController.php - Expenses → Photos: relates photos
backend/app/Models/Expense.php