Este proyecto es una API simple para la gestión de una agencia de autos, utilizando Django, un framework de desarrollo web en Python. La aplicación cuenta con la capacidad de:

• Creación de vehículos
• Creación de tipos de vehículos
• Creación de marcas de vehículos
• Búsqueda por filtrado de (año, marca, tipo, precio)
• Creación y gestión de features dinámicas para blog
• Documentación de la API con Redoc
• Capacidad de crear Backups remotos y locales
• Traducciones con gettext_lazy para futuras integraciones internacionales

• Python (3.11.2) # Versión específica de Python requerida
• Django (django>=4.1.7) # Versión específica de Django requerida
• Docker (Opcional)

1. Clona este repositorio en tu máquina local.

2. Abre una terminal y navega hasta el directorio raíz del proyecto.

3. Crea un entorno virtual para el proyecto (opcional, pero se recomienda).

   python -m venv venv   # Comando para crear un entorno virtual
   

4. Activa el entorno virtual.

   • En Windows:

     venv\Scripts\activate   # Comando para activar el entorno virtual en Windows
     

   • En macOS y Linux:

     source venv/bin/activate   # Comando para activar el entorno virtual en macOS y Linux
     

5. Instala las dependencias del proyecto.

   pip install -r requirements/local.txt   # Comando para instalar las dependencias del proyecto desde un archivo requirements.txt
   

1. En la versión local, las variables de entorno no están ocultas por lo que no es necesario configurar nada.

1. En la terminal, navega hasta el directorio raíz del proyecto si aún no lo has hecho.

2. Ejecute el siguiente comando para iniciar el servidor de desarrollo:

   Comando para iniciar el servidor de desarrollo de Django

   python manage.py runserver 8080   # Comando para iniciar el servidor de desarrollo de Django en el puerto 8080
   

3. Ejecute el siguiente comando para iniciar las migraciones correspondientes:

       python manage.py migrate
   

4. Abra un navegador web y navegue a http://127.0.0.1:8080/ para ver la aplicación en funcionamiento.

5. Si desea acceder al panel de administración de Django, este se encontrará en la sección http://127.0.0.1:8080/ego-motors-admin/

6. para acceder necesitará permisios de superusuario, si desea crear uno podra ejecutar el comando:

    python manage.py createsuperuser

7. En la seccion http://127.0.0.1:8080/redoc/ podra ver los endpoints de la API de forma grafica.

• El proyecto también se puede desplegar localmente usando Docker con el siguiente comando:

  docker compose -f local.yml up --build -d --remove-orphans   # Comando para levantar el proyecto usando Docker
  

  Esto es escencialmente util si no se quiere instalar ni configurar muchas dependencias, a su vez mejora la capacidad de adaptacion a futuros miembros para contribuir en el mismo

  IMPORTANTE modificar a partir de la linea 87 a la 94 de la siguiente manera:

# DATABASES = {
#     "default": {
#         "ENGINE": "django.db.backends.sqlite3",
#         "NAME": ROOT_DIR / "db.sqlite3",
#     }
# }

DATABASES = {"default": env.db("DATABASE_URL")}

Esto es escencial para que nuestro servicio de Django pueda conectarse a la base de datos de del servicio PostgreSQL.

• En el archivo Makefile encontrará una variedad de comandos útiles para la mejora del código, creación de backups, entre otras tareas.