@famgia/omnify-laravel 0.0.88 → 0.0.90

package/stubs/ai-guides/cursor/laravel-testing.mdc.stub

@@ -0,0 +1,138 @@
+---
+description: "PEST testing rules - 正常系/異常系, naming conventions"
+globs: ["tests/**", "**/*Test.php"]
+alwaysApply: false
+---
+
+# Testing Rules (PEST)
+
+> **Agent:** Act as **@tester** agent
+> - Read `.claude/guides/laravel/testing.md` for full guide
+
+## How to Run Tests
+
+```bash
+# Run ALL tests (from project root - uses Docker wrapper)
+./artisan test
+
+# Run specific test file
+./artisan test --filter=UserControllerTest
+
+# Run specific test method
+./artisan test --filter="creates user with valid data"
+
+# Run with coverage (if xdebug installed)
+./artisan test --coverage
+```
+
+> **Note:** The root `./artisan` script is a wrapper that runs commands inside Docker container.
+
+## Testing Process
+
+1. **Before writing tests:**
+   - Read the Controller to understand endpoints
+   - Read the Request to understand validation rules
+   - Read the Resource to understand response structure
+
+2. **Write tests covering:**
+   - 正常系 (Normal cases) - success scenarios
+   - 異常系 (Abnormal cases) - failure scenarios
+
+3. **Run tests to verify:**
+   ```bash
+   cd backend && ./artisan test
+   ```
+
+4. **All tests must pass before committing**
+
+## Critical Rules
+
+1. **PEST Syntax** - Use `describe()` + `it()`, not PHPUnit
+2. **正常系 + 異常系** - Cover both success and failure
+3. **Naming** - Use `正常:` and `異常:` prefixes
+4. **Coverage** - All endpoints, all validation rules
+5. **RefreshDatabase** - MUST use for SQLite in-memory
+
+## Database Trait - IMPORTANT
+
+```php
+// ✅ CORRECT - Use RefreshDatabase for SQLite in-memory
+use Illuminate\Foundation\Testing\RefreshDatabase;
+uses(RefreshDatabase::class);
+
+// ❌ WRONG - DatabaseTransactions doesn't run migrations
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+uses(DatabaseTransactions::class);  // Will fail with "no such table"
+```
+
+| Trait                  | When to Use                       | Notes                           |
+| ---------------------- | --------------------------------- | ------------------------------- |
+| `RefreshDatabase`      | SQLite in-memory (default)        | Runs migrations, then truncates |
+| `DatabaseTransactions` | MySQL/PostgreSQL with existing DB | Only wraps in transaction       |
+
+## Test Naming
+
+```php
+// 正常系 (Normal) - success behavior
+it('正常: returns paginated users')
+it('正常: creates user with valid data')
+it('正常: deletes user')
+
+// 異常系 (Abnormal) - failure behavior
+it('異常: fails to create user with missing email')
+it('異常: fails to create user with invalid kana format')
+it('異常: returns 404 when user not found')
+it('異常: returns 401 when not authenticated')
+```
+
+## Coverage Matrix
+
+| Endpoint | 正常系             | 異常系                |
+| -------- | ------------------ | --------------------- |
+| index    | List, filter, sort | Empty, invalid params |
+| store    | Creates → 201      | 422 (each field)      |
+| show     | Returns → 200      | 404                   |
+| update   | Updates → 200      | 404, 422              |
+| destroy  | Deletes → 204      | 404                   |
+
+## Template
+
+```php
+describe('POST /api/users', function () {
+    // 正常系
+    it('正常: creates user with valid data', function () {
+        $response = $this->postJson('/api/users', validUserData());
+        
+        $response->assertCreated();
+        $this->assertDatabaseHas('users', ['email' => 'test@example.com']);
+    });
+    
+    // 異常系 - Required fields
+    it('異常: fails to create user with missing email', function () {
+        $data = validUserData();
+        unset($data['email']);
+        
+        $this->postJson('/api/users', $data)
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors(['email']);
+    });
+    
+    // 異常系 - Format validation
+    it('異常: fails to create user with invalid email format', function () {
+        $this->postJson('/api/users', validUserData(['email' => 'invalid']))
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors(['email']);
+    });
+});
+```
+
+## Japanese Field Tests
+
+```php
+it('異常: fails with hiragana in kana field', function () {
+    $this->postJson('/api/users', validUserData([
+        'name_kana_lastname' => 'たなか'  // hiragana - should fail
+    ]))->assertUnprocessable()
+       ->assertJsonValidationErrors(['name_kana_lastname']);
+});
+```

package/stubs/ai-guides/cursor/laravel.mdc.stub

@@ -0,0 +1,82 @@
+---
+description: "Laravel backend development rules - security, performance, patterns"
+globs: ["{{LARAVEL_BASE}}/**"]
+alwaysApply: false
+---
+
+# Laravel Rules
+
+> **Documentation:** `.claude/guides/laravel/`
+> **Specific Rules:** See also `laravel-controller.mdc`, `laravel-resource.mdc`, `laravel-request.mdc`, `laravel-testing.mdc`
+
+## Critical Rules
+
+1. **Thin Controller** - Validate → Delegate → Respond (see `laravel-controller.mdc`)
+2. **Schema-First** - Use Omnify schemas, don't create migrations manually
+3. **Security** - Always use `$request->validated()`, never `$request->all()`
+4. **Performance** - Use `with()` for relations, `paginate()` for lists
+5. **Dates** - Store UTC, return `->toISOString()`
+6. **Testing** - Write 正常系 + 異常系 tests (see `laravel-testing.mdc`)
+7. **Imports** - Always `use` and short class names, never FQCN inline
+
+## File-Specific Rules
+
+| File Type  | Rule File               | Key Focus                    |
+| ---------- | ----------------------- | ---------------------------- |
+| Controller | `laravel-controller.mdc` | Thin, Query Builder, OpenAPI |
+| Resource   | `laravel-resource.mdc`   | Schema matches output        |
+| Request    | `laravel-request.mdc`    | Schema matches validation    |
+| Test       | `laravel-testing.mdc`    | 正常系 + 異常系 coverage     |
+
+## Security Checklist
+
+- [ ] `$fillable` defined in Model
+- [ ] `$hidden` for sensitive fields
+- [ ] `$request->validated()` not `$request->all()`
+- [ ] No raw SQL with user input
+- [ ] `with()` for eager loading
+- [ ] `whenLoaded()` in Resources
+- [ ] `paginate()` for list endpoints
+
+## When to Use What
+
+| Scenario         | Solution           |
+| ---------------- | ------------------ |
+| Simple CRUD      | Controller + Model |
+| Multi-step logic | Service            |
+| Reusable action  | Action class       |
+| Async task       | Job                |
+
+## Pre-Edit Checklist
+
+**BEFORE editing any file, MUST:**
+
+1. **Read the file first** - Check existing imports, patterns, style
+2. **Check imports** - Add `use` if class not imported
+3. **Follow existing style** - Match indentation, naming, patterns
+4. **Never use FQCN inline** - Always import first
+
+## Imports Rule
+
+```php
+// ❌ WRONG: Inline FQCN
+public function store(): \Illuminate\Http\JsonResponse
+
+// ✅ CORRECT: Import and use short name
+use Illuminate\Http\JsonResponse;
+public function store(): JsonResponse
+```
+
+## Don't Over-Engineer
+
+| ❌ DON'T                             | ✅ DO                      |
+| ----------------------------------- | ------------------------- |
+| Add workaround to hide bugs         | Fix root cause or report  |
+| Repository for simple CRUD          | Use Eloquent directly     |
+| Service that just wraps Model       | Controller + Model        |
+| Interface with 1 implementation     | Concrete class            |
+| Manual 404 check with route binding | Trust framework           |
+| "Improve" unrelated code            | Change only what's needed |
+| Build for future "just in case"     | YAGNI - build when needed |
+
+**Full examples:** `.claude/guides/laravel/architecture.md`

package/stubs/ai-guides/cursor/omnify.mdc.stub

@@ -0,0 +1,58 @@
+---
+description: "Omnify schema-driven code generation rules"
+globs: ["schemas/**/*.yaml", "omnify.config.ts"]
+alwaysApply: false
+---
+
+# Omnify Schema Rules
+
+This project uses Omnify for schema-driven code generation.
+
+## Documentation
+
+Read these files in `.claude/omnify/guides/omnify/`:
+
+| File                  | Content                          |
+| --------------------- | -------------------------------- |
+| `schema-guide.md`     | Base schema format               |
+| `config-guide.md`     | Configuration (omnify.config.ts) |
+| `laravel-guide.md`    | Laravel generator                |
+| `typescript-guide.md` | TypeScript generator             |
+| `japan-guide.md`      | Japanese field types             |
+
+## Commands
+
+```bash
+npx omnify generate  # Generate code from schemas
+npx omnify validate  # Validate all schemas
+```
+
+## Important
+
+- **DO NOT** manually edit files in `database/migrations/omnify/`
+- **DO NOT** manually edit files in `resources/ts/omnify/schemas/base/`
+- **DO NOT** manually edit files in `app/Models/OmnifyBase/`
+- Schema changes → Run `npx omnify generate`
+
+## Schema Quick Reference
+
+```yaml
+name: User
+displayName:
+  ja: ユーザー
+  en: User
+
+properties:
+  email:
+    type: Email
+    unique: true
+  name:
+    type: String
+  role:
+    type: EnumRef
+    target: UserRole
+
+options:
+  timestamps: true
+  softDelete: true
+```

package/stubs/ai-guides/laravel/README.md.stub

@@ -0,0 +1,59 @@
+# Backend Guides
+
+> Laravel 12, PHP 8.4, MySQL 8
+
+## Quick Navigation
+
+| Guide                                | Description                                   |
+| ------------------------------------ | --------------------------------------------- |
+| [architecture.md](./architecture.md) | Design philosophy, when to use Service/Action |
+| [controller.md](./controller.md)     | Thin controller pattern, CRUD template        |
+| [request.md](./request.md)           | Form validation, FormRequest                  |
+| [resource.md](./resource.md)         | API response format, dates                    |
+| [service.md](./service.md)           | When & how to use services                    |
+| [testing.md](./testing.md)           | PEST, 正常系/異常系                           |
+| [openapi.md](./openapi.md)           | Swagger documentation                         |
+| [datetime.md](./datetime.md)         | Carbon, UTC handling                          |
+
+## Related
+
+| Topic                    | Location                                                    |
+| ------------------------ | ----------------------------------------------------------- |
+| **Security rules**       | [/rules/security.md](../../rules/security.md)               |
+| **Performance rules**    | [/rules/performance.md](../../rules/performance.md)         |
+| **Naming conventions**   | [/rules/naming.md](../../rules/naming.md)                   |
+| **Checklist**            | [/checklists/backend.md](../../checklists/backend.md)       |
+| **New feature workflow** | [/workflows/new-feature.md](../../workflows/new-feature.md) |
+
+## Quick Patterns
+
+### Thin Controller
+
+```php
+public function store(UserStoreRequest $request): UserResource
+{
+    return new UserResource(User::create($request->validated()));
+}
+```
+
+### Resource with Dates
+
+```php
+public function toArray($request): array
+{
+    return [
+        'id' => $this->id,
+        'name' => $this->name,
+        'created_at' => $this->created_at?->toISOString(),
+    ];
+}
+```
+
+### When to Use What
+
+| Question                   | Answer          |
+| -------------------------- | --------------- |
+| Simple CRUD?               | Controller only |
+| Multi-step business logic? | Service         |
+| Single reusable action?    | Action class    |
+| Async task?                | Job             |