Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Document the Prisma partial-index drift on Ticket_email_sourceId_key

Abierto Apto para principiantes
  • ¿Algo no está bien?
#179 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 3 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
74/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
sql
Área
databases, documentation

Línea de trabajo

Comienza en schema.prisma, en el modelo Ticket, e inspecciona el historial de migraciones existente en busca del SQL sin procesar que crea Ticket_email_sourceId_key. Añade un comentario que nombre el índice parcial, explique por qué solo se puede crear mediante SQL sin procesar y qué deja de funcionar si se elimina. Si hay tiempo, confirma que el índice Message(ticketId, responseKey) se puede expresar en Prisma y revisa la guía de contribución o de migraciones para encontrar la misma advertencia.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

area: infrastructure roadmap roadmap: later

Ticket_email_sourceId_key is a partial unique index, created in raw SQL on #170's branch:

CREATE UNIQUE INDEX "Ticket_email_sourceId_key"
ON "Ticket"("sourceId")
WHERE "source" = 'EMAIL' AND "sourceId" IS NOT NULL;

Prisma's schema language cannot express a WHERE clause on @@unique. So the index exists in the database and in the migration history, but has no representation in schema.prisma.

The failure mode

prisma migrate dev compares the schema against the database, sees an index it cannot account for, and reports drift. The suggested resolution is typically to drop it. Someone tidying up a drift warning, in good faith, removes the constraint that stops Postmark retries creating duplicate tickets — and nothing fails, because the guard it backs is a belt-and-braces read that usually catches the retry first.

Silent loss of a correctness guarantee, triggered by following the tool's advice.

What to do

Cheapest useful step is a comment in schema.prisma on the Ticket model, naming the index, saying it is intentionally raw-SQL-only, why Prisma cannot express it, and what breaks if it is dropped. A future reader hitting the drift warning then has the context at the point of decision.

Worth considering alongside:

  • Whether other raw-SQL objects have the same exposure. The Message(ticketId, responseKey) unique index on #170's branch is expressible in Prisma, so it is likely fine — worth confirming rather than assuming.
  • Whether a CI check should assert the index still exists, so its removal fails loudly instead of silently. A single pg_indexes query in a migration test would do it.
  • Documenting the same trap in whatever contributing/migrations guide exists, since the next partial index will hit it too.

Related: #169 proposes more partial unique indexes for the other inbound doors, which would multiply this.

Lenguaje dominante
TypeScript
Estrellas
8
Forks
4
Merge medio
3 d 19 h
PR fusionados (30 d)
10

Preparar el entorno

  • Incluye un Dockerfile o un archivo de Docker Compose
  • Sin plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de CopilotKit/outpost

Todos los issues de CopilotKit/outpost

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.