How verhiron/pub-krawl-api works
This repository is a Laravel-backed pub-discovery API with account registration and token authentication. The main workflow is an API request routed to a domain controller, which queries pub, country, city, or beer data and returns a standardized JSON response; pub detail and country/global listings are distinct discovery stages. Authentication uses the User model and Sanctum tokens. The domain controllers and route wiring are excerpted; domain-table storage is inferred from their queries, while its schema and database configuration were not inspected.
Main entry points: api.php API routes · AuthController.php Auth endpoints · ApiResponse.php JSON response helper · CountryController.php Country listing
Components 12
API routing
- Laravel bootstrap
bootstrap/app.php - API routes
routes/api.php
Pub discovery
- Country listing
app/Http/Controllers/Api/V1/CountryController.php - City lookup
app/Http/Controllers/Api/V1/CityController.php - Pub discovery
app/Http/Controllers/Api/V1/PubController.php - Beer lookup
app/Http/Controllers/Api/V1/BeerController.php - Domain database
Identity
- Auth endpoints
app/Http/Controllers/AuthController.php - User model
app/Models/User.php - Token storage
Shared services
- JSON response helper
app/Helpers/ApiResponse.php
Other components
- API client
Connections 18
- API client → Laravel bootstrap: sends request
- Laravel bootstrap → API routes: loads routes
bootstrap/app.php - API routes → Country listing: dispatches
routes/api.php - API routes → City lookup: dispatches
routes/api.php - API routes → Pub discovery: dispatches
routes/api.php - API routes → Beer lookup: dispatches
routes/api.php - API routes → Auth endpoints: dispatches
routes/api.php - Country listing → Domain database: queries
app/Http/Controllers/Api/V1/CountryController.php - City lookup → Domain database: queries
app/Http/Controllers/Api/V1/CityController.php - Pub discovery → Domain database: queries
app/Http/Controllers/Api/V1/PubController.php - Beer lookup → Domain database: queries
app/Http/Controllers/Api/V1/BeerController.php - Country listing → JSON response helper: formats result
app/Http/Controllers/Api/V1/CountryController.php - City lookup → JSON response helper: formats result
app/Http/Controllers/Api/V1/CityController.php - Pub discovery → JSON response helper: formats result
app/Http/Controllers/Api/V1/PubController.php - Beer lookup → JSON response helper: formats result
app/Http/Controllers/Api/V1/BeerController.php - Auth endpoints → User model: creates and checks
app/Http/Controllers/AuthController.php - Auth endpoints → Token storage: issues and revokes
- Auth endpoints → API client: returns JSON
app/Http/Controllers/AuthController.php