TODO

CHANGELOG

• Instrucciones paso a paso para clonar y configurar el proyecto localmente.

• Lista de herramientas y versiones necesarias (como .NET, SQL Server, etc.).

• Detalles sobre archivos de configuración importantes, como appsettings.json o variables de entorno necesarias.

• Explicación de la arquitectura del proyecto (carpetas principales y su propósito).

Este proyecto fue creado bajo el tipo de "Clean Architecture", que se centra en la separación de responsabilidades y la independencia entre capas. Esta arquitectura consiste en dividir el código en varias capas bien definidas, donde cada una tiene una responsabilidad específica y está desacoplada de las demás. Las principales características de Clean Architecture son:

Capas organizadas en círculos concéntricos:

Entidad/Core: Representa las reglas de negocio y los modelos más fundamentales del dominio. Esta capa es la más interna y no depende de otras capas. Caso de uso/Aplicación: Contiene la lógica de aplicación específica, como los casos de uso y los servicios que coordinan las interacciones entre las entidades y otras capas. Infraestructura: Gestiona la interacción con el mundo externo, como las bases de datos, servicios externos, o la interacción con frameworks específicos (como Entity Framework en el caso de .NET). Esta capa contiene implementaciones detalladas de interfaces definidas en el núcleo de la aplicación. UI/Web API: Capa más externa, encargada de manejar las interacciones con el usuario o cliente, como las solicitudes HTTP en el caso de una API. Independencia: Las capas internas no dependen de las externas, lo que significa que las reglas de negocio no conocen nada sobre bases de datos, interfaces de usuario o frameworks específicos.

Interfaces desacopladas: Los detalles de implementación, como los repositorios de datos, están separados a través de interfaces que permiten intercambiar tecnologías (por ejemplo, cambiar la base de datos de SQL Server a MySQL) sin modificar la lógica de negocio.

Inversión de dependencias: Utiliza principios de inversión de control (IoC) para lograr que las dependencias fluyan hacia adentro, de las capas externas hacia las internas. Esto facilita pruebas unitarias y permite aislar el código en diferentes capas.

Esta estructura asegura que el código sea mantenible, escalable, y fácilmente testeable, además de permitir cambios en las tecnologías subyacentes sin afectar las reglas de negocio.

Tecnologia	Nombre
	NET 8.0.401 - August 15, 2024
	NUGET
	Microsoft Visual Studio Professional 2022 (64-bit) - Current Version 17.11.2

• Documentación de los principales endpoints de la API (métodos, rutas, y ejemplos de respuestas).

• Descripción de la base de datos utilizada, tablas principales y su relación.

• Instrucciones sobre cómo ejecutar las pruebas y verificar que todo funcione correctamente.

• Guía para realizar el despliegue en entornos de producción.

• Guía para contribuir al proyecto, incluyendo buenas prácticas y reglas de estilo de código.

𝗗𝗶𝗱 𝘆𝗼𝘂 𝗸𝗻𝗼𝘄 𝘁𝗵𝗮𝘁 𝘆𝗼𝘂 𝗰𝗮𝗻 𝗴𝗲𝗻𝗲𝗿𝗮𝘁𝗲 𝗽𝗿𝗼𝗳𝗲𝘀𝘀𝗶𝗼𝗻𝗮𝗹-𝗹𝗼𝗼𝗸𝗶𝗻𝗴 𝗱𝗼𝗰𝘂𝗺𝗲𝗻𝘁𝗮𝘁𝗶𝗼𝗻 𝗱𝗶𝗿𝗲𝗰𝘁𝗹𝘆 𝗳𝗿𝗼𝗺 𝘆𝗼𝘂𝗿 𝗖# 𝗰𝗼𝗱𝗲? 😃

/// <summary>
/// Describe el propósito del método o la clase.
/// Asi se pone un enlace en la documentacion: <a href="http://stackoverflow.com">here</a>
/// </summary>
/// <remarks>se utiliza para proporcionar información adicional, por ejemplo, si hay algún problema conocido que desee que otros desarrolladores conozcan.</remarks>
/// <param name="paramname">Describe un parámetro de método.</param>
/// <returns>Describe el valor devuelto de un método.</returns>
/// <exception cref="InvalidProgramException">Describe una excepción que se puede producir.</exception>

• Información sobre la licencia bajo la cual se distribuye el proyecto.

Enlaces

Enlaces

Ejecuta el siguiente comando en la terminal para construir la imagen desde el Dockerfile y nombrarla como medicalofficeapi:

docker build -t medicalofficeapi .

Ahora que tienes la imagen construida, ejecuta el contenedor con el siguiente comando:

docker run --name MedicalOfficeApi -d -p 8080:8080 -p 8081:8081 medicalofficeapi

Para verificar que el contenedor está corriendo y tiene el nombre correcto, usa:

docker ps

Ejecuta el siguiente comando en la terminal para construir la imagen desde el Dockerfile y nombrarla como medicalofficeapi:

docker build -t custom-seq .

Ahora que tienes la imagen construida, ejecuta el contenedor con el siguiente comando:

docker run --name seq -d --restart unless-stopped -p 5341:80 custom-seq

Para verificar que el contenedor está corriendo y tiene el nombre correcto, usa:

docker ps

docker-compose down
docker-compose up --build

docker exec -it MedicalOfficeApi curl http://seq:5341

Eliminar la red existente: Si ya existe una red medicalnetwork externa, debes eliminarla antes de volver a ejecutar el docker-compose para que la nueva red interna se cree correctamente.

docker network rm medicalnetwork

Ejecutar el Docker Compose: Después de modificar tu archivo docker-compose.yml, vuelve a ejecutar:

docker-compose up -d

Verificar la configuración: Para verificar que los contenedores están utilizando las IPs correctas, puedes usar el siguiente comando:

docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <container_name>

Es posible que haya un conflicto con una red previamente definida. Puedes eliminar la red medicalnetwork si existe, para asegurar que Docker la recree con la configuración correcta.

docker network rm medicalnetwork

Ahora, vuelve a ejecutar el docker-compose para que los contenedores se levanten con la nueva configuración.

docker-compose up -d
o
docker-compose up

Una vez que los contenedores estén en ejecución, puedes verificar que estén usando las IPs correctas.

docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' seq
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' sql1
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' MedicalOfficeApi

docker-compose down

Si deseas eliminar también los volúmenes asociados (por ejemplo, para eliminar datos persistentes de la base de datos), puedes añadir la opción --volumes:

docker-compose down --volumes

Esto eliminará los contenedores, las redes definidas (si no son externas), y los volúmenes creados.

Si deseas eliminar las imágenes no usadas que ya no están asociadas a ningún contenedor, puedes ejecutar:

docker image prune

Después de ejecutar docker-compose down, puedes verificar que todo se ha detenido y eliminado con los siguientes comandos:

docker ps -a

docker network ls

Ver las imágenes disponibles:

docker images

Con estos pasos, habrás detenido y eliminado todo lo relacionado con tu entorno de Docker, y habrás configurado las IPs estáticas para tus contenedores en el archivo docker-compose.yml.

docker-compose up -d

docker network inspect medicalnetwork

docker exec -it MedicalOfficeApi sh
ping 192.168.1.102  # IP del contenedor sql1

Con esta configuración, tendrás una red privada con IPs estáticas para tus contenedores, asegurando comunicación directa y predecible entre ellos.