💊 Catálogo Farmacia
Aplicación Django (CRUD) para gestionar el catálogo de productos de una farmacia: stock, precio y fechas de vencimiento.
▶ Ver demo
¿Qué problema resuelve?
Reemplaza la planilla del inventario: muestra el valor total del stock, alerta de los productos por vencer (30 días) o vencidos y no permite registrar productos con la fecha de vencimiento ya pasada.
Stack
Python 3.12 · Django 5.2 · SQLite (local) / PostgreSQL vía DATABASE_URL · WhiteNoise · Vercel
Estructura del proyecto
CatalogoFarmacia/
├── core/ # Configuración del proyecto Django
│ ├── settings.py
│ ├── urls.py
│ ├── wsgi.py # Punto de entrada en Vercel
│ └── asgi.py
├── farmacia/ # App del catálogo
│ ├── migrations/
│ ├── static/farmacia/ # CSS y JS de la interfaz
│ ├── templates/farmacia/
│ │ ├── catalogo_list.html
│ │ ├── catalogo_form.html
│ │ └── catalogo_confirm_delete.html
│ ├── admin.py
│ ├── apps.py
│ ├── forms.py
│ ├── models.py
│ ├── tests.py
│ ├── urls.py
│ └── views.py
├── templates/
│ └── base.html # Plantilla base compartida
├── manage.py
├── requirements.txt
├── vercel.json
└── .python-version
Cómo correrlo localmente
python -m venv venv
venv\Scripts\activate # Windows (Linux/Mac: source venv/bin/activate)
pip install -r requirements.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver
python manage.py test # ejecutar pruebas
En local DEBUG es True por defecto y se usa una clave de desarrollo. Con DEBUG=False la app exige SECRET_KEY (ver .env.example).
Lint: pip install ruff==0.17.0 && ruff check . && ruff format --check .
Seguridad
SECRET_KEY obligatoria fuera de desarrollo; cookies Secure, HSTS y Referrer-Policy en producción.- CSRF de Django en todos los formularios; ORM sin SQL crudo.
- CI con ruff, tests y
manage.py check --deploy; CodeQL, Dependabot y gitleaks (pre-commit).
Para reportar vulnerabilidades, mira SECURITY.md.
Qué aprendí
- El patrón MVT de Django y las vistas genéricas basadas en clases para un CRUD completo.
- A validar reglas de negocio en el formulario (por ejemplo, no aceptar fechas vencidas) y a probarlas.
- A desplegar Django en un entorno serverless (Vercel) y lo que implica su sistema de archivos efímero.
- Que un valor por defecto para
SECRET_KEY termina usándose en producción si nadie lo configura.
Licencia
MIT © 2026 Fernanda (Fernandamv96)
