# Casos de uso (consolidado) — MVP + 90 días

Documento para **pegar en el mural** (FigJam/Figma). Consolidado desde:
- `docs/interviews/*`
- `docs/blueprint/*`
- `docs/mvp-inventario-balanzas/*`
- `inputs/*`

Convención:
- **P0** = MVP operativo (reduce error humano y da stock confiable)
- **P1** = 90 días (objetivos declarados: costeos, tracking plantas, activos, CRM)

---

## P0 — MVP operativo (inventario + balanza + auditoría)

### Estación de pesado (Bridge API)
- **UC-SCL-01 — Conectar balanza a estación (Mac)** (Operador/Tech): balanza disponible para leer peso.
- **UC-SCL-02 — Ver peso en vivo** (Operador): UI muestra lectura live + unidad.
- **UC-SCL-03 — Detectar peso estable** (Sistema): marca `stable=true` según regla de estabilidad.
- **UC-SCL-04 — Tarear frasco/recipiente** (Operador): tara (hardware o lógica) antes de pesar neto.
- **UC-SCL-05 — Capturar peso estable** (Operador): genera `capture_id` + `net_mg` para registrar operación.
- **UC-SCL-06 — Manejar desconexión/falla** (Sistema): estado claro + fallback manual con auditoría.

### Catálogos y configuración mínima
- **UC-SET-01 — Gestionar genéticas (alta/baja)** (Admin): activar/inactivar genéticas según demanda/cultivo.
- **UC-SET-02 — Gestionar tipos de contenedor** (Admin): bolsa stock / frasco / bolsita.
- **UC-SET-03 — Crear/registrar contenedores con código** (Admin/Operador): contenedores con `code` único.
- **UC-SET-04 — Asociar genética a contenedor** (Operador): definir qué genética contiene (cuando aplique).

### Movimientos de inventario (ledger)
- **UC-INV-01 — Registrar movimiento (ledger)** (Operador): ingreso/salida/traspaso con auditoría inmediata.
- **UC-INV-02 — Traspaso bolsa → frasco (TRANSFER)** (Operador): una transacción consistente (no doble carga).
- **UC-INV-03 — Fraccionar a bolsita (PACKAGE)** (Operador): origen (frasco/bolsa) → bolsita con código.
- **UC-INV-04 — Registrar merma (WASTE/MERMA)** (Operador): merma categorizada por operación/etapa.
- **UC-INV-05 — Ajuste auditado (ADJUSTMENT)** (Admin): corrección con motivo obligatorio (sin editar histórico).

### Consultas y control (anti “stock en la cabeza”)
- **UC-VIS-01 — Ver stock por genética** (Staff/Admin): stock total + distribución por contenedores.
- **UC-VIS-02 — Ver stock por contenedor** (Staff/Admin): saldo actual derivado del ledger.
- **UC-VIS-03 — Ver historial de movimientos** (Staff/Admin): filtros por fecha/genética/contenedor/usuario.

### Seguridad y auditoría
- **UC-SEC-01 — Roles y permisos mínimos** (Superadmin): staff vs admin vs cultivo.
- **UC-AUD-01 — Auditoría inmediata por operación** (Sistema): quién/qué/cuándo/origen/destino/peso/merma.

### Reportes mínimos
- **UC-RPT-01 — Exportar stock actual** (Admin): snapshot por genética y contenedor.
- **UC-RPT-02 — Exportar ledger de movimientos** (Admin): rango de fechas para revisión/inspección.
- **UC-RPT-03 — Exportar merma** (Admin): por operación/etapa.

---

## P1 — 90 días (objetivos declarados)

### Samplers (operación por lote)
- **UC-SMP-01 — Crear batch de sampler** (Staff): definir genéticas y cantidad.
- **UC-SMP-02 — Extraer por genética en bloque** (Staff): una captura por genética (evitar 20 salidas manuales).
- **UC-SMP-03 — Generar bolsitas/paquetes de sampler** (Staff): creación masiva + trazabilidad opcional.

### Cultivo (tracking desde individualización)
- **UC-CUL-01 — Registrar lote de esquejes (batch)** (Cultivo): lote agrupado pre-trasplante.
- **UC-CUL-02 — Registrar éxitos/bajas del lote** (Cultivo): métricas simples.
- **UC-CUL-03 — Trasplante: crear planta individual con código** (Cultivo): individualización post-trasplante.
- **UC-CUL-04 — Cambiar etapa de planta** (Cultivo): vege → flora → secado → curado.
- **UC-CUL-05 — Registrar cosecha y vincular a lote final** (Cultivo): cosecha → lote final.
- **UC-CUL-06 — Ingreso de lote final a inventario** (Operador): stock inicial por lote/genética.

### Activos y depreciación
- **UC-AST-01 — Registrar equipos con código** (Admin): luces, sensores, etc.
- **UC-AST-02 — Configurar política de depreciación** (Admin): lineal/vida útil.
- **UC-AST-03 — Calcular depreciación por período** (Sistema): base para costeos.

### Costeos
- **UC-CST-01 — Registrar horas de mano de obra** (Staff/Cultivo): horas por tarea/proceso.
- **UC-CST-02 — Registrar insumos consumidos** (Staff/Cultivo): sustrato, macetas, nutrientes, agua, EPP.
- **UC-CST-03 — Registrar energía (kWh)** (Admin): por equipo/sala (potencia × horas).
- **UC-CST-04 — Prorratear costos a lote/genética** (Sistema): reglas definidas.
- **UC-CST-05 — Calcular costo por gramo** (Admin): costo unitario por lote/genética.

### Integración con CRM (portal pacientes)
- **UC-CRM-01 — Publicar disponibilidad de genéticas** (Sistema): stock “publicable” al portal.
- **UC-CRM-02 — Registrar entregas (sin exponer PII innecesaria)** (Staff/Admin): entrega con permisos.
- **UC-CRM-03 — Sincronizar pedidos/entregas** (Sistema): contrato de datos CRM ↔ inventario.

---

## Stickies (copy/paste a FigJam)

Cada línea = 1 sticky.

```text
[P0] UC-SCL-01 Conectar balanza a estación (Mac)
[P0] UC-SCL-02 Ver peso en vivo
[P0] UC-SCL-03 Detectar peso estable
[P0] UC-SCL-04 Tara frasco/recipiente
[P0] UC-SCL-05 Capturar peso estable (capture_id + net_mg)
[P0] UC-SCL-06 Falla/desconexión: fallback con auditoría

[P0] UC-SET-01 Alta/baja genéticas
[P0] UC-SET-02 Tipos de contenedor (bolsa/frasco/bolsita)
[P0] UC-SET-03 Crear contenedor con código
[P0] UC-SET-04 Asociar genética a contenedor

[P0] UC-INV-01 Registrar movimiento (ledger)
[P0] UC-INV-02 Traspaso bolsa → frasco (1 transacción)
[P0] UC-INV-03 Fraccionar frasco/bolsa → bolsita con código
[P0] UC-INV-04 Registrar merma categorizada
[P0] UC-INV-05 Ajuste auditado con motivo (sin editar histórico)

[P0] UC-VIS-01 Ver stock por genética
[P0] UC-VIS-02 Ver stock por contenedor
[P0] UC-VIS-03 Ver historial de movimientos (filtros)

[P0] UC-SEC-01 Roles y permisos mínimos
[P0] UC-AUD-01 Auditoría inmediata por operación

[P0] UC-RPT-01 Export stock actual
[P0] UC-RPT-02 Export ledger movimientos (CSV)
[P0] UC-RPT-03 Export merma

[P1] UC-SMP-01 Batch sampler
[P1] UC-SMP-02 Extraer por genética en bloque (1 captura por genética)
[P1] UC-SMP-03 Crear bolsitas sampler + trazabilidad opcional

[P1] UC-CUL-01 Lote de esquejes
[P1] UC-CUL-02 Éxitos/bajas del lote
[P1] UC-CUL-03 Trasplante: planta individual con código
[P1] UC-CUL-04 Cambiar etapa (vege/flora/secado/curado)
[P1] UC-CUL-05 Cosecha → lote final
[P1] UC-CUL-06 Lote final → inventario

[P1] UC-AST-01 Registrar equipos con código
[P1] UC-AST-02 Política de depreciación
[P1] UC-AST-03 Depreciación por período

[P1] UC-CST-01 Horas de mano de obra
[P1] UC-CST-02 Insumos consumidos
[P1] UC-CST-03 Energía (kWh)
[P1] UC-CST-04 Prorrateo de costos
[P1] UC-CST-05 Costo por gramo

[P1] UC-CRM-01 Publicar disponibilidad de genéticas al portal
[P1] UC-CRM-02 Registrar entregas con permisos
[P1] UC-CRM-03 Sync pedidos/entregas CRM ↔ inventario
```