Skip to content
Volver a proyectos

dgii-helper

En desarrollo

API que valida identificadores fiscales dominicanos y entrega números de comprobante sin duplicados

Rol: Desarrollador en solitario

En solitario · Desde nov 2026 · Repo público

.NET 10ASP.NET CoreEF CoreSQL ServerAngular 21xUnitTestcontainersDocker
113, against a real SQL Server
Tests de la API
52
Tests del front

Una API en ASP.NET Core para las dos cosas que necesita cualquier sistema de facturación dominicano: comprobar que un RNC, una cédula, un NCF o un e-CF tienen forma válida, y entregar números de NCF sin que ninguno se repita aunque lleguen muchas facturas a la vez. Incluye un front en Angular para validar identificadores y para registrar rangos y entregar sus números.

Problema

Entregar el siguiente número de factura leyendo un contador y escribiéndolo de nuevo da el mismo número a dos peticiones que llegan juntas. Un NCF repetido es un problema con la DGII, no solo un bug.

Solución

Cada rango autorizado entrega su siguiente número con un solo UPDATE ... OUTPUT: SQL Server bloquea la fila, suma uno y devuelve el valor anterior en la misma sentencia. Registrar un rango corre en una transacción serializable que rechaza solapes y reintenta cuando SQL Server aborta una por deadlock.

Todavía no

No está desplegado en ningún lado. No consulta el padrón de la DGII, no valida el XML de un e-CF ni firma y envía documentos; solo comprueba que los identificadores tengan forma válida.

Puntos clave de arquitectura

  • 40 peticiones simultáneas sobre un rango de 40 números reciben 40 números distintos y seguidos. En un rango más chico las que sobran reciben 409 y nadie recibe un número repetido
  • El dígito verificador del RNC es una suma ponderada módulo 11, probada con vectores calculados a mano. La cédula usa Luhn y se compara contra una implementación independiente de Luhn en 20 000 números
  • Los tests corren contra un SQL Server real con Testcontainers. Rompí la implementación a propósito (emitir leyendo y luego escribiendo, un aislamiento más bajo, pesos equivocados) y la suite detectó cada una
  • Los endpoints que escriben piden una clave de API comparada en tiempo constante, y la app no arranca en producción sin ella. Hay un límite de peticiones por IP
  • El front en Angular usa señales y componentes standalone, con 52 tests. Lo corrí en un navegador contra la API real: registré un rango de 3 números, entregué los 3, vi el botón pasar a agotado y vi que una clave incorrecta muestra el aviso de 401
  • Un bug que encontré en el camino: EF envuelve el error de deadlock dos niveles adentro, así que mi primer reintento nunca corría. Ahora recorre toda la cadena de excepciones