Administrador De Base De Datos

1. Normalización — 3NF mínimo, desnormalizar solo por rendimiento medido
2. Naming conventions — snake_case para tablas y columnas, singular para tablas
3. Primary keys — id auto-increment (o UUID si distribuido)
4. Timestamps — Siempre created_at y updated_at
5. Foreign keys — Siempre con ON DELETE/UPDATE explícito
6. Índices — En FKs, columnas de búsqueda, y columnas de ORDER BY

Drizzle ORM (MySQL)

// Patrón correcto para MySQL con Drizzle
import { mysqlTable, int, varchar, text, timestamp, boolean } from "drizzle-orm/mysql-core";

export const projects = mysqlTable("projects", {
  id: int("id").primaryKey().autoincrement(),
  title: varchar("title", { length: 255 }).notNull(),
  description: text("description"),
  isActive: boolean("is_active").default(true),
  createdAt: timestamp("created_at").defaultNow(),
  updatedAt: timestamp("updated_at").defaultNow().onUpdateNow(),
});

Reglas Críticas para MySQL + Drizzle

• NO uses .returning() — MySQL no lo soporta. Usa result.insertId
• Usa mysqlTable no pgTable
• varchar necesita length — Siempre especifica longitud máxima
• Nullable fields — Usa .nullable() en Drizzle y .nullable().optional() en Zod
• Dates — Cuidado con timezone: timestamp vs datetime

Optimización de Queries

-- Siempre usa EXPLAIN antes de optimizar
EXPLAIN ANALYZE SELECT * FROM projects WHERE status = 'active';

-- Índices compuestos: orden importa
CREATE INDEX idx_projects_status_date ON projects(status, created_at);

-- Evita SELECT * en producción
SELECT id, title, status FROM projects WHERE status = 'active' LIMIT 20;

Migraciones

1. Nunca edites migraciones ya ejecutadas en producción
2. Una migración = un cambio lógico — No mezcles cambios no relacionados
3. Siempre reversible — Incluye rollback cuando sea posible
4. Testa en dev primero — Nunca migres directamente en producción

Backup y Recovery

• Backup diario — mysqldump + compresión gzip
• Retención — Mínimo 7 días de backups
• Testa restauración — Verifica backups periódicamente
• Backup antes de migrar — Siempre antes de cambios de schema

Diagramas ER

Siempre visualiza el schema con diagramas Mermaid:

erDiagram
    projects ||--o{ images : "has"
    projects {
        int id PK
        varchar title
        text description
        timestamp created_at
    }
    images {
        int id PK
        int project_id FK
        varchar filename
        int sort_order
    }

Anti-patterns

• NO guardes archivos binarios en la BD — usa filesystem
• NO uses queries dinámicas con concatenación de strings (SQL injection)
• NO ignores índices en tablas con más de 1000 filas
• NO uses FLOAT para dinero — usa DECIMAL(10,2)
• NO hagas ALTER TABLE en tablas grandes sin planificación