feat: User Components

.github/workflows/server_test.yml

@@ -48,6 +48,7 @@ jobs:
         with:
           php-version: "8.2"
           tools: composer:v2
+          coverage: pcov
 
       - name: Cache Composer dependencies
         uses: actions/cache@v4
@@ -102,5 +103,12 @@ jobs:
           APP_ENV: testing
 
       - name: Run tests
-        run: ./vendor/bin/phpunit --stop-on-failure --testdox
-        working-directory: ./src
+        run: ./vendor/bin/phpunit --stop-on-failure --testdox --coverage-clover coverage/clover.xml
+        working-directory: ./src
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./src/coverage/clover.xml
+          fail_ci_if_error: false

.github/workflows/static_analysis.yml

@@ -0,0 +1,41 @@
+name: Static Analysis
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    paths:
+      - "src/**/*.php"
+  workflow_dispatch: {}
+
+jobs:
+  mago:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: "8.2"
+          coverage: none
+          tools: composer
+
+      - name: Cache Composer dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/composer
+          key: ${{ runner.os }}-composer-${{ hashFiles('src/composer.lock') }}
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress
+        working-directory: ./src
+
+      - name: Setup Mago
+        uses: nhedger/setup-mago@v1
+
+      - name: Run Mago lint
+        run: ./vendor/bin/mago lint
+        working-directory: ./src

.gitignore

@@ -0,0 +1 @@
+.idea/

codecov.yml

@@ -0,0 +1,14 @@
+coverage:
+  status:
+    project:
+      default:
+        target: auto
+        threshold: 1%
+    patch:
+      default:
+        target: 85%
+
+comment:
+  layout: "reach,diff,flags,files"
+  behavior: default
+  require_changes: false

src/.gitignore

@@ -1,4 +1,5 @@
 /.phpunit.cache
+/.composer
 /node_modules
 /public/build
 /public/hot
@@ -7,6 +8,7 @@
 /storage/app/public
 /storage/app/private/unesco/world-heritage-sites.json
 /storage/app/private/unesco/normalized/world_heritage_sites_translation.json
+/storage/certs/
 
 /vendor
 .env

src/CLAUDE.md

@@ -0,0 +1,71 @@
+# CLAUDE.md
+
+## Commit Rules
+
+- コミットは必ず細分化する（1つの論理的変更 = 1コミット）
+- コミットメッセージに Claude の署名（`Co-Authored-By`, `Generated with Claude Code` など）を含めない
+- コミットメッセージは英語で記述する（例: `feat: add deleteUser to UserRepositroyInterface`）
+
+## Branch Rules
+
+- 機能ごとに親ブランチを切り、層ごとに子ブランチを切る
+  - 例: `feat/user-delete`（親）
+  - 例: `feat/user-delete_infra-layer`（子）
+  - 例: `feat/user-delete_application-layer`（子）
+  - 例: `feat/user-delete_presentation-layer`（子）
+- 子ブランチは親ブランチへ PR を出す
+- 親ブランチはさらに上位ブランチへ PR を出す
+
+## PR Rules
+
+### Title
+- 日英併記にする
+- 例: `feat: implement Presentation layer for DELETE /api/v1/users/{id} / ユーザー削除APIのPresentation層実装`
+
+### Description
+以下の構成で記述する:
+
+```
+## Motivation / 目的
+
+（英語で動機・背景を説明。日本語でも補足する）
+
+## What I have done / 実施内容
+
+（実装内容を箇条書きで記述）
+
+## Test Results / テスト結果
+
+（実行したテストのメソッド名を列挙）
+
+Closes #xxx
+```
+
+- PR description に Claude の署名（`Generated with Claude Code` など）を含めない
+
+## Testing Rules
+
+- テストファイルはすべて `app/Packages/` 配下に置く（`tests/` ではない）
+  - phpunit.xml が `app/Packages` のみをスキャンするため
+- Infra 層のテストは実 DB（Docker の `heritage-mysql-test`）を使ったインテグレーションテストにする（Mockery 不使用）
+- Application 層・Domain 層のテストは Mockery を使ったユニットテストにする
+- void を返すメソッドのテストでは `#[\PHPUnit\Framework\Attributes\DoesNotPerformAssertions]` アトリビュートを使う
+
+## Architecture Rules (DDD / CQRS)
+
+- `QueryUseCases`: 読み取り専用（副作用なし）
+  - UseCase, Dto, Factory/Dto, ViewModel, Factory/ViewModel
+- `CommandUseCases`: 書き込み（状態変更あり）
+  - UseCase, UseCommand
+- `UserRepositroyInterface` の引数は `UserEntity`（Command オブジェクトを直接渡さない）
+- パスワードのハッシュ化は Application 層（UseCase）で行う
+- パスワード変更は独立した別 API とし、更新系 Command には含めない
+
+## Docker File Sync
+
+- macOS + Docker Desktop ではファイル同期に遅延が発生することがある
+- テストが古い挙動を示す場合は `docker cp` でファイルを強制同期する
+  ```bash
+  docker cp <host_path> heritage-app:<container_path>
+  docker exec heritage-app php artisan route:clear
+  ```

src/app/Models/User.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Foundation\Auth\User as Authenticatable;
+use Laravel\Sanctum\HasApiTokens;
+
+class User extends Authenticatable
+{
+    use HasApiTokens;
+    protected $table = 'users';
+
+    protected $fillable = [
+        'first_name',
+        'last_name',
+        'email',
+        'password',
+        'age_range',
+        'subscription_tier',
+        'subscription_expires_at',
+        'email_verified_at',
+    ];
+
+    protected $hidden = [
+        'password',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'password'                => 'hashed',
+            'subscription_expires_at' => 'datetime',
+            'email_verified_at'       => 'datetime',
+        ];
+    }
+}

src/app/Packages/Domains/ImageEntity.php → src/app/Packages/Domains/Image/ImageEntity.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace App\Packages\Domains;
+namespace App\Packages\Domains\Image;
 
 class ImageEntity
 {

src/app/Packages/Domains/ImageEntityCollection.php → src/app/Packages/Domains/Image/ImageEntityCollection.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace App\Packages\Domains;
+namespace App\Packages\Domains\Image;
 
 class ImageEntityCollection
 {

src/app/Packages/Domains/Test/ImageEntityCollectionTest.php → src/app/Packages/Domains/Image/Tests/ImageEntityCollectionTest.php

@@ -1,10 +1,10 @@
 <?php
 
-namespace App\Packages\Domains\Test;
+namespace App\Packages\Domains\Image\Tests;
 
 use Tests\TestCase;
-use App\Packages\Domains\ImageEntity;
-use App\Packages\Domains\ImageEntityCollection;
+use App\Packages\Domains\Image\ImageEntity;
+use App\Packages\Domains\Image\ImageEntityCollection;
 use Mockery;
 
 class ImageEntityCollectionTest extends TestCase

src/app/Packages/Domains/Test/ImageEntityTest.php → src/app/Packages/Domains/Image/Tests/ImageEntityTest.php

@@ -1,8 +1,8 @@
 <?php
 
-namespace App\Packages\Domains\Test;
+namespace App\Packages\Domains\Image\Tests;
 
-use App\Packages\Domains\ImageEntity;
+use App\Packages\Domains\Image\ImageEntity;
 use Tests\TestCase;
 
 class ImageEntityTest extends TestCase

src/app/Packages/Domains/User/AgeRange.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace App\Packages\Domains\User;
+
+enum AgeRange: string
+{
+    case Teens     = 'teens';
+    case Twenties  = '20s';
+    case Thirties  = '30s';
+    case Forties   = '40s';
+    case Fifties   = '50s';
+    case SixtyPlus = '60plus';
+}

src/app/Packages/Domains/User/Factory/SubscriptionFactory.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Packages\Domains\User\Factory;
+
+use App\Packages\Domains\User\Subscription\Subscription;
+use App\Packages\Domains\User\Subscription\SubscriptionTier;
+use DateTimeImmutable;
+
+final class SubscriptionFactory
+{
+    public static function build(array $data): Subscription
+    {
+        $expiresAt = $data['expires_at'] ?? null;
+        if ($expiresAt !== null && !$expiresAt instanceof DateTimeImmutable) {
+            $expiresAt = new DateTimeImmutable($expiresAt);
+        }
+
+        $now = $data['now'] ?? null;
+        if ($now !== null && !$now instanceof DateTimeImmutable) {
+            $now = new DateTimeImmutable($now);
+        }
+
+        return new Subscription(
+            SubscriptionTier::from($data['tier']),
+            $expiresAt,
+            $now,
+        );
+    }
+}

src/app/Packages/Domains/User/Factory/UserEntityFactory.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Packages\Domains\User\Factory;
+
+use App\Packages\Domains\User\Factory\SubscriptionFactory;
+use App\Packages\Domains\User\UserEntity;
+use App\Packages\Domains\User\AgeRange;
+use App\Packages\Domains\User\ValueObject\Email;
+
+final class UserEntityFactory
+{
+    public static function build(array $data): UserEntity
+    {
+        $subscription = SubscriptionFactory::build([
+            'tier' => $data['subscription_tier'],
+            'expires_at' => $data['subscription_expires_at'] ?? null,
+            'now' => $data['now'] ?? null,
+        ]);
+
+        return new UserEntity(
+            id: isset($data['id']) ? (int) $data['id'] : null,
+            firstName: $data['first_name'],
+            lastName: $data['last_name'],
+            email: new Email($data['email']),
+            ageRange: AgeRange::from($data['age_range']),
+            subscription: $subscription,
+            passwordHash: $data['password_hash'] ?? null,
+        );
+    }
+}

src/app/Packages/Domains/User/Interface/TokenServiceInterface.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace App\Packages\Domains\User\Interface;
+
+use App\Packages\Domains\User\UserEntity;
+
+interface TokenServiceInterface
+{
+    public function createToken(UserEntity $entity): string;
+
+    public function revokeAllTokens(UserEntity $entity): void;
+
+    public function revokeCurrentToken(string $plainTextToken): void;
+}

src/app/Packages/Domains/User/Interface/UserRepositroyInterface.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Packages\Domains\User\Interface;
+
+use App\Packages\Domains\User\UserEntity;
+use App\Packages\Features\QueryUseCases\Dto\User\UserDto;
+use App\Packages\Domains\User\ValueObject\Email;
+
+interface UserRepositroyInterface
+{
+    public function createUser(UserEntity $entity): UserDto;
+
+    public function findById(int $id): ?UserDto;
+
+    public function updateUser(UserEntity $entity): UserDto;
+
+    public function deleteUser(int $id): void;
+
+    public function findByEmail(Email $email): ?UserEntity;
+}