Análisis del sistema

[rpgrca]

En una reunión relámpago hoy empezamos con la parte de back-end del sprint 1. No estoy escribiendo la documentación sino tomando notas y haciendo tormenta de ideas con los presentes para refinar los alcances del sistema.

Análisis
- Descripción del sistema

  El sistema permitirá al (usuario martillero) crear (subastas) donde podrá poner en (venta) (lotes) consignados por (usuarios consignatarios) que hayan sido aceptados y dados de alta por el usuario martillero. En las subastas los (usuarios pujadores) podrán pujar por dichos lotes, siendo el (dueño) de la última (puja) el ganador del lote.

  El programa no permitirá a los usuarios consignatarios crear sus lotes directamente ya que el usuario martillero debe verificar las condiciones y tasarlos antes de ponerlos en subasta.

  Tampoco permitirá a los consignatarios o pujadores comunicarse entre ellos, se podrán únicamente comunicar con el martillero a través del formulario de contacto.

  El martillero decide el precio base al cual se venderá.

  No soportará precio de reserva por debajo del cual el lote no se vende.     

- Se elige MVC
- Qué hay dentro de M(odel)

  - Usuario ---+-----> Martillero (administrador de sistemas)
               |
               +-----> Consignatario
               |
               +-----> Pujador

  - Subasta
  - Lote
  - Puja
  - Venta

- Qué hay dentro de V(iew)
  - Landing page ---+---> Login (www.bidon.com.ar/login) (1)
                    |
                    +---> Registración (2)
                    |
                    +---> Recuperación de clave (3)
                    |
                    +---> Catálogo (4)
                    |
                    +---> Contacto (5)

  - Landing page ---+---> Perfil -------> Grabar cambios (6)
                    |
                    +---> Lotes propios (7)
                    |
                    +---> Catálogo (4)
                    |
                    +---> Contacto (6)

- Qué hay dentro de C(ontroller)
  - API / EP

  1. /api/login (usuario, password) -> ok (guid, uuid)
  2. /api/registrar (usuario, email, password) -> ok, error (ya existe usuario, ya existe mail)
  3. /api/recuperar (email) -> ok
  4. /api/catalogo -> ok
  5. /api/contacto (nombre, email, asunto, texto) -> ok
  6. /api/actualizar_perfil (usuario, email, password) -> ok, error (ya existe usuario, ya existe mail)
  7. /api/lotes (usuario) -> ok

[rpgrca]

La nueva versión que hice a la noche.

Análisis
- Descripción del sistema

  El sistema permitirá al (usuario martillero) dar de alta (usuarios consignatarios), quienes consignarán (artículos) propios al martillero para la (venta). El sistema también permitirá al usuario martillero crear (subastas) para poner en venta dichos artículos como (lotes). En dichas subastas los (usuarios pujadores) podrán pujar por dichos lotes, siendo el dueño de la última (puja) el (ganador) del lote.

  El programa no permitirá a los usuarios consignatarios crear sus artículos directamente ya que el usuario martillero debe verificar las condiciones y tasarlos antes de ponerlos en subasta.

  Tampoco permitirá a los consignatarios o pujadores comunicarse entre ellos, se podrán únicamente comunicar con el martillero a través del formulario de contacto.

  El martillero decide el precio base al cual se venderá.

  No soportará precio de reserva por debajo del cual el lote no se vende.

  No permitirá baja de usuarios.

- Se elige MVC

- Qué hay dentro de M(odel)

  - Usuario ---+-----> Martillero (administrador de sistemas)
               |
               +-----> Consignatario
               |
               +-----> Pujador

  - Subasta
  - Lote
  - Puja
  - Venta

- Qué hay dentro de V(iew)
  - Landing page ---+---> Login (www.bidon.com.ar/login) (1)
                    |
                    +---> Registración (2)
                    |
                    +---> Recuperación de clave (3)
                    |
                    +---> Catálogo (4)
                    |
                    +---> Contacto (5)

  - Landing page ---+---> Perfil -------> Grabar cambios (6)
                    |
                    +---> Lotes propios (7)
                    |
                    +---> Catálogo (4)
                    |
                    +---> Contacto (6)

  - Landing page ---+---> Subasta de pujador (9)
                    |
                    +---> Compras (8)
                    |
                    +---> Perfil -------> Grabar cambios (6)
                    |
                    +---> Catálogo (4)
                    |
                    +---> Contacto (6)

  - Landing page ---+---> Perfil -------> Grabar cambios (6)
                    |
                    +---> Subasta de martillero (10)
                    |
                    +---> ABM pujadores ---+---> Alta de usuario (2)
                    |                      |
                    |                      +---> Modificación de usuario -------> Grabar cambios (6)
                    |
                    +---> AMB consignatarios ---+---> Alta de consignatario (11)
                    |                           |
                    |                           +---> Modificación de consignatario -------> Grabar cambios (6)
                    |
                    +---> ABM lotes ---+---> Alta de lote (12)
                    |                  |
                    |                  +---> Baja de lote (13)
                    |                  |
                    |                  +---> Modificación de lote (14)
                    |
                    +---> Publicidad (15)
                    |
                    +---> Catálogo (4)
                    |
                    +---> Contacto (5)


- Qué hay dentro de C(ontroller)
  - API / EP
  1. ingresar al sistema: /api/login (usuario, password) -> ok (guid, uuid)
  2. registrarse al sistema: /api/registrar (usuario, email, password) -> ok, error (ya existe usuario, ya existe mail)
  3. recuperación de credenciales: /api/recuperar (email) -> ok
  4. listado de catálogo: /api/catalogo -> ok
  5. contactar sitio: /api/contacto (nombre, email, asunto, texto) -> ok
  6. actualización de datos: /api/actualizar_perfil (usuario, email, password) -> ok, error (ya existe usuario, ya existe mail)
  7. listado de lotes y ventas por consignatario: /api/lotes (usuario) -> ok
  8. listado de compras por usuario: /api/compras (usuario) -> ok
  9. pujar: /api/pujas, /api/lote, /api/pujar
  10. subastar: /api/pujas, /api/lote, /api/acreditar
  11. ingresar consignatario al sistema: /api/registrar_consignatario
  12. ingresar lote al sistema: /api/crear_lote (título, descripción, usuario, base) -> ok
  13. quitar lote del sistema: /api/borrar_lote -> ok, error (no existe)
  14. modificar información del lote: /api/modificar_lote (título, descripción, usuario, base) -> ok
  15. modificación de publicidad para landing page: /api/publicar (título, imagen, descripción, fecha) -> ok


- Como se interrelacionan los módulos Usuario (Martillero, Consignatario, Pujador), Subasta, Lote, Puja, Venta entre sí
  1. Qué es una puja?
     Una puja es el pujador haciendo una oferta por un lote

     +---------+1      * +------+ *      1+------+
     | Pujador |-------> | Puja | <-------| Lote |
     +---------+         +------+         +------+

  2. Qué es un lote?
     Un lote es un artículo de un consignatario puesto a la venta en la subasta

     +----------+1      * +------+ *      1+---------+
     | Artículo |-------> | Lote | <-------| Subasta |
     +----------+         +------+         +---------+

  3. Qué es un artículo?
     Un artículo es mercadería del consignatario a vender

     +---------------+1      * +----------+
     | Consignatario |-------> | Artículo |
     +---------------+         +----------+

  4. Qué es una subasta?
     Una subasta es la venta de un conjunto de lotes a través de pujas por parte de pujadores.

     +------+*      1+---------+
     | Lote |------->| Subasta |
     +------+        +---------+

  5. Qué es una venta?
     Una venta es una puja ganadora de un lote.

     +------+1    0-1 +-------+
     | Puja |-------> | Venta |
     +------+         +-------+

[rpgrca]

Interrelaciones entre los distintos componentes del sistema