db-model-conventionslisted
Install: claude install-skill DaniDSanj/Spec-Driven-Development-Template
# Convenciones de esquema de base de datos
Los **valores** concretos de este proyecto (motor y versión, convención de PK, uso de schemas,
herramienta de migraciones) están en `.claude/context/00_perfil_proyecto.md`. Aplica su **regla de
campos sin rellenar**: si el campo tiene default declarado y sigue vacío, úsalo y menciónalo en tu
respuesta; si no tiene default seguro, pregunta antes de generar nada que dependa de él.
Este fichero contiene solo convenciones, comunes a PostgreSQL y SQL Server salvo donde se señala la
diferencia explícitamente. Las skills hermanas del dominio:
| Skill | Cuándo |
|---|---|
| `db-model-ideas` | Bocetar tablas de una feature antes del plan |
| `db-model-protocol` | Reconciliar el esquema propuesto contra el modelo canónico y analizar impacto |
| `db-model-integration` | Generar la migración y actualizar el modelo canónico, tras aprobación |
## Motor
Cuál usa este proyecto: ver **Base de datos → Motor** en el perfil. PostgreSQL es el motor por defecto;
SQL Server solo con justificación.
## Convenciones de nombres
- Tablas: plural, `snake_case` → `users`, `order_items`.
- Columnas: singular, `snake_case` → `first_name`, `created_at`.
- Clave primaria: ver **Base de datos → Convención de clave primaria** en el perfil (`id` por defecto).
- Clave foránea: `[tabla_referenciada_singular]_id` → `user_id`, `order_id`. Siempre indexada.
- Schemas (PostgreSQL) para namespacing por dominio: ver **Base de datos → Uso de schemas** en el
perfil (por