first commit

docs/05_USER_WORKFLOWS.md

@@ -0,0 +1,43 @@
+# User Workflows
+
+## Workflow 1 — Criar encomenda ao fornecedor
+1. Selecionar fornecedor
+2. Criar nova encomenda
+3. Adicionar artigos e quantidades
+4. Guardar encomenda com estado `ordered`
+
+## Workflow 2 — Receber mercadoria
+1. Abrir encomenda pendente
+2. Visualizar lista de artigos esperados
+3. Registar quantidade recebida por artigo
+4. Marcar discrepâncias ou faltas
+5. Fechar receção
+6. Atualizar estado da encomenda para:
+   - `received`
+   - `partially_received`
+   - `pending`
+
+## Workflow 3 — Registar inventário
+1. Ver artigos recebidos e ainda não registados
+2. Confirmar entrada no inventário
+3. Criar unidades ou stock registado
+4. Definir estado inicial operacional
+
+## Workflow 4 — Preparar artigo para venda
+1. Ver artigos registados e ainda não preparados
+2. Marcar como preparado
+3. Marcar como publicado/anunciado
+4. Guardar referência do anúncio, se aplicável
+
+## Workflow 5 — Registar venda
+1. Selecionar artigo vendido
+2. Introduzir dados da venda
+3. Associar comprador
+4. Alterar estado para `sold` ou `pending_shipment`
+
+## Workflow 6 — Gerir envio
+1. Ver lista de vendas pendentes de envio
+2. Abrir venda
+3. Confirmar destinatário
+4. Marcar envio como concluído
+5. Atualizar estado para `shipped`