109 lines
4.0 KiB
Markdown
109 lines
4.0 KiB
Markdown
# Don Confiao Backend - Contexto del Proyecto
|
|
|
|
## Tipo de Proyecto
|
|
Backend Django con Django REST Framework
|
|
|
|
## Estructura del Proyecto
|
|
```
|
|
don_confiao_backend/
|
|
├── requirements.txt # Dependencias Python
|
|
├── docker-compose.yml # Configuración Docker
|
|
├── django.Dockerfile # Dockerfile Django
|
|
├── .env # Variables de entorno
|
|
├── .env_example # Ejemplo de variables de entorno
|
|
├── README.rst # Documentación básica
|
|
├── Rakefile # Tareas rake
|
|
├── doc/ # Documentación adicional
|
|
│ └── requests.org
|
|
└── tienda_ilusion/ # Proyecto Django
|
|
├── manage.py
|
|
├── db.sqlite3 # Base de datos SQLite
|
|
├── don_confiao/ # App principal
|
|
│ ├── models.py # Modelos: Customer, Product, Sale, SaleLine, Payment, ReconciliationJar, AdminCode
|
|
│ ├── views.py
|
|
│ ├── api_views.py
|
|
│ ├── serializers.py
|
|
│ ├── forms.py
|
|
│ ├── admin.py
|
|
│ ├── urls.py
|
|
│ ├── export_csv.py
|
|
│ ├── tests/ # Tests
|
|
│ └── migrations/
|
|
├── users/ # App de usuarios
|
|
│ ├── models.py
|
|
│ ├── views.py
|
|
│ ├── serializers.py
|
|
│ ├── urls.py
|
|
│ └── tests/
|
|
└── tienda_ilusion/ # Configuración Django
|
|
├── settings.py
|
|
├── urls.py
|
|
├── wsgi.py
|
|
└── asgi.py
|
|
```
|
|
|
|
## Dependencias Principales
|
|
- Django==5.0.6
|
|
- djangorestframework
|
|
- django-cors-headers
|
|
- djangorestframework-simplejwt
|
|
- sabatron-tryton-rpc-client==7.4.0 (integración con Tryton ERP)
|
|
|
|
## Modelos Principales (don_confiao/models.py)
|
|
- **Customer**: Clientes (name, address, email, phone, external_id)
|
|
- **Product**: Productos (name, price, measuring_unit, categories)
|
|
- **ProductCategory**: Categorías de productos
|
|
- **Sale**: Ventas (customer, date, phone, description, payment_method, reconciliation)
|
|
- **SaleLine**: Líneas de venta (sale, product, quantity, unit_price, description)
|
|
- **Payment**: Pagos (date_time, type_payment, amount, reconciliation_jar)
|
|
- **PaymentSale**: Relación muchos a muchos entre Payment y Sale
|
|
- **ReconciliationJar**: Arqueo de caja (is_valid, date_time, reconcilier, cash_taken, cash_discrepancy)
|
|
- **AdminCode**: Códigos de administrador
|
|
|
|
## Autenticación
|
|
- JWT con djangorestframework-simplejwt
|
|
- ACCESS_TOKEN_LIFETIME: 30 minutos
|
|
- REFRESH_TOKEN_LIFETIME: 1 día
|
|
|
|
## API Endpoints
|
|
- REST API en don_confiao/api_views.py y users/
|
|
- URLs en don_confiao/urls.py y users/urls.py
|
|
|
|
## Ejecución con Docker Compose
|
|
|
|
El proyecto se ejecuta con docker-compose. Todos los comandos `manage.py` deben ejecutarse dentro del contenedor:
|
|
|
|
```bash
|
|
# Ejecutar tests
|
|
docker-compose run --rm django python manage.py test
|
|
|
|
# Migraciones
|
|
docker-compose run --rm django python manage.py makemigrations
|
|
docker-compose run --rm django python manage.py migrate
|
|
|
|
# Servidor desarrollo
|
|
docker-compose up
|
|
|
|
# Shell Django
|
|
docker-compose run --rm django python manage.py shell
|
|
|
|
# Crear superuser
|
|
docker-compose run --rm django python manage.py createsuperuser
|
|
```
|
|
|
|
Nota: El volumen monta `tienda_ilusion/` en `/app/`, por lo que el path correcto es `python manage.py` (no `python tienda_ilusion/manage.py`).
|
|
|
|
## Tests
|
|
- Framework: Django unittest
|
|
- Directorio: don_confiao/tests/
|
|
- Ejecutar: `docker-compose run --rm django python manage.py test`
|
|
|
|
## Comandos Útiles (dentro del contenedor)
|
|
- Migraciones: `docker-compose run --rm django python manage.py makemigrations && docker-compose run --rm django python manage.py migrate`
|
|
- Servidor desarrollo: `docker-compose up`
|
|
- Shell Django: `docker-compose run --rm django python manage.py shell`
|
|
- Superuser: `docker-compose run --rm django python manage.py createsuperuser`
|
|
|
|
## Integraciones
|
|
- **Tryton ERP**: Integración mediante sabatron-tryton-rpc-client para sincronización de clientes, productos y ventas
|