Fullstack Implementation

Validation Loop (MANDATORY)

Before completing ANY implementation, run this verification sequence:

composer test           # All PHP tests pass
npm run types          # No TypeScript errors
npm run lint           # No linting errors
./vendor/bin/pint      # PHP code styled
python -m pytest       # Python tests pass
ruff check .           # Python lint clean
mypy .                 # Python typing clean

Do NOT report completion until all checks pass.

Instructions

1. Review docs/code-standards.md for naming conventions
2. Check docs/codebase-summary.md for current structure
3. Follow patterns in docs/system-architecture.md
4. Implement backend first, then frontend
5. Run verification commands before committing

Implementation Order

Backend First (Laravel)

1. Route → routes/web.php or routes/api.php
2. Controller → app/Http/Controllers/
3. FormRequest → app/Http/Requests/
4. Model → app/Models/
5. Policy → app/Policies/

Backend First (FastAPI)

1. Router → src/api/
2. Schema → src/schemas/
3. Model → src/models/
4. Service → src/services/
5. Migration → Alembic revision (if applicable)

Frontend Second

1. Types → resources/js/types/
2. Page → resources/js/pages/
3. Components → resources/js/components/
4. Hooks → resources/js/hooks/

Laravel 12 Patterns

Controllers

// Invokable for single action
class ShowDashboardController
{
    public function __invoke(): Response
    {
        return Inertia::render('Dashboard', [...]);
    }
}

// Resource for CRUD
class PostController extends Controller
{
    public function store(StorePostRequest $request) { ... }
}

Form Requests

class StorePostRequest extends FormRequest
{
    public function authorize(): bool
    {
        return $this->user()->can('create', Post::class);
    }

    public function rules(): array
    {
        return [
            'title' => ['required', 'string', 'max:255'],
        ];
    }
}

React 19 Patterns

Inertia Form

const { data, setData, post, processing, errors } = useForm({
    title: '',
});

const submit = (e: FormEvent) => {
    e.preventDefault();
    post(route('posts.store'));
};

TypeScript Types

interface Post {
    id: number;
    title: string;
    created_at: string;
}

interface Props {
    posts: Post[];
}

Verification

composer test            # PHP tests
npm run types           # TypeScript
npm run lint            # ESLint
./vendor/bin/pint       # PHP style
python -m pytest        # Python tests
ruff check .            # Python lint
mypy .                  # Python typing

Instructions

1. Read project docs for context and conventions
2. Identify entry points (routes/controllers/pages)
3. Follow patterns in docs/code-standards.md
4. Keep changes minimal and cohesive
5. Add or update tests when behavior changes
6. Update docs/codebase-summary.md if adding new files

Examples

• "Add a new CRUD page with validation and tests"
• "Wire a form to a controller endpoint and handle errors"
• "Add a FastAPI router, schema, service, and tests"