159 lines
4.9 KiB
Markdown
159 lines
4.9 KiB
Markdown
# Arara OARMP
|
|
|
|
Este repositório organiza os arquivos e processamentos do projeto Arara OARMP 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.
|
|
|
|
## O que é um repositório
|
|
|
|
Um repositório é uma pasta controlada pelo Git. Ele guarda os arquivos do projeto e também o histórico de alterações.
|
|
|
|
O Gitea do PPGAO/ITA é o site onde esse repositório fica hospedado de forma privada, para que os colaboradores possam acessar, baixar, atualizar e enviar contribuições.
|
|
|
|
Na prática:
|
|
|
|
- o Git mostra o que mudou;
|
|
- o Gitea permite compartilhar o projeto;
|
|
- os commits são registros das alterações feitas;
|
|
- o `LOG.md` explica o motivo e o contexto das mudanças importantes.
|
|
|
|
## Estrutura do projeto
|
|
|
|
```text
|
|
arara_oarmp/
|
|
raw/
|
|
pre_process/
|
|
processed/
|
|
docs/
|
|
CONTEXTO.md
|
|
LOG.md
|
|
README.md
|
|
```
|
|
|
|
- `raw/`: documentos originais. Não editar esses arquivos diretamente.
|
|
- `pre_process/`: scripts e arquivos intermediários gerados a partir dos documentos originais.
|
|
- `processed/`: arquivos finais, limpos e prontos para análise ou uso.
|
|
- `docs/`: documentação técnica, autoria e histórico de versões.
|
|
- `CONTEXTO.md`: regras, combinados e orientações permanentes do projeto.
|
|
- `LOG.md`: histórico rastreável das ações feitas no projeto.
|
|
- `README.md`: este guia inicial.
|
|
|
|
## Colaboradores
|
|
|
|
Usamos tags curtas para identificar quem fez cada alteração relevante:
|
|
|
|
- `VTO`: Vitor Cesa.
|
|
- `GNR`: Generoso.
|
|
- `JOM`: João Marcos.
|
|
|
|
Sempre que alguém fizer uma mudança importante, deve registrar no `LOG.md` com data, hora, tag do autor, ação, arquivos e observações.
|
|
|
|
## Como usar pelo site do Gitea
|
|
|
|
Este caminho é bom para quem só quer ver arquivos, baixar documentos ou conferir o histórico.
|
|
|
|
1. Abra o repositório no Gitea do PPGAO/ITA.
|
|
2. Entre nas pastas para ver os arquivos.
|
|
3. Use `raw/` para consultar documentos originais.
|
|
4. Use `pre_process/` para consultar arquivos intermediários.
|
|
5. Use `processed/` para consultar dados finais quando existirem.
|
|
6. Abra o `LOG.md` para entender o que já foi feito.
|
|
7. Abra o `CONTEXTO.md` para ver os combinados do projeto.
|
|
|
|
Para baixar um arquivo pelo site:
|
|
|
|
1. Clique no arquivo.
|
|
2. Clique em `Download raw file` ou no botão de download.
|
|
3. Salve no computador.
|
|
|
|
## Documentação
|
|
|
|
- `docs/about.md`: descrição técnica, fluxo de dados, limitações e oportunidades de melhoria.
|
|
- `docs/authors.md`: autoria, colaboradores e regras de contribuição.
|
|
- `docs/changelog.md`: histórico resumido de versões significativas.
|
|
- `LOG.md`: diário operacional detalhado.
|
|
|
|
## Como usar no computador
|
|
|
|
Este caminho é para quem vai mexer nos arquivos e devolver alterações ao Gitea.
|
|
|
|
Primeiro, instale o Git:
|
|
|
|
```powershell
|
|
git --version
|
|
```
|
|
|
|
Se o comando não funcionar, o Git ainda não está instalado.
|
|
|
|
Depois, clone o repositório:
|
|
|
|
```powershell
|
|
git clone https://git.ppgao.ita.br/vitorcesavc/arara_oarmp.git
|
|
cd arara_oarmp
|
|
```
|
|
|
|
Antes de começar a trabalhar, atualize sua cópia:
|
|
|
|
```powershell
|
|
git pull
|
|
```
|
|
|
|
Depois de alterar arquivos, veja o que mudou:
|
|
|
|
```powershell
|
|
git status
|
|
```
|
|
|
|
Adicione os arquivos modificados:
|
|
|
|
```powershell
|
|
git add .
|
|
```
|
|
|
|
Crie um commit com uma mensagem curta:
|
|
|
|
```powershell
|
|
git commit -m "Descreva a alteração feita"
|
|
```
|
|
|
|
Envie para o Gitea:
|
|
|
|
```powershell
|
|
git push
|
|
```
|
|
|
|
## Fluxo recomendado de trabalho
|
|
|
|
1. Rode `git pull` antes de começar.
|
|
2. Coloque documentos novos em `raw/`.
|
|
3. Gere arquivos intermediários em `pre_process/`.
|
|
4. Coloque resultados finais em `processed/`.
|
|
5. Atualize o `LOG.md`.
|
|
6. Faça commit.
|
|
7. Rode `git push`.
|
|
|
|
## Cuidados importantes
|
|
|
|
- Não editar arquivos originais dentro de `raw/`.
|
|
- Não apagar arquivos de outros colaboradores sem combinar.
|
|
- 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.
|
|
- Preferir nomes de arquivo descritivos, com tipo do documento, aeronave, matrícula e data quando possível.
|
|
- Registrar no `LOG.md` qualquer decisão que afete os dados.
|
|
|
|
## Estado atual
|
|
|
|
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`.
|
|
|
|
Arquivos principais:
|
|
|
|
```text
|
|
raw/relatorio_ciclo_inspecoes_c105_2805_2026-06-15.pdf
|
|
pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_texto.txt
|
|
pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_inspecoes.json
|
|
pre_process/relatorio_ciclo_inspecoes_c105_2805_2026-06-15_inspecoes.csv
|
|
pre_process/preprocess_pdf.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.
|