> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/sdks/backend-sdk/backend1n/changelog.md).

# Changelog

### \[5.0.0] \[2026/09/28]

### Añadido

* Entidad `collections`, con endpoints de creación (`POST /collections`), listado con filtro por prefijo (`GET /collections?prefix=`) y borrado en cascada (`DELETE /collections/{collectionId}`).
* Migración automática al arrancar: si `collections` está vacía, se rellena a partir de los `collectionId` ya presentes en `patterns`, para no romper despliegues existentes.
* Validación de integridad referencial: `collectionId` debe existir al subir imágenes, crear/actualizar/listar/buscar especímenes; un `mediaId` solo puede respaldar un espécimen (`faceId`) a la vez; el `mediaId` de un espécimen debe pertenecer a su misma colección. Al eliminar un espécimen se elimina también su imagen.
* Documentación de `GET /metrics` y `GET /metrics/prometheus` (métricas operativas en JSON y formato Prometheus) y de los parámetros de configuración `metrics_*`.
* Documentación de las respuestas `401` (autenticación JWT) y `413` (cuerpo demasiado grande), y de las reglas de autenticación.

### Cambiado

* **Cambio de contrato**: `tenantId` renombrado a `collectionId` en toda la API pública (solicitudes y respuestas), con el tipo cambiado de UUID a cadena de texto restringida a letras ASCII, dígitos, `_` y `-`. Los nombres de campo en base de datos (`tenantId`/`tenant_id`) no se ven afectados.
* `GET /faces`: el parámetro `collectionId` (antes `tenantId`) sigue siendo **obligatorio** y debe corresponder a una colección existente; sin él la API responde `400`.
* `PUT /faces/{Id}`: `mediaId` y `collectionId` deben indicarse juntos o ninguno de los dos - no se permite cambiar de colección sin especificar también el `mediaId` de destino.

### \[4.5.0] \[2026/07/22]

### Añadido

* Autenticación JWT opcional, configurable desde `config.json` o mediante variables de entorno `FACEPHI_BACKEND1N_REST_*`.
* Soporte para bases de datos `PostgreSQL`.
* Cobertura de pruebas de integración para endpoints públicos y protegidos cuando la autenticación JWT está habilitada.
* Cobertura de pruebas de integración para los backends MongoDB y PostgreSQL.

### \[4.4.0] \[2026/05/13]

### Cambiado

* Actualización del backend a `selphid/6.20.0`.

### Corregido

* Revisión de bad request en los valores enum de entrada.

### \[4.3.0] \[2026/04/30]

### Cambiado

* Actualización del backend a `selphid/6.19.0`.

### \[4.2.0] \[2026/03/31]

### Añadido

* Precedencia de configuración mediante variables de entorno (`FACEPHI_BACKEND1N_REST_*`).

### Cambiado

* Actualización del motor biométrico.

### Corregido

* Las entradas Base64 y JSON malformadas ahora devuelven HTTP 400 en lugar de HTTP 500.
* Imagen base de Docker actualizada a Ubuntu 26.04 para mejorar la seguridad.

### \[4.1.0] \[2026/01/07]

### Cambiado

* Actualización del backend a `selphid/6.17.0`.
  * Tokens con `futureTimeAllowed`.
  * Galerías 1:N con soporte de timestamp (listar/eliminar plantillas obsoletas).

### \[4.0.0] \[2025/11/25]

### Añadido

* Documentación pública completa y swagger.

### Cambiado

* Uso de SelphID `flavor::facial` como sustituto del motor biométrico.
* Imagen de Docker simplificada, libre de vulnerabilidades.

### \[3.1.0] \[2024/10/29]

### Añadido

* Helm chart.

### Actualizado

* Uso de `facephi-types/0.2.0`.
* Actualización a recognition `facephi-recognition/3.20.2`.

### \[3.0.0] \[2024/08/22]

### Añadido

* Implementación de extractor de 1ª parte.
* Implementación de matcher 1:N de 1ª parte.
* Soporte para TemplateRawSuper.
* Distribuciones duales (3ª/1ª parte) con compatibilidad de base de datos.

### Mejorado

* Compatibilidad retroactiva de la base de datos con Antifraude Backend `2.0.0`.
* La base de datos se actualiza al nuevo formato `3.0.0` al llamar al endpoint `/search`.
  * El formato antiguo `pattern.templateRaw` se acepta y se actualiza a TemplateRawSuper.
  * Se elimina `pattern.faceTemplate`.

### Cambiado

* `facialTemplate` ya no se devuelve desde los endpoints `/faces/*`.
* El body de `/extract/template` requiere el parámetro `facialTemplateRaw`, en lugar de `faceTemplate`.
* El body de `/search/template/{tenantId}` requiere el parámetro `facialTemplateRaw`, en lugar de `facialTemplate`.

### \[2.2.0] \[2024/05/16]

### Añadido

* Nuevo endpoint:
  * POST: `/search/template/{ID}`.

### Corregido

* Crash al buscar con templates inválidos.

### \[2.1.0] \[2024/05/10]

### Añadido

* Almacenamiento de TemplateRaw en MongoDB.
* Nuevos endpoints:
  * GET: `/faces`.
  * GET: `/faces/{UUID}`.

### \[2.0.0] \[2024/05/06]

### Añadido

* Soporte para MongoDB.
* Endpoints para almacenar datos en la base de datos.

### Cambiado

* Primeros endpoints basados en SelphID-1:N pasan a ser los endpoints finales:
  * POST: `/extract`.
  * POST: `/extract/template`.
  * POST: `/assets/upload`.
  * GET: `/assets/media/{UUID}`.
  * POST: `/faces`.
  * PUT: `/faces/{UUID}`.
  * DELETE: `/faces/{UUID}`.
  * POST: `/search/image/{GALLERY_ID}`.

### \[1.0.0] \[2024/03/13]

* Primera versión estable.
* Clonación de endpoints desde SelphID-SDK 1:N.
* Implementación 1:N de 3ª parte.
