# REQUIREMENTS: [Nombre del Proyecto]

> Versión: 0.1 | Última actualización: YYYY-MM-DD
> Los requisitos con estado "Aprobado" están congelados para la fase actual.
> Cambios a requisitos aprobados requieren aprobación del Product Owner.

---

## Guía de prioridades

| Nivel | Significado |
|-------|-------------|
| P0 | Crítico — sin esto el sistema no funciona. Bloqueante para el lanzamiento. |
| P1 | Alta — funcionalidad core esperada por el usuario. MVP incompleto sin esto. |
| P2 | Media — mejora significativa. Puede lanzarse sin esto pero debe estar pronto. |
| P3 | Baja — nice-to-have. Entra si hay tiempo disponible en la fase. |

## Guía de estados

| Estado | Significado |
|--------|-------------|
| Borrador | En discusión, puede cambiar |
| Aprobado | Congelado para esta fase, listo para implementar |
| En desarrollo | Siendo implementado actualmente |
| Completado | Implementado y verificado |
| Pospuesto | Movido a fase futura |
| Cancelado | Descartado con justificación documentada |

---

## Requisitos Funcionales

### Módulo: [Nombre del módulo — ej. Autenticación]

| ID | Prioridad | Descripción | Criterios de aceptación | Estado |
|----|-----------|-------------|------------------------|--------|
| REQ-001 | P0 | [Descripción concisa de qué debe hacer el sistema] | - [Criterio 1 verificable] / - [Criterio 2 verificable] | Borrador |
| REQ-002 | P0 | | | Borrador |
| REQ-003 | P1 | | | Borrador |

### Módulo: [Nombre del segundo módulo — ej. Gestión de Facturas]

| ID | Prioridad | Descripción | Criterios de aceptación | Estado |
|----|-----------|-------------|------------------------|--------|
| REQ-010 | P0 | | | Borrador |
| REQ-011 | P1 | | | Borrador |
| REQ-012 | P1 | | | Borrador |
| REQ-013 | P2 | | | Borrador |

### Módulo: [Nombre del tercer módulo]

| ID | Prioridad | Descripción | Criterios de aceptación | Estado |
|----|-----------|-------------|------------------------|--------|
| REQ-020 | P1 | | | Borrador |
| REQ-021 | P2 | | | Borrador |
| REQ-022 | P3 | | | Borrador |

---

## Requisitos No Funcionales

| ID | Categoría | Descripción | Métrica | Estado |
|----|-----------|-------------|---------|--------|
| RNF-001 | Performance | El sistema responde en menos de [N]ms para el P95 | P95 < [N]ms bajo [X] usuarios concurrentes | Borrador |
| RNF-002 | Disponibilidad | Uptime mínimo en producción | >= 99.5% mensual | Borrador |
| RNF-003 | Seguridad | Datos en tránsito cifrados | TLS 1.2+ en todos los endpoints | Borrador |
| RNF-004 | Seguridad | Autenticación obligatoria en toda operación de escritura | 100% endpoints POST/PUT/DELETE con auth | Borrador |
| RNF-005 | Escalabilidad | El sistema soporta [N] usuarios concurrentes | Sin degradación hasta [N] usuarios | Borrador |
| RNF-006 | Mantenibilidad | Cobertura de tests | >= 80% en módulos de lógica de negocio | Borrador |
| RNF-007 | Accesibilidad | Interfaz web accesible | WCAG 2.1 nivel AA | Borrador |

---

## Restricciones de implementación

| ID | Descripción | Impacto |
|----|-------------|---------|
| RES-001 | [Restricción técnica mandatoria — ej. debe integrarse con SAP existente] | [Cómo afecta el diseño] |
| RES-002 | [Restricción regulatoria — ej. datos deben residir en México] | [Cómo afecta la infraestructura] |
| RES-003 | [Restricción de tiempo — ej. lanzamiento fijado para fecha X] | [Qué se prioriza] |

---

## Casos de uso principales (flujos happy path)

### [CU-001] [Nombre del caso de uso]

**Actor**: [Tipo de usuario]
**Precondición**: [Estado del sistema antes de empezar]

1. El usuario [acción 1]
2. El sistema [respuesta 1]
3. El usuario [acción 2]
4. El sistema [respuesta 2]
5. [...]

**Postcondición**: [Estado del sistema al finalizar]
**Flujos alternativos**:
- Si [condición]: [qué pasa]

---

### [CU-002] [Nombre del caso de uso]

**Actor**:
**Precondición**:

1.
2.
3.

**Postcondición**:

---

## Preguntas abiertas

Decisiones de requisitos que aún no están resueltas. Cada una bloquea
uno o más requisitos hasta que se responda.

| # | Pregunta | Quién decide | Fecha límite | Estado |
|---|----------|-------------|--------------|--------|
| Q1 | [Pregunta específica sobre el comportamiento esperado] | [Nombre/Rol] | YYYY-MM-DD | Abierta |
| Q2 | | | | Abierta |

---

## Historial de cambios a requisitos

| Fecha | ID Req | Cambio | Motivo | Aprobado por |
|-------|--------|--------|--------|-------------|
| YYYY-MM-DD | REQ-NNN | [descripción del cambio] | [por qué] | [nombre] |
