Release v0.5.0

.dockerignore

@@ -0,0 +1,48 @@
+.git
+.gitignore
+.gitattributes
+
+Dockerfile
+docker-compose.yml
+.dockerignore
+
+README.md
+CHANGELOG.md
+LICENSE.md
+docs/
+
+.vscode/
+.idea/
+*.swp
+*.swo
+
+.DS_Store
+Thumbs.db
+
+storage/logs/*
+storage/framework/logs/*
+storage/app/public/*
+storage/framework/cache/*
+storage/framework/sessions/*
+storage/framework/testing/*
+storage/framework/views/*
+
+node_modules/
+vendor/
+
+.env
+
+build/
+coverage/
+
+*.tmp
+*.log
+*.pid
+*.seed
+*.pid.lock
+
+.phpunit.result.cache
+.php_cs.cache
+
+dist/
+public/build/

.env.example

@@ -1,11 +1,38 @@
 APP_NAME=Phenix
+APP_KEY=
+APP_ENV=local
 APP_DEBUG=true
 APP_URL=http://127.0.0.1
 APP_PORT=1337
 
 DB_CONNECTION=mysql
+DB_HOST=127.0.0.1
+DB_PORT=3306
 DB_DATABASE=phenix
 DB_USERNAME=root
-DB_PASSWORD=
+DB_PASSWORD=secret
 
-LOG_CHANNEL=stream
+LOG_CHANNEL=file
+
+CACHE_STORE=redis
+RATE_LIMIT_STORE="${CACHE_STORE}"
+
+QUEUE_DRIVER=redis
+
+CORS_ORIGIN=
+
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_USERNAME=
+REDIS_PASSWORD=null
+
+SESSION_DRIVER=redis
+
+MAIL_MAILER=smtp
+MAIL_HOST=127.0.0.1
+MAIL_PORT=587
+MAIL_ENCRYPTION=tls
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_FROM_ADDRESS=hello@example.com
+MAIL_FROM_NAME="Example"

.env.example.docker

@@ -0,0 +1,26 @@
+APP_NAME=Phenix
+APP_KEY=
+APP_ENV=local
+APP_DEBUG=true
+APP_URL=http://127.0.0.1
+APP_PORT=1337
+
+DB_CONNECTION=mysql
+DB_HOST=mysql
+DB_PORT=3306
+DB_DATABASE=phenix
+DB_USERNAME=phenix
+DB_PASSWORD=secret
+MYSQL_PORT=3307
+
+LOG_CHANNEL=stream
+
+QUEUE_DRIVER=database
+
+CORS_ORIGIN=
+
+REDIS_HOST=redis
+REDIS_PORT=6379
+REDIS_PASSWORD=null
+
+SESSION_DRIVER=redis

.github/copilot-instructions.md

@@ -0,0 +1,142 @@
+# Phenix Framework - AI Coding Instructions
+
+## Architecture Overview
+
+**Phenix** is an asynchronous PHP web framework built on the [AmPHP](https://amphp.org/) ecosystem. This is a **skeleton application** that depends on `phenixphp/framework` for core functionality. Official documentation can be found at [Phenix Documentation](https://phenix.omarbarbosa.com/).
+
+### Key Components
+- **App Structure**: Standard MVC with `app/` (controllers, tasks), `config/` (service configs), `routes/` (API definitions)
+- **Framework Integration**: Core framework lives in `vendor/phenixphp/framework/src/` - reference this for understanding internals
+- **Service Providers**: Configured in `config/app.php` - handles DI container, routing, queue, database, etc.
+- **Entry Points**: `public/index.php` (HTTP server), `phenix` CLI (console commands)
+
+## Development Workflow
+
+### Server & Hot Reloading
+```bash
+composer dev                    # Starts development server with file watcher
+# OR directly: php server       # Custom file watcher that restarts on changes
+XDEBUG_MODE=off php public/index.php  # Direct server start (faster, no debugging)
+```
+- Server runs on `APP_URL:APP_PORT` (default: http://127.0.0.1:1337)
+- Watches: `app/`, `config/`, `routes/`, `database/`, `composer.json`, `.env`
+- Requires Node.js for chokidar file watcher
+- Use `XDEBUG_MODE=off` for better performance when debugging isn't needed
+
+### Testing
+```bash
+composer test                   # PHPUnit tests (XDEBUG_MODE=off)
+composer test:coverage          # With coverage reports
+```
+- **Test Framework**: PHPUnit with custom HTTP client helpers
+- **Test Structure**: `tests/Feature/` and `tests/Unit/` with shared `TestCase`
+- **HTTP Testing**: Uses Amp HTTP client with helper functions: `get()`, `post()`, etc.
+
+### Quality Tools
+```bash
+composer format                 # PHP CS Fixer
+composer analyze                # PHPStan
+```
+
+## Queue System Architecture
+
+**Critical Pattern**: This project implements an async task queue system with Redis/Database backends.
+
+### Task Definition
+```php
+// Extend QueuableTask for background jobs
+class MyTask extends QueuableTask
+{
+    protected int|null $maxTries = 3;  // Configure retries
+
+    protected function handle(Channel $channel, Cancellation $cancellation): Result
+    {
+        // Async task logic here
+        return Result::success('TaskName', 'Success message');
+    }
+}
+```
+
+### Task Dispatch
+```php
+// From controllers/anywhere:
+MyTask::dispatch();              // Queue immediately
+MyTask::enqueue()->delay(60);    // Queue with delay
+MyTask::dispatchIf($condition);  // Conditional dispatch
+```
+
+### Queue Workers
+```bash
+./phenix queue:work redis --queue=default    # Process queue
+./phenix queue:work --once                   # Process once and exit
+./phenix queue:work --chunks                 # Batch processing
+```
+
+## Configuration Patterns
+
+### Environment-Driven Config
+```php
+// config/ files use closures for lazy evaluation:
+'driver' => env('QUEUE_DRIVER', static fn (): string => 'database'),
+'timeout' => env('TIMEOUT', static fn (): int => 30),
+```
+
+### Service Provider Registration
+- All providers registered in `config/app.php`
+- Queue system: `QueueServiceProvider`, `TaskServiceProvider`
+- Database: Supports MySQL/PostgreSQL with migrations via Phinx
+
+## Data Layer
+
+### Database
+- **Migrations**: `database/migrations/` using Phinx (not Eloquent)
+- **Configuration**: `config/database.php` supports multiple connections
+- **CLI**: `./phenix` provides migration commands
+
+### Queue Backends
+- **Redis**: Uses Lua scripts for atomic operations (`LuaScripts.php`)
+- **Database**: Uses tasks table with state management
+- **Parallel**: AmPHP parallel processing with worker pools
+
+## HTTP Layer
+
+### Routing
+```php
+// routes/api.php - use Facade pattern:
+Route::get('/', [WelcomeController::class, 'index']);
+Route::post('/tasks', [TaskController::class, 'store']);
+```
+
+### Controllers
+```php
+class MyController extends Controller
+{
+    public function index(): Response
+    {
+        return response()->json(['data' => $data]);
+        // OR: response()->plain('text');
+    }
+}
+```
+
+## Key Conventions
+
+1. **Strict Types**: Always use `declare(strict_types=1);`
+2. **Static Factories**: Config uses static closures for defaults
+3. **Facade Pattern**: `Phenix\Facades\*` for service access
+4. **Result Objects**: Tasks return `Result::success()` or `Result::failure()`
+5. **Async First**: Built for non-blocking I/O with AmPHP primitives
+
+## Critical Files to Reference
+
+- `config/app.php` - Service provider registration and app config
+- `vendor/phenixphp/framework/src/Queue/` - Queue implementation details
+- `vendor/phenixphp/framework/src/Tasks/QueuableTask.php` - Base task class
+- `bootstrap/app.php` - Application bootstrap via `AppBuilder`
+
+## Common Pitfalls
+
+1. **Queue Retries**: Tasks need explicit `$maxTries` property set
+2. **Environment**: Copy `.env.example` to `.env` for local development
+3. **CLI vs HTTP**: Different entry points (`phenix` vs `public/index.php`)
+4. **Dependencies**: Framework code lives in vendor - check there for implementation details

.github/workflows/run-tests.yml

@@ -9,6 +9,30 @@ on:
 jobs:
   test:
     runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:8.0
+        env:
+          MYSQL_DATABASE: phenix
+          MYSQL_USER: phenix
+          MYSQL_PASSWORD: secret
+          MYSQL_ROOT_PASSWORD: secret
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping -h 127.0.0.1 -uroot -psecret --silent"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
+      redis:
+        image: redis:7-alpine
+        ports:
+          - 6379:6379
+        options: >-
+          --health-cmd="redis-cli ping"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
 
     steps:
       - name: Checkout code
@@ -20,7 +44,7 @@ jobs:
         uses: shivammathur/setup-php@v2
         with:
           php-version: 8.2
-          extensions: json, mbstring, pcntl, intl, fileinfo
+          extensions: json, mbstring, pcntl, intl, fileinfo, sockets, mysqli, sqlite3
           coverage: xdebug
 
       - name: Setup problem matchers
@@ -32,27 +56,28 @@ jobs:
         run: |
           composer install --no-interaction --prefer-dist --no-progress --no-suggest
 
-      - name: Check quality code with PHPInsights
+      - name: Check code formatting with PHP CS Fixer
         run: |
-          vendor/bin/phpinsights -n --ansi --format=github-action
+          vendor/bin/php-cs-fixer fix --dry-run --diff --ansi
 
       - name: Analyze code statically with PHPStan
         run: |
-          cp .env.example .env
-          vendor/bin/phpstan --xdebug
+          cp .env.example .env.testing
+          XDEBUG_MODE=off vendor/bin/phpstan --xdebug
 
       - name: Execute tests
         run: |
-          cp .env.example .env
-          vendor/bin/pest --coverage
+          cp .env.example .env.testing
+          php phenix key:generate .env.testing --force
+          vendor/bin/phpunit
 
       - name: Prepare paths for SonarQube analysis
         run: |
           sed -i "s|$GITHUB_WORKSPACE|/github/workspace|g" build/logs/clover.xml
           sed -i "s|$GITHUB_WORKSPACE|/github/workspace|g" build/report.junit.xml
 
       - name: Run SonarQube analysis
-        uses: sonarsource/sonarcloud-github-action@master
+        uses: sonarsource/sonarqube-scan-action@master
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

.gitignore

@@ -12,4 +12,5 @@ tests/coverage
 node_modules
 npm-debug.log
 package-lock.json
-package.json
+package.json
+*.sqlite*

app/Constants/OneTimePasswordScope.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Constants;
+
+enum OneTimePasswordScope: string
+{
+    case LOGIN = 'login';
+
+    case RESET_PASSWORD = 'reset_password';
+
+    case VERIFY_EMAIL = 'verify_email';
+
+    case AUTHORIZE = 'authorize';
+
+    public static function toArray(): array
+    {
+        return array_column(self::cases(), 'value');
+    }
+}