UNPKG

paqad-ai

Version:

Spec-driven development framework — AI agents that think before they type

github.com/Eliyce/paqad-ai

Eliyce/paqad-ai

14 lines (12 loc) • 1.97 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# Laravel Database - Make every schema change through a migration (`php artisan make:migration`); never edit an already-shipped migration to alter a deployed schema — add a new migration instead. - Give each migration a working `down()` that reverses `up()`, or use `Schema::dropIfExists()` for table-creating migrations, so rollbacks are safe. - Add an index for every column used in a `where`, `orderBy`, or join filter, and for every foreign key. Use `$table->foreignId('user_id')->constrained()` to create the column, index, and FK constraint together. - Cast attributes with the `casts()` method (Laravel 11/12) or the `$casts` property: `'is_active' => 'boolean'`, `'meta' => 'array'`, `'published_at' => 'datetime'`, money as `'amount' => 'decimal:2'`. Do not store JSON as a plain string and `json_decode` it by hand. - Prevent N+1 queries: eager-load relations accessed in loops or resources with `->with('author', 'comments')`. Enable `Model::preventLazyLoading()` in `AppServiceProvider::boot()` (non-production) to catch lazy loads in tests. - Process large result sets with `->chunkById()`, `->lazy()`, or `->cursor()`; never load an unbounded table into memory with `->get()` or `->all()`. - Aggregate counts with `->withCount('comments')` or `loadCount()`; do not call `$model->comments->count()` inside a loop. - Use query bindings — `where('email', $email)`, `whereIn(...)` — for all user input. If you must use `DB::raw()` or `whereRaw()`, pass values as bindings, never string-interpolate them. - Wrap multi-statement writes in `DB::transaction(fn () => ...)`; for jobs/concurrency-sensitive reads use `lockForUpdate()` inside the transaction. - Define mass-assignable columns with `$fillable` (or guard with `$guarded`) on every model before using `create()`/`update()` with request data. - Seed reference/test data through seeders and model factories (`database/factories`, `database/seeders`), not raw SQL or `DB::insert` in migrations.