# Conceptos básicos

> Qué es una cuenta, un proyecto, una app, una versión o una confirmación, y cómo encajan el plan, el crédito de uso, el tope de gasto y el monedero.

Para usar Dilohost basta con hablar con tu agente, pero conocer estas piezas te ayuda a pedir las cosas con precisión y a entender lo que te contesta.

## Cuenta

Todo lo que publicas vive en una **cuenta**. Cada persona tiene la suya al registrarse, con su plan, su saldo y su consumo. Una cuenta tiene un identificador corto, de siete caracteres (por ejemplo `a1b2c3d`), que aparece en las direcciones de tus webs.

### Propietario y equipo

- El **propietario** es quien creó la cuenta. Solo hay uno.
- Puede invitar a otras personas como **usuarios**. Comparten la cuenta entera: publican, borran (con confirmación), compran dominios con el saldo de la cuenta y recargan.
- Solo el propietario gestiona el equipo, el plan, el método de pago, los datos de facturación, el tope de gasto y los códigos para llevarse un dominio.

Una persona puede pertenecer a varias cuentas: la suya y las de quienes la inviten. Ver [Equipo](/docs/cuenta/equipo).

## Proyecto

Un **proyecto** agrupa lo que forma parte de lo mismo: la web de una tienda, su base de datos, su almacén de fotos y sus tareas programadas. Su identificador tiene de 2 a 20 caracteres en minúsculas, números o guiones (por ejemplo `tienda` o `mi-tienda`).

Borrar un proyecto no lo elimina en el acto: va a la [papelera](#papelera) 30 días.

## Recursos de un proyecto

Dentro de un proyecto hay **recursos**. Cada uno tiene un nombre de 1 a 20 minúsculas y números, sin guiones (por ejemplo `web`, `api` o `datos`).

| Recurso | Qué es |
|---|---|
| **Web estática** | HTML, CSS, JavaScript e imágenes, sin servidor. Se publica en segundos. |
| **App** | Una aplicación con servidor: Node, PHP/Laravel, Python, Go, Ruby o lo que describa su Dockerfile. Dilohost la construye y la mantiene en marcha. |
| **Worker** | Un proceso que corre siempre con el código de una app; por ejemplo, la cola de trabajos (`php artisan queue:work`). |
| **Tarea programada** | Un comando que se ejecuta con un horario (formato cron, hora de Madrid); por ejemplo, `php artisan schedule:run` cada 5 minutos. |
| **Base de datos** | PostgreSQL o MySQL, con su propio usuario y copias diarias. |
| **Almacén de ficheros** | Un *bucket* compatible con S3 para fotos, documentos o vídeos de la app. |

En las herramientas, la web estática y la app se tratan igual: a las dos se les llama «app» y se publican con `deploy`. Dilohost decide cuál es por lo que hay en el código. Ver [Webs estáticas](/docs/publicar/webs-estaticas) y [Apps con servidor](/docs/publicar/apps).

## Dirección de una web

Cada web o app publicada tiene una dirección con HTTPS:

```text
https://<app>-<proyecto>-<cuenta>.dilosite.es
```

Por ejemplo, la app `web` del proyecto `tienda` en la cuenta `a1b2c3d` está en `https://web-tienda-a1b2c3d.dilosite.es`. Puedes cambiarla por un nombre a tu gusto en dilosite.es (ver [Versiones y dirección](/docs/publicar/versiones)) o usar tu propio dominio (ver [Dominios](/docs/dominios/conectar)).

## Versión

Cada vez que publicas una web o una app se crea una **versión** numerada: 1, 2, 3… El historial guarda cuándo se publicó cada una, con qué mensaje y cuál está en línea. Puedes volver a una versión anterior sin esperar a que se construya de nuevo. Ver [Versiones](/docs/publicar/versiones).

Una versión pasa por estos estados:

| Estado | Qué significa |
|---|---|
| En cola | Esperando su turno para construirse. |
| Construyendo | Instalando dependencias y preparando la app. |
| Arrancando | La versión nueva se está poniendo en marcha. |
| En línea | Ya responde en su dirección. |
| Falló | No se pudo construir o no arrancó. La versión anterior sigue en línea. |
| Sustituida | Hubo otra publicación más reciente antes de que terminara. |

## Confirmación

Lo que **borra, sustituye o cuesta dinero** no se hace a la primera. La primera vez, Dilohost devuelve un resumen de lo que va a pasar y un código; tu agente te lo cuenta y solo lo repite con ese código si tú dices que sí. El código caduca a los 10 minutos y vale una sola vez. Ver [Confirmaciones](/docs/seguridad/confirmaciones).

## Plan

El **plan** marca cuántos proyectos, apps, bases de datos, almacenes, dominios y buzones puedes tener, y cuántas publicaciones al día. Hay un plan **Gratis** sin caducidad y planes de pago mensuales o anuales. Ver [Planes y precios](/docs/cuenta/planes).

## Crédito de uso

Cada plan incluye un **crédito de uso** al mes, en euros. Dilohost mide cada hora lo que gasta cada app (memoria, procesador, disco, bases de datos, salida a Internet, buzones…) y lo valora con una tarifa pública. Mientras no pases del crédito, no pagas nada más. Si lo pasas, el exceso se cobra:

- en los planes de pago, en tu factura;
- en el plan Gratis, del [monedero](#monedero).

Te avisamos al llegar al 80 % y al 100 % del crédito. Ver [Pagos](/docs/cuenta/pagos).

## Tope de gasto

En los planes de pago, el **tope de gasto** es lo máximo que aceptas pagar de exceso al mes (25 € si no lo cambias; puedes subirlo, bajarlo o quitarlo). Si se alcanza, Dilohost para tus apps con servidor hasta que lo subas o empiece el mes siguiente. Las webs estáticas y el correo siguen funcionando.

## Monedero

El **monedero** es el saldo de la cuenta. Se recarga con tarjeta y sirve para comprar y renovar dominios y, en el plan Gratis, para pagar el uso que pase del crédito. Si en Gratis no queda saldo, las apps con servidor se paran hasta el día 1. Ver [Pagos](/docs/cuenta/pagos).

## Papelera

Un proyecto borrado se guarda **30 días** con todos sus datos: código, bases de datos y copias, almacenes y tareas. En ese tiempo puedes recuperarlo entero. Pasado el plazo se borra para siempre. Ver [Papelera y bajas](/docs/cuenta/papelera-y-bajas).

## Herramientas

Por debajo, tu agente usa las **herramientas** del servidor MCP de Dilohost: `project`, `deploy`, `database`, `domain`, `email`… Cada una agrupa varias acciones. No necesitas conocerlas, pero si te interesa, están todas en la [referencia de herramientas](/docs/referencia/herramientas).

## Relacionado

- [Inicio rápido](/docs/inicio-rapido)
- [Ejemplos de peticiones](/docs/ejemplos)
- [Planes y precios](/docs/cuenta/planes)
- [Seguridad](/docs/seguridad)