okfn-brasil/oficial-backups

backup de arquivos comuns da produção da OKBR

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.

oficial-backups's Issues

Gerenciar informações da infraestrutura

A informação pode ser mantida aqui neste git, ou em algum git adicional. No passado foi essa página de Wiki

https://wiki.okfn.org/Open_Knowledge_Brasil/Mapa_de_infraestrutura

... O ideal seria retomar o uso de Mediawiki centralizando todo o conhecimento estratégico da organização. Não requer publicidade (evita exposição de rascunhos e risco de login indevido), basta que todos os membros tenham acesso e que os backups sejam públicos.

Usar padrao SHA3

Ver https://github.com/okfn-brasil/discussOKBr-assets/blob/master/base58perl.pl

Uso exemplo, depois de chmod 777 base58perl.pl,

cd pasta_dos_arquivos_desejados
~/gits/discussOKBr-assets/base58perl.pl

grava por cima do arquivo anterior.

Nova alternativa para (ou dispensar totalmente) a geração de chucksum

Atualmente o README.md diz ser obrigatório refazer o checksum quando adicionamos arquivos. Essa etapa como obrigatória é problemática demais pois:

• cria uma barreira tecnológica imensa: nem todos do time tem perfil técnico para instalar as ferramentas, entender e executar o processo;
• as instruções dependem do sha3sum que tem que ser compilado manualmente no macOS, assim como sua dependência libkeccak;
• o processo no macOS duplicaria dependências do sistema operacional.

Fica aqui uma discussão sobre os dois últimos pontos.

Compreendo os motivos linkados no README.md, mas a medida, como implementada, atrapalha o fluxo de trabalho da equipe ao invés de ajudar.

Resolver questão da data

Definitivamente o git não oferece garantia sobre as datas. Uma forma de garantir é submetendo os arquivos the checksum (sha3-256sum.b58btc.txt de cada pasta) ao datador https://opentimestamps.org/
ou seja, submetendo à datação e gravando também o arquivo sha3-256sum.b58btc.txt.ots.

---

PS: este repositório tem arquivos1970 e future-max mostrando o mais antigo e mais futuro possível. Para detalhes de como manipular datas, ver alexpeattie/working-with-dates-in-git.
Alguma informação confiável (ex. data de criação do repo) pode vir da API do Github.

Novo nome para este repositório

Conforme diretiva #15 do Suporte OKBr (PURL suporte.ok.org.br/ticket/15), este repositório deixa de se chamar "discussOKBr-assets" e passa a se chamar "oficial-backups".