Atualiza documentacao da estrutura OAMRP
This commit is contained in:
18
CONTEXTO.md
18
CONTEXTO.md
@@ -2,13 +2,14 @@
|
|||||||
|
|
||||||
## Objetivo
|
## Objetivo
|
||||||
|
|
||||||
Organizar, preservar e processar documentos relacionados ao projeto `arara_oarmp`, mantendo rastreabilidade das alterações e separando arquivos originais, intermediários e processados.
|
Organizar, preservar e processar documentos relacionados ao projeto Arara OAMRP, mantendo rastreabilidade das alterações e separando arquivos originais, intermediários, processados e modelos de software.
|
||||||
|
|
||||||
## Estrutura de Pastas
|
## Estrutura de Pastas
|
||||||
|
|
||||||
- `raw/`: arquivos originais, sem alteração.
|
- `db/raw/`: arquivos originais, sem alteração.
|
||||||
- `pre_process/`: scripts e saídas intermediárias de pré-processamento.
|
- `db/pre_process/`: scripts e saídas intermediárias de pré-processamento.
|
||||||
- `processed/`: dados finais limpos, consolidados ou prontos para análise.
|
- `db/processed/`: dados finais limpos, consolidados ou prontos para análise.
|
||||||
|
- `software/`: modelos, scripts analíticos e protótipos executáveis do OAMRP.
|
||||||
- `docs/`: documentação técnica, autoria e histórico de versões.
|
- `docs/`: documentação técnica, autoria e histórico de versões.
|
||||||
|
|
||||||
## Arquivos de Documentação
|
## Arquivos de Documentação
|
||||||
@@ -28,8 +29,9 @@ Organizar, preservar e processar documentos relacionados ao projeto `arara_oarmp
|
|||||||
|
|
||||||
## Orientações de Trabalho
|
## Orientações de Trabalho
|
||||||
|
|
||||||
- Manter documentos originais sempre em `raw/`.
|
- Manter documentos originais sempre em `db/raw/`.
|
||||||
- Não alterar arquivos dentro de `raw/`; quando necessário, gerar cópias ou saídas em `pre_process/`.
|
- Não alterar arquivos dentro de `db/raw/`; quando necessário, gerar cópias ou saídas em `db/pre_process/`.
|
||||||
|
- Manter modelos e protótipos executáveis em `software/`.
|
||||||
- Registrar no `LOG.md` toda entrada, alteração, processamento ou decisão relevante.
|
- Registrar no `LOG.md` toda entrada, alteração, processamento ou decisão relevante.
|
||||||
- Registrar em `docs/changelog.md` mudanças significativas de versão, como novo parser, novo conjunto de dados, mudança estrutural ou nova funcionalidade.
|
- Registrar em `docs/changelog.md` mudanças significativas de versão, como novo parser, novo conjunto de dados, mudança estrutural ou nova funcionalidade.
|
||||||
- Usar o formato de log com data, hora, tag do colaborador e descrição objetiva da ação.
|
- Usar o formato de log com data, hora, tag do colaborador e descrição objetiva da ação.
|
||||||
@@ -38,7 +40,7 @@ Organizar, preservar e processar documentos relacionados ao projeto `arara_oarmp
|
|||||||
- Registrar quantidade de registros extraídos, descartados, corrigidos ou validados.
|
- Registrar quantidade de registros extraídos, descartados, corrigidos ou validados.
|
||||||
- Registrar problemas encontrados nos arquivos originais, como erros de digitação, páginas ilegíveis, campos ausentes ou tabelas quebradas.
|
- Registrar problemas encontrados nos arquivos originais, como erros de digitação, páginas ilegíveis, campos ausentes ou tabelas quebradas.
|
||||||
- Registrar decisões de padronização, por exemplo nomes de colunas, unidades, formatos de data e tratamento de acentos.
|
- Registrar decisões de padronização, por exemplo nomes de colunas, unidades, formatos de data e tratamento de acentos.
|
||||||
- Explicitar os critérios usados para mover dados de `pre_process/` para `processed/`.
|
- Explicitar os critérios usados para mover dados de `db/pre_process/` para `db/processed/`.
|
||||||
- Atualizar `docs/about.md` quando o fluxo técnico, campos extraídos ou limitações conhecidas mudarem.
|
- Atualizar `docs/about.md` quando o fluxo técnico, campos extraídos ou limitações conhecidas mudarem.
|
||||||
|
|
||||||
## Formato Recomendado do Log
|
## Formato Recomendado do Log
|
||||||
@@ -46,5 +48,5 @@ Organizar, preservar e processar documentos relacionados ao projeto `arara_oarmp
|
|||||||
```text
|
```text
|
||||||
| Data | Hora | Autor | Ação | Arquivos | Observações |
|
| Data | Hora | Autor | Ação | Arquivos | Observações |
|
||||||
| --- | --- | --- | --- | --- | --- |
|
| --- | --- | --- | --- | --- | --- |
|
||||||
| 2026-06-15 | 15:41 | VTO | Pré-processou PDF de inspeções | raw/documento.pdf; pre_process/saida.csv | 18 inspeções extraídas |
|
| 2026-06-15 | 15:41 | VTO | Pré-processou PDF de inspeções | db/raw/documento.pdf; db/pre_process/saida.csv | 18 inspeções extraídas |
|
||||||
```
|
```
|
||||||
|
|||||||
1
LOG.md
1
LOG.md
@@ -21,3 +21,4 @@ Legenda de autores:
|
|||||||
| 2026-06-15 | 17:57 | VTO | Criou documentação técnica no padrão `docs/` | `docs/about.md`; `docs/authors.md`; `docs/changelog.md`; `README.md`; `CONTEXTO.md`; `LOG.md` | Estrutura inspirada no módulo `meteorologia_aeroportos`: documentação técnica, autoria e changelog separados do log operacional. |
|
| 2026-06-15 | 17:57 | VTO | Criou documentação técnica no padrão `docs/` | `docs/about.md`; `docs/authors.md`; `docs/changelog.md`; `README.md`; `CONTEXTO.md`; `LOG.md` | Estrutura inspirada no módulo `meteorologia_aeroportos`: documentação técnica, autoria e changelog separados do log operacional. |
|
||||||
| 2026-06-15 | 18:11 | VTO | Agrupou artefatos do relatório de ciclo em subpasta própria | `pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/`; `README.md`; `docs/about.md` | Removido `.gitkeep` de `pre_process/` porque a pasta deixou de estar vazia; `.gitkeep` de `processed/` foi mantido. |
|
| 2026-06-15 | 18:11 | VTO | Agrupou artefatos do relatório de ciclo em subpasta própria | `pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/`; `README.md`; `docs/about.md` | Removido `.gitkeep` de `pre_process/` porque a pasta deixou de estar vazia; `.gitkeep` de `processed/` foi mantido. |
|
||||||
| 2026-06-15 | 18:33 | VTO | Comparou ICA 66-31/2023 com relatório de ciclo C-105 2805 | `raw/ICA 66-31 2023.pdf`; `pre_process/comparacao_ica_66_31_c105_2023/` | A comparação usou o Anexo D textual do PDF completo da ICA. |
|
| 2026-06-15 | 18:33 | VTO | Comparou ICA 66-31/2023 com relatório de ciclo C-105 2805 | `raw/ICA 66-31 2023.pdf`; `pre_process/comparacao_ica_66_31_c105_2023/` | A comparação usou o Anexo D textual do PDF completo da ICA. |
|
||||||
|
| 2026-06-15 | 19:01 | VTO | Reorganizou dados em `db/` e adicionou protótipo OAMRP | `db/`; `software/oamrp_v1.py`; `.gitignore`; `README.md`; `CONTEXTO.md`; `docs/about.md`; `docs/authors.md`; `docs/changelog.md` | Commit `1131267`; diretórios `raw/`, `pre_process/` e `processed/` movidos para `db/`; modelo MIP inicial em PuLP adicionado em `software/`. |
|
||||||
|
|||||||
40
README.md
40
README.md
@@ -1,6 +1,6 @@
|
|||||||
# Arara OARMP
|
# Arara OAMRP
|
||||||
|
|
||||||
Este repositório organiza os arquivos e processamentos do projeto Arara OARMP do Esquadrão Arara, em Manaus.
|
Este repositório organiza os arquivos, processamentos e protótipos do projeto Arara OAMRP do Esquadrão Arara, em Manaus.
|
||||||
|
|
||||||
A ideia é construir, em conjunto, uma base confiável para encaixar missões, aeronaves e manutenções. O repositório serve como lugar único para guardar documentos originais, registrar decisões, transformar relatórios em dados utilizáveis e manter um histórico claro do que foi feito por cada colaborador.
|
A ideia é construir, em conjunto, uma base confiável para encaixar missões, aeronaves e manutenções. O repositório serve como lugar único para guardar documentos originais, registrar decisões, transformar relatórios em dados utilizáveis e manter um histórico claro do que foi feito por cada colaborador.
|
||||||
|
|
||||||
@@ -21,18 +21,21 @@ Na prática:
|
|||||||
|
|
||||||
```text
|
```text
|
||||||
arara_oarmp/
|
arara_oarmp/
|
||||||
|
db/
|
||||||
raw/
|
raw/
|
||||||
pre_process/
|
pre_process/
|
||||||
processed/
|
processed/
|
||||||
|
software/
|
||||||
docs/
|
docs/
|
||||||
CONTEXTO.md
|
CONTEXTO.md
|
||||||
LOG.md
|
LOG.md
|
||||||
README.md
|
README.md
|
||||||
```
|
```
|
||||||
|
|
||||||
- `raw/`: documentos originais. Não editar esses arquivos diretamente.
|
- `db/raw/`: documentos originais. Não editar esses arquivos diretamente.
|
||||||
- `pre_process/`: scripts e arquivos intermediários gerados a partir dos documentos originais.
|
- `db/pre_process/`: scripts e arquivos intermediários gerados a partir dos documentos originais.
|
||||||
- `processed/`: arquivos finais, limpos e prontos para análise ou uso.
|
- `db/processed/`: arquivos finais, limpos e prontos para análise ou uso.
|
||||||
|
- `software/`: modelos e protótipos executáveis, incluindo o modelo MIP inicial de roteamento.
|
||||||
- `docs/`: documentação técnica, autoria e histórico de versões.
|
- `docs/`: documentação técnica, autoria e histórico de versões.
|
||||||
- `CONTEXTO.md`: regras, combinados e orientações permanentes do projeto.
|
- `CONTEXTO.md`: regras, combinados e orientações permanentes do projeto.
|
||||||
- `LOG.md`: histórico rastreável das ações feitas no projeto.
|
- `LOG.md`: histórico rastreável das ações feitas no projeto.
|
||||||
@@ -54,9 +57,9 @@ Este caminho é bom para quem só quer ver arquivos, baixar documentos ou confer
|
|||||||
|
|
||||||
1. Abra o repositório no Gitea do PPGAO/ITA.
|
1. Abra o repositório no Gitea do PPGAO/ITA.
|
||||||
2. Entre nas pastas para ver os arquivos.
|
2. Entre nas pastas para ver os arquivos.
|
||||||
3. Use `raw/` para consultar documentos originais.
|
3. Use `db/raw/` para consultar documentos originais.
|
||||||
4. Use `pre_process/` para consultar arquivos intermediários.
|
4. Use `db/pre_process/` para consultar arquivos intermediários.
|
||||||
5. Use `processed/` para consultar dados finais quando existirem.
|
5. Use `db/processed/` para consultar dados finais quando existirem.
|
||||||
6. Abra o `LOG.md` para entender o que já foi feito.
|
6. Abra o `LOG.md` para entender o que já foi feito.
|
||||||
7. Abra o `CONTEXTO.md` para ver os combinados do projeto.
|
7. Abra o `CONTEXTO.md` para ver os combinados do projeto.
|
||||||
|
|
||||||
@@ -125,16 +128,16 @@ git push
|
|||||||
## Fluxo recomendado de trabalho
|
## Fluxo recomendado de trabalho
|
||||||
|
|
||||||
1. Rode `git pull` antes de começar.
|
1. Rode `git pull` antes de começar.
|
||||||
2. Coloque documentos novos em `raw/`.
|
2. Coloque documentos novos em `db/raw/`.
|
||||||
3. Gere arquivos intermediários em `pre_process/`.
|
3. Gere arquivos intermediários em `db/pre_process/`.
|
||||||
4. Coloque resultados finais em `processed/`.
|
4. Coloque resultados finais em `db/processed/`.
|
||||||
5. Atualize o `LOG.md`.
|
5. Atualize o `LOG.md`.
|
||||||
6. Faça commit.
|
6. Faça commit.
|
||||||
7. Rode `git push`.
|
7. Rode `git push`.
|
||||||
|
|
||||||
## Cuidados importantes
|
## Cuidados importantes
|
||||||
|
|
||||||
- Não editar arquivos originais dentro de `raw/`.
|
- Não editar arquivos originais dentro de `db/raw/`.
|
||||||
- Não apagar arquivos de outros colaboradores sem combinar.
|
- Não apagar arquivos de outros colaboradores sem combinar.
|
||||||
- Não subir arquivos temporários do Office, como arquivos começando com `~$`.
|
- Não subir arquivos temporários do Office, como arquivos começando com `~$`.
|
||||||
- Não colocar senhas, tokens ou informações pessoais desnecessárias no repositório.
|
- Não colocar senhas, tokens ou informações pessoais desnecessárias no repositório.
|
||||||
@@ -145,14 +148,17 @@ git push
|
|||||||
|
|
||||||
Já existe um pré-processamento do relatório de ciclo de inspeções da aeronave C-105 matrícula 2805, com data de relatório `2026-06-15`.
|
Já existe um pré-processamento do relatório de ciclo de inspeções da aeronave C-105 matrícula 2805, com data de relatório `2026-06-15`.
|
||||||
|
|
||||||
|
Também existe um primeiro protótipo em `software/oamrp_v1.py`, que formula um modelo MIP compacto em PuLP para atribuir aeronaves a missões de transporte, respeitando continuidade espacial/temporal, turnaround mínimo e limite de horas até inspeção.
|
||||||
|
|
||||||
Arquivos principais:
|
Arquivos principais:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
raw/relatorio_ciclo_inspecoes_c105_2805_2026-06-15.pdf
|
db/raw/relatorio_ciclo_inspecoes_c105_2805_2026-06-15.pdf
|
||||||
pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/preprocess_pdf.py
|
db/pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/preprocess_pdf.py
|
||||||
pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_texto.txt
|
db/pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_texto.txt
|
||||||
pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_inspecoes.json
|
db/pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_inspecoes.json
|
||||||
pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_inspecoes.csv
|
db/pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_inspecoes.csv
|
||||||
|
software/oamrp_v1.py
|
||||||
```
|
```
|
||||||
|
|
||||||
Esse processamento extraiu 18 inspeções e separou campos como inspeção, referência, vencimento, TSO, letra, nível, duração, intervalo por horas de voo, meses contínuos e pousos.
|
Esse processamento extraiu 18 inspeções e separou campos como inspeção, referência, vencimento, TSO, letra, nível, duração, intervalo por horas de voo, meses contínuos e pousos.
|
||||||
|
|||||||
@@ -1,16 +1,17 @@
|
|||||||
# Documentação Técnica — Arara OARMP
|
# Documentação Técnica — Arara OAMRP
|
||||||
|
|
||||||
## O que é
|
## O que é
|
||||||
|
|
||||||
O Arara OARMP é um projeto para organizar dados e documentos usados no planejamento e acompanhamento operacional do Esquadrão Arara, em Manaus.
|
O Arara OAMRP é um projeto para organizar dados, documentos e modelos usados no planejamento e acompanhamento operacional do Esquadrão Arara, em Manaus.
|
||||||
|
|
||||||
O objetivo é construir uma base rastreável para encaixar missões, aeronaves e manutenções, começando pela leitura e estruturação de documentos operacionais e de manutenção.
|
O objetivo é construir uma base rastreável para encaixar missões, aeronaves e manutenções, começando pela leitura e estruturação de documentos operacionais e de manutenção.
|
||||||
|
|
||||||
Nesta fase inicial, o projeto contém:
|
Nesta fase inicial, o projeto contém:
|
||||||
|
|
||||||
- documentos originais em `raw/`;
|
- documentos originais em `db/raw/`;
|
||||||
- scripts e saídas intermediárias em `pre_process/`;
|
- scripts e saídas intermediárias em `db/pre_process/`;
|
||||||
- área reservada para dados finais em `processed/`;
|
- área reservada para dados finais em `db/processed/`;
|
||||||
|
- protótipos de otimização e análise em `software/`;
|
||||||
- documentação de contexto, autoria, mudanças e rastreabilidade.
|
- documentação de contexto, autoria, mudanças e rastreabilidade.
|
||||||
|
|
||||||
## Fontes de dados
|
## Fontes de dados
|
||||||
@@ -21,32 +22,44 @@ Fonte inicial processada:
|
|||||||
|
|
||||||
| Arquivo | Conteúdo | Observação |
|
| Arquivo | Conteúdo | Observação |
|
||||||
| --- | --- | --- |
|
| --- | --- | --- |
|
||||||
| `raw/relatorio_ciclo_inspecoes_c105_2805_2026-06-15.pdf` | Relatório de ciclo de inspeções do equipamento | Aeronave C-105, matrícula 2805, relatório de 2026-06-15 |
|
| `db/raw/relatorio_ciclo_inspecoes_c105_2805_2026-06-15.pdf` | Relatório de ciclo de inspeções do equipamento | Aeronave C-105, matrícula 2805, relatório de 2026-06-15 |
|
||||||
|
|
||||||
Arquivos originais devem permanecer em `raw/` sem edição direta.
|
Arquivos originais devem permanecer em `db/raw/` sem edição direta.
|
||||||
|
|
||||||
## Como funciona
|
## Como funciona
|
||||||
|
|
||||||
O fluxo atual é:
|
O fluxo atual é:
|
||||||
|
|
||||||
1. Guardar documentos originais em `raw/`.
|
1. Guardar documentos originais em `db/raw/`.
|
||||||
2. Executar scripts de extração e padronização em `pre_process/`.
|
2. Executar scripts de extração e padronização em `db/pre_process/`.
|
||||||
3. Gerar saídas intermediárias em texto, JSON e CSV.
|
3. Gerar saídas intermediárias em texto, JSON e CSV.
|
||||||
4. Manter campos originais para rastreabilidade.
|
4. Manter campos originais para rastreabilidade.
|
||||||
5. Separar campos discretos úteis para cálculo, comparação e planejamento.
|
5. Separar campos discretos úteis para cálculo, comparação e planejamento.
|
||||||
6. Registrar mudanças relevantes em `LOG.md`.
|
6. Registrar mudanças relevantes em `LOG.md`.
|
||||||
7. Consolidar dados finais em `processed/` quando os critérios de qualidade estiverem definidos.
|
7. Consolidar dados finais em `db/processed/` quando os critérios de qualidade estiverem definidos.
|
||||||
|
8. Desenvolver protótipos e modelos em `software/`, mantendo dados e código separados.
|
||||||
|
|
||||||
## Pré-processamento atual
|
## Pré-processamento atual
|
||||||
|
|
||||||
O script `pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/preprocess_pdf.py` lê o relatório de ciclo de inspeções em PDF e gera:
|
O script `db/pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/preprocess_pdf.py` lê o relatório de ciclo de inspeções em PDF e gera:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_texto.txt
|
db/pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_texto.txt
|
||||||
pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_inspecoes.json
|
db/pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_inspecoes.json
|
||||||
pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_inspecoes.csv
|
db/pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_inspecoes.csv
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Modelo OAMRP inicial
|
||||||
|
|
||||||
|
O arquivo `software/oamrp_v1.py` contém um protótipo de modelo MIP em PuLP para o Aircraft Routing do Esquadrão Arara. O modelo usa dados sintéticos/substituíveis de aeronaves e missões e busca maximizar o cumprimento ponderado de missões opcionais.
|
||||||
|
|
||||||
|
Restrições representadas no protótipo:
|
||||||
|
|
||||||
|
- continuidade espacial e temporal por aeronave;
|
||||||
|
- turnaround mínimo entre missões;
|
||||||
|
- limite de horas de célula até a próxima inspeção;
|
||||||
|
- base inicial e horas acumuladas reais de cada aeronave como parâmetros de entrada.
|
||||||
|
|
||||||
Campos extraídos e estruturados:
|
Campos extraídos e estruturados:
|
||||||
|
|
||||||
| Campo | Conteúdo |
|
| Campo | Conteúdo |
|
||||||
@@ -97,13 +110,14 @@ Unidades de duração:
|
|||||||
3. Mudanças no formato do relatório podem exigir ajuste no script.
|
3. Mudanças no formato do relatório podem exigir ajuste no script.
|
||||||
4. A grafia original é preservada, inclusive erros existentes no documento fonte.
|
4. A grafia original é preservada, inclusive erros existentes no documento fonte.
|
||||||
5. Ainda não há validação cruzada com outros sistemas ou fontes oficiais.
|
5. Ainda não há validação cruzada com outros sistemas ou fontes oficiais.
|
||||||
6. Ainda não há modelo final em `processed/` para integração completa entre missões, aeronaves e manutenções.
|
6. O modelo em `software/oamrp_v1.py` ainda é protótipo e usa dados de exemplo a substituir por bases reais.
|
||||||
|
7. Ainda não há modelo final em `db/processed/` para integração completa entre missões, aeronaves e manutenções.
|
||||||
|
|
||||||
## Oportunidades de melhoria
|
## Oportunidades de melhoria
|
||||||
|
|
||||||
| Prioridade | Melhoria |
|
| Prioridade | Melhoria |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| Alta | Definir o modelo final de dados em `processed/` |
|
| Alta | Definir o modelo final de dados em `db/processed/` |
|
||||||
| Alta | Criar uma tabela mestre de aeronaves |
|
| Alta | Criar uma tabela mestre de aeronaves |
|
||||||
| Alta | Criar uma tabela mestre de missões |
|
| Alta | Criar uma tabela mestre de missões |
|
||||||
| Alta | Definir regras para cálculo de vencimento por horas, meses e pousos |
|
| Alta | Definir regras para cálculo de vencimento por horas, meses e pousos |
|
||||||
@@ -116,7 +130,7 @@ Unidades de duração:
|
|||||||
|
|
||||||
Se o pré-processamento falhar, verifique:
|
Se o pré-processamento falhar, verifique:
|
||||||
|
|
||||||
- se o PDF existe em `raw/`;
|
- se o PDF existe em `db/raw/`;
|
||||||
- se o nome do arquivo no script corresponde ao arquivo real;
|
- se o nome do arquivo no script corresponde ao arquivo real;
|
||||||
- se as bibliotecas Python necessárias estão instaladas;
|
- se as bibliotecas Python necessárias estão instaladas;
|
||||||
- se o layout do PDF mudou;
|
- se o layout do PDF mudou;
|
||||||
@@ -125,5 +139,5 @@ Se o pré-processamento falhar, verifique:
|
|||||||
Para reexecutar o pré-processamento:
|
Para reexecutar o pré-processamento:
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
python pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/preprocess_pdf.py
|
python db/pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15/preprocess_pdf.py
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -10,16 +10,16 @@
|
|||||||
|
|
||||||
## Instituição e contexto
|
## Instituição e contexto
|
||||||
|
|
||||||
Projeto desenvolvido para apoiar o OARMP do Esquadrão Arara, em Manaus, com organização colaborativa em repositório Git.
|
Projeto desenvolvido para apoiar o OAMRP do Esquadrão Arara, em Manaus, com organização colaborativa em repositório Git.
|
||||||
|
|
||||||
## Como contribuir
|
## Como contribuir
|
||||||
|
|
||||||
Ao modificar ou estender este projeto:
|
Ao modificar ou estender este projeto:
|
||||||
|
|
||||||
1. Atualize sua cópia com `git pull` antes de começar.
|
1. Atualize sua cópia com `git pull` antes de começar.
|
||||||
2. Preserve documentos originais em `raw/`.
|
2. Preserve documentos originais em `db/raw/`.
|
||||||
3. Coloque scripts e saídas intermediárias em `pre_process/`.
|
3. Coloque scripts e saídas intermediárias em `db/pre_process/`.
|
||||||
4. Coloque resultados finais e validados em `processed/`.
|
4. Coloque resultados finais e validados em `db/processed/`.
|
||||||
5. Registre mudanças operacionais em `LOG.md`.
|
5. Registre mudanças operacionais em `LOG.md`.
|
||||||
6. Registre mudanças de versão em `docs/changelog.md` quando houver alteração significativa.
|
6. Registre mudanças de versão em `docs/changelog.md` quando houver alteração significativa.
|
||||||
7. Identifique o autor usando a tag do colaborador: `VTO`, `GNR` ou `JOM`.
|
7. Identifique o autor usando a tag do colaborador: `VTO`, `GNR` ou `JOM`.
|
||||||
@@ -39,6 +39,7 @@ Ao modificar ou estender este projeto:
|
|||||||
|
|
||||||
| Versão | Autor | Data | Descrição resumida |
|
| Versão | Autor | Data | Descrição resumida |
|
||||||
| --- | --- | --- | --- |
|
| --- | --- | --- | --- |
|
||||||
|
| v0.2 | VTO | 2026-06 | Reorganização dos dados em `db/`, criação de `software/` e inclusão do protótipo MIP `oamrp_v1.py` |
|
||||||
| v0.1 | VTO | 2026-06 | Estrutura inicial, documentação, pré-processamento do primeiro relatório de inspeções e migração para o repositório `arara_oarmp` |
|
| v0.1 | VTO | 2026-06 | Estrutura inicial, documentação, pré-processamento do primeiro relatório de inspeções e migração para o repositório `arara_oarmp` |
|
||||||
|
|
||||||
Contribuidores futuros devem adicionar uma linha nesta tabela e criar a entrada correspondente em `docs/changelog.md`.
|
Contribuidores futuros devem adicionar uma linha nesta tabela e criar a entrada correspondente em `docs/changelog.md`.
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# Changelog
|
# Changelog
|
||||||
|
|
||||||
Todas as versões significativas do Arara OARMP devem ser registradas aqui. O `LOG.md` guarda o diário operacional detalhado; este arquivo resume mudanças por versão.
|
Todas as versões significativas do Arara OAMRP devem ser registradas aqui. O `LOG.md` guarda o diário operacional detalhado; este arquivo resume mudanças por versão.
|
||||||
|
|
||||||
Formato:
|
Formato:
|
||||||
|
|
||||||
@@ -14,6 +14,22 @@ Formato:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## v0.2 — VTO — 2026-06
|
||||||
|
|
||||||
|
### Adicionado
|
||||||
|
|
||||||
|
- Diretório `software/` com o primeiro protótipo `software/oamrp_v1.py`.
|
||||||
|
- Modelo MIP compacto em PuLP para atribuição de aeronaves a missões opcionais.
|
||||||
|
- Regras de `.gitignore` para caches Python.
|
||||||
|
|
||||||
|
### Alterado
|
||||||
|
|
||||||
|
- Estrutura de dados reorganizada para `db/raw/`, `db/pre_process/` e `db/processed/`.
|
||||||
|
- Documentação atualizada para refletir a separação entre dados (`db/`) e modelos (`software/`).
|
||||||
|
- Nome técnico do projeto padronizado como Arara OAMRP nos documentos principais.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## v0.1 — VTO — 2026-06
|
## v0.1 — VTO — 2026-06
|
||||||
|
|
||||||
### Adicionado
|
### Adicionado
|
||||||
|
|||||||
Reference in New Issue
Block a user