@famgia/omnify-laravel 0.0.88 → 0.0.89

package/stubs/ai-guides/claude-agents/tester.md.stub

@@ -0,0 +1,196 @@
+# Tester Agent
+
+> Agent for writing tests and ensuring test coverage.
+
+## Role
+
+**Testing Specialist** - Writes comprehensive tests covering all scenarios.
+
+## When to Use
+
+- Writing tests for new features
+- Adding missing test coverage
+- Verifying test completeness
+- Test debugging
+
+## Persona
+
+### Style
+
+- Thorough and systematic
+- Edge-case aware
+- Clear test naming
+- Real-world scenarios
+
+### Core Principles
+
+1. **正常系 + 異常系**: Cover both success and failure paths
+2. **API-First Data**: Create test data via API when possible
+3. **PEST Syntax**: Use PEST, not PHPUnit
+4. **Descriptive Names**: `正常:` and `異常:` prefixes
+5. **No Bias**: Test real behavior, not implementation
+
+## Context to Read
+
+Before writing tests, read these:
+
+| Priority      | File                                                       | Purpose                 |
+| ------------- | ---------------------------------------------------------- | ----------------------- |
+| **Required**  | [/guides/laravel/testing.md](../guides/laravel/testing.md) | Full testing guide      |
+| **Required**  | [/rules/naming.md](../rules/naming.md)                     | Test naming conventions |
+| **Reference** | [/checklists/backend.md](../checklists/backend.md)         | Test checklist          |
+
+## Test Coverage Matrix
+
+### Per Endpoint
+
+| Endpoint    | 正常系 (Normal)              | 異常系 (Abnormal)            |
+| ----------- | ---------------------------- | ---------------------------- |
+| **index**   | List, filter, sort, paginate | Empty result, invalid params |
+| **store**   | Creates → 201                | 422 (each field), duplicate  |
+| **show**    | Returns → 200                | 404 not found                |
+| **update**  | Full update, partial         | 404, 422                     |
+| **destroy** | Deletes → 204                | 404                          |
+
+### Auth Endpoints (if protected)
+
+| Scenario      | Expected |
+| ------------- | -------- |
+| No token      | 401      |
+| Invalid token | 401      |
+| No permission | 403      |
+
+### Japanese Field Validation
+
+| Field         | Valid        | Invalid          |
+| ------------- | ------------ | ---------------- |
+| `name_kana_*` | カタカナ     | hiragana, romaji |
+| Max length    | Within limit | Exceeds limit    |
+
+## Test Naming Convention
+
+```php
+// 正常系 (Normal cases) - success behavior
+it('正常: returns paginated users')
+it('正常: creates user with valid data')
+it('正常: updates user with partial data')
+
+// 異常系 (Abnormal cases) - 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')
+```
+
+## Test Template
+
+```php
+describe('POST /api/users', function () {
+    // ================================================================
+    // 正常系 (Normal Cases)
+    // ================================================================
+    
+    it('正常: creates user with valid data', function () {
+        $data = [
+            'name_lastname' => '田中',
+            'name_firstname' => '太郎',
+            'name_kana_lastname' => 'タナカ',
+            'name_kana_firstname' => 'タロウ',
+            'email' => 'test@example.com',
+            'password' => 'password123',
+        ];
+        
+        $response = $this->postJson('/api/users', $data);
+        
+        $response->assertCreated()
+            ->assertJsonPath('data.email', 'test@example.com');
+        
+        $this->assertDatabaseHas('users', ['email' => 'test@example.com']);
+    });
+    
+    // ================================================================
+    // 異常系 (Abnormal Cases)
+    // ================================================================
+    
+    // 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 () {
+        $data = validUserData(['email' => 'not-an-email']);
+        
+        $this->postJson('/api/users', $data)
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors(['email']);
+    });
+    
+    // Japanese field validation
+    it('異常: fails to create user with invalid kana format', function () {
+        $data = validUserData(['name_kana_lastname' => 'たなか']); // hiragana
+        
+        $this->postJson('/api/users', $data)
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors(['name_kana_lastname']);
+    });
+    
+    // Unique constraint
+    it('異常: fails to create user with duplicate email', function () {
+        User::factory()->create(['email' => 'existing@example.com']);
+        $data = validUserData(['email' => 'existing@example.com']);
+        
+        $this->postJson('/api/users', $data)
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors(['email']);
+    });
+});
+
+describe('GET /api/users/{id}', function () {
+    it('正常: returns user by id', function () {
+        $user = User::factory()->create();
+        
+        $this->getJson("/api/users/{$user->id}")
+            ->assertOk()
+            ->assertJsonPath('data.id', $user->id);
+    });
+    
+    it('異常: returns 404 when user not found', function () {
+        $this->getJson('/api/users/99999')
+            ->assertNotFound();
+    });
+});
+```
+
+## Debugging Failed Tests
+
+```mermaid
+flowchart TD
+    Fail[Test Failed] --> Check1{Endpoint correct?}
+    Check1 -->|No| FixEndpoint[Fix URL/method]
+    Check1 -->|Yes| Check2{Data valid?}
+    Check2 -->|No| FixData[Fix test data]
+    Check2 -->|Yes| Check3{Assertion correct?}
+    Check3 -->|No| FixAssert[Fix assertion]
+    Check3 -->|Yes| CodeBug[Code has bug - fix code]
+```
+
+## Example Interaction
+
+```
+User: Write tests for OrderController
+
+Tester Agent:
+1. Read /guides/laravel/testing.md
+2. Identify endpoints (index, store, show, update, destroy)
+3. For each endpoint:
+   - Write 正常系 tests
+   - Write 異常系 tests (validation, 404, 401, 403)
+4. Add Japanese field tests if applicable
+5. Output complete test file with describe/it blocks
+```

package/stubs/ai-guides/claude-checklists/backend.md.stub

@@ -0,0 +1,112 @@
+# Backend Checklist
+
+> Quick reference. For details, see linked guides.
+
+## New Resource
+
+| Step | Action                | Guide                                                       |
+| ---- | --------------------- | ----------------------------------------------------------- |
+| 1    | Create schema         | [guides/omnify/schema-guide.md](../guides/omnify/schema-guide.md) |
+| 2    | `npx omnify generate` |                                                             |
+| 3    | `./artisan migrate`   |                                                             |
+| 4    | Model (extend base)   | [guides/laravel/README.md](../guides/laravel/README.md)     |
+| 5    | Controller (thin)     |                                                             |
+| 6    | Resource              |                                                             |
+| 7    | Routes                |                                                             |
+| 8    | **Tests**             | [guides/laravel/testing.md](../guides/laravel/testing.md)   |
+| 9    | `./artisan test`      |                                                             |
+| 10   | OpenAPI               | [guides/laravel/openapi.md](../guides/laravel/openapi.md)   |
+
+> **Full workflow**: [workflows/new-feature.md](../workflows/new-feature.md)
+
+---
+
+## Before Commit
+
+### Code
+- [ ] No `dd()`, `dump()`, `console.log`
+- [ ] No commented-out code
+- [ ] Type hints on methods
+
+### Security
+- [ ] `$fillable` defined in Model
+- [ ] `$request->validated()` (not `all()`)
+- [ ] Sensitive data in `$hidden`
+
+### API
+- [ ] Dates use `->toISOString()`
+- [ ] Return Resource (not Model)
+- [ ] Proper HTTP status codes
+
+### Performance
+- [ ] `with()` for relations
+- [ ] `whenLoaded()` in Resources
+- [ ] `paginate()` for lists
+
+> **Details**: [rules/](../rules/)
+
+---
+
+## Tests
+
+### Coverage Required
+
+| Endpoint    | 正常系             | 異常系                |
+| ----------- | ------------------ | --------------------- |
+| **index**   | List, filter, sort | Empty, invalid params |
+| **store**   | Creates → 201      | 422 (validation)      |
+| **show**    | Returns → 200      | 404                   |
+| **update**  | Updates → 200      | 404, 422              |
+| **destroy** | Deletes → 204      | 404                   |
+
+### Auth Tests (if protected)
+- 401: Not authenticated
+- 403: Not authorized
+
+> **Full guide**: [guides/laravel/testing.md](../guides/laravel/testing.md)
+
+---
+
+## OpenAPI
+
+1. Check `OmnifyBase/*RequestBase.php` for request fields
+2. Check `OmnifyBase/*ResourceBase.php` for response fields
+3. Use `$ref` from `Schemas.php`
+4. Run `./artisan l5-swagger:generate`
+
+> **Full guide**: [guides/laravel/openapi.md](../guides/laravel/openapi.md)
+
+---
+
+## Controller Methods
+
+### index
+```php
+return UserResource::collection(
+    User::with('relation')
+        ->when($request->search, fn($q, $s) => $q->where('name', 'like', "%{$s}%"))
+        ->paginate($request->input('per_page', 15))
+);
+```
+
+### store
+```php
+return new UserResource(User::create($request->validated()));
+```
+
+### show
+```php
+return new UserResource($user->load('relation'));
+```
+
+### update
+```php
+$user->update($request->validated());
+return new UserResource($user);
+```
+
+### destroy
+```php
+$user->delete();
+return response()->noContent();
+```

package/stubs/ai-guides/claude-omnify/antdesign-guide.md.stub

@@ -0,0 +1,401 @@
+# Omnify + Ant Design Integration Guide
+
+This guide shows how to use Omnify-generated validation rules with Ant Design Forms.
+
+## Generated Files
+
+Omnify generates validation rules in `rules/` directory:
+- `rules/{Model}.rules.ts` - Validation rules for each model
+
+## File Structure
+
+```typescript
+// rules/User.rules.ts
+
+// Display name for model (multi-locale)
+export const UserDisplayName: LocaleMap = {
+  ja: 'ユーザー',
+  en: 'User',
+};
+
+// Display names for properties (multi-locale)
+export const UserPropertyDisplayNames: Record<string, LocaleMap> = {
+  name: { ja: '名前', en: 'Name' },
+  email: { ja: 'メールアドレス', en: 'Email' },
+};
+
+// Validation rules with multi-locale messages
+export const UserRules: Record<string, ValidationRule[]> = {
+  name: [
+    { required: true, message: { ja: '名前は必須です', en: 'Name is required' } },
+    { max: 100, message: { ja: '名前は100文字以内で入力してください', en: 'Name must be at most 100 characters' } },
+  ],
+  email: [
+    { required: true, message: { ja: 'メールアドレスは必須です', en: 'Email is required' } },
+    { type: 'email', message: { ja: 'メールアドレスの形式が正しくありません', en: 'Email is not a valid email address' } },
+  ],
+};
+
+// Helper functions
+export function getUserRules(locale: string): Record<string, Rule[]>;
+export function getUserDisplayName(locale: string): string;
+export function getUserPropertyDisplayName(property: string, locale: string): string;
+```
+
+## Basic Usage
+
+```tsx
+import { Form, Input, Button } from 'antd';
+import {
+  getUserRules,
+  getUserDisplayName,
+  getUserPropertyDisplayName
+} from '@/types/model/rules/User.rules';
+
+interface UserFormProps {
+  locale?: string;
+  onSubmit: (values: User) => void;
+}
+
+export function UserForm({ locale = 'ja', onSubmit }: UserFormProps) {
+  const [form] = Form.useForm();
+  const rules = getUserRules(locale);
+
+  return (
+    <Form
+      form={form}
+      layout="vertical"
+      onFinish={onSubmit}
+    >
+      <Form.Item
+        name="name"
+        label={getUserPropertyDisplayName('name', locale)}
+        rules={rules.name}
+      >
+        <Input placeholder={getUserPropertyDisplayName('name', locale)} />
+      </Form.Item>
+
+      <Form.Item
+        name="email"
+        label={getUserPropertyDisplayName('email', locale)}
+        rules={rules.email}
+      >
+        <Input type="email" />
+      </Form.Item>
+
+      <Form.Item>
+        <Button type="primary" htmlType="submit">
+          {locale === 'ja' ? '送信' : 'Submit'}
+        </Button>
+      </Form.Item>
+    </Form>
+  );
+}
+```
+
+## With Edit Mode (Initial Values)
+
+```tsx
+import { Form, Input, Button, Spin } from 'antd';
+import { getUserRules, getUserPropertyDisplayName } from '@/types/model/rules/User.rules';
+import { User } from '@/types/model';
+
+interface UserEditFormProps {
+  user: User;
+  locale?: string;
+  onSubmit: (values: Partial<User>) => void;
+  loading?: boolean;
+}
+
+export function UserEditForm({ user, locale = 'ja', onSubmit, loading }: UserEditFormProps) {
+  const [form] = Form.useForm();
+  const rules = getUserRules(locale);
+
+  // Set initial values when user data changes
+  React.useEffect(() => {
+    form.setFieldsValue(user);
+  }, [user, form]);
+
+  return (
+    <Spin spinning={loading}>
+      <Form
+        form={form}
+        layout="vertical"
+        initialValues={user}
+        onFinish={onSubmit}
+      >
+        <Form.Item
+          name="name"
+          label={getUserPropertyDisplayName('name', locale)}
+          rules={rules.name}
+        >
+          <Input />
+        </Form.Item>
+
+        <Form.Item
+          name="email"
+          label={getUserPropertyDisplayName('email', locale)}
+          rules={rules.email}
+        >
+          <Input type="email" />
+        </Form.Item>
+
+        <Form.Item>
+          <Button type="primary" htmlType="submit" loading={loading}>
+            {locale === 'ja' ? '更新' : 'Update'}
+          </Button>
+        </Form.Item>
+      </Form>
+    </Spin>
+  );
+}
+```
+
+## Dynamic Locale Switching
+
+```tsx
+import { Form, Input, Select } from 'antd';
+import { useState, useMemo } from 'react';
+import { getUserRules, getUserPropertyDisplayName, getUserDisplayName } from '@/types/model/rules/User.rules';
+
+export function UserFormWithLocale() {
+  const [locale, setLocale] = useState('ja');
+  const [form] = Form.useForm();
+
+  // Memoize rules to avoid recalculation
+  const rules = useMemo(() => getUserRules(locale), [locale]);
+
+  return (
+    <>
+      <Select value={locale} onChange={setLocale} style={{ marginBottom: 16 }}>
+        <Select.Option value="ja">日本語</Select.Option>
+        <Select.Option value="en">English</Select.Option>
+        <Select.Option value="vi">Tiếng Việt</Select.Option>
+      </Select>
+
+      <h2>{getUserDisplayName(locale)}</h2>
+
+      <Form form={form} layout="vertical">
+        <Form.Item
+          name="name"
+          label={getUserPropertyDisplayName('name', locale)}
+          rules={rules.name}
+        >
+          <Input />
+        </Form.Item>
+
+        <Form.Item
+          name="email"
+          label={getUserPropertyDisplayName('email', locale)}
+          rules={rules.email}
+        >
+          <Input type="email" />
+        </Form.Item>
+      </Form>
+    </>
+  );
+}
+```
+
+## With Table Columns
+
+```tsx
+import { Table, TableColumnsType } from 'antd';
+import { getUserPropertyDisplayName } from '@/types/model/rules/User.rules';
+import { User } from '@/types/model';
+
+interface UserTableProps {
+  users: User[];
+  locale?: string;
+  loading?: boolean;
+}
+
+export function UserTable({ users, locale = 'ja', loading }: UserTableProps) {
+  const columns: TableColumnsType<User> = [
+    {
+      title: getUserPropertyDisplayName('name', locale),
+      dataIndex: 'name',
+      key: 'name',
+    },
+    {
+      title: getUserPropertyDisplayName('email', locale),
+      dataIndex: 'email',
+      key: 'email',
+    },
+  ];
+
+  return (
+    <Table
+      columns={columns}
+      dataSource={users}
+      rowKey="id"
+      loading={loading}
+    />
+  );
+}
+```
+
+## Custom Form Hook
+
+```tsx
+import { Form, FormInstance } from 'antd';
+import { useMemo } from 'react';
+
+// Generic hook for any model's rules
+export function useModelForm<T>(
+  getRules: (locale: string) => Record<string, any[]>,
+  locale: string = 'ja'
+): {
+  form: FormInstance<T>;
+  rules: Record<string, any[]>;
+} {
+  const [form] = Form.useForm<T>();
+  const rules = useMemo(() => getRules(locale), [getRules, locale]);
+
+  return { form, rules };
+}
+
+// Usage
+import { getUserRules } from '@/types/model/rules/User.rules';
+
+function MyComponent() {
+  const { form, rules } = useModelForm(getUserRules, 'ja');
+
+  return (
+    <Form form={form}>
+      <Form.Item name="name" rules={rules.name}>
+        <Input />
+      </Form.Item>
+    </Form>
+  );
+}
+```
+
+## Modal Form
+
+```tsx
+import { Modal, Form, Input, message } from 'antd';
+import { getUserRules, getUserDisplayName, getUserPropertyDisplayName } from '@/types/model/rules/User.rules';
+import { User } from '@/types/model';
+
+interface UserModalFormProps {
+  open: boolean;
+  onClose: () => void;
+  onSubmit: (values: Partial<User>) => Promise<void>;
+  initialValues?: Partial<User>;
+  locale?: string;
+}
+
+export function UserModalForm({
+  open,
+  onClose,
+  onSubmit,
+  initialValues,
+  locale = 'ja'
+}: UserModalFormProps) {
+  const [form] = Form.useForm();
+  const [loading, setLoading] = useState(false);
+  const rules = getUserRules(locale);
+
+  const handleSubmit = async () => {
+    try {
+      const values = await form.validateFields();
+      setLoading(true);
+      await onSubmit(values);
+      message.success(locale === 'ja' ? '保存しました' : 'Saved successfully');
+      form.resetFields();
+      onClose();
+    } catch (error) {
+      if (error instanceof Error) {
+        message.error(error.message);
+      }
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <Modal
+      title={getUserDisplayName(locale)}
+      open={open}
+      onCancel={onClose}
+      onOk={handleSubmit}
+      confirmLoading={loading}
+      okText={locale === 'ja' ? '保存' : 'Save'}
+      cancelText={locale === 'ja' ? 'キャンセル' : 'Cancel'}
+    >
+      <Form
+        form={form}
+        layout="vertical"
+        initialValues={initialValues}
+      >
+        <Form.Item
+          name="name"
+          label={getUserPropertyDisplayName('name', locale)}
+          rules={rules.name}
+        >
+          <Input />
+        </Form.Item>
+
+        <Form.Item
+          name="email"
+          label={getUserPropertyDisplayName('email', locale)}
+          rules={rules.email}
+        >
+          <Input type="email" />
+        </Form.Item>
+      </Form>
+    </Modal>
+  );
+}
+```
+
+## Validation Rule Types
+
+Omnify generates these rule types based on schema:
+
+| Schema | Generated Rule |
+|--------|---------------|
+| `required: true` | `{ required: true, message: {...} }` |
+| `type: Email` | `{ type: 'email', message: {...} }` |
+| `maxLength: N` | `{ max: N, message: {...} }` |
+| `minLength: N` | `{ min: N, message: {...} }` |
+| `max: N` (numeric) | `{ max: N, type: 'number', message: {...} }` |
+| `min: N` (numeric) | `{ min: N, type: 'number', message: {...} }` |
+| `pattern: regex` | `{ pattern: /regex/, message: {...} }` |
+
+## Built-in Validation Messages
+
+Omnify includes templates for 5 languages:
+- Japanese (ja)
+- English (en)
+- Vietnamese (vi)
+- Korean (ko)
+- Chinese (zh)
+
+Custom templates can be configured in `omnify.config.ts`:
+
+```typescript
+export default defineConfig({
+  output: {
+    typescript: {
+      validationTemplates: {
+        required: {
+          ja: '${displayName}を入力してください',
+          en: '${displayName} is required',
+          vi: '${displayName} là bắt buộc',
+        },
+        maxLength: {
+          ja: '${displayName}は${max}文字以内です',
+          en: '${displayName} must be at most ${max} characters',
+        },
+      },
+    },
+  },
+});
+```
+
+Available placeholders:
+- `${displayName}` - Property display name
+- `${min}` - Minimum value/length
+- `${max}` - Maximum value/length