Flujo

1. Ir a detalle de Pedido con estado Listo para entrega
2. Se debe mostrar un botón para pasar a estado Entregado
3. Al hacer click se llama a un endpoint que cambia Pedido a estado Entregado. 💡 (Utilizar la misma función que se utiliza para el otro estado)
4. Se debe devolver al usuario a la pantalla del Pedido mostrando
   • Estado: Entregado
   • Fecha de entrega real: Nuevo Campo 💡
   • Campo pagado => True

Similares a Productos e Insumos

Ejemplo Ajax Mixin

• https://docs.djangoproject.com/en/2.2/topics/class-based-views/generic-editing/#ajax-example

Pasos

1. Usuario elige que tipo de producto agregar (Regular o Irregular)

2. Se lo redirige a la página de creación de dicho producto con su formulario

• Cargar productos regulares
• Cargar productos irregulares
• La tabla productos muestra todos los productos
• Tests de pedidos
• Dividir views en 2 archivos diferentes: views_regular.py y views_irregular.py
• Crear templates para cada uno
• Crear formularios para productos Irregulares

TO DO

• Tests urls para un producto regular
• Tests urls para un producto irregular

Ideas

Abstract models

1. Modelo Producto (Abstract) con campos comúnes
2. Modelo por tipo de producto

• Bandeja, Cuadro
• Producto irregular

class ProductoBase(models.Model):
    class Meta:
        abstract = True

    nombre = models.CharField(
        max_length=100,
    )

    def __str__(self) -> str:
        return self.nombre


class Regular(ProductoBase):
    largo = models.DecimalField(default=0,
                                help_text='Largo en cm', max_digits=3, decimal_places=1)
    ancho = models.DecimalField(default=0,
                                help_text='Ancho en cm', max_digits=3, decimal_places=1)
    alto = models.DecimalField(default=0,
                               help_text='Alto en cm', max_digits=3, decimal_places=1)

class Irregular(ProductoBase):
    insumos_utilizados = models.ManyToManyField(Insumo,
                                     through="InsumosProducto",
                                     through_fields=('producto', 'insumo'))
    
    def precio(self):
          # Calcular precio de cada insumo y devolver el total
          self.insumos_utilizados.precio_m2()

A futuro se podría dejar que el usuario cree un tipo de producto, pero por ahora los crea el administrador.

Links

• https://docs.djangoproject.com/en/3.0/topics/db/models/
• https://realpython.com/modeling-polymorphism-django-python/
• https://djangobook.com/mdj2-advanced-models/

Campos

• ID
• Fecha
• Fecha validez (Opcional)
• Estado (Si pasó la fecha validez se pasa a Rechazado)
• Cliente
• Productos a vender
• Precio de cada producto (Se calcula al momento de guardar el presupuesto)
• Precio final
• Observaciones (Agregar validez del mismo, forma de pago, etc)

Extra

Ver si es factible crear un Pedido en base a un Presupuesto:

1. Dentro del Presupuesto
2. Click en Generar Pedido
3. Se deberían tomar los datos de
   • ID del Cliente
   • IDs de Productos, la cantidad y el precio de los mismos
4. Se dirige a un formulario de Pedido con los datos precargados

Utilizar el mixin para mostrar mensaje de borrado exitoso en todas las DeleteView

• Productos
• Clientes
• Compras
• Core
• Pedidos
• Proveedores

• Crear config docker
• Deployar a Heroku

Info

• https://hacksoft.blog/github-actions-in-action-setting-up-django-and-postgres/
• https://testdriven.io/blog/deploying-django-to-heroku-with-docker/#heroku-container-runtime

Fullcalendar puede servir.

Debería mostrar:

• Pedidos por entregar
• Vista diaria, semanal, mensual
• Filtrar pedidos por estado (Creado, En proceso, Entregado)
• Ver detalle de pedido (Tooltip)
• Link a DetailView

Nice to have:

• Agregar pedido con click en calendario mediante un modal.
• Modificar estado del pedido

• https://github.com/browniebroke/django-codemod

Lib: Django-model-utils https://django-model-utils.readthedocs.io/en/latest/models.html#softdeletablemodel

Hay que actualizar modelos en base a la última revisión del esquema de la BD.

Parte de este issue

• (#30) Precio a DecimalField
• (#29) precio_final de Pedido

El precio_final de un Pedido se guarda en un campo de la BD.
Este precio debería ser calculado en base al precio de los productos, como si fuese un atributo derivado.

Solución

• No pasar el campo precio_final en el formulario de creación de pedido
• En método save() se hace el cálculo del precio final con los precios de todos los productos.
• Al editar un producto el cálculo no se realiza nuevamente, ya que los productos pueden haber cambiado de precio.

Todo

• Modificar el formulario de PedidoForm para sacar ocultar el precio
• Agregar el cálculo del precio final en el modelo Pedido.
• Sobreescribir el campo precio_final del Pedido a guardar. (form_valid())

Tests

• Crear pedido con productos y calcular precio
• Actualizar pedido con productos y calcular precio

TODO

• Al cambiar estado de Pedido == Pagado, se debe crear la OT (update_or_create())
• https://www.notion.so/marcorichetta/Clases-de-Consulta-4-b2790a0d6596431ba1904e0a5828888e

Diagrama Estados de Pedido

Diagrama 2 (Viejo)

Campos

• ID
• Pedido
  • Fecha
  • Cliente
  • Productos a fabricar
• Estado (default= Creada | En proceso | Finalizada)
• Observaciones
• Incidentes de producción

Extra

• Tabla relacional con tipos de incidente (?)

Muchos recursos por acá https://testdriven.io/blog/production-django-deployments-on-heroku/

• https://github.com/henriquebastos/python-decouple/

Ver posibles formas de pago para elegir en el sistema.

La prioridad está en las Compras a Proveedores ya que pueden ser mediante tarjeta, cheques, etc
Luego se puede usar el conocimiento adquirido y replicarlo en el modelo de Pedidos de Clientes.

Recursos

• Diagrama de Vasco
• https://www.vertabelo.com/blog/technical-articles/a-data-model-for-a-wine-store
• http://www.databaseanswers.org/data_models/customers_and_orders/customers_and_orders_with_ref_data.htm

Crear Pedido

1. Se deben poder elegir productos junto con la cantidad
2. Se debe mostrar el precio del producto una vez que se elige
3. Al aplicar el descuento se calcula el precio final en el mismo formulario

Checklist

• Seleccionar producto y llamar a función para calcular el precio
• Mostrar el precio (Precio de producto * cantidad)
• Botón para calcular total
• Tomar el valor del descuento para calcular el precio final
• Animar (?)

Última alternativa
💡 Mostrar el precio dentro del mismo select del producto, junto con la descripción

https://github.com/incuna/django-wkhtmltopdf

• https://mattsegal.dev/postgres-backup-and-restore.html

El usuario accede a una ListView

Debe poder:

• Ver una tabla con registros y puede cargar más con paginación
• Ordenar por campos (Mayor, Menor, etc)
• Hacer una búsqueda por texto
• Botones para detail, update y delete en cada row de la tabla (https://joshuahunter.com/posts/using-bootstrap-buttons-with-django-tables2/)

Apps

• Clientes
• Proveedores
• Productos
• Pedidos
• Compras
• Insumos
• Localidades

Tablas y filtros

Tables2

• Docs
• Ejemplos

Filter

• https://django-filter.readthedocs.io/en/stable/

Ejemplo Combinados

Datatables

• https://github.com/pivotal-energy-solutions/django-datatable-view (Mas nueva)
• https://pypi.org/project/django-datatables-view/

• https://testdriven.io/blog/django-caching/

Cuando se renderiza un listado de productos el cálculo de las variables tarda bastante.

• https://github.com/jmcarp/nplusone
• https://testdriven.io/blog/django-performance-testing/
• http://schegel.net/posts/optimizing-django-orm-queries/
• https://hakibenita.com/all-you-need-to-know-about-prefetching-in-django
• Auto Prefetch

A través del modal con los detalles del pedido estaría bueno poder:

• Agregar pedido con click en un día
• Modificar estado de un pedido seleccionado

https://django-jazzmin.readthedocs.io/

Django extra views

• https://stackoverflow.com/a/60492388/6389248

#29 depende de este issue.

Algunos campos tienen Float o Integer.

• Cambiarlos a Float.
• Cambiar calculo de precios de Producto.
• Corregir formateo de precios en templates Ejemplos SO
• Testear formularios.

Recursos

• floatformat tag
• Puede ser útil para localización
• Usar coma en vez de punto en los forms

El usuario debe poder generar un pdf de:

• Pedido del cliente finalizado {% if estado finalizado 'mostrar link' %}
• Presupuesto (Misma lógica)

Librerías

• Weasyprint
• Wkhtml

Usar los archivos dataAlgo.py que tengo en la compu.

django-simple-history para modelos de compras y pedidos

• Crear core app con Autocomplete por modelo
• https://github.com/yourlabs/django-autocomplete-light

from dal import autocomplete

class PacienteAutocomplete(autocomplete.Select2QuerySetView):
    """
    Base de autompletado para pacientes.
    """

    def get_queryset(self):
        if not self.request.user.has_perm('pacientes.view_paciente'):
            return Paciente.objects.none()

        qs = Paciente.objects.all()

        if self.q:
            qs = qs.filter(Q(numero_documento__icontains=self.q) |
                           Q(nombres__icontains=self.q) |
                           Q(apellidos__icontains=self.q)
                           )

        return qs.order_by("apellidos", "nombres")[:5]

Ejemplo Localidad

Investigar la forma de autodocumentar el sistema mediante Sphinx u otra alternativa.

Herramientas para realizar Manual de Usuario

• Sphinx
• Integración con django

Ejemplo con sphinx

• https://django-music-publisher.readthedocs.io/en/latest/manual.html
• https://github.com/matijakolaric-com/django-music-publisher/tree/master/docs

• https://github.com/joke2k/django-environ

Usuario operario

• Este usuario puede ver un tablero con las órdenes de trabajo iniciadas y las finalizadas
• También puede cambiar el estado de la O.T.

Todo

• Crear usuario
• Asignarle permisos de vista de O.T.
• Quitarle permisos para ver demás views -> Hay que restringir las demás views (Yeah right)