feat: implement Login API across all layers / ユーザーログインAPIの全層実装

[zigzagdev]

Motivation / 目的

Implement POST /api/v1/user/login API using Laravel Sanctum for token-based authentication.
Each layer was developed on its own branch and merged in sequence.

ユーザーログイン機能（POST /api/v1/user/login）を実装しました。
Laravel Sanctum を用いたトークン認証を採用し、DDD の各層を個別ブランチで実装して順次マージしています。

---

What I have done / 実施内容

Domain Layer

• Added Email Value Object (App\Packages\Domains\User\ValueObject\Email)
• Added findByEmail to UserRepositroyInterface
• Refactored UserEntity and UserEntityFactory to use Email VO
• Added TokenServiceInterface (createToken, revokeAllTokens)

Infra Layer

• Installed laravel/sanctum and published config (expiration: 1440 min = 1 day)
• Added personal_access_tokens migration
• Added HasApiTokens trait to User model
• Implemented SanctumTokenService (resolves User Eloquent model from UserEntity and delegates to Sanctum)
• Bound TokenServiceInterface → SanctumTokenService in AppServiceProvider

Application Layer

• Added AuthTokenDto (token: string, tokenType: string = 'Bearer')
• Implemented LoginUseCase::handle(string $email, string $password): AuthTokenDto
  • findByEmail → entity null check → password_verify → createToken
  • Password errors return InvalidArgumentException (→ 401)

Presentation Layer

• Added AuthController::login with 200 / 401 / 500 response handling
• Registered POST /v1/user/login route
• Refactored routes/api.php using Route::controller()->prefix()->group() grouping
• Added integration tests for all 3 HTTP paths (200, 401, 500)

Static Analysis (mago)

• Added mago.toml with lint-based static analysis config (scoped to app/Packages)
• Added .github/workflows/static_analysis.yml CI workflow (mago lint on PR)

---

Test Results / テスト結果

Integration Tests

• LoginTest::test_login_returns_200_with_token_on_valid_credentials
• LoginTest::test_login_returns_401_when_user_not_found
• LoginTest::test_login_returns_401_on_wrong_password
• LoginTest::test_login_returns_500_on_unexpected_error
• SanctumTokenServiceTest::test_createToken_returns_plain_text_token
• SanctumTokenServiceTest::test_createToken_throws_when_user_not_found
• SanctumTokenServiceTest::test_revokeAllTokens_deletes_tokens_for_user
• SanctumTokenServiceTest::test_revokeAllTokens_throws_when_user_not_found
• UserRepositoryTest::test_findByEmail_returns_entity_when_email_matches
• UserRepositoryTest::test_findByEmail_returns_null_when_email_not_found

Unit Tests

• LoginUseCaseTest::test_handle_returns_auth_token_dto_on_valid_credentials
• LoginUseCaseTest::test_handle_throws_when_user_not_found
• LoginUseCaseTest::test_handle_throws_when_password_does_not_match

Closes #405

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 61.75%. Comparing base (0ca7fd4) to head (e24f4c2).
⚠️ Report is 33 commits behind head on feat/user.

Additional details and impacted files

@@               Coverage Diff               @@
##             feat/user     #535      +/-   ##
===============================================
+ Coverage        60.30%   61.75%   +1.45%     
- Complexity        1534     1585      +51     
===============================================
  Files              123      132       +9     
  Lines             7854     8153     +299     
===============================================
+ Hits              4736     5035     +299     
  Misses            3118     3118              

Files with missing lines	Coverage Δ
src/app/Models/User.php	100.00% <ø> (ø)
...ackages/Domains/User/Factory/UserEntityFactory.php	100.00% <100.00%> (ø)
...kages/Domains/User/Service/SanctumTokenService.php	100.00% <100.00%> (ø)
...mains/User/Tests/Factory/UserEntityFactoryTest.php	100.00% <100.00%> (ø)
...ins/User/Tests/Service/SanctumTokenServiceTest.php	100.00% <100.00%> (ø)
...app/Packages/Domains/User/Tests/UserEntityTest.php	100.00% <100.00%> (ø)
...Packages/Domains/User/Tests/UserRepositoryTest.php	100.00% <100.00%> (ø)
...kages/Domains/User/Tests/ValueObject/EmailTest.php	100.00% <100.00%> (ø)
src/app/Packages/Domains/User/UserEntity.php	100.00% <100.00%> (ø)
src/app/Packages/Domains/User/UserRepository.php	98.11% <100.00%> (+0.67%)	⬆️
... and 7 more

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[zigzagdev]

LGTM