backup de arquivos comuns da produção da OKBR
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
data
docs
imgs
README.md
datapackage.json
metodologia.md
sha3-base58.pl

README.md

Backup oficial da OKBr

Backup de arquivos publicados no Diário Oficial da OKBr e dos demais subsídios para o blog, o DiscussOKBr, etc. Repositório público para preservação digital e garantia de autenticidade dos documentos e demais fontes oficiais da OKBr.

Objetivos

Servir de referência autoritativa para consultas, downloads e auditoria dos documentos da e sob tutela da OKBr.

Arquivos são armazenados neste repositório com a finalidade de preservar, com integridade e autenticidade garantidos, cópias de dados oficiais, jurídicos e administrativos da OKBr. O repositório tem como finalidade armazenar:

  • metadados e indicativos de licenças e créditos das publicações da OKBr (blog, DiscussOKBr, Facebook e canal Medium).
  • códigos-fonte de ilustrações (para constar origem ou licenças), e de anexos (ex. PDFs originais).
  • dados e contedos fiscais (ex. notas fiscais eletrônicas, romaneios e faturas).
  • metadados relativos ao "patrimônio da OKBr" e à infraestrutura de sua manutenção.
  • backups dos conteúdos oficiais: Diário Oficial da Organização (arquivos RSS do Discourse) e Blog (arquivos XML RSS do Wordpress).

Dados e conteúdos que satisfaçam esses critérios, mas por seu tamanho (mais de ~200Mb) não puderem ser mantidos neste repositório, devem ser armazenados no okfn-brasil/oficial-backupsbig. Exemplo típico são os vídeos de assembleias e reuniões da OKBr.

Procedimentos

Conforme a pasta onde for efetuada alteração, conferir na "pasta raiz" o respectivo README de procedimentos. São apenas três tipos de procedimento:

  • Documentos (pasta docs): atenção para os procedimentos relativos ao DOO (Diário Oficial da OKBr), que em geral demandam uso concomitante das demais pastas.

  • Ilustrações (pasta imgs): atenção para a demanda por atualização nos metadados (pasta data)

  • Dados (pasta data): podem ser metadados, descrevendo objeto postado em outra pasta, ou dados brutos da OKBr.

No futuro esse processo será automatizado (CKAN?), mas por hora se for necessário haverá recurso humano sendo pago para manter o repositório em ordem.

Checksums

Uso obrigatório em todas as pastas. Depois de atualizado com novos arquivos, antes de fazer o git add da pasta alterada, rodar sha3-base58.pl na pasta. Exemplo:

cd docs/okbr-oficial
../../sha3-base58.pl

As justificativas detalhadas para o uso deste algoritmo de checksum se encontram descritas na Wiki.