Metodologia de Organização: mudanças entre as edições

De Urb608
Ir para navegação Ir para pesquisar
Urb608 (discussão | contribs)
Editor (discussão | contribs)
 
(8 revisões intermediárias por um outro usuário não estão sendo mostradas)
Linha 1: Linha 1:
= Metodologia de Organização da pasta urb608 no File Browser =
= Organização da pasta urb608 =


A pasta '''urb608''' deve funcionar como um repositório organizado de materiais de pesquisa, apoio documental e produção vinculada ao ambiente da '''wiki URB608'''.
A pasta '''urb608''' deve funcionar como um repositório organizado de materiais de pesquisa, apoio documental e produção vinculada ao ambiente da '''wiki URB608'''.
Linha 31: Linha 31:
A pasta poderá ser acessada pelo navegador em:
A pasta poderá ser acessada pelo navegador em:


[http://150.164.107.115/upload/urb608/ http://150.164.107.115/upload/urb608/]
http://150.164.107.115/upload/files
 
Exemplo de arquivo salvo:
 
<pre>
urb608/02_legislacao/plano_diretor_bh_2019.pdf
</pre>
 
Link correspondente:
 
[http://150.164.107.115/upload/urb608/02_legislacao/plano_diretor_bh_2019.pdf http://150.164.107.115/upload/urb608/02_legislacao/plano_diretor_bh_2019.pdf]


== 3. Função de cada pasta ==
== 3. Função de cada pasta ==
Linha 88: Linha 78:
├── estilos_qml/
├── estilos_qml/
├── layouts/
├── layouts/
└── backups/
</pre>
</pre>


Linha 124: Linha 113:
<pre>
<pre>
08_audio_video/
08_audio_video/
├── entrevistas_audio/
├── externo/
├── entrevistas_video/
├── campo/
├── campo/
├── transcricoes/
└── editados/
└── editados/
</pre>
</pre>
Linha 138: Linha 125:
09_producao/
09_producao/
├── textos/
├── textos/
├── artigos/
├── relatorios/
├── relatorios/
├── apresentacoes/
├── apresentacoes/
├── tabelas/
├── tabelas/
└── figuras/
├── modelagem_3d/
├── photoshop/
├── af/
</pre>
</pre>


Linha 155: Linha 143:
├── dados_abertos/
├── dados_abertos/
├── mapas_publicados/
├── mapas_publicados/
└── material_site/
</pre>
</pre>


Linha 163: Linha 150:


<pre>
<pre>
AAAA-MM-DD_tema_descricao_v01.ext
AAAA-MM-DD-tema-descricao-v01-setor01.ext
AAAA-MM-DD-tema-descricao-v01-grupo01.ext
</pre>
</pre>


Exemplos:
Exemplos:


<pre>
<pre>2026-05-13-base-estacoes-metro-bh-v01-setor01.gpkg
2026-05-13_urb608_estrutura_organizacao_v01.md
2026-05-13-base-estacoes-metro-bh-v01-grupo01.gpkg</pre>
2026-05-13_plano_diretor_bh_2019_v01.pdf
2026-05-13_base_estacoes_metro_bh_v01.gpkg
2026-05-13_mapa_acessibilidade_estacoes_bh_v01.pdf
2026-05-13_entrevista_tecnico_mobilidade_audio_v01.mp3
</pre>


Evitar:
Evitar:


<pre>
<pre>Mapa final.pdf
Mapa final.pdf
Relatório novo corrigido.docx
Relatório novo corrigido.docx
Base atualizada última versão.gpkg
Base atualizada última versão.gpkg</pre>
</pre>


Preferir:
Preferir:


<pre>
<pre>
2026-05-13_mapa_rede_metroferroviaria_bh_v03.pdf
2026-05-13-relatorio-mobilidade-metropolitana-v02-setor04.docx
2026-05-13_relatorio_mobilidade_metropolitana_v02.docx
2026-05-13-relatorio-mobilidade-metropolitana-v02-grupo04.docx
2026-05-13_base_rede_metroferroviaria_bh_v04.gpkg
</pre>
</pre>


== 5. Regras práticas de organização ==
== 5. Regras práticas de organização ==
1. '''Nunca apagar o arquivo bruto.''' Dados originais devem ficar em <code>04_dados/bruto/</code>.


# '''Nunca apagar o arquivo bruto.''' Dados originais devem ficar em <code>04_dados/bruto/</code>.
2. '''Separar arquivo bruto de arquivo tratado.''' Dados corrigidos, filtrados ou editados devem ficar em <code>04_dados/tratado/</code>.
# '''Separar arquivo bruto de arquivo tratado.''' Dados corrigidos, filtrados ou editados devem ficar em <code>04_dados/tratado/</code>.
# '''Arquivos QGIS devem ficar concentrados em <code>05_qgis/</code>.''' Projetos <code>.qgz</code>, estilos <code>.qml</code>, layouts e camadas auxiliares devem ser mantidos juntos.
# '''Mapas exportados devem ir para <code>06_mapas/</code>.''' Separar PDF, PNG, SVG e versões para impressão.
# '''Imagens de campo devem ter data e local no nome.''' Exemplo:


<pre>
3. '''Arquivos QGIS devem ficar concentrados em <code>05_qgis/</code>.''' Projetos <code>.qgz</code>, estilos <code>.qml</code>, layouts e camadas auxiliares devem ser mantidos juntos.
2026-05-13_serra-do-curral_vegetacao_001.jpg
</pre>6. '''Materiais finais não devem ficar misturados com rascunhos.''' Versões finais devem ir para <code>10_publicacao/</code>.


7.'''Todo projeto ou conjunto de arquivos deve ter um README.''' O arquivo <code>README.md</code> deve explicar o conteúdo da pasta e o padrão usado.
4. '''Mapas exportados devem ir para <code>06_mapas/</code>.''' Separar PDF, PNG, SVG e versões para impressão.


== 6. Modelo de README.md ==
5. '''Imagens de campo devem ter data e local no nome.''' Exemplo:


Criar na raiz:
<pre>
2026-05-13-serra-do-curral-vegetacao-001.jpg
</pre>6. '''Materiais finais não devem ficar misturados com rascunhos.''' Versões finais devem ir para <code>10_publicacao/</code>.


[http://150.164.107.115/upload/urb608/README.md http://150.164.107.115/upload/urb608/README.md]
== 6. README.md ==


Conteúdo sugerido:
CO arquivo <code>README.md</code> é um documento de texto em formato Markdown utilizado para descrever e organizar o conteúdo de uma pasta ou projeto. Sua função é explicar a estrutura dos arquivos, os padrões utilizados, as convenções de nomenclatura, os softwares empregados e outras informações importantes para a equipe.


<pre>
O README funciona como uma documentação rápida da pasta, facilitando a compreensão, manutenção e organização dos arquivos em projetos colaborativos.<pre>
# URB608 — Organização de Arquivos
# URB608 — Organização de Arquivos


Linha 232: Linha 209:
- 06_mapas: mapas exportados em PDF, PNG, SVG e outros formatos.
- 06_mapas: mapas exportados em PDF, PNG, SVG e outros formatos.
- 07_imagens: fotografias, imagens de campo, diagramas e capturas de tela.
- 07_imagens: fotografias, imagens de campo, diagramas e capturas de tela.
- 08_audio_video: áudios, vídeos, entrevistas e transcrições.
- 08_audio_video: áudios e vídeos.
- 09_producao: textos, relatórios, artigos e apresentações em elaboração.
- 09_producao: textos, relatórios, modelagens e apresentações em elaboração.
- 10_publicacao: versões finais e materiais publicados.
- 10_publicacao: versões finais e materiais publicados.


## Padrão de nomes
## Padrão de nomes
AAAA-MM-DD_tema_descricao_v01.ext
AAAA-MM-DD-tema-descricao-v01-setor01.ext


## Regras principais
## Regras principais
Linha 247: Linha 224:
</pre>
</pre>


== 7. Comando para criar a estrutura no servidor ==
== 7. Síntese da metodologia ==
 
A partir do terminal do servidor:
 
<syntaxhighlight lang="bash">
mkdir -p /var/www/html/upload/urb608/{00_admin,01_referencias,02_legislacao,03_documentos,04_dados/{bruto,tratado,tabelas,geodados,metadados},05_qgis/{projetos_qgz,camadas,estilos_qml,layouts,backups},06_mapas/{png,pdf,svg,georreferenciados,impressao},07_imagens/{campo,satelite,diagramas,capturas_tela,editadas,ia_geradas},08_audio_video/{entrevistas_audio,entrevistas_video,campo,transcricoes,editados},09_producao/{textos,artigos,relatorios,apresentacoes,tabelas,figuras},10_publicacao/{versao_final,anexos,dados_abertos,mapas_publicados,material_site}}
</syntaxhighlight>
 
Criar o README:
 
<syntaxhighlight lang="bash">
nano /var/www/html/upload/urb608/README.md
</syntaxhighlight>
 
== 8. Síntese da metodologia ==


A pasta '''urb608''' deve ser organizada como um repositório de pesquisa com separação clara entre fontes, dados, arquivos de trabalho, mapas, imagens, mídias, produção textual e materiais finais.
A pasta '''urb608''' deve ser organizada como um repositório de pesquisa com separação clara entre fontes, dados, arquivos de trabalho, mapas, imagens, mídias, produção textual e materiais finais.

Edição atual tal como às 14h53min de 19 de junho de 2026

Organização da pasta urb608

A pasta urb608 deve funcionar como um repositório organizado de materiais de pesquisa, apoio documental e produção vinculada ao ambiente da wiki URB608.

A ideia principal é separar arquivos por função: documentos administrativos, referências, legislação, dados, QGIS, mapas, imagens, áudio, vídeo e materiais finais.

Endereço-base da pasta:

http://150.164.107.115/upload/urb608/

1. Estrutura recomendada

urb608/
├── 00_admin/
├── 01_referencias/
├── 02_legislacao/
├── 03_documentos/
├── 04_dados/
├── 05_qgis/
├── 06_mapas/
├── 07_imagens/
├── 08_audio_video/
├── 09_producao/
├── 10_publicacao/
└── README.md

2. Endereço de acesso

A pasta poderá ser acessada pelo navegador em:

http://150.164.107.115/upload/files

3. Função de cada pasta

00_admin/

Para editais, termos de referência, autorizações, atas, cronogramas, orçamentos e documentos administrativos.

01_referencias/

Para artigos, livros, capítulos, relatórios técnicos, bibliografia em PDF, fichamentos e textos de apoio.

02_legislacao/

Para leis, decretos, planos diretores, resoluções, normas técnicas, portarias, pareceres e documentos institucionais.

03_documentos/

Para documentos gerais da pesquisa, entrevistas transcritas, notas de campo, formulários, planilhas de acompanhamento e registros internos.

04_dados/

Para bases de dados brutas e tratadas.

Estrutura sugerida:

04_dados/
├── bruto/
├── tratado/
├── tabelas/
├── geodados/
└── metadados/

05_qgis/

Para arquivos de trabalho do QGIS.

Estrutura sugerida:

05_qgis/
├── projetos_qgz/
├── camadas/
├── estilos_qml/
├── layouts/

06_mapas/

Para mapas exportados.

06_mapas/
├── png/
├── pdf/
├── svg/
├── georreferenciados/
└── impressao/

07_imagens/

Para fotografias, imagens de campo, capturas de tela, imagens de satélite, diagramas e imagens editadas.

07_imagens/
├── campo/
├── satelite/
├── diagramas/
├── capturas_tela/
├── editadas/
└── ia_geradas/

08_audio_video/

Para áudios, vídeos, entrevistas, registros de campo e transcrições.

08_audio_video/
├── externo/
├── campo/
└── editados/

09_producao/

Para materiais em elaboração.

09_producao/
├── textos/
├── relatorios/
├── apresentacoes/
├── tabelas/
├── modelagem_3d/
├── photoshop/
├── af/

10_publicacao/

Para materiais finais ou prontos para divulgação.

10_publicacao/
├── versao_final/
├── anexos/
├── dados_abertos/
├── mapas_publicados/

4. Regra simples de nomeação dos arquivos

Usar sempre o padrão:

AAAA-MM-DD-tema-descricao-v01-setor01.ext
AAAA-MM-DD-tema-descricao-v01-grupo01.ext

Exemplos:

2026-05-13-base-estacoes-metro-bh-v01-setor01.gpkg
2026-05-13-base-estacoes-metro-bh-v01-grupo01.gpkg

Evitar:

Mapa final.pdf
Relatório novo corrigido.docx
Base atualizada última versão.gpkg

Preferir:

2026-05-13-relatorio-mobilidade-metropolitana-v02-setor04.docx
2026-05-13-relatorio-mobilidade-metropolitana-v02-grupo04.docx

5. Regras práticas de organização

1. Nunca apagar o arquivo bruto. Dados originais devem ficar em 04_dados/bruto/.

2. Separar arquivo bruto de arquivo tratado. Dados corrigidos, filtrados ou editados devem ficar em 04_dados/tratado/.

3. Arquivos QGIS devem ficar concentrados em 05_qgis/. Projetos .qgz, estilos .qml, layouts e camadas auxiliares devem ser mantidos juntos.

4. Mapas exportados devem ir para 06_mapas/. Separar PDF, PNG, SVG e versões para impressão.

5. Imagens de campo devem ter data e local no nome. Exemplo:

2026-05-13-serra-do-curral-vegetacao-001.jpg

6. Materiais finais não devem ficar misturados com rascunhos. Versões finais devem ir para 10_publicacao/.

6. README.md

CO arquivo README.md é um documento de texto em formato Markdown utilizado para descrever e organizar o conteúdo de uma pasta ou projeto. Sua função é explicar a estrutura dos arquivos, os padrões utilizados, as convenções de nomenclatura, os softwares empregados e outras informações importantes para a equipe.

O README funciona como uma documentação rápida da pasta, facilitando a compreensão, manutenção e organização dos arquivos em projetos colaborativos.

# URB608 — Organização de Arquivos

## Descrição
Esta pasta reúne documentos, dados, imagens, mapas, arquivos QGIS, legislação, referências e materiais de produção associados ao ambiente da wiki URB608.

## Endereço-base
http://150.164.107.115/upload/urb608/

## Estrutura
- 00_admin: documentos administrativos.
- 01_referencias: artigos, livros, relatórios e bibliografia.
- 02_legislacao: leis, decretos, planos, normas e documentos institucionais.
- 03_documentos: documentos gerais da pesquisa.
- 04_dados: bases brutas, tratadas, tabelas, geodados e metadados.
- 05_qgis: projetos, camadas, estilos, layouts e backups do QGIS.
- 06_mapas: mapas exportados em PDF, PNG, SVG e outros formatos.
- 07_imagens: fotografias, imagens de campo, diagramas e capturas de tela.
- 08_audio_video: áudios e vídeos.
- 09_producao: textos, relatórios, modelagens e apresentações em elaboração.
- 10_publicacao: versões finais e materiais publicados.

## Padrão de nomes
AAAA-MM-DD-tema-descricao-v01-setor01.ext

## Regras principais
1. Manter arquivos brutos separados dos arquivos tratados.
2. Não apagar arquivos originais.
3. Usar nomes sem espaços, sem acentos e com data.
4. Registrar versões com v01, v02, v03.
5. Colocar materiais finais apenas em 10_publicacao.

7. Síntese da metodologia

A pasta urb608 deve ser organizada como um repositório de pesquisa com separação clara entre fontes, dados, arquivos de trabalho, mapas, imagens, mídias, produção textual e materiais finais.

A regra principal é:

bruto fica em bruto;
tratado fica em tratado;
QGIS fica em QGIS;
mapa exportado fica em mapas;
produto final fica em publicação;
todo arquivo tem data, tema e versão.