# Registro de campo e setores — PMRR Campos V6 Este diretório recebe observações rastreáveis e setores definidos pela equipe técnica. A estrutura está pronta para uso; os registros atuais estão vazios. Isso informa que o acervo ainda não foi integrado a este formato, e não que inexistem campanhas ou estudos anteriores. | Arquivo | Uso | | --- | --- | | `modelo_observacoes.csv` | Cabeçalhos para iniciar uma planilha de observações; nenhuma linha de exemplo representa trabalho real. | | `modelo_setores.geojson` | Coleção vazia para receber polígonos de setores. | | `observacoes.csv` | Registro atual de observações a conferir e incorporar. | | `setores.geojson` | Registro atual de setores a conferir e incorporar. | Os modelos para download também estão em `web/downloads/modelo_observacoes_pmrr_v6.csv` e `web/downloads/modelo_setores_pmrr_v6.geojson`. Faça uma cópia dos modelos para trabalhar. Não sobrescreva um registro preenchido com um modelo vazio. ## Preencher observações Use CSV UTF-8, ponto e vírgula como separador, ponto decimal e datas `AAAA-MM-DD`. Preserve os nomes das colunas. Ao usar uma planilha, mantenha IDs como texto. Uma linha representa uma evidência localizada; várias evidências podem pertencer ao mesmo evento. | Campo | Conteúdo e regra | | --- | --- | | `observation_id` | Identificador único e estável da evidência. Não usar CPF, nome de morador ou telefone. | | `hex_id` | Identificador existente na malha PMRR. Conferir a associação espacial no SIG. | | `process` | Um processo do vocabulário abaixo. Uma observação de processo misto pode ser desdobrada em registros relacionados pelo mesmo `event_id`. | | `date` | Data de obtenção, vistoria ou registro da evidência. Obrigatória. | | `event_id`, `event_date` | Identificador único e data do evento quando conhecidos. Não copiar o mesmo desastre como eventos independentes em cada HEX. | | `lon`, `lat` | Longitude e latitude em graus decimais WGS84. Somente posição real e documentada; não geocodificar um registro municipal no centroide para fingir precisão local. | | `evidence_type` | Tipo de evidência do vocabulário abaixo. | | `source` | Referência recuperável ao arquivo, ficha, foto, registro institucional ou medição. Descrever o método e a precisão quando aplicável. | | `description` | Descrição observacional, separando o que foi visto/medido do que foi relatado ou interpretado. Informar limites e referência de medidas. | | `water_depth_m` | Lâmina/atingimento em metros, quando medidos ou reconstruídos com referência explícita. Vazio significa não informado; zero é uma medição ou observação que precisa ser justificada. | | `shoreline_date_start`, `shoreline_date_end` | Datas inicial e final da série usada em medição costeira. Preencher ambas ou nenhuma; inicial anterior à final. | | `shoreline_uncertainty_m` | Incerteza posicional em metros, acompanhada do método e da referência em `source`/`description`. Não é automaticamente a incerteza de uma taxa em m/ano. | | `building_distance_m` | Distância medida entre edificação e frente erosiva/feição explicitada; não é distância genérica ao centro do HEX. | | `reviewer` | Nome profissional ou identificação rastreável da equipe responsável pela revisão técnica. Obrigatório para `validado`. | | `validation_status` | `pendente`, `validado` ou `rejeitado`. O status é declarado pela equipe, nunca inferido pelo script. | Processos admitidos: `inundacao_fluvial`, `alagamento`, `enxurrada`, `erosao_costeira`, `inundacao_costeira`, `movimentos_massa`, `incendio_vegetacao`, `outro`. Tipos de evidência: `vistoria`, `fotografia`, `marca_agua`, `relato_georreferenciado`, `registro_defesa_civil`, `medicao_costa`, `documento`, `outro`. Observações costeiras declaradas `validado` e do tipo `medicao_costa` exigem período e incerteza. O validador confere o preenchimento; a equipe precisa conferir método, datum, referência de linha de costa e significado da incerteza. Formulários ou documentos sem localização suficiente permanecem no inventário de fontes até que seja possível associá-los ao território com precisão conhecida. ## Preencher setores Use GeoJSON `FeatureCollection`, geometrias `Polygon` ou `MultiPolygon`, coordenadas bidimensionais `[longitude, latitude]` WGS84, anéis fechados e sem CRS legado. Delimite o setor conforme o processo, as áreas de origem e atingimento e a ocupação; ele não precisa coincidir com as bordas dos HEX. Cada `Feature` deve conter estas propriedades: | Propriedade | Tipo / regra | | --- | --- | | `sector_id` | Texto único e estável. | | `process` | Um dos processos admitidos acima. Setores de processos diferentes podem se sobrepor. | | `grade` | `null`, `R1`, `R2`, `R3` ou `R4`, conforme avaliação técnica específica. Não converter automaticamente os intervalos da triagem em R1–R4. | | `status` | `preliminar` ou `validado`. | | `date` | Data ISO da classificação/revisão; pode ser `null` em setor preliminar. | | `reviewer` | Identificação profissional/equipe responsável; pode ser `null` em setor preliminar. | | `evidence_refs` | Lista de `observation_id` presentes no CSV. Uma lista vazia é aceita somente para setor preliminar. | | `hex_ids` | Lista opcional de IDs existentes para associação operacional; exige conferência espacial externa. | Para publicar um setor declarado `validado`, o registro precisa ter grau, data, responsável e referências às observações declaradas validadas. A data do setor não pode preceder as evidências citadas. Um rótulo R3/R4 isolado não comprova validação. Descrição de critérios, vistoria, revisão técnica, documentação e participação comunitária continuam necessários fora da checagem de preenchimento. ## Conferir e publicar Na raiz do projeto: ```bash python3 scripts/validate_field_inputs.py python3 -m unittest discover -s tests -p test_field_inputs.py -v ``` Para conferir outro lote sem alterar o registro atual: ```bash python3 scripts/validate_field_inputs.py --observations caminho/observacoes.csv --sectors caminho/setores.geojson ``` Depois da revisão técnica do lote e de sua incorporação aos arquivos atuais: ```bash python3 scripts/validate_field_inputs.py --publish-sectors python3 scripts/build_site.py ``` A opção `--publish-sectors` produz `web/data/field-sectors.geojson` somente se não houver erros estruturais. Publica propriedades previstas no esquema, geometria e a declaração da equipe; não publica o texto integral das observações. Os registros vazios geram `metadata.status = "no_records"`. Os registros preenchidos geram `field_records`, com contagens separadas de preliminares e declarados validados. Publicar não ocorre por executar apenas a checagem. **Limite da verificação:** o script confere IDs, datas, números finitos, referências, campos obrigatórios, anéis fechados e extensão retangular da malha. Não verifica contenção no município, associação do ponto ao HEX, auto-interseção, sobreposição, qualidade da geocodificação, evidência física, adequação dos graus ou autoria. Essas verificações exigem SIG e avaliação técnica. Um resultado `passed_structure_checks` não é uma validação do risco. Não incluir dados pessoais de moradores, documentos de identificação, contatos ou fotografias identificáveis sem tratamento adequado. Para a consulta territorial, referências técnicas e dados agregados são suficientes. Procedimentos: [Validação de campo](../../docs/VALIDACAO_CAMPO_V6.md) · [Insumos pendentes](../../docs/INSUMOS_PENDENTES_V6.md).