# Conceptos básicos

> **Para quién es esta página:** todos, antes de tocar cualquier otra pantalla.
> **Qué vas a saber al terminar:** las ocho palabras que se repiten en todo el módulo.

Todas las pantallas de Proyectos usan el mismo vocabulario. Si estas ocho palabras te quedan claras ahora, el resto de la documentación se lee solo.

Vamos a usar siempre el mismo ejemplo: la empresa **Constructora del Sur**, que está remodelando la oficina central de su cliente **Acme S.A.**

## 1. Proyecto

Un **proyecto** es un trabajo con principio, fin y presupuesto. Es la caja donde entra todo lo demás.

Un proyecto tiene un nombre, opcionalmente un cliente, un presupuesto, fechas de inicio y final, y personas asignadas.

[![](https://d1s864zb5202r6.cloudfront.net/uploads/images/gallery/2026-05/scaled-1680-/image-1778298860728.png)](https://d1s864zb5202r6.cloudfront.net/uploads/images/gallery/2026-05/image-1778298860728.png)

<p class="callout info">💡 <strong>Nuestro ejemplo:</strong> "Remodelación oficina central — Cliente: Acme S.A. — Presupuesto: ₡5.000.000 — Del 01/05/2026 al 30/06/2026."</p>

## 2. Cliente

Un **cliente** es para quién estás haciendo el trabajo. En nuestro ejemplo, Acme S.A.

Sirve para agrupar: si Acme te contrata tres obras distintas, las tres van a tener el mismo cliente y podés verlas juntas.

<p class="callout warning">El cliente es <strong>opcional</strong>. Un proyecto puede no tener cliente — por ejemplo, una remodelación de tus propias oficinas. Y ojo: el cliente acá es solo un nombre para agrupar. El módulo no le factura ni le cobra nada.</p>

## 3. Recurso

Un **recurso** es una persona asignada a un proyecto. La palabra suena fría, pero significa algo preciso: no es "un empleado de la empresa", es "esta persona, trabajando en este proyecto, a esta tarifa".

Cada recurso tiene un nombre y una **tarifa**: cuánto se le paga por hora en ese proyecto.

[![](https://d1s864zb5202r6.cloudfront.net/uploads/images/gallery/2026-05/scaled-1680-/image-1778298908122.png)](https://d1s864zb5202r6.cloudfront.net/uploads/images/gallery/2026-05/image-1778298908122.png)

<p class="callout info">💡 La misma persona puede ser recurso de varios proyectos a la vez, <strong>con tarifas distintas en cada uno</strong>. María puede cobrar ₡3.000 la hora en la obra de Acme y ₡3.500 en la de Beta.</p>

Que alguien sea empleado de tu empresa **no** lo hace recurso de un proyecto. Hay que asignarlo explícitamente, proyecto por proyecto. Si no está asignado, no le podés registrar trabajo.

## 4. Actividad

Una **actividad** es una tarea dentro del proyecto: "pintura", "instalación eléctrica", "acabados".

Sirve para saber en qué se fueron las horas. Es **opcional**: si no definís actividades, todo funciona igual, solo que el reporte de horas no va a tener ese desglose.

<p class="callout warning">Las actividades son una lista plana — solo título y descripción. No tienen fechas propias, ni dependen unas de otras, ni se le asignan a una persona en particular.</p>

## 5. Progreso

Un **progreso** es el registro de que alguien trabajó: "María trabajó 8 horas el 5 de mayo en la obra de Acme".

Es la unidad básica del módulo. Todo lo demás — el presupuesto consumido, lo que se paga en planilla, los reportes — sale de sumar progresos.

Cada progreso tiene uno de tres **estados**:

| Estado | Qué significa | Cuenta para el presupuesto |
|---|---|---|
| 🟡 **Pendiente** | Se registró, falta que alguien lo apruebe | No |
| 🟢 **Aprobado** | Válido y en camino a la planilla | Sí |
| 🔴 **Rechazado** | No se va a pagar | No |

[![](https://d1s864zb5202r6.cloudfront.net/uploads/images/gallery/2026-05/scaled-1680-/image-1778298964780.png)](https://d1s864zb5202r6.cloudfront.net/uploads/images/gallery/2026-05/image-1778298964780.png)

<p class="callout info">Todo progreso nace <strong>Pendiente</strong>, sin excepción. Ni siquiera un administrador puede crear uno ya aprobado.</p>

## 6. Hora extra

Una **hora extra** es trabajo que se pasó de la jornada semanal de la persona.

No la registrás vos como algo aparte: el sistema la detecta solo. Si anotás horas que superan lo que a esa persona le queda de jornada en la semana, el sistema parte el registro en dos — uno regular y uno extra — y marca el segundo con un rayo ⚡.

<p class="callout warning">Esto solo pasa si el proyecto está configurado para hacerlo. Si está en modo <em>Ignorar</em>, nunca se generan extras: todo se guarda como trabajo regular, por más horas que sean. Ver <em>Configuración del proyecto</em>.</p>

Las horas extra pueden pagarse con un concepto salarial distinto al de las horas normales.

## 7. Sanción

Una **sanción** es un descuento que le aplicás a alguien en su planilla, desde el proyecto.

Se usa cuando la persona no cumplió con lo que debía. El monto se calcula con la misma tarifa del proyecto: si sancionás 4 horas y la tarifa es ₡3.000, el descuento es ₡12.000.

<p class="callout danger">Para poder sancionar, el proyecto tiene que tener configurado un <strong>concepto de sanción</strong>. Si no lo tiene, el sistema te va a decir "No se pudo registrar la sanción" sin explicarte que la causa es esa. Ver <em>Configuración del proyecto</em>.</p>

## 8. Presupuesto

Cada proyecto tiene un **monto presupuestado**: cuánta plata hay disponible para pagar el trabajo de la gente.

Contra eso, el sistema calcula el **presupuesto ejecutado**: la suma de todos los progresos **aprobados**. Nada más.

<p class="callout warning">Los progresos <strong>pendientes no cuentan</strong> en el ejecutado. Si tenés mucho trabajo sin aprobar, el ejecutado va a verse más bajo de lo que realmente vas a terminar pagando. Aprobá seguido si querés que el número sirva para decidir.</p>

<p class="callout danger">El presupuesto <strong>no es un tope</strong>. El sistema te deja registrar y aprobar trabajo que lo supere, sin bloquearte ni advertirte. Es un número para que vos lo vigiles.</p>

## Resumen

| Palabra | En una línea |
|---|---|
| **Proyecto** | El trabajo completo, con presupuesto y fechas |
| **Cliente** | Para quién es el trabajo (opcional) |
| **Recurso** | Una persona asignada a un proyecto, con su tarifa |
| **Actividad** | Una tarea dentro del proyecto (opcional) |
| **Progreso** | "Fulano trabajó N horas el día tal" |
| **Hora extra** | Trabajo que se pasó de la jornada semanal |
| **Sanción** | Un descuento aplicado desde el proyecto |
| **Presupuesto** | Cuánto hay disponible, contra cuánto se aprobó |