How 2001sheheryar-sa/splitwise-pk works
This is a Laravel API for shared-expense groups: users register or log in, create groups and manage members, record split expenses, then create settlements against outstanding balances. The API controllers own these operations and delegate domain work to services; MongoDB-backed models hold users, groups, expenses, and settlements. The README documents equal, exact, and percentage splits and balance-ledger updates. Some routes and supporting modules are unsampled, so uncertain links are omitted rather than inferred.
Main entry points: ExpenseService.php Expense service · AuthController.php Authentication · GroupController.php Group API · GroupService.php Group service
Components 20
API and auth
- API routes
routes/api.php - Auth routes
routes/Api/auth.php - Authentication
app/Http/Controllers/AuthController.php - Token middleware
app/Http/Middleware/AuthToken.php - Token service
app/Services/TokenService.php - Registration service
app/Services/RegistrationService.php
Group management
- Group API
app/Http/Controllers/GroupController.php - Group service
app/Services/GroupService.php - Group policy
app/Policies/GroupPolicy.php
Expenses and settlement
- Expense API
app/Http/Controllers/ExpenseController.php - Expense service
app/Services/ExpenseService.php - Settlement API
app/Http/Controllers/SettlementController.php - Settlement service
app/Services/SettlementService.php
Domain data
- User model
app/Models/User.php - User token
app/Models/UserToken.php - Group model
app/Models/Groups.php - Expense model
app/Models/Expense.php - Settlement model
app/Models/Settlements.php
Other components
- User
- MongoDB
Connections 24
- User → Auth routes: requests auth
- Auth routes → Authentication: routes to
routes/Api/auth.php - API routes → Auth routes: loads routes
- Authentication → Registration service: registers with
app/Http/Controllers/AuthController.php - Authentication → Token service: issues tokens
app/Http/Controllers/AuthController.php - Authentication → User model: looks up user
app/Http/Controllers/AuthController.php - Token middleware → User token: checks token
app/Http/Middleware/AuthToken.php - API routes → Token middleware: registers middleware
- User → Group API: manages groups
- Group API → Group service: delegates changes
app/Http/Controllers/GroupController.php - Group API → Expense service: requests balances
app/Http/Controllers/GroupController.php - Group service → Group model: creates and updates
app/Services/GroupService.php - Group policy → Group model: authorizes access
app/Policies/GroupPolicy.php - Expense API → Expense service: delegates expenses
app/Http/Controllers/ExpenseController.php - User → Expense API: records expenses
- Expense service → Expense model: creates and reads
app/Services/ExpenseService.php - Expense service → Settlement model: reads settlements
app/Services/ExpenseService.php - Settlement API → Expense service: gets balances
app/Http/Controllers/SettlementController.php - Settlement API → Settlement service: validates and delegates
app/Http/Controllers/SettlementController.php - User → Settlement API: records settlements
- Settlement service → Settlement model: creates and updates
app/Services/SettlementService.php - Group service → MongoDB: transacts on
app/Services/GroupService.php - Expense service → MongoDB: transacts on
app/Services/ExpenseService.php - Group model → User model: relates members
app/Models/Groups.php