Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

grb-postgres-migrations

/grb-postgres-migrations

Prowadzi zmiany schematu bazy Postgres w projekcie Go i React: migracje golang-migrate, gorm, klucze UUID i seed.

Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Prowadzi zmiany schematu bazy Postgres w projekcie Go i React: migracje golang-migrate, gorm, klucze UUID i seed.

Oryginalny opis (EN)

Use when changing the database schema, the seed, a gorm store or a migration in the Go React boilerplate. Covers embedded golang-migrate files, gorm boundaries, UUID keys, seed idempotency and the relevant commands.

Jak działa

  1. Schema changes
  2. Rules
  3. Seed
  4. Commands
  5. Testing a schema change
  6. Useful checks
Sekcje z nagłówków SKILL.md, w oryginale · 67 linii, 277 słów
Podgląd SKILL.md
---
name: grb-postgres-migrations
description: Use when changing the database schema, the seed, a gorm store or a migration in the Go React boilerplate. Covers embedded golang-migrate files, gorm boundaries, UUID keys, seed idempotency and the relevant commands.
---

# PostgreSQL, gorm and migrations

PostgreSQL is the only database. The adapter is
`internal/adapter/postgres`. gorm rows never leave that package.

## Schema changes

1. Add a new pair of files in
   `internal/adapter/postgres/migrations/`:
   - `000002_short_name.up.sql`
   - `000002_short_name.down.sql`
2. Never edit an applied migration.
3. Use snake_case table and column names.
4. Use `uuid` primary keys generated in Go with `entity.NewUUID()`.
5. Add indexes for foreign keys and common filters.
6. Use `timestamptz` and defaults.
7. Update the gorm row struct in `models.go`.
8. Update the store methods.
9. Run `make db-migrate` or `make db-reset`.

## Rules

- gorm stays inside `internal/adapter/postgres`, `internal/xmodule` and `cmd`.
- Store rows convert to entities at the boundary.
- Use `port.ErrUniqueViolation` for duplicate-key failures.
- Use transactions for multi-row writes.
- Use `context.Context` on every query.
- Never scan directly into an HTTP DTO.

## Seed

- `internal/adapter/postgres/seed.go` is idempotent.
- Permissions and roles are upserted.
- Demo users are inserted only when absent.
- Demo password is `password`.
- The seeded state is 14 users and 3 roles.
- Run `make db-seed` after a role or permission change.

## Commands

```bash
make db-up        # Postgres and Mailpit
make db-migrate   # apply migrations
make db-seed      # permissions, roles, demo users
make db-reset     # destructive rebuild
```

The server also applies migrations at boot. `cmd/migrate` exists for release
pipelines.

## Testing a schema change

1. Run `make db-reset`.
2. Sign in as `superadmin@example.com`.
3. Exercise the affected screen.
4. Run `make test` and the relevant Playwright spec.
5. Confirm the seed still produces the documented counts.

## Useful checks

```sql
SELECT count(*) FROM users;
SELECT count(*) FROM roles;
SELECT key, value FROM settings;
```

Wersje

W bazie nie ma innych skilli o nazwie grb-postgres-migrations.

Migawka bazy z 13.11.2026 · wersja paczki 7430ad080b7e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100go-data-persistence
    Pokazuje wzorce trwałości danych w Go: surowy SQL z sqlx i pgx, ORM-y Ent i GORM, pule połączeń, migracje golang-migrate i transakcje.
  • 100grb-architecture
    Wskazuje, gdzie w projekcie Go i React umieścić nową funkcję, i pilnuje granic warstw architektury heksagonalnej.
  • 100grb-testing
    Pomaga pisać i uruchamiać testy w projekcie Go i React: testy jednostkowe Go, Vitest, Playwright i stos testowy Docker.
  • 90dev-writing-migrations
    Pisze migracje żywego schematu Postgres lub MySQL: plan, pliki, rozszerzenie i zwężenie oraz realne wycofanie.
  • 100migration-helper
    Pisze bezpieczne migracje schematu i danych z planem wycofania i sprawdzeniem blokad dla Postgres i MySQL.
  • 95postgres-best-practices
    Podpowiada dobre praktyki pracy z Postgres: projekt schematu, indeksy, optymalizację zapytań, migracje i typowe pułapki przy pisaniu SQL.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.