ogticrd / cuenta-unica-registry

Portal de Registro de Cuenta Única
https://registro.cuentaunica.gob.do
MIT License
34 stars 3 forks source link
arquitecturadigital authentication aws-liveness government nextjs ory

logo-cuenta-unica.svg

Portal de Registro de Cuenta Única

Linters Staging Deployment Prod Deployment License

Tabla de contenidos

Descripción y contexto

Esta es la plataforma de registro para la creación de una Cuenta Única ciudadana, la cual tiene como finalidad simplificar la obtención de Servicios Gubernamentales, permitiendo a los ciudadanos el acceso a los portales, trámites y servicios que las instituciones ofrezcan de forma digital, con una única cuenta. El proceso de registro consiste en identificarse con su número de cédula, realizar una prueba de vida y crear su cuenta seleccionando un correo y contraseña.

Guía de usuario

Guía de instalación

Existen 2 formas de instalar la aplicación en su máquina o servidor. La forma más fácil y recomendada es utilizando Docker:

git clone --depth 1 https://github.com/opticrd/cuenta-unica-registry.git
cd cuenta-unica-registry
docker build --target runner -t cuenta-unica .
docker run -d cuenta-unica

La segunda es utilizando pnpm:

git clone https://github.com/opticrd/cuenta-unica-registry.git
cd cuenta-unica-registry
pnpm install
pnpm start

Dependencias

[!WARNING] Actualmente este aplicativo depende de múltiple servicios externos para su funcionamiento, por lo que puede ser complejo replicar el proyecto en su totalidad en un ambiente local.

Confirma que tengas todas las variables de entorno configuradas como actualmente se establecen en el archivo de ejemplo .env.example.

Este proyecto depende de las siguientes recursos externos:

Tecnologías

Pasos para utilizar contenedores de desarrollo

Requisitos:

Configuración del contenedor de desarrollo:

Dentro de su espacio de trabajo de VS Code, existe una carpeta llamada .devcontainer. Dentro de esta carpeta, existe un archivo llamado devcontainer.json que se utiliza para definir la configuración del contenedor. Se deben de hacer los ajustes necesarios como Dockerfile, Docker Compose, puertos, montajes de volumen, variables de entorno, etc.

Ejecute el contenedor de desarrollo:

Configuración de depuración:

Dentro de su espacio de trabajo de VS Code, existe un archivo llamado launch.json ubicado en la carpeta .vscode. Este archivo contiene las configuraciones para depurar su aplicación específica.

Ejecute la aplicación en modo de depuración:

Detener el contenedor de desarrollo

Para detener un contenedor de desarrollo en Visual Studio Code, puede seguir estos pasos:

Alternativamente, puede ir a la esquina inferior derecha de la ventana de VS Code donde verá el ícono verde "><". Al hacer clic en él, se mostrará el Explorador remoto. Desde allí, puede hacer clic derecho en el contenedor asociado con su proyecto y seleccionar "Remote: Close Remote Conenction". Esta acción detendrá el contenedor asociado con su proyecto. Si desea iniciarlo de nuevo, puede utilizar el comando "Dev Containers: Open Folder in Container".

Tener en cuenta que detener el contenedor no lo eliminará; simplemente lo detiene. Si desea eliminar el contenedor por completo, puede hacerlo usando los comandos de Docker en la terminal o usando una herramienta GUI de Docker.

Autor/es

Información adicional

Próximamente podrás tener más información sobre el proyecto en https://cuentaunica.gob.do/

Agradecimientos