aspnet-template/DOCUMENTATION.md

# Documentacion

ASP.NET core controllers API 9.0

https://dotnet.microsoft.com/en-us/apps/aspnet

## Tipos de APIs en aspnet

- Minimal - Parecido a express
- Controllers - Parecido a Nestjs, estructurado, completo

- [aspnet core 9 api](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/apis?view=aspnetcore-9.0)
- [aspnet controllers](https://learn.microsoft.com/en-us/aspnet/core/web-api/?view=aspnetcore-9.0)
- [tutorial para crear proyecto nuevo](https://learn.microsoft.com/en-us/aspnet/core/tutorials/first-web-api?view=aspnetcore-9.0)

## Creación del proyecto

> Reemplazar `MyApp` con el nombre del proyecto, por ejemplo `Trazo`.

Con Docker, ejecutar el comando:

```sh
docker run --rm -v $(pwd):/app mcr.microsoft.com/dotnet/sdk:9.0 sh -c "cd /app && dotnet new webapi --use-controllers -o MyApp && chown -R $(id -u):$(id -g) MyApp"
```

para crear un proyecto nuevo, vacio, sin tener que instalar ningun programa.

## Ejecutar el proyecto

- Compilar imagen de docker:
`docker build -t aspnet-dev   --build-arg USER_ID=$(id -u) --build-arg GROUP_ID=$(id -g) .`

- Ejecutar imagen de desarrollo:
`docker run -it --rm -v $(pwd):/app -p 5233:5233 aspnet-dev`

Una vez la imagen de desarrollo se este ejecutando entrarás a un shell.
Dentro de ese shell ejecuta: `dotnet watch run` para iniciar la aplicacion.
Puedes cancelar con Ctrl-C, reiniciar, ejecutar otros comandos de EF, etc.