Características

• ✅ Registro, inicio y cierre de sesión con el sistema de autenticación de Django
• ✅ CRUD completo de tareas (crear, listar, editar, eliminar)
• ✅ Cada usuario sólo ve y gestiona sus propias tareas
• ✅ Categorización de tareas
• ✅ Interfaz responsiva con Bootstrap 5
• ✅ Panel de administración de Django
• 📋 API REST (planificado — ver roadmap)

Requisitos Previos

Antes de comenzar, asegúrate de tener instalado:

• Python: v3.10 o superior
• pip: gestor de paquetes de Python
• PostgreSQL: v13 o superior

Instalación

1. Clonar el repositorio

git clone https://github.com/brayandiazc/gestortareas-django.git
cd gestortareas-django

2. Crear y activar un entorno virtual

python3 -m venv gestor_tareas_env
source gestor_tareas_env/bin/activate   # En Windows: gestor_tareas_env\Scripts\activate

3. Instalar dependencias

pip install -r requirements.txt

4. Configurar variables de entorno

cp .env.example .env
# Edita .env con tus credenciales de base de datos y una SECRET_KEY nueva

5. Crear la base de datos y aplicar migraciones

python manage.py migrate
python manage.py createsuperuser   # opcional, para el panel de administración

Configuración

Las variables de entorno se documentan en .env.example. Cópialo a .env y completa los valores para tu entorno.

Nunca subas tu archivo .env con valores reales al repositorio. Ver SECURITY.md y docs/conventions/secrets.md.

Uso

Desarrollo local

python manage.py runserver
# La aplicación quedará disponible en http://127.0.0.1:8000

Rutas principales:

Arquitectura

Aplicación Django monolítica con renderizado del lado del servidor. Se organiza en dos apps de dominio (usuarios y tareas) sobre el proyecto gestor_tareas. Detalle completo en docs/architecture/architecture.md.

Stack Tecnológico

• Backend: Python 3.10+, Django 5.1
• Base de datos: PostgreSQL (vía psycopg2)
• Frontend: Plantillas de Django + Bootstrap 5
• Configuración: variables de entorno con python-dotenv

Inventario completo (con versiones y justificación) en docs/architecture/stack.md.

Comandos Disponibles

python manage.py runserver        # Iniciar el servidor de desarrollo
python manage.py migrate          # Aplicar migraciones
python manage.py makemigrations   # Generar nuevas migraciones
python manage.py createsuperuser  # Crear un superusuario
python manage.py test             # Ejecutar los tests

Testing

python manage.py test

Convenciones de testing en docs/conventions/testing.md.

Contribución

Lee la Guía de Contribución para conocer el flujo de trabajo (Git Flow), los estándares de código, el formato de commits (Conventional Commits) y el proceso de Pull Requests.

Roadmap

Visión y próximos pasos en docs/product/roadmap.md.

Documentación

Toda la documentación vive en docs/:

Soporte

¿Problemas o sugerencias? Abre un issue en el repositorio o escribe a brayandiazc@gmail.com.

Versionado

Usamos Git para el control de versiones y seguimos Semantic Versioning. Consulta las etiquetas para ver las versiones disponibles y el CHANGELOG.

Autores

• Brayan Diaz C — Trabajo inicial — @brayandiazc

Licencia

Este proyecto está bajo la licencia MIT.

⌨️ con ❤️ por @brayandiazc