# Changelog — Propuesta funcional Pessi

Versiones del documento de arquitectura/flujo compartido con el cliente.
Cada versión vive en su propia carpeta `vN/` para poder comparar y volver atrás sin pisar nada.

## v1 — 2026-08-30
- Primer borrador: arquitectura general (app web + Android + dashboard gerencial sobre plataforma en la nube).
- Flujo de propiedad en alquiler (6 pasos) con alertas de vencimiento.
- Checklist de módulos funcionales (captación, comercialización, inventario, ventas/alquileres, comisiones, marketing digital, agenda, dashboard).
- Pendiente de definir: integración API MercadoLibre (automática vs. manual asistida), alcance de la app Android para gerencia, esquema de cálculo de comisiones.

## v2 — 2026-08-30
- Analizado `Flujograma.xlsx` provisto por el cliente (guardado en `fuentes/Flujograma-cliente.xlsx`) y comparado contra la v1.
- Agrega la línea de negocio "Administración de propiedades" (cobro por cuenta de terceros), ausente en v1: operaciones mensuales, liquidación por propietario, autogestión.
- Agrega CRM de clientes como módulo separado del maestro de propiedades (leads interesados en alquilar o comprar).
- Agrega ficha de propiedad con campos concretos (dirección, m², dormitorios, baños, etc.) e ingreso en dos pasos (preliminar → completa).
- Agrega máquina de estados explícita por operación: 6 pasos para alquiler/venta, 5 para administración (con retorno de "Renovado" a "Activo").
- Ajusta el modelo de comisiones: comisión (monto o %) para alquiler/venta vs. tarifa de cobro para administración.
- Nueva sección "Preguntas abiertas" incorporando los signos de interrogación que el propio cliente dejó en el archivo (publicación vía API a portales, "Costos?").
- Diagrama de arquitectura general (sección 1) y flujo de alquiler (sección 4) se mantienen de la v1, con ajustes menores de etiquetas.

### v2 — extensiones (misma fecha)
- Analizada la propuesta comercial del proveedor (3 meses, USD 7.000–8.000, Supabase + Cloudflare): se detectó una contradicción de stack (GCP vs. Supabase/Cloudflare en distintas secciones del mismo documento) y recortes de alcance no explicitados frente al brief original — sin app Android, sin publicación multi-portal/redes, sin marketing digital, sin autogestión de propietarios, sin alertas activas de vencimiento.
- `landing/pessi-landing.html`: landing comercial de la v2 con estética de "ficha con sello de estado" (carpeta/dossier), pensada para mostrarle la propuesta al cliente.
- `prototipo/pessi-app-mockup.html`: prototipo navegable de la app (dashboard, propiedades, negocio por línea en kanban de estados, CRM, agenda, finanzas) con datos de ejemplo fijos — sin base de datos ni validaciones, solo para mostrar cómo se vería la interfaz.

## v2 — 2026-09-02 · ajuste de modelo: Persona con roles
- Corrige un supuesto del flujograma original: "Cliente" y "Propietario" dejan de ser maestros separados y pasan a ser **roles sobre una misma Persona/Empresa**. La misma persona puede ser propietaria de una propiedad y, a la vez, estar buscando alquilar otra — se carga una sola vez y se le agregan roles, sin duplicar la ficha ni perder el historial.
- Actualizados: diagrama de arquitectura (sección 1), diagrama de las tres líneas de negocio (sección 2) y el módulo "CRM de clientes" (ahora "Personas y roles") en el checklist funcional.
- `prototipo/pessi-app-mockup.html`: la vista "Clientes (CRM)" pasa a llamarse "Personas", con una columna de Roles y un caso de ejemplo (Ana Beatriz Silva: propietaria en administración + interesada en alquilar) que muestra el escenario de roles múltiples.

## v2 — 2026-09-02 · nueva sección "A resolver antes de desarrollar"
- Agrega la sección 7 al documento de arquitectura con cinco puntos importantes a definir con el proveedor antes de que arranque el desarrollo:
  1. **Seguridad de acceso** — MFA (tipo Google Authenticator) y expiración de sesión. Recomendación propia: MFA obligatorio para gerencia/administración, opcional para agentes; sesión de hasta 24h combinada con cierre por inactividad (más corto en pantallas financieras).
  2. **Publicación en MercadoLibre** — API automática vs. carga manual asistida, y si el plan de MercadoLibre del cliente admite integración por API.
  3. **Guardado de contratos en la nube** — URLs firmadas con expiración, alcance de visibilidad por rol, retención post-cierre.
  4. **Calendario por usuario** — anotaciones libres diarias además de vencimientos automáticos; el administrador/gerencia ve los calendarios de todos los agentes; a definir si las anotaciones personales son privadas.
  5. **Menú y permisos por línea de negocio** — el sidebar del prototipo hoy muestra todo a cualquier usuario; en la versión real cada usuario debería ver solo su(s) línea(s) asignada(s) (Alquiler / Administración / Venta / General), permitiendo asignaciones combinadas (ej. Venta + Alquiler). Queda pendiente de resolver el modelo de permisos.

## v2 — 2026-09-02 · flujo detallado de alquiler y ajustes de ficha
- Nueva sección 5, "Flujo detallado de alquiler, paso a paso": abre el flujo de 6 pasos de la sección 4 en 9 pasos concretos, marcando explícitamente dónde se toca el maestro de Personas (alta o reutilización del propietario en captación) y dónde cambia el rol de alguien (Interesado → Inquilino al reservar). Secciones siguientes renumeradas: Módulos funcionales (6), Preguntas abiertas (7), A resolver antes de desarrollar (8).
- Ficha de propiedad: se agregan los campos "Dormitorios en suite (sí/no + cantidad)" y "Otros" (campo libre para características no contempladas en la lista fija).

## v2 — 2026-09-02 · decisión: ficha de propiedad única para las tres líneas
- El cliente compartió la lista de campos de la ficha de Venta del Excel original, más corta que la de Alquiler (sin orientación, aptos por piso, cantidad de pisos, parrillero, mascota, antigüedad, garantía ni nombre de administración). Al consultarlo, aclaró expresamente que para él los atributos de la propiedad son los mismos sin importar la línea de negocio.
- Se agrega un callout de "Decisión" en la sección de Módulos funcionales dejando esto documentado como definición explícita del cliente, no como supuesto del equipo: una única Ficha de propiedad, sin variantes por línea de negocio.

## v2 — 2026-09-02 · requisito: auditoría de cambios de estado
- Se agrega a "A resolver antes de desarrollar" un requisito explícito del cliente: todo cambio de estado de una operación (y de los montos del Acuerdo — comisión, tarifa) tiene que quedar auditado (quién, cuándo, desde/hacia qué valor), con el registro de solo lectura incluso para quien hizo el cambio.

## v2 — 2026-09-02 · mapa del sistema completo
- `diagramas/pessi-sistema-completo.html`: diagrama de referencia con las piezas grandes del sistema — usuarios y permisos por rol (agente de alquiler/venta ve solo su línea, gerencia ve todo con MFA), Portal de Cliente como acceso externo separado (lectura acotada a su propia operación), el núcleo (Propiedades, Personas, Workflow de tareas, Agenda), el Dashboard gerencial, y Logs y auditoría (separando auditoría de negocio de log de sistema).
- Deja explícitos dos mecanismos nuevos del pedido del cliente: (1) una propiedad puede tener varias operaciones simultáneas — alquiler y venta a la vez, no una u otra; (2) el workflow de tareas incluye traspaso entre áreas (de un agente a administración o gerencia), y ese traspaso queda auditado igual que un cambio de estado.
- Incorporado a `pessi-arquitectura.html`: callout de decisión "una propiedad puede tener varias operaciones a la vez" (Propiedad 1 → N Operaciones) tras la sección 2; atributos de Cliente (documento, teléfono, presupuesto, zona de interés, garantías/referencias) en el módulo "Personas y roles"; y la distinción explícita auditoría de negocio (estados, montos, traspasos de tareas) vs. log de sistema (accesos, ediciones, permisos) en la sección 8.

## v2 — 2026-09-02 · versión para presentar al cliente
- `pessi-mapa-del-sistema.html`: copia completa de `pessi-arquitectura.html` pensada para compartir directo con el cliente — mismo contenido, pero sin ninguna mención a "v1" ni al lenguaje de comparación interno ("qué cambia respecto a la v1"). El callout de comparación se reescribió como "Puntos clave del modelo", sin la columna "se mantiene" (que por definición compara contra una versión anterior).

## v3 — 2026-09-02
- `v3/pessi-mantenimientos-objetos.html`: primer documento de la v3. Inventario de piezas del sistema en dos capas — **9 mantenimientos** (catálogos/configuración: usuarios y roles, tipos de propiedad, amenities, barrios/zonas, portales de publicación, conceptos de administración, tarifas y comisiones por defecto, monedas, empresas) y **12 objetos** (entidades operativas: Propiedad, Persona, Operación, Acuerdo, Contrato/Documento, Tarea, Evento de agenda, Liquidación, Comisión/Factura, Alerta, Registro de auditoría, Log de sistema).
- Se agrega a ese mismo documento la sección "Infraestructura: base de datos, hosting y medios" — decisión de stack (Supabase para base de datos/auth/RLS/MFA, Cloudflare para el hosting web; Android es desarrollo aparte), tabla de dónde se guarda cada tipo de archivo (fotos → Cloudflare Images, videos → Cloudflare Stream, documentos/contratos → storage privado con URL firmada), y los pendientes de confirmar con quien implemente (tier de backups/PITR, región del dato, servicio de notificaciones).