🚛
Parqueaderos · Libreto de pruebas
XCLOUD para FRIMAC · 27-abr-2026
Abrir demo → 🖨️ Imprimir / PDF
🚛

Libreto de pruebas

Demo Parqueaderos MVP · Plataforma de control de acceso de tractocamiones · XCLOUD para FRIMAC S.A.

Libreto de pruebas — Demo Parqueaderos MVP

Para: Armando (TI Director) · Darío · equipo FRIMAC

De: Alejandro Forero — XCLOUD

Fecha: 2026-04-27

Demo URL: https://parqueaderos.xclos.com

Versión: 0.1.0 · MVP demo

Confidencial bajo NDA


0. Antes de empezar — qué es y qué NO es

Qué es esto

Es una plataforma multi-parqueadero funcional al 100% desplegada en Cloudflare edge. Cubre los 12 criterios de aceptación que ustedes listaron en su documento técnico v1.0 del 27-abr-2026, capítulo 21. Construido en respuesta directa a ese documento, sin pedirles información adicional, asumiendo lo que ustedes ya plantearon como decisiones (3 parqueaderos demo en Floridablanca/Bogotá/Cartagena, 4 tipos de vehículo, RBAC con 6 roles, etc.).

Qué NO es

Todo lo anterior es deliberadamente fuera de alcance del MVP — son los entregables cobrables de fase 2.

Cuánto tiempo les va a tomar probarlo


1. Cómo entrar

URL única (mismo enlace en computador o celular)

https://parqueaderos.xclos.com

Desde computador

Cualquier navegador moderno (Chrome, Edge, Firefox, Safari). Da el recorrido completo del panel admin.

Desde celular Android o iPhone

  1. Abre Chrome (Android) o Safari (iPhone).
  2. Pega la URL https://parqueaderos.xclos.com en la barra de dirección.
  3. Verás la pantalla con los 7 botones de roles. Tap en el rol que quieras probar (recomendado: 🧰 Guarda Floridablanca para probar la PWA, 👑 Superadmin para el admin).
  4. La aplicación se adapta automáticamente al tamaño del celular: el menú lateral se oculta y aparece un botón ☰ (hamburger) arriba a la izquierda — tap para abrirlo.

Instalar como app en el celular (opcional, recomendado para guardas)

Una vez dentro, sobre todo en 📱 Captura móvil:

Esto convierte la web en una PWA instalable — funciona como una app nativa sin pasar por App Store / Play Store. Si la quieren desinstalar después: tap largo al icono → Eliminar, igual que cualquier app.

Lo que necesita el celular

Acceso de un click

Al abrir el login encontrarán 7 botones grandes con cada rol demo. Un click → entran automáticamente con esas credenciales precargadas. No necesitan escribir nada.

BotónRolPara qué probarlo
👑 Superadminadmin@xclos.comVista global — recorrido inicial Armando
🏢 Admin operativoarmando@frimac.demoDirección sin gestión de usuarios
👮 Supervisorsupervisor.flor@frimac.demoSolo Floridablanca — RBAC scoped real
🧰 Guarda Floridablancaguarda1.flor@frimac.demoPWA captura — para Darío o equipo operativo
🧰 Guarda Bogotáguarda2.bog@frimac.demoPWA captura desde Bogotá
👁️ Auditorauditor.demo@gov.coSolo lectura · perfil regulador
🤝 Cliente externocontacto@clientedemo.comSolo sus movimientos (rol futuro)

Si prefieren login manual, password: Demo2026!*

Recomendación de orden de pruebas:

1. Armando entra como superadmin y hace recorrido completo de admin.

2. Después se sale y entra como supervisor para ver cómo cambia el RBAC.

3. Después se sale y entra como guarda1.flor y abre la PWA en celular.


2. Recorrido para ARMANDO (TI Director) — 20 min

Objetivo: validar que la plataforma cumple los criterios técnicos, de seguridad y de compliance que pidió FRIMAC.

2.1. Login y dashboard general

  1. Abre https://parqueaderos.xclos.com en navegador de escritorio.
  2. Click en "Ingresar al demo".
  3. Login con admin@xclos.com / Demo2026!*.
  4. Llegas al Dashboard.

Qué deberías ver y validar:

Mapea a doc FRIMAC: cap. 17 (panel administrativo), cap. 21 criterio 11 (acciones críticas en auditoría visible).

2.2. Vista de Parqueaderos — cap. 6 del doc

  1. Click en sidebar izquierdo: 📍 Parqueaderos.
  2. Verás 3 cards:

- PQ-FLOR-01 — FRIMAC Floridablanca, coordenadas reales 7.0648, -73.0937, radio 200m

- PQ-BOG-01 — FRIMAC Bogotá Calle 13, radio 180m

- PQ-CTG-01 — FRIMAC Cartagena Mamonal, radio 250m

Qué validar:

2.3. Movimientos — cap. 8 y 9 del doc

  1. Sidebar: 🚦 Movimientos.
  2. Verás ~43 movimientos sembrados (mezcla de entradas/salidas de últimos 30 días + algunos activos hoy).

Pruebas a hacer:

Validar columnas:

Mapea a doc FRIMAC: cap. 8 flujo entrada, cap. 9 flujo salida, cap. 11 clasificación 4 tipos vehículo, cap. 17 reportes consolidados.

2.4. Vehículos — cap. 11 del doc

  1. Sidebar: 🚛 Vehículos.
  2. Filtros por tipo arriba: Todos / PROPIO / FIDELIZADO / CLIENTE / VISITANTE.

Qué deberías ver:

Pruebas a hacer:

2.5. Conductores — Ley 1581 en acción

  1. Sidebar: 🧑‍✈️ Conductores.
  2. Verás 20 conductores con datos reales sintéticos.

Validación crítica de compliance:

Mapea a doc FRIMAC: cap. 18 seguridad y privacidad, cap. 4 (no funcional, control de acceso a cédulas).

2.6. Talanqueras — el "MOCK MODE" honesto

  1. Sidebar: 🚧 Talanqueras.
  2. Banner naranja arriba: "⚠️ MOCK MODE" — totalmente transparente.

Qué validar:

Importante: este patrón está listo para reemplazar el mock por integración real. ADR-005 documenta el contrato TalanqueraGateway y los protocolos soportados (HTTP REST, MQTT, Modbus, SOAP). Cuando hagamos fase 2, cambiar TALANQUERA_MOCK=false en variables de entorno y conectar el gateway local en cada sitio.

Mapea a doc FRIMAC: cap. 12 apertura talanqueras (patrón completo), cap. 20 requisitos integrador físico (lo que necesitaríamos de FRIMAC para fase 2).

2.7. Novedades — cap. 9 del doc

  1. Sidebar: ⚠️ Novedades.
  2. Verás 4 novedades sembradas, ordenadas por severidad y estado.

Casos demo incluidos:

Prueba interactiva:

Mapea a doc FRIMAC: cap. 13 reglas 5 y 10 (registro de novedades antes de salida, supervisor autoriza excepciones).

2.8. Reportes consolidados — cap. 17 del doc

  1. Sidebar: 📈 Reportes.

Qué verás:

Pruebas a hacer:

2.9. Auditoría append-only — cap. 18 del doc

  1. Sidebar: 🔍 Auditoría.

Aquí está el diferencial técnico clave. La tabla auditoria en D1 tiene triggers SQL que rechazan UPDATE y DELETE. Es matemáticamente imposible alterar registros desde la aplicación o con SQL directo.

Qué validar:

Para que confíen en esto, prueben: si abren consola de devtools y intentan modificar/borrar un registro de auditoría desde la UI, no pueden — no hay endpoint de modificación. Y a nivel DB el trigger lo rechaza.

Retención: 7 años (alineado SuperTransporte sectorial).

2.10. Compliance Ley 1581 — cap. 18 del doc

  1. Sidebar: 🛡️ Compliance.

Verás 7 KPIs: Consentimientos activos · revocados · ARCO pendientes · ARCO resueltas · Audit entries · Conductores con consent · Fotos por purgar (retención 90d).

Sección "Mecanismos activos" lista los 9 controles built-in:

Sección "Marco regulatorio": lista las leyes y normas aplicables.

Probar el flujo de privacidad pública:

  1. Abre nueva pestaña incógnito (sin login).
  2. Ve a https://parqueaderos.xclos.com/privacidad.
  3. Lees la política versionada.
  4. Click en "Solicitar derecho ARCO" → formulario público para que cualquier conductor ejerza sus derechos sin necesidad de cuenta.
  5. (Opcional) llena con datos demo y envía → queda registrado en arco_solicitudes y en auditoría.

Mapea a doc FRIMAC: cap. 4 privacidad, cap. 18 seguridad y cumplimiento.

2.11. Usuarios y RBAC — cap. 5 del doc

  1. Sidebar: 👥 Usuarios.
  2. Verás los 7 usuarios demo con su rol y los parqueaderos que tienen asignados.

Qué notar:

Mapea a doc FRIMAC: cap. 5 actores y roles, cap. 13 regla 1 (usuario solo opera parqueaderos asignados).


3. Recorrido para DARÍO (operación) — 25 min

Objetivo: validar el flujo de captura desde el celular del guarda y la asistencia con AURA chat.

3.1. Probar la PWA móvil — el flujo de cap. 8

Mejor experiencia: abrir desde un celular real.

Alternativa: Chrome desktop → F12 → ícono de celular → emular iPhone/Android.

  1. Abre https://parqueaderos.xclos.com en el celular.
  2. Login con guarda1.flor@frimac.demo / Demo2026!*.
  3. Eres redirigido al admin, click en "📱 Captura móvil" del menú.

Qué deberías ver:

Esto es correcto y deseado: el sistema te bloquea porque está validando geofencing real. Cumple cap. 7 y cap. 13 regla 2 del doc FRIMAC.

3.2. Simular que estás dentro del parqueadero (Chrome devtools)

Para probar el flujo completo sin viajar a Floridablanca:

  1. Chrome → F12 → Tres puntitos arriba a la derecha → More tools → Sensors.
  2. Geolocation → Custom location:

- Latitude: 7.0648

- Longitude: -73.0937

  1. Refresca la PWA. Ahora dirá:

> ✅ FRIMAC Floridablanca - Sede Principal

> 0m del centro · 50m precisión

3.3. Registrar una entrada — cap. 8 del doc, criterios 1-9 y 11 cap. 21

  1. Click en "⬇️ ENTRADA".
  2. Foto placa: click en el input de archivo, en celular abre cámara, en desktop pides una foto de prueba.

- Tras subir la imagen, el sistema llama a Workers AI Llama 3.2 Vision.

- Verás "🤖 Analizando placa con IA..."

- Después: "🤖 OCR detectó: ABC123 (87% confianza) · confirma o corrige"

- El campo placa se prellena automáticamente.

  1. Confirma o corrige la placa manualmente (cumple cap. 10 — "Ningún dato capturado por OCR debe guardarse sin confirmación visual del operador").
  2. Llena cédula: prueba con 1098765432 (ya existe en seed) o cualquiera nueva.
  3. Opcional: contenedor MSCU1234567, sello S-1001-A, observaciones.
  4. Click en "⬇️ Registrar entrada y abrir talanquera".

Qué pasa internamente (lo verás en pantalla):

  1. Frontend valida geofencing local → OK.
  2. Backend re-valida geofencing → OK.
  3. RBAC: verifica que el guarda esté asignado a ese parqueadero → OK.
  4. Lookup de vehículo: si la placa existe, lo encuentra; si no, crea como VISITANTE.
  5. Lookup de conductor: si la cédula existe, lo asocia; si no, crea con datos placeholder.
  6. Validación: ¿hay entrada activa duplicada? Si sí, error 409.
  7. Inserta movimiento en D1.
  8. Llama al gateway mock de talanquera → simula 800-1500ms latencia → 95% éxito.
  9. Registra apertura en aperturas_talanquera + 2 entradas en auditoría.
  10. Responde con movimiento_id + apertura.resultado.

UI muestra:

✅ Movimiento #44 registrado

🚧 Talanquera abrió correctamente (mock)

Latencia: 1247ms

A los 2.5 segundos vuelve a la pantalla principal, con el movimiento ya en "últimos movimientos".

3.4. Registrar la salida correspondiente — cap. 9 del doc

  1. Click en "⬆️ SALIDA".
  2. Toma foto o ingresa la misma placa que usaste en entrada.
  3. Click en "🔍 Buscar entrada activa".

Qué deberías ver:

Entrada activa encontrada

📍 FRIMAC Floridablanca - Sede Principal

👨‍✈️ (Conductor)

📦 MSCU1234567

🕐 hace 2 min

  1. Confirmación: "Carga coincide con la entrada" o "Hay diferencia — registrar novedad".
  2. Si seleccionas diferencia + observaciones, se registra una novedad operativa automáticamente (cap. 13 regla 10).
  3. Click en "⬆️ Registrar salida y abrir talanquera".

Resultado esperado:

Mapea a doc FRIMAC: cap. 9 flujo salida completo, cap. 13 reglas 3 y 10.

3.5. Validar caso adverso: entrada duplicada

  1. Sin haber hecho la salida, intenta crear OTRA entrada con la misma placa.
  2. Resultado esperado: error entrada_duplicada con mensaje en pantalla.

Cumple cap. 13 regla 4: "No se permite duplicar entrada activa para la misma placa en el mismo parqueadero".

3.6. Validar caso adverso: fuera de radio

  1. En Chrome devtools → cambia ubicación a 4.0, -75.0 (cualquier punto lejano).
  2. Refresca PWA → dirá "Fuera de cualquier parqueadero autorizado".
  3. Si fuerzas el envío bypass UI (con curl o devtools), el backend rechaza con 403 y registra GEOFENCE_FAILURE en auditoría.

Cumple cap. 13 regla 2 + cap. 21 criterio 2.

3.7. AURA chat — diferencial conversacional

  1. En cualquier momento, ve a 💬 AURA (esquina superior derecha o sidebar).
  2. Llega al chat.

Pruebas sugeridas (botones rápidos abajo o escribe libremente):

PreguntaTool que usaQué responde
"¿Cuántas entradas hubo hoy?"query_movimientos_todayLista de movimientos del día con conteo
"¿Hay novedades pendientes?"query_novedades_pendientesLas novedades sin resolver ordenadas por severidad
"¿Qué vehículos están adentro ahora?"query_open_movementsLista de entradas activas por parqueadero
"Movimientos del FRM101"query_vehicle_historyHistórico del vehículo específico
"Resumen últimos 7 días"query_kpisKPIs consolidados
"Auditoría reciente"query_audit_log_recent30 últimos eventos de auditoría

Validar en cada respuesta:

Modelo usado: Llama 3.3 70B en Workers AI con tool calling. Costo despreciable (~$0.01/100 queries).


4. Validación cruzada con el documento FRIMAC v1.0

Tabla de mapeo directo de cada capítulo del documento de ustedes contra lo entregado:

Cap. doc FRIMACLo que pideImplementado en
2 Objetivos9 objetivos enumeradosTodos cumplidos · ver tabla abajo
3 Alcance funcional10 módulosTodos en MVP excepto módulo offline distribuido (cap. 19 — diferido fase 2)
4 No funcional7 categoríasHTTPS ✓ · Auth ✓ · Permisos ✓ · Trazabilidad ✓ · Privacidad ✓ · Mantenibilidad ✓
5 Actores y roles6 roles6 roles implementados con RBAC scoped real
6 Modelo multi-parq5 entidadesLas 5 + 11 más (16 tablas total)
7 GeofencingDetección automáticaCliente + servidor + audit
8 Flujo entrada12 pasosImplementados 12/12 · uno solo asíncrono (foto upload puede ser background)
9 Flujo salida11 pasosImplementados 11/11
10 Captura placas/cédulaOCR placas + PDF417Llama 3.2 Vision para placa + lib JS PDF417 cliente + corrección manual obligatoria
11 Clasificación vehículos4 tiposPROPIO · FIDELIZADO · CLIENTE · VISITANTE
12 Apertura talanquerasPatrón backend → gatewayPatrón completo · gateway mock con etiqueta MOCK MODE
13 Reglas de negocio10 reglas10/10 enforced en backend
14 Modelo de datos16 tablas referenciales16 tablas + 4 adicionales para sessions, rate-limit, consent, ARCO
15 API mínima11 endpoints sugeridos13 endpoints implementados
16 Payload entradaJSON ejemploIdéntico estructura
17 Panel web8 funciones12 secciones implementadas
18 Seguridad y compliance10 controles10/10 + hash chain (extra) + DLP scrubber (extra)
19 Modo offline4 escenariosSolo escenario 2 (cliente con queue) — escenarios 1 y 3 diferidos fase 2 (ADR-006)
20 Integrador físico7 elementosDocumento de requisitos preparado para fase 2 — ADR-005
21 Criterios aceptación12 criterios12/12 ✅
22 Entregables proveedor10 entregables8/10 listos · faltan: app nativa iOS/Android (es PWA), gateway físico (mock)
23 Fases implementación5 fasesFase 1 (levantamiento) + Fase 2 (MVP) ya hechas en este demo
24 Puntos pendientes10 preguntasAsunciones documentadas — discutimos en kickoff fase 2
25 ConclusiónEstructura propuestaImplementada tal cual la describen

Detalle objetivos cap. 2 (los 9):

  1. ✅ Registrar entradas y salidas de tractocamiones en tiempo real
  2. ✅ Identificar automáticamente parqueadero por georreferenciación
  3. ✅ Capturar placa con cámara móvil + OCR (ANPR fija deferido fase 2)
  4. ✅ Escanear cédula del conductor
  5. ✅ Registrar contenedores, sellos, fotos, novedades
  6. ✅ Autorizar apertura con trazabilidad y permisos (mock con audit)
  7. ✅ Operar con vehículos propios, fidelizados, clientes, visitantes
  8. ✅ Centralizar BD consultable por reportes y auditoría
  9. ✅ Evitar aperturas no autorizadas o fuera del parqueadero asignado

5. Lista de chequeo para Armando

Marquen lo que validaron:

Funcional

Móvil/PWA

Seguridad y compliance

Performance


6. Cómo reportar lo que prueben

Si encuentran bugs o tienen feedback, hay tres formas:

  1. Email a Alejandro: con captura + descripción + URL exacta donde pasó.
  2. WhatsApp: descripción rápida + screenshot.
  3. Anotar en sesión: agendamos una sesión de feedback de 30 minutos donde recorremos juntos lo que les llamó la atención.

Información útil que ayuda a debuggar:


6.5. Componentes transversales (verlos en cualquier sección)

DataTable estándar

Las pantallas de Movimientos, Vehículos, Conductores, Clientes, Contenedores, Auditoría y Usuarios usan un mismo componente DataTable con:

Patrón canónico de OSSFIA — mismo diseño que en otros productos del ecosistema XCLOUD.

AURA chat flotante

Botón violeta 💬 abajo-derecha visible en TODAS las páginas admin (no en el login ni en la PWA).

Esto reemplaza la página dedicada /aura que existía antes.


6.6. Respuestas FRIMAC al cap. 24 (recibidas 2026-04-27)

Estas respuestas YA están incorporadas en el documento de discovery interno (project/F02_domain/DISCOVERY.md) y dictan el alcance fase 2:

#PreguntaRespuesta FRIMACImplicación
1Parqueaderos al inicio2 sitios + GPS con toleranciaProducción inicia con 2; demo muestra 3 para validar multi-sitio
2Carriles + barreras2 carriles + 2 barreras por sitioTotal fase 2: 4 carriles + 4 talanqueras a integrar
3Marca/modelo HWPendiente — foto + manual técnicoBloquea cotización fija fase 2 — necesario antes de SOW
4ANPR fijaSolo móvil inicialmenteOCR Llama 3.2 Vision desde celular. ANPR fase 3
5CédulaCC + extranjeras (2-3 nacionalidades)Schema soporta CC/CE/PA/PEP/TI
6Retención fotos2-3 mesesMVP a 90 días — alineado
7ERPNO directa — exportan CSV para conciliaciónCSV/Excel oficial es el contrato; sin conector bidireccional
7HikCentralSÍ existeOportunidad fase 3 — cobrable como add-on
8Cobro clientesSí — recibo manual hoy. Modelo: monto fijo por sitioMódulo billing simple en fase 2
924/7Sin ventanas mantenimiento; deploys cero downtime
9OfflineOcasional por intermitencia datosADR-006 PWA queue cubre el escenario
10Despliegue(pendiente — Microsoft TBD)MVP en CF, migración Azure cobrable

7. Limitaciones explícitas del MVP (sin sorpresas)

TemaEstado MVPCuándo se resuelve
Apertura física talanqueraMock con etiqueta claraFase 2 — requiere levantamiento HW en sitio
ANPR fijaNo integradaFase 2 — opcional según presupuesto
Multi-cliente con cobroSolo CRUD básicoFase 2 — módulo billing
App nativa iOS/AndroidPWA instalableFase 2 si lo piden — PWA suele ser suficiente
Modo offline con gateway localNo (solo offline cliente)Fase 2 — Raspberry Pi por sitio
Integración HikCentral / ERP / TMSNoFase 2 — adaptadores específicos
Templates personalizables FRIMAC (logo, colores)GenéricoSprint 1 fase 2 — fácil de cambiar
Multi-idiomaSolo españolDiferido — bajo demanda
2FANoFase 2 — TOTP o magic link email
Backup/restore manual de BDNo expuestoFase 2 — UI admin

8. Próximos pasos sugeridos

Después de que prueben:

  1. Reunión de feedback (30 min, virtual): comentarios sobre lo que vieron.
  2. Decisión go/no-go fase 2: si les gusta, firmamos carta-acuerdo cocreación 6 meses.
  3. Kickoff técnico fase 2 (1 hora): resolvemos los 10 puntos pendientes del cap. 24, levantamos hardware en al menos 1 parqueadero piloto.
  4. Sprint 1 fase 2 (2 semanas): branding FRIMAC + migración a su tenant Azure (si lo prefieren) + integración primer hardware real.
  5. Producción primer parqueadero: 1 sitio operativo en 8 semanas desde firma.

9. Contacto directo

Alejandro Forero

XCLOUD Solutions

admin@xcloudcol.onmicrosoft.com

WhatsApp: (el que ya tienen)

Para preguntas técnicas profundas sobre la arquitectura, los ADRs están en el repo (acceso bajo NDA): project/F04_architecture/adr_001..adr_006_*.md.

Para ver el documento técnico-funcional original que ustedes nos enviaron y validar punto por punto: docs/research/01_doc_tecnico_frimac.md en el repo.


Confidencial bajo NDA. Demo gratuito de validación. No constituye oferta comercial firme — esa va por carta-acuerdo cocreación separada.

URL del demo: https://parqueaderos.xclos.com

Versión libreto: 1.0 — 27 de abril de 2026