Changelog - RoundAway Express¶
All notable changes to the product are documented here.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased] - 2026-05-15¶
Added¶
- PRD completo (v0.1.0): Visión del producto, actores, roadmap
- MVP 1 - Básico: Registro, QR/Tracking, Dashboard, Notifications
- MVP 2 - Intermedio: Warehouse, Pricing, Ledger, Facturación
- MVP 3 - Avanzado: Netting, Yape/Plin, Reporting
- Modelo de Datos completo: Tenant, Companies, Users, Couriers, Shipments, Packages, Bags, BagAssignments, Flights, PackageEvents, Contacts, PricingRules
- Reglas de Negocio (RB-001 a RB-014):
- RB-001: Splitting y Consolidación de Paquetes
- RB-002: Multi-Tenancy Flexible
- RB-003: Empresas Inscritas por País
- RB-004: Sistema de Pagos (efectivo, al recoger/entregar)
- RB-005: Tracking Público (anónimo, rate limited, 3 días)
- RB-006: Recepción sin Pre-registro (in-situ por Warehouse Operator)
- RB-007: Consolidación y Notificaciones (automática, 24h espera)
- RB-008: Scheduling de Flights (ambos crean, permite cambios)
- RB-009: Courier No-show (reasignación manual, afecta rating)
- RB-010: Confirmación de Entrega (verbal + foto)
- RB-011: Paquetes No Recogidos (storage configurable, Admin decide)
- RB-012: KYC y Monitoreo (sin KYC, monitoreo activo)
- RB-013: Aduanas y Documentación (no en MVP, solo QR)
- RB-014: Setup de Nuevo Tenant (mínimo: Companies + Pricing + 1 WH + 1 User)
- PackageEvents unificados: 17 eventos con indicador MVP1/Post-MVP1
- Entidades nuevas: Bag, Courier, BagAssignments, Flights con atributos detallados
Changed¶
- PRD reescrito completamente con nueva estructura
- Modelo de datos expandido con Bags y Couriers como entidades separadas
- Events unificados en una sola lista (antes había 3 listas separadas)
Fixed¶
- RB-003: Identificadores fiscales (CIF/RUC/DNI-NIE)
- RB-011: Typo en "costo acumulado"
- Ordenamiento de Reglas de Negocio (RB-001 a RB-014 secuencial)
Security¶
- Tracking público con rate limiting para evitar DoS
- Sanitización de outputs en tracking anónimo
[1.0.0] - 2026-05-01¶
Added¶
- MVP complete with shipment management
- Public tracking page (
/track) - Dashboard for couriers
- Authentication with JWT (access + refresh tokens)
- Real-time WebSocket updates for shipments board
- Multi-tenancy with Row Level Security (RLS)
- Rate limiting by pricing tier
- Email notifications infrastructure
Security¶
- OWASP Top 10 compliance measures
- Token encryption in storage
- HTTPS enforcement in production
- Input validation and sanitization
- IP blocklist for abuse prevention
Architecture¶
- Clean Architecture with modular monolith
- Backend: FastAPI + SQLModel + PostgreSQL
- Frontend: Flet (web/desktop/mobile)
- Redis for real-time pub/sub
Guidelines for Updates¶
- Before implementing a feature: Check if PRD needs update
- After PRD change: Update this changelog with:
- Date of change
- Type of change (Added/Changed/Fixed/etc.)
- Brief description
- Impact on existing functionality
- Breaking changes: Must be documented prominently
- Security changes: Use
### Securitysection
Last updated: May 2026