Administración del piloto
Controles operativos, cuota, retención y trazabilidad por organización.
Configuración por organización
Administración puede configurar el servicio de consulta con estos valores:
- estado
pilot,activeosuspended; - cuota mensual por credencial;
- límite de solicitudes por minuto y credencial;
- plazo de retención del ledger;
- vigencia máxima de nuevas credenciales;
- tipos de consulta y finalidades habilitados;
- máximo de resultados devueltos por consulta;
- precio unitario informativo y moneda.
El precio unitario prepara la medición comercial, pero todavía no genera cargos ni facturas. El estado suspended bloquea nuevas consultas sin revocar ni borrar credenciales.
Organizaciones y usuarios
Cada cliente es una organización aislada de Supastarter. Resillia crea la organización y asigna un propietario inicial; el propietario o un administrador del cliente puede invitar más usuarios. El registro público permanece cerrado: una persona nueva solo puede crear su cuenta mediante una invitación vigente.
owner: administra miembros, credenciales y configuración general;admin: administra miembros y credenciales sin poder eliminar la organización;member: consulta el dashboard, el historial y el consumo, sin administrar credenciales.
Las reglas, consultas, API keys, consumo e historial siempre se resuelven con el identificador de organización. Ser administrador global de Resillia no convierte datos de una organización en datos compartidos con otra.
Credenciales
Las claves se muestran completas una sola vez, se almacenan mediante hash y vencen automáticamente. Una clave vencida o revocada obtiene la misma respuesta 401 que una clave desconocida, evitando revelar su estado.
Las integraciones deben enviar Idempotency-Key al crear una consulta. Reintentar la misma operación con la misma clave devuelve durante 24 horas la respuesta original sin volver a consumir cuota. Una clave reutilizada con otro cuerpo se rechaza con 409.
Auditoría y retención
Cada consulta conserva organización, credencial, fecha, propósito, identificador de solicitud, vista enmascarada, huella HMAC y unidades facturables. Nunca persiste el nombre o la cédula completos en el ledger.
La limpieza se ejecuta con:
POST /api/internal/person-search/retention
Authorization: Bearer $PERSON_SEARCH_CRON_SECRETEl endpoint elimina registros cuyo plazo configurado para la organización ya venció. Debe invocarse diariamente desde el programador del servidor y nunca exponerse con el secreto en una URL, log o repositorio.
Reportes de consumo
El dashboard muestra el total mensual y el desglose por credencial o por consultas hechas desde el panel. Descargar reporte CSV exporta el ledger enmascarado del mes en curso con identificador de solicitud, fecha, tipo, finalidad, estado, fuente, resultados, unidades facturables y credencial.
La exportación no incluye el nombre ni la cédula completos. Admite períodos de hasta 366 días y aplica un límite de seguridad de 10.000 filas. Los valores se escapan para impedir que una planilla interprete contenido como fórmulas.
Antes de activar datos reales
El paso de pilot a active no conecta por sí mismo el corpus. Antes deben aprobarse el adaptador de datos, las fuentes permitidas, los criterios de coincidencia, la política jurídica, el período de retención y el procedimiento de atención de reclamos.