NPDD/Baobáxia/Arquitetura - Histórico de revisão

Vince em 19h46min de 6 de outubro de 2024

2024-10-06T19:46:57Z

Mostrar alterações

Vince em 22h19min de 2 de fevereiro de 2024

2024-02-02T22:19:05Z

Fernao: /* API / Rotas de acesso */

2014-09-16T18:38:50Z

API / Rotas de acesso

Fernao em 18h38min de 16 de setembro de 2014

2014-09-16T18:38:31Z

Fernao: /* API / Rotas de acesso */

2014-07-29T18:06:14Z

API / Rotas de acesso

Fernao: /* Atualização - 06/06/2014 */

2014-07-09T21:31:01Z

Atualização - 06/06/2014

Fernao: /* Atualização - 06/06/2014 */

2014-07-09T21:26:49Z

Atualização - 06/06/2014

Fernao: related media

2014-07-09T20:57:20Z

related media

Fernao em 17h57min de 6 de junho de 2014

2014-06-06T17:57:39Z

Fernao: /* Middleware */ atualizando urls da arquitetura

2014-06-06T17:54:37Z

Middleware: atualizando urls da arquitetura

← Edição anterior		Edição das 22h19min de 2 de fevereiro de 2024
Linha 1:		Linha 1:
		+	= Conceitos gerais =
		+
		+	Baobáxia pode ser compreendida como uma plataforma de compartilhamento de '''saberes''' de comunidades dentro de uma rota de confiança.
		+
		+	Este artigo apresenta os principais conceitos da Baobáxia, tanto do ponto de vista de usuáries quando do ponto de vista técnico.
		+
		+
		+	:'''Tecnicamente falando''', Baobáxia é uma aplicação desenvolvida em Python que gerencia repositórios Git de forma descentralizada, distribuindo conteúdo entre instâncias a partir da criação de rotas de confiança, atuando de forma descentralizada, federada e rizomática.
		+
		+
		+	== Saberes ==
		+
		+	São conhecimentos da comunidade representados dentro da plataforma, como seu acervo cultural ou um artigo escrito por seus integrantes. Um saber pode conter em si informações, arquivos e até mesmo outros saberes.
		+
		+
		+	:'''Tecnicamente falando''', Saber se apresenta como uma pasta e um arquivo de metadados (chamado de ".baobaxia") em formato JSON. O arquivo de metadados contém informações gerais de identificação e específicas de acordo com o tipo de saber. Por exemplo, se o saber é um item de um acervo cultural, precisará de título, descrição, conjunto de tags e outras informações que facilitem sua organização. Dentro da pasta do saber também podem ser armazenados arquivos anexos (gerenciados pelo git-annex), como a mídia correspondente ao item de acervo, no exemplo anterior. A pasta também pode conter arquivos de hipertexto, por exemplo, se o saber é um artigo, com o conteúdo do artigo. Pode haver ali também outros saberes criando uma relação de composição.
		+
		+
		+	== Mucuas ==
		+
		+	São as unidades que compõe a Baobáxia, as instâncias que rodam a plataforma e nas quais usuáries conectam-se para acessar a rede. Podem ser compreendidas como parte de um território digital. Além de acessar e gerenciar saberes da pŕopria comunidade, as mucuas também refletem os saberes de outras mucuas.
		+
		+
		+	:'''Tecnicamente falando''', Mucua pode ser compreendida tanto como uma instância da Baobáxia rodando em uma infraestrutura de rede quanto como conjunto de dados tutelados através daquela instância. A mucua é também um saber, tendo sua pasta específico com o arquivo de metadados e os saberes que constituem aquele conjunto de dados.
		+
		+
		+	== Balaios ==
		+
		+	São grupos de mucuas definidos como universos de saberes. Por exemplo, o balaio chamado Rede Mocambos pode agregar mucuas das diversas comunidades envolvidas na luta desta rede. Além disso, uma mucua pode participar de mais do que um balaio. Assim, a mucua Abdias pode fazer parte do balaio Rede Mocambos e também de um outro chamado Rota dos Baobás, por exemplo. Em cada balaio, a mucua terá saberes específicos que pode não compartilhar em outros balaios.
		+
		+
		+	:'''Tecnicamente falando''', Balaio é um repositório git + git-annex compartilhado entre um grupo de instâncias. Também são saberes e portanto possuem metadados em uma pasta (a pasta do repositório) onde estarão as pastas das mucuas. Dessa forma, cada mucua tem sua pasta específica dentro do repositório.
		+
		+
		+	== Rotas ==
		+
		+	São conexões entre mucuas de um mesmo balaio. Por exemplo, a mucua DPadua, também dentro do balaio Rede Mocambos, possui uma rota para a mucua Abdias. Desta forma, a mucua DPadua pode conectar a mucua Abdias para fazer a troca de saberes. A partir daí, Abdias e DPadua passam a compartilhar saberes uma da outra. Assim, se houver uma rota de Abdias para a mucua Oyá, esta última poderá receber o conteúdo de DPádua, mesmo sem que haja uma rota direta entre as duas.
		+
		+
		+	:'''Tecnicamente falando''', Rotas são conexões SSH previamente autorizadas por chave pública que são criadas para fazer a sincronização (pull e push) entre instâncias do mesmo repositório (balaio). A mucua que possui a rota (autorização e dados de conexão) conecta outra mucua e faz as operações, de modo que a segunda mucua não precisa conhecer aquela rota ou estar autorizada para conectar a primeira mucua.
		+
		+
		+
		+	= Documentação antiga =
	== Configuração do Repositório ==		== Configuração do Repositório ==

@@ Linha 123: / Linha 123: @@
 /[repo]/[mucua]/addgroup/[groupname]                 # add mucua to [groupname]
 /[repo]/[mucua]/delgroup/[groupname]                 # remove mucua from [groupname]
-/[repo]/[mucua]getgroups (sem t:)  - todos os grupos da mucua
+/[repo]/[mucua]/getgroups (sem t:)  - todos os grupos da mucua
 /[repo]/[mucua]/getterritory (somente t:)  - todos os territórios da mucua
 /mucua/                                # get default mucua

@@ Linha 100: / Linha 100: @@
 ==== API / Rotas de acesso ====
 <pre>
@@ Linha 123: / Linha 121: @@
 /[repo]/[mucua]/info                            # ver + infos sobre a mucua
 /[repo]/[mucua]/requests                        # ver requisições da mucua
 # home da rede
@@ Linha 139: / Linha 143: @@
 # funcionalidades básicas para definição de escopo
-/repository/list                          # lista repositorios disponíveis
+/repository/list                          # lista repositorios disponíveis (buggy)
 /repository/*                          # get default repository
-/[repo]/mucuas                         # get mucuas
+/[repository]/mucuas                         # get mucuas
 # busca
-/[repo]/[mucua]/bbx/search/[arg1]/[arg2]/...  # busca por args
+/[repo]/[mucua]/bbx/search/[arg1]/[arg2]/.../[sortby]/[sort1]/[asc|desc]/[sort2].../[limit]/[num]/[offset]  # busca por args
 </pre>
 ===== proposta 22/01/14 =====
+ (ANTIGA)
 Nova proposta das rotas, padronizando no esquema REST (22/01/2014)

@@ Linha 133: / Linha 133: @@
 /[repo]/[mucua]/media/[uuid] {put, delete}  # update/delete media
 /[repo]/[mucua]/media/last {get}                # pega últimas medias adicionadas
 /[repo]/[mucua]/media/[uuid]/[width]x[height].[format]       # get image of media
 /[repo]/[mucua]/media/[uuid]/related          # get related media to [uuid]

@@ Linha 133: / Linha 133: @@
 /[repo]/[mucua]/media/[uuid] {put, delete}  # update/delete media
 /[repo]/[mucua]/media/last {get}                # pega últimas medias adicionadas
-/[repo]/[mucua]/media/[uuid]/show_image       # get image of media
+/[repo]/[mucua]/media/[uuid]/[width]x[height].[format]       # get image of media
 /[repo]/[mucua]/media/[uuid]/related          # get related media to [uuid]

@@ Linha 103: / Linha 103: @@
 ===== Atualização - 06/06/2014 =====
 # autenticacao
 /login
@@ Linha 143: / Linha 144: @@
 # busca
 /[repo]/[mucua]/bbx/search/[arg1]/[arg2]/...  # busca por args
+</pre>
 ===== proposta 22/01/14 =====

@@ Linha 98: / Linha 98: @@
 * repositorio (acervo, bruto, outras redes)
 * etiqueta
 ==== API / Rotas de acesso ====
 Nova proposta das rotas, padronizando no esquema REST (22/01/2014)