Revisión de la estructura de vistas y componentes de la app

fabianabarca · fabianabarca · commit c76167409e5f · 2025-06-05T20:57:51.000-03:00
diff --git a/specs/docs/.vitepress/config.mts b/specs/docs/.vitepress/config.mts
@@ -80,6 +80,18 @@ export default defineConfig({
               { text: "FeedbackForm", link: "/desarrollo/componentes/" },
             ],
           },
+          {
+            text: "Vistas",
+            collapsed: true,
+            items: [
+              { text: "Splash", link: "/desarrollo/vistas/Splash" },
+              { text: "Home", link: "/desarrollo/vistas/Home" },
+              { text: "Login", link: "/desarrollo/vistas/Login" },
+              { text: "Profile", link: "/desarrollo/vistas/Profile" },
+              { text: "Run", link: "/desarrollo/vistas/Run" },
+              { text: "Alerts", link: "/desarrollo/vistas/Alerts" },
+            ],
+          },
           {
             text: "Módulos",
             collapsed: true,
diff --git a/specs/docs/desarrollo/componentes/AgencyVehicleSelector.md b/specs/docs/desarrollo/componentes/AgencyVehicleSelector.md
@@ -0,0 +1 @@
+# `AgencyVehicleSelector`
diff --git a/specs/docs/desarrollo/componentes/AlertSetup.md b/specs/docs/desarrollo/componentes/AlertSetup.md
diff --git a/specs/docs/desarrollo/componentes/LoginForm.md b/specs/docs/desarrollo/componentes/LoginForm.md
@@ -0,0 +1 @@
+# `Login`
diff --git a/specs/docs/desarrollo/componentes/RunInfo.md b/specs/docs/desarrollo/componentes/RunInfo.md
@@ -0,0 +1,16 @@
+# `RunInfo`
+
+Información de la carrera configurada o en progreso.
+
+- Vehículo asignado
+- Ruta
+- Recorrido
+- Tipo de viaje (SCHEDULED, UNSCHEDULED, etc.)
+- Hora de inicio
+- Fecha de inicio
+- Minutos transcurridos
+
+## Acciones
+
+- Botón para finalizar el viaje
+- Botón para interrumpir el viaje
diff --git a/specs/docs/desarrollo/componentes/RunSetup.md b/specs/docs/desarrollo/componentes/RunSetup.md
@@ -0,0 +1,11 @@
+# `RunSetup`
+
+Abre un modal para elegir
+
+- Ruta
+- Recorrido
+- Tipo de viaje (SCHEDULED, UNSCHEDULED, NEW, DELETED, etc.)
+
+Devuelve una lista de viajes (_trips_) que se pueden seleccionar para iniciar un viaje. Chofer elige un viaje según la hora de salida.
+
+Botón: Confirmar datos de la carrera (no la inicia aún)
diff --git a/specs/docs/desarrollo/vistas/Alerts.md b/specs/docs/desarrollo/vistas/Alerts.md
@@ -0,0 +1,3 @@
+# `Alerts`
+
+Lugar para ver y reportar alertas.
diff --git a/specs/docs/desarrollo/vistas/Home.md b/specs/docs/desarrollo/vistas/Home.md
@@ -0,0 +1,13 @@
+# `Home`
+
+> Pantalla principal
+
+## Anatomía
+
+- Logotipo de la agencia
+- Nombre de la agencia
+- Vehículo asignado
+- Estadísticas del conductor
+- Botón para configurar nueva instancia de un viaje (carrera, _run_)
+
+## Componentes
diff --git a/specs/docs/desarrollo/vistas/Login.md b/specs/docs/desarrollo/vistas/Login.md
@@ -0,0 +1,7 @@
+# `Login`
+
+## Anatomía
+
+## Componentes
+
+`LoginForm`
diff --git a/specs/docs/desarrollo/vistas/Messages.md b/specs/docs/desarrollo/vistas/Messages.md
@@ -0,0 +1,3 @@
+# `Messages`
+
+Módulo operativo de comunicación entre el conductor y la agencia de transporte.
diff --git a/specs/docs/desarrollo/vistas/Profile.md b/specs/docs/desarrollo/vistas/Profile.md
@@ -0,0 +1,16 @@
+# `Profile`
+
+## Anatomía
+
+- Foto de perfil
+- Nombre de usuario
+- Correo electrónico
+- Cédula
+- Agencia de transporte
+- Vehículo asignado
+- Botón para editar agencia y vehículo
+- Cerrar sesión
+
+## Componentes
+
+`AgencyVehicleSelector`
diff --git a/specs/docs/desarrollo/vistas/Run.md b/specs/docs/desarrollo/vistas/Run.md
@@ -0,0 +1,21 @@
+# `Run`
+
+`if` no hay un viaje en progreso:
+
+Si no está configurada la carrera:
+
+- `RunSetup`: Abre un modal para elegir ruta, recorrido y tipo de viaje.
+
+Si está configurada la carrera:
+
+- Muestra los datos de la carrera configurada.
+- Muestra un botón para cambiar la configuración de la carrera.
+- Muestra un gran botón verde para iniciar el viaje.
+
+`else if` hay un viaje en progreso:
+
+- `RunInfo`: Muestra información del viaje en progreso.
+
+`else`
+
+Algo
diff --git a/specs/docs/desarrollo/vistas/Splash.md b/specs/docs/desarrollo/vistas/Splash.md

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Alerts`
	`2`	`+`
	`3`	`+Lugar para ver y reportar alertas.`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Messages`
	`2`	`+`
	`3`	`+Módulo operativo de comunicación entre el conductor y la agencia de transporte.`