basic structure based off rails example

Author: philsturgeon

frameworks-laravel/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[compose.yaml]
+indent_size = 4

frameworks-laravel/.env.example

@@ -0,0 +1,65 @@
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_URL=http://localhost
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+# APP_MAINTENANCE_STORE=database
+
+# PHP_CLI_SERVER_WORKERS=4
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION=sqlite
+# DB_HOST=127.0.0.1
+# DB_PORT=3306
+# DB_DATABASE=laravel
+# DB_USERNAME=root
+# DB_PASSWORD=
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+
+CACHE_STORE=database
+# CACHE_PREFIX=
+
+MEMCACHED_HOST=127.0.0.1
+
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_MAILER=log
+MAIL_SCHEME=null
+MAIL_HOST=127.0.0.1
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_FROM_ADDRESS="[email protected]"
+MAIL_FROM_NAME="${APP_NAME}"
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"

frameworks-laravel/.gitattributes

@@ -0,0 +1,11 @@
+* text=auto eol=lf
+
+*.blade.php diff=html
+*.css diff=css
+*.html diff=html
+*.md diff=markdown
+*.php diff=php
+
+/.github export-ignore
+CHANGELOG.md export-ignore
+.styleci.yml export-ignore

frameworks-laravel/.gitignore

@@ -0,0 +1,24 @@
+*.log
+.DS_Store
+.env
+.env.backup
+.env.production
+.phpactor.json
+.phpunit.result.cache
+/.fleet
+/.idea
+/.nova
+/.phpunit.cache
+/.vscode
+/.zed
+/auth.json
+/node_modules
+/public/build
+/public/hot
+/public/storage
+/storage/*.key
+/storage/pail
+/vendor
+Homestead.json
+Homestead.yaml
+Thumbs.db

frameworks-laravel/README.md

@@ -0,0 +1,208 @@
+# F1 Laps API - Laravel PHP
+
+A Laravel PHP implementation of the Formula 1 lap times API. This API provides endpoints for managing drivers, circuits, and lap time data.
+
+## Overview
+
+This is a Laravel version of the F1 Laps API, providing the same functionality as the Rails version but built with PHP and Laravel framework.
+
+## Features
+
+- **Drivers Management**: Create and list F1 drivers
+- **Circuits Management**: Create and list racing circuits
+- **Lap Times**: Record and query lap times with flexible filtering
+- **Health Check**: API health and version information
+
+## Setup
+
+### Prerequisites
+
+- PHP 8.2 or higher
+- Composer
+- SQLite (default) or MySQL/PostgreSQL
+
+### Installation
+
+1. Install dependencies:
+```bash
+composer install
+```
+
+2. Set up your environment:
+```bash
+cp .env.example .env
+php artisan key:generate
+```
+
+3. Run migrations and seed the database with demo data:
+```bash
+php artisan migrate --seed
+```
+
+Or to start fresh with demo data:
+```bash
+php artisan migrate:fresh --seed
+```
+
+4. Start the development server:
+```bash
+php artisan serve
+```
+
+The API will be available at `http://localhost:8000`.
+
+## Demo Data
+
+The application includes database seeders that populate the database with realistic F1 data:
+- **10 F1 Drivers** (Verstappen, Hamilton, Leclerc, Norris, etc.)
+- **10 Famous Circuits** (Monaco, Silverstone, Monza, Spa, etc.)
+- **30+ Lap Times** with realistic lap times in milliseconds
+
+This demo data makes it easy to test the API endpoints without having to create data manually.
+
+## API Endpoints
+
+All endpoints are prefixed with `/api/v1`.
+
+### Health Check
+
+- `GET /api/v1/health` - Get API health status
+
+### Drivers
+
+- `GET /api/v1/drivers` - List all drivers
+- `POST /api/v1/drivers` - Create a new driver
+
+**Create Driver Request:**
+```json
+{
+  "name": "Lewis Hamilton",
+  "code": "HAM"
+}
+```
+
+### Circuits
+
+- `GET /api/v1/circuits` - List all circuits
+- `POST /api/v1/circuits` - Create a new circuit
+
+**Create Circuit Request:**
+```json
+{
+  "name": "Monaco Grand Prix",
+  "location": "Monte Carlo, Monaco"
+}
+```
+
+### Lap Times
+
+- `GET /api/v1/lap_times` - List all lap times (with optional filters)
+  - Query parameters:
+    - `driver_id` - Filter by driver ID
+    - `circuit_id` - Filter by circuit ID
+    - `lap_min` - Minimum lap number
+    - `lap_max` - Maximum lap number
+- `POST /api/v1/lap_times` - Create a new lap time
+- `GET /api/v1/drivers/{driverId}/lap_times` - Get lap times for a specific driver
+- `GET /api/v1/circuits/{circuitId}/lap_times` - Get lap times for a specific circuit
+
+**Create Lap Time Request:**
+```json
+{
+  "driver_id": 1,
+  "circuit_id": 1,
+  "lap_number": 1,
+  "time_ms": 82345
+}
+```
+
+## Testing
+
+Run the tests:
+```bash
+php artisan test
+```
+
+## OpenAPI Specification
+
+The OpenAPI specification is available in `openapi.yaml`. This spec is compatible with the Rails version and can be used to generate SDKs using Speakeasy.
+
+## Database
+
+By default, the application uses SQLite. The database file is created at `database/database.sqlite`.
+
+To use a different database, update your `.env` file accordingly.
+
+## Models
+
+### Driver
+- `id`: Integer (auto-increment)
+- `name`: String
+- `code`: String (indexed)
+- `created_at`: Timestamp
+- `updated_at`: Timestamp
+
+### Circuit
+- `id`: Integer (auto-increment)
+- `name`: String
+- `location`: String
+- `created_at`: Timestamp
+- `updated_at`: Timestamp
+
+### LapTime
+- `id`: Integer (auto-increment)
+- `driver_id`: Integer (foreign key to drivers)
+- `circuit_id`: Integer (foreign key to circuits)
+- `lap_number`: Integer
+- `time_ms`: Integer (lap time in milliseconds)
+- `created_at`: Timestamp
+- `updated_at`: Timestamp
+
+## Development
+
+### Running Locally
+
+```bash
+php artisan serve
+```
+
+The API will be available at `http://localhost:8000`.
+
+### Artisan Commands
+
+Laravel provides various artisan commands for development:
+
+```bash
+# Run migrations
+php artisan migrate
+
+# Rollback migrations
+php artisan migrate:rollback
+
+# Create a new migration
+php artisan make:migration create_table_name
+
+# Create a new model
+php artisan make:model ModelName
+
+# Create a new controller
+php artisan make:controller ControllerName
+```
+
+## License
+
+This project is licensed under the MIT License.
+
+
+
+## Code of Conduct
+
+In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).
+
+## Security Vulnerabilities
+
+If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [[email protected]](mailto:[email protected]). All security vulnerabilities will be promptly addressed.
+
+## License
+
+The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

frameworks-laravel/app/Http/Controllers/Api/V1/CircuitController.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Models\Circuit;
+use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+
+class CircuitController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     */
+    public function index(): JsonResponse
+    {
+        return response()->json(Circuit::all());
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     */
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'required|string',
+            'location' => 'required|string',
+        ]);
+
+        $circuit = Circuit::create($validated);
+
+        return response()->json($circuit, 201);
+    }
+
+    /**
+     * Display the specified resource.
+     */
+    public function show(string $id)
+    {
+        //
+    }
+
+    /**
+     * Update the specified resource in storage.
+     */
+    public function update(Request $request, string $id)
+    {
+        //
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     */
+    public function destroy(string $id)
+    {
+        //
+    }
+}