> For the complete documentation index, see [llms.txt](https://academy.trowelapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.trowelapp.com/empleados/asistencia/registro-de-asistencia-movil.md).

# Registro de asistencia (móvil)

La app móvil de Trowel permite registrar la **asistencia** y el **tiempo trabajado** de forma sencilla desde el teléfono. La pantalla principal es **Mi jornada**, desde la que puedes iniciar y parar el trabajo, consultar el total del día, cambiar de proyecto y acceder al histórico de registros.

<figure><img src="/files/Vs85KxDYkU2yddougpBJ" alt="" width="188"><figcaption></figcaption></figure>

### Qué puedes hacer

| Acción                       | Descripción                                                                             |
| ---------------------------- | --------------------------------------------------------------------------------------- |
| **Iniciar trabajo**          | Registra la entrada (check-in) con la hora y, si aplica, el proyecto detectado por GPS. |
| **Parar trabajo**            | Registra la salida (check-out) y cierra el registro en curso.                           |
| **Cambiar proyecto**         | Durante una jornada activa, asignar otro proyecto al registro actual o abrir uno nuevo. |
| **Consultar histórico**      | Ver todos los registros de un día concreto, navegar entre fechas y abrir el detalle.    |
| **Editar registros**         | Corregir horarios, proyecto o campos personalizados (según permisos).                   |
| **Crear registros manuales** | Añadir un registro que no se generó automáticamente al fichar.                          |

### Conceptos básicos

* **Registro**: intervalo de tiempo entre un check-in y un check-out. Puede tener proyecto asignado y campos personalizados.
* **Registro abierto**: check-in realizado sin check-out todavía. La jornada sigue en curso.
* **Proyecto activo**: proyecto asociado al registro en curso. Se muestra en la tarjeta de proyecto de Mi jornada.
* **Edición manual**: cualquier cambio hecho a mano en fechas u horas queda marcado como editado manualmente.

### Geolocalización

Al iniciar o parar el trabajo, la app obtiene la **ubicación GPS** del dispositivo para:

* Detectar automáticamente el proyecto en el que te encuentras.
* Registrar las coordenadas del fichaje en el servidor.

Si hay **varios proyectos cercanos**, se abre un selector para que elijas en cuál estás. Este selector **no** pregunta si quieres crear un registro nuevo o editar el actual: simplemente aplica el proyecto al check-in o check-out que estabas realizando.

### Permisos

Algunas acciones requieren permisos específicos en tu cuenta:

* **Ver Mi jornada e histórico**: acceso al portal del empleado / registro horario.
* **Crear y editar registros**: necesario para editar el registro activo, crear registros manuales o modificar registros cerrados.
* **Parte diario tras el checkout**: si tu empresa lo tiene activado, al parar el trabajo se puede ofrecer crear un parte diario con las horas trabajadas.

### Organización de esta guía

La documentación sigue el flujo real de la app:

1. **Mi jornada** — Pantalla principal y sus estados (fuera de jornada, trabajando, sin conexión).
2. **Fichaje** — Check-in, check-out y selección de proyecto por GPS.
3. **Cambiar proyecto** — Flujo exclusivo del botón *Cambiar* durante una jornada activa.
4. **Histórico** — Consulta de registros por día.
5. **Detalle de registro** — Información completa de un registro.
6. **Editar registro** — Formulario de edición y creación manual.

Se recomienda leer primero Mi jornada y después Iniciar trabajo y Parar trabajo.