Processos, Procedimentos e Tarefas

Esta referência define os níveis operacionais usados para documentar a plataforma.

Nível	Definição	Exemplo no PHPB Hub
Processo	Sequência ampla de uso.	Consulta exploratória do acervo.
Procedimento	Conjunto de passos repetível dentro de um processo.	Filtrar coleções por estado e século.
Tarefa	Ação direta do usuário.	Clicar em Baixar em uma coleção.
Operação técnica	Chamada ou transformação executada pela aplicação.	api.analysis.frequency({ mode: "lemma" }).

Processos principais

Processo	Procedimentos
Consulta editorial	Listar coleções, abrir detalhe, ler amostras, exportar.
Busca linguística	Definir termo, modo e filtros; abrir concordância; exportar resultados.
Análise exploratória	Escolher análise, ajustar escopo, calcular, exportar CSV.
Curadoria local	Editar amostra, salvar override, anotar trecho, revisar fila.
Montagem de subcorpus	Criar projeto, adicionar coleções, exportar projeto.

Estados de processamento

Estado	Significado
pending	Item ainda não processado.
processing	Item em processamento ou simulação de fila.
done	Item pronto para consulta.
error	Item com falha registrada.

Estados de revisão de amostra

Estado	Significado
auto	Segmentação aceita automaticamente.
partial	Segmentação parcial ou com advertências.
review	Requer conferência manual.

Operações com persistência local

Operação	Efeito
Criar projeto	Grava em phpb-demo-projects:{tenant}:v1.
Adicionar coleção a projeto	Atualiza collection_ids do projeto.
Criar anotação	Grava em phpb-demo-annotations:{tenant}:v1.
Editar amostra	Grava override em phpb-corpus-overrides:{tenant}:v1.
Reprocessar documento	Salva status processing como override de documento.
Iniciar ingestão	Grava timestamp em phpb-demo-ingest:{tenant}:v1.

Critérios de cuidado

• Dados locais não representam curadoria definitiva.
• Exportações devem ser citadas conforme a referência editorial da coleção.
• Análises calculadas no navegador são exploratórias.
• O payload público precisa permanecer sanitizado antes do deploy.