> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://naturgy-comer-documentation-p5mde.vercel.app/api/mcp` to find what you need.

# Plantilla de página de caso de uso

Copia esta página en la sección correcta del caso de uso. Se recomienda esta
forma de ruta:

```text
src/pages/<dominio>/<diataxis>/<identificador>.md
```

Los tipos Diátaxis son `tutorials`, `how-to`, `explanations` y `reference`.
Usa el dominio para conservar el contexto y `audience` para describir quién
lee la página. Las etiquetas de audiencia son metadatos de navegación, no
controles de acceso.

## Metadatos de la página

```md
---
description: Una frase que explique el valor de la página.
docId: docs.<dominio>.<identificador>
scope: use-case | account | method | agent-guide | reference
domain: atc | operations | account | method | agent-guide | reference
diataxis: tutorial | how-to | explanation | reference
useCase: <caso-de-uso> # solo para dominios de casos de uso
audience: public | internal | shared
kind: domain-index | section-index | overview | feature | agent | workflow | decision | metrics | testing
status: canonical | generated | working | skeleton
keywords: [término de búsqueda, otro término]
---
```

## Estructura recomendada

```md
# <Título de la página>

## Resumen

¿Qué problema resuelve, para quién y qué resultado produce?

## Contexto y alcance

- Contexto de negocio:
- Dentro del alcance:
- Fuera del alcance:
- Supuestos:

## Actores y sistemas

| Actor o sistema | Responsabilidad |
| --- | --- |
| <Nombre> | <Responsabilidad> |

## Flujo de trabajo

1. <Activador o condición inicial>
2. <Acción principal>
3. <Decisión o transferencia>
4. <Resultado esperado>

## Excepciones y recuperación

Describe los fallos de validación, las rutas alternativas, los reintentos, las
escaladas y la propiedad de cada caso.

## Datos y permisos

Documenta entradas, salidas, conservación, requisitos de acceso y enlaces a
esquemas autorizados. No incluyas secretos ni datos personales.

## Operaciones

- Responsable:
- Estado: Borrador | En revisión | Activo | Retirado
- Última revisión:
- Próxima revisión:
- Enlace de observabilidad o soporte:

## Referencias

- <Fuente autorizada>
```

## Antes de publicar

Añade la página al índice Diátaxis del dominio y al grupo correspondiente de
la barra lateral, crea o actualiza su entrada en el manifiesto de agentes,
verifica su propietario canónico y ejecuta `npm run build`.