O app é a interface do Varanda para iOS, Android e web. Ele não guarda lógica de protocolo: fala com um nó pelo contrato de rpc.md. A interface ainda está em construção. Onde este documento diz "em construção", a tela pode mudar de campos ou de ordem.
Convenção: onde este documento diz "na web hospedada", vale também para o app instalado com a instalação da associação (veja "No app instalado com a instalação"), salvo onde a diferença é dita. O que é dito do "app com configuração manual" (a tela Conectar em Avançado), do varanda-serve e da CLI continua valendo só para eles.
- Cria a identidade (a chave pública do diário; na web, derivada de uma passkey) e mostra o estado do certificado de membro; na web hospedada e no app instalado com a instalação, vincula a chave a uma conta Google e dá um @nome.
- Publica textos e respostas no diário da pessoa, com emojis e, na web hospedada e no app instalado com a instalação, com até 10 fotos ou GIFs; define nome e bio.
- Segue e deixa de seguir pessoas. Quem a pessoa segue é público e é o mesmo em todos os aparelhos dela (veja "Seguidos em todos os aparelhos").
- Mostra o feed dos diários seguidos e o diário da própria pessoa, com as fotos das publicações.
- Curte, republica e cita publicações (registros
like,reposte a citação, públicos, no diário de quem age), abre a conversa de uma publicação com todas as respostas e o perfil de qualquer membro. Na web hospedada, o índice do semeador diz onde procurar e quantas respostas, curtidas, republicações e citações há; cada publicação mostrada é buscada e conferida pelo nó (veja "Conversa" e "Membro"). Na web hospedada, o número de curtidas e o de republicações abrem a lista de quem curtiu e de quem republicou (veja "Curtidas e republicações"). - Na web hospedada, mostra a Espiadinha: até três publicações por diário que a pessoa não segue, em rodadas, sem sugestões nem pesos escondidos.
- Sincroniza com pares e com o semeador sozinho e de modo contínuo enquanto o app está aberto e com rede, depois que a identidade está desbloqueada e o certificado de membro confirmado. Na web, a sincronização automática para quando a aba fica oculta: a página envia
sync.stope libera sua conexão com o semeador; ela reinicia assim que a aba volta a aparecer. A fila de saída não envia enquanto a aba está oculta. O Web Lock que permite só uma aba com o nó continua igual. Não há botão de sincronizar nem indicador de sincronização: só a nota "Sem internet" quando o aparelho está sem rede. - Na web hospedada, com o nó no navegador, a conexão com o semeador fica aberta enquanto a aba está visível, e cada aba visível ocupa uma vaga externa do semeador. Se a conexão cai, o nó disca de novo com espera crescente e um pouco aleatória (até 5 s nos primeiros 3 minutos de queda, depois até 30 s; quando o semeador avisa que está reiniciando, numa implantação, a espera é de 0,5 a 1,5 s); com o semeador cheio, a aba mostra "Semeador ocupado" e tenta de novo. Uma aba oculta libera a sincronização contínua com um
sync.stop, e ao aparecer de novo começa uma rodada nova na hora. A Espiadinha não usa a conexão da sincronização: cada página abre a sua própria conexão curta com o semeador, com uma chave descartável que não anuncia nada, e a fecha ao terminar, esteja a sincronização ligada ou parada. É uma escolha de privacidade: a conexão da sincronização já anunciou o diário e os seguidos da pessoa, e espiar por ela deixaria o semeador ligar o que a pessoa espia à identidade dela. Uma publicação de outro aparelho chega a uma aba visível em poucos segundos; uma aba oculta a recebe na próxima vez que aparece. Puxar a lista para atualizar espera, no máximo 10 s, a conexão verificada com o semeador ficar quieta por cerca de 1,5 s depois da última novidade; só conta a conexão com o semeador, e uma conexão que cai recomeça a contagem. Sem rede, com a aba oculta ou com a sincronização automática desligada ou desistida, puxar só relê o que está no aparelho, sem esperar. O Web Lock não muda. No app com configuração manual e novaranda-servenão há esse ciclo: puxar a lista só relê os dados do aparelho. - Na web com o nó no navegador, a pessoa continua conectada depois de recarregar ou reabrir o app, até tocar "Sair" ou ficar 30 dias sem abrir (veja "Continuar conectado").
- Mostra nomes e @nomes no lugar de chaves: a chave só aparece em Ajustes › Avançado › Identidade técnica e na etapa do certificado.
Os formatos de registro e de certificado estão em protocol.md. Os nomes das partes do app (A Rua, Diário e os demais) vêm de design.md.
Há quatro jeitos de ter um nó, e a interface é a mesma:
- No aplicativo (iOS, Android), com a instalação da associação (tipo
web). O nó é a mesma sessão do@varanda/web-memberdo site (Hypercore 10, o mesmo diário), rodando num worklet Bare dentro do app, com os dados em arquivos no diretório do app e o semeador alcançado porwss://<instalação>/seeder. A interface fala com ele por IPC, sem token: o canal é privado do processo do app. O endereço da instalação é o que foi salvo em Conectar, depois o valor do build (EXPO_PUBLIC_VARANDA_INSTALLATION), depois o padrãohttps://bora.varanda.app; o app lê<instalação>/varanda.json. Veja "No app instalado com a instalação". - No aplicativo (iOS, Android), com configuração manual (tipo
core). O nó é a sessão do@varanda/corerodando num worklet Bare dentro do app, com a chave da associação, o bootstrap ou a DHT pública (Conectar › Avançado). A interface fala com ele por IPC, sem token. Os dados ficam no diretório de documentos do app, na pastavaranda. A prova no simulador iOS está em ios-gate.md. - Na web, no próprio navegador. O nó roda na página: é a sessão do
@varanda/web-member(Hypercore 10), carregada como o scriptvaranda-node.js, servido ao lado do app. Os diários (o próprio e os seguidos) e o núcleo de fotos deste aparelho ficam no IndexedDB do navegador (bancovaranda-node); a chave do diário é derivada da passkey, e o que fica guardado para continuar conectado está num banco à parte, cifrado (veja "Entrar com a passkey" e "Continuar conectado"). O nó não usa a DHT: o único par é o semeador da associação, alcançado pela entrada WebSocket dele (seed --ws-port). A interface fala com o nó em memória, sem rede e sem token, com as mesmas mensagens de rpc.md. É o modo padrão da versão web. - Na web, com o
varanda-serve. O navegador não roda o nó. Quem roda é ovaranda-serve, na máquina da pessoa, e a interface fala com ele por um WebSocket em127.0.0.1. As chaves ficam na máquina, não no navegador. As opções e as regras de segurança do servidor estão no README (seção "Servidor local para a interface web"). A página entra nesse modo quando é aberta no endereço que ovaranda-serveimprime (com#token=...); a aba lembra o modo até ser fechada.
Ao abrir o app, a cadeira sobe e assenta, as letras de "Varanda" entram uma a uma e "conectando…" pulsa, sobre o mesmo fundo das telas de abertura nativas. Na web hospedada, a própria página já desenha essa animação antes de o app carregar. A marca fica sempre até mostrar a apresentação inteira (a entrada e uma pausa curta, 1,5 s), em qualquer fase, inclusive numa falha de conexão e antes da prévia de A Rua guardada no celular; na web o tempo conta da pintura da página. Depois disso, quem volta ao app e já tem a configuração lembrada não espera mais tempo fixo, e a marca sai quando as primeiras linhas de A Rua estão prontas (com nomes, os dados das fotos e as contagens, e com a faixa de Momentos assentada, ou aos 5 s se uma leitura trava). Ela cobre também a conexão com o semeador. A tela "Conectar" (com "tentar de novo" e "Detalhes técnicos") só aparece quando a conexão falha ou depois de 10 s sem resposta, e continua no lugar durante uma nova tentativa. Com "reduzir movimento" ligado, nada se move. Verificação em docs/verification.md seções 44 e 242.
Na primeira abertura do aparelho, antes dos Termos, três cartões explicam o app: o diário que fica no aparelho, o que é seu continua seu, e a varanda para conversar. Dá para pular, voltar, avançar ou começar. Na web, deslizar, os botões e as setas do teclado funcionam, e cada cartão é anunciado para leitor de tela. Os cartões são só apresentação e não são aceite de nada. O registro, varanda-intro no localStorage (web) ou varanda-intro.json na pasta de documentos (nativo), guarda só a versão vista e a data. Não há telemetria nem dependência nova.
Limites: o registro vale por aparelho, não por conta. Se o armazenamento for recusado (modo privado), os cartões voltam na próxima abertura, e Pular continua funcionando. Quem abre /@nome ou /convite/<código> pela primeira vez no aparelho vê os cartões antes, e o link é mantido. A volta do Google (?conta=) não mostra os cartões e não os marca como vistos. Verificação em docs/verification.md seção 39.
No app nativo, na primeira abertura ninguém digita o endereço da instalação da associação (veja "No app instalado com a instalação"). A tela Conectar aparece quando a configuração da instalação não carrega (com "Tentar de novo") e para mudar o endereço. Atrás de "Avançado" fica a configuração manual, que, depois de salva, continua valendo no lugar da instalação. Ela pede:
- a chave pública da associação (64 dígitos hexadecimais);
- como achar pares: uma lista de bootstrap (
host:porta) ou o interruptor "DHT pública", que começa desligado; - opcionalmente, o endereço local da DHT.
Com a DHT pública ligada, o endereço local da DHT não pode ser de loopback (127.x.x.x, localhost, ::1): uma DHT presa ao próprio aparelho nunca alcança um par público. O formulário recusa com "com a DHT pública, apague o endereço local da DHT: ... só alcança este aparelho", e o nó recusa a mesma combinação. Uma configuração gravada antes dessa regra perde só esse endereço quando o app a lê.
A DHT pública é uma escolha ativa da pessoa (opt-in). Sem bootstrap e sem o interruptor ligado, o nó não tem como achar pares. A configuração, que não é segredo, fica em Documents/varanda-config.json, fora do diretório de dados do nó, e só é gravada depois que o nó inicia com ela. Ajustes › Conexão mostra a mesma configuração depois: dá para trocar o bootstrap ou a DHT pública (o nó reinicia), mas a associação fica só para leitura depois que a identidade existe.
Depois do Conectar (ou, com o varanda-serve, logo de início), a primeira configuração aparece sozinha, sem as abas, em três passos (o progresso aparece uma vez, em pontos, e o leitor de tela diz "Passo n de 3"): Criar sua conta (cria a identidade), Liberar sua conta (mostra a chave como "Código para enviar à associação", com "copiar código", e recebe o que a associação devolveu em "O que a associação devolveu"; o botão é "gravar e continuar" e, depois de gravar, a tela diz "Conta liberada.") e Como você quer aparecer (nome de 1 a 80 caracteres e bio opcional, com "Continuar" e "Pular por enquanto"). Cada passo tem uma frase curta e um botão de ajuda (o círculo com o "i" na barra do topo) que abre "Como funciona a conta" ou "Como liberar sua conta". Nos dois primeiros passos, um link "Conexão" abre Ajustes › Conexão. Enquanto o perfil próprio é lido, a tela diz "Um instante"; se a leitura demora mais de 10 s, aparece "Continuar mesmo assim". Pular vale só para esta sessão: o nome é pedido de novo na próxima carga. Ao concluir, o aviso "Tudo pronto. Siga pessoas para encher a Rua." leva às abas. A sincronização começa assim que o certificado está confirmado, sem esperar o nome.
O app mostra os dois documentos numa lista de linhas que abrem no lugar ("Ler" e "Fechar"), no mesmo layout dos demais passos, e só segue com "Aceitar e continuar", sob a frase que pede para ler e aceitar os dois documentos. O aceite é guardado no aparelho (chave varanda-terms no localStorage, arquivo varanda-terms.json no nativo), por membro, e é pedido de novo para cada conta e a cada versão nova dos textos.
No app com nó próprio e no varanda-serve, o portão aparece antes de Conectar enquanto o aparelho não tem registro da versão atual, e de novo para uma identidade que o registro não lista. Nesses modos o aceite continua por aparelho.
Com a instalação hospedada (web e app instalado), Entrar vem primeiro. Enquanto o nó conecta, aparece a abertura, nunca os Termos. Depois de Entrar, se o aparelho não tem registro da versão atual para aquele membro, o app pergunta ao serviço de conta (leitura assinada, invite.sign com summary) por até 4 segundos, com a abertura na tela. Com uma passkey extra de recuperação, o próprio Entrar lê no serviço de conta o texto cifrado que abre a conta (POST /account/recovery/fetch, só o identificador derivado da passkey, que o serviço não consegue ligar a ela, salvo quando guarda a chave pública dela para Excluir conta), também antes dos Termos: sem essa leitura a passkey não abre a conta, e nada é gravado. Num aparelho sem o diário daquela chave, a abertura fica na tela enquanto a recuperação depois de Entrar busca a chave, por até 15 segundos, e então a pergunta espera a resposta do serviço por até 4 segundos. Quando Entrar abre uma identidade sem conta, o cartão "Esta passkey não abriu nenhuma conta" aparece no lugar da abertura, antes dos Termos; com "Criar conta com ela", a abertura volta enquanto a recuperação busca a chave, e então vêm os Termos e a configuração. Se o serviço guarda o aceite exatamente da versão atual, o aparelho o registra (já sincronizado) e nenhum portão aparece. Sem vínculo, com serviço antigo, sem rede ou com resposta lenta, o portão aparece logo depois da passkey. A pergunta é feita uma vez por membro e versão em cada carga da página. "Criar minha conta" mostra os Termos antes de a cerimônia da passkey começar, com "Voltar" para a tela de Entrar. O código de recuperação ("Outras formas de entrar" › código) também termina numa passkey nova, então, quando esta carga da página ainda não tem aceite, mostra os Termos antes de o campo do código abrir, como Criar, e esse aceite é registrado para a primeira conta conhecida nessa carga da página, criada ou entrada. Uma sessão retomada de um membro já registrado passa direto. Com o vínculo Google, o app também registra o aceite no serviço de conta (assinado pela chave do diário, terms.sign), até 3 tentativas por carga. Sem armazenamento, o portão volta a cada carga, salvo quando o serviço de conta confirma o aceite (conta vinculada). Os limites desta ordem estão em docs/verification/feat-sync-sorte-termos.md. A seção 29 de docs/verification.md é anterior a ela (portão antes de Entrar, nada ao serviço de conta antes do aceite) e continua valendo para o app com nó próprio e o varanda-serve.
Os três passos na web hospedada. Todo passo depois das boas-vindas usa o mesmo layout moderno (Stepper): barra do topo só com o botão (i), o progresso uma vez só, em pontos (o leitor de tela diz "Passo n de 3"), um disco com o ícone, um título, uma frase, botões grandes de largura total, avisos em linha com ícone de informação e as explicações na ajuda (i). Depois do botão Entrar, o app mostra três passos: Bem-vindo à Varanda (uma tela de boas-vindas, sem contador de passo: só o botão de informação no canto de cima, a cadeira num disco, o título e "Uma rede social feita entre pessoas.", e dois botões de largura total, "Criar minha conta" e "Já tenho conta"; outra passkey, o celular por QR code e o código de recuperação ficam numa lista que abre em "Outras formas de entrar", que abre sozinha depois de uma entrada que não encontra a conta; as explicações (a passkey, gerenciadores que sincronizam, o celular pelo QR code, perder a passkey) ficam em "Como funciona a entrada" (HELP.entrar em apps/app/src/help.js), que o botão de informação abre), Escolha seu @nome (o vínculo com a conta Google, abaixo; com o portão de convites ligado, só com o link de convite, veja "Convites para entrar") e Como você quer aparecer (nome e bio opcional, com "Continuar" e "Pular por enquanto"; pular vale só para esta sessão e o nome é pedido de novo na próxima carga). Quem entra num aparelho novo vê antes "Buscando sua conta…" enquanto a sincronização de recuperação busca no semeador o que já existe dessa identidade; se o certificado volta de lá, o passo da conta é pulado. A mesma regra do "Um instante" e do "Continuar mesmo assim" vale aqui, e o aviso final é "Tudo pronto. Siga pessoas para encher a Rua.". A sincronização contínua começa quando o certificado está confirmado, sem esperar o nome.
Rede cheia. Antes de oferecer "Criar minha conta", o app hospedado (web, e o app instalado ligado a uma instalação hospedada) pergunta GET /account/admission ao serviço de conta, que responde { "open": true } ou { "open": false }. Com open: false o passo mostra "A Varanda está cheia por enquanto..." com o botão "tentar de novo" e não oferece "Criar minha conta", "criar mesmo assim" nem "criar com o celular"; "Entrar", entrar com o celular, outra passkey, o código de recuperação (os três em "Outras formas de entrar"), "Concluir e entrar" e "Criar passkey nova" depois de um código de recuperação seguem funcionando. Se a leitura falha, o app não bloqueia e o serviço ainda recusa com "lista-de-espera" se a vaga acabar no meio da entrada. A leitura não reserva vaga nem um convite abre vaga, e a resposta vale por instalação. Configuração digitada à mão, configuração manual e varanda-serve não perguntam. Ver docs/verification.md seção 124.
Cartão "Instale o Varanda". Depois do cadastro novo, o app oferece a instalação uma vez, num cartão calmo embaixo da barra do topo (título "Instale o Varanda", uma linha e dois botões). Ele aparece só na carga de página que volta do passo do Google (LINK_RETURN) E que mostrou o passo "vinculo" com node.info lido e sem certificado de membro; quem já é membro e vincula o Google em Ajustes › Conta e @nome nunca o recebe, nem numa recarga. Onde o navegador oferece instalar: "Instalar" abre o diálogo do navegador e fecha o cartão, e "Agora não" fecha o cartão e grava a mesma dispensa de 30 dias da nota "Instalar o Varanda" (varanda-install-dismissed), que então também some. No Safari do iPhone e do iPad o cartão traz a instrução "Compartilhar → Adicionar à Tela de Início" e o botão "Entendi". As demais regras da nota (só em celular e iPad, nunca instalado, nunca no app nativo) valem também para o cartão.
Confirme sua idade. Quando o operador liga a verificação de idade, a web hospedada e o app ligado à instalação mostram a tela "Confirme sua idade" depois de Entrar (ou da recuperação) e antes de "Escolha seu @nome". Quem já tinha conta também passa por ela: fica nessa tela até concluir. O botão leva à página da Didit (selfie e, quando preciso, documento), que devolve a pessoa para /?idade=volta ou, no app, que abre a página no navegador do aparelho, para varanda://idade. O app com configuração manual não tem esse passo. A idade mínima é 16. Só a faixa (16-17 ou 18+) fica guardada, no serviço de conta; a foto e o documento não chegam ao Varanda. A tela mostra só o essencial em caixas suaves; como funciona (Didit, selfie ou documento, só a faixa guardada, retomar por cerca de uma hora, a volta pelo app ou pelo navegador, política de privacidade) fica em "Como funciona a confirmação de idade", no botão (i). Se a consulta falha, o app continua pedindo a verificação. Sem a verificação ligada no servidor, o passo não aparece. Detalhes em docs/verification.md, seção 40.
Confirme seu celular. Quando o serviço de conta exige o celular, a web hospedada e o app ligado à instalação mostram a tela "Confirme seu celular" depois da idade e antes de "Escolha seu @nome", também para quem já tinha conta: o app fica bloqueado até a confirmação. Um código de uso único chega por SMS (novo código depois de um minuto); só celular brasileiro vale, e números virtuais, descartáveis e fixos são recusados. O código aparece em seis casas sobre um só campo, e um código completo é conferido uma vez sozinho; depois de um erro ou de uma resposta incerta, só uma edição ou "Confirmar" o envia de novo. O número não é prova de identidade nem serve para recuperar a conta. Em Ajustes, "Trocar o celular" repete o passo. Na configuração manual não há essa etapa.
Primeira visita numa instalação hospedada. A página busca /varanda.json na própria origem ({"v":1,"association":"<chave>"}), monta sozinha a configuração (a associação e o semeador wss://<este host>/seeder) e mostra só o botão Entrar. Ninguém preenche a tela Conectar. Enquanto conecta, a tela Conectar diz "conectando…". Se o /varanda.json falha numa página hospedada, o app mostra uma frase simples ("Não foi possível conectar agora. Confira sua internet e tente de novo.", ou "O Varanda já está aberto em outra aba ou janela. Feche a outra e toque em Tentar de novo.") com o botão "Tentar de novo". O mesmo vale numa página hospedada em que uma configuração manual foi gravada antes. Um "Detalhes técnicos" recolhido guarda a mensagem original, a configuração em uso, "usar outra configuração" (ou "configurar manualmente" quando a descoberta falhou) e o aviso de que limpar os dados do site apaga os diários guardados; o formulário manual só aparece se a pessoa pedir. Em Ajustes › Avançado › Conexão a visão técnica continua aberta.
A última associação válida fica no localStorage (varanda-web-discovered), só para a mesma origem. Ela é usada quando a instalação não responde: sem rede, tempo esgotado, HTTP 408/429/5xx ou redirecionamento. Qualquer outra resposta que não seja uma configuração válida (404, HTML, JSON inválido ou corpo maior que 4 KiB) faz o app esquecer a associação lembrada e mostrar o erro.
Abrir sem rede, instalado ou numa aba. Depois de uma visita com rede que termine de guardar o app, o service worker permite abrir a página sem rede. Ele só é registrado na instalação hospedada em HTTPS com o nó no navegador, nunca em localhost nem com varanda-serve. Para instalar, use o menu do navegador (no iPhone, Compartilhar › Adicionar à Tela de Início). O próprio app também sugere a instalação, só na página hospedada com o nó no navegador e só em celulares e no iPad, nunca com o app já instalado: uma nota "Instalar o Varanda" embaixo da barra do topo, com o botão "Instalar" onde o navegador oferece o diálogo de instalação (Chrome no Android) e, no Safari do iPhone e do iPad, a orientação "Compartilhar → Adicionar à Tela de Início". Fechar a nota vale neste navegador e ela volta depois de 30 dias; cancelar o diálogo do navegador não inicia os 30 dias, e a nota volta quando o navegador oferecer a instalação de novo. Uma aba do Safari não sabe se o app já foi para a Tela de Início, então ali a nota aparece até ser fechada. Em Ajustes › Instalar o app, o botão "Instalar" aparece sempre que o navegador oferece a instalação. No Samsung Internet o app não oferece instalação e remove o link do manifesto da aba (não de um app já instalado), porque o Play Protect bloqueia o app que esse navegador cria ("App de risco bloqueado", feito para uma versão antiga do Android); Ajustes aponta para instalar pelo Chrome e entrar com a mesma passkey. O app guarda index.html, o bundle com hash, varanda-node-<versão>.js (a cópia do nó com o nome desta versão, a única que a página carrega), o manifesto e os ícones desta versão: cada arquivo é conferido por SHA-256 e o index.html também pela marca varanda-release. O worker não acrescenta respostas ao cache durante o uso e recusa HTML no endereço de scripts ou de outros recursos. Navegações buscam a rede primeiro, com a cópia guardada desta versão quando a rede falha ou responde 404/5xx; arquivos com hash e o nó desta versão usam primeiro o cache. Assim a página guardada servida enquanto uma implantação troca os arquivos roda o nó da mesma versão, e uma página de outra versão nunca recebe o nó guardado. Uma nova versão do worker instala numa carga posterior com rede e assume depois que todas as janelas do app são fechadas, sem skipWaiting. Por isso uma janela aberta antes de uma atualização continua rodando a versão antiga: o app compara a marca varanda-release da página com a versão que o servidor entrega agora (o VERSION de /sw.js, que o worker nunca intercepta) ao voltar à janela, a cada 30 minutos e quando um worker novo começa a instalar, e, se forem diferentes, mostra "Nova versão disponível." com o botão "atualizar", que recarrega a página na versão nova (rascunhos não enviados se perdem, como em qualquer recarga). Uma checagem que falha (sem rede) não muda o aviso; o app nativo não o mostra.
Entrar com a passkey. A identidade não é guardada: é derivada de uma passkey (WebAuthn com a extensão PRF). Uma passkey nova só é aceita se for guardada num gerenciador que sincroniza entre os aparelhos da mesma conta, como o do Google, o da Apple, o 1Password ou o Bitwarden. Essa regra vale só para criar: uma passkey que já existe sempre entra, mesmo que não sincronize. Num computador sem um gerenciador que sincronize, a página oferece o caminho pelo celular: a pessoa lê o QR code com a câmera do celular, e a passkey é criada ou usada no gerenciador dele. Se a página mostrar que a passkey do Varanda não está num gerenciador que sincroniza, a recuperação é esta: salvar a passkey num gerenciador que sincroniza, para que a conta do Google ou da Apple a devolva num aparelho novo. Quem perdeu a passkey conhecida pode sair do cartão sem apagar o diário deste aparelho; ninguém precisa apagar passkey à mão. Na primeira vez, "Criar minha conta" cria a passkey (rotulada Varanda xxxxxx, sem e-mail nem identificador do Google) e deriva a chave; nas seguintes, "Entrar" pede biometria ou PIN e deriva a mesma chave. Depois de entrar, a pessoa continua conectada neste aparelho até tocar "Sair" (abaixo). Algumas passkeys só entregam o resultado PRF num segundo passo, e então a página pede "Concluir e entrar". A passkey com que a conta foi criada continua abrindo a conta, inclusive sem internet, enquanto existir no gerenciador. Além dela, a pessoa pode cadastrar outras passkeys e um código de recuperação para a MESMA conta (veja "Passkeys e recuperação", abaixo): sem nenhuma passkey da conta e sem o código, a conta não volta. O caminho pelo celular, outra passkey e o código de recuperação ficam em "Outras formas de entrar" na tela Entrar.
Passkeys e recuperação. Ajustes › Passkeys e recuperação aparece na web hospedada e no app ligado à instalação, com a passkey conhecida, a conta desbloqueada e vinculada (o serviço de conta só guarda entradas de contas vinculadas). A tela lista as entradas cadastradas só com o tipo e a data, e tem:
- Adicionar passkey: cria uma passkey nova, de preferência em outro gerenciador (por exemplo, um gerenciador de senhas além do Google ou da Apple), e cadastra no serviço de conta a chave da conta embrulhada para ela. São até quatro passkeys extras por conta. A passkey nova não cria outra identidade: ela só desembrulha a raiz da passkey original, e as chaves continuam as mesmas. Depois do cadastro, quando o serviço de conta guarda a chave da passkey que abriu a sessão, a tela pede essa passkey de novo ("Confirme com a passkey deste aparelho para que a passkey nova também confirme a exclusão da conta.") e manda ao serviço a chave pública da passkey nova com essa confirmação (
src/extraPasskeyKey.js); então a passkey nova também confirma Excluir conta na hora. Sem a confirmação (serviço antigo, passkey deste aparelho sem chave guardada, cancelada ou recusada), a tela diz que a passkey nova já abre a conta, mas uma exclusão confirmada só com ela fica agendada por 7 dias. Quando o navegador exige um toque novo para a segunda cerimônia, aparece o botão "Confirmar com a passkey deste aparelho". Acima do botão, um aviso pede para usar a passkey nova só com o app atualizado, porque uma versão antiga abre com ela uma conta vazia, separada. - Trocar a passkey deste aparelho: primeiro explica a troca (adicionar a nova, conferir que ela entra e depois apagar a antiga no gerenciador de senhas; a passkey original continua abrindo a conta onde existir, e o Varanda não consegue invalidá-la). Depois adiciona e cadastra a nova, pede a confirmação da passkey antiga para guardar a chave da nova (como em Adicionar passkey) e só então liga este aparelho a ela.
- Criar código de recuperação: um código de 36 letras e números em 9 grupos de 4, mostrado uma vez só, com copiar e a caixa "Anotei o código". Um código novo substitui o anterior no serviço de conta: o anterior deixa de entrar num aparelho que ainda não o usou, mas quem já entrou com ele continua com acesso. O código fica no cartão da tela Passkeys, também depois de sair da tela e voltar, até a pessoa marcar "Anotei o código" e tocar "pronto"; o cartão não tem "cancelar".
- Remover em cada entrada, com confirmação. Remover impede novas entradas com aquela passkey ou aquele código, mas não desconecta um aparelho que já entrou com ela ou com ele, e quem já a usou ou já o usou continua com acesso.
Remover ou trocar não revoga nada: a chave da conta vem da passkey original e não pode ser trocada, então quem já entrou com uma passkey adicionada ou com o código guarda essa chave. O cartão do código e as duas confirmações dizem isso, e que, se um deles vazar, o caminho seguro é criar uma conta nova.
Se o envio falha depois de a passkey ter sido criada no gerenciador, a tela diz que a passkey foi criada mas não cadastrada, oferece "tentar de novo" nesta sessão e pede para apagar a passkey no gerenciador se a pessoa desistir. Uma resposta que se perdeu mostra o aviso de resultado desconhecido e "conferir", que lista as entradas; o app nunca repete o pedido sozinho. Com o máximo de entradas, o aviso pede para remover uma antes.
Entrar com outra passkey ou com o código. No cartão Entrar, "entrar com outra passkey" aparece sempre que há uma passkey conhecida e deixa o navegador oferecer qualquer passkey. Uma passkey cadastrada em Passkeys e recuperação é reconhecida pela marca no identificador do usuário: o app busca no serviço de conta a raiz embrulhada para ela e abre a mesma conta, e este aparelho fica ligado a essa passkey. Uma passkey sem marca, ou que não devolveu identificador e não é a deste aparelho, entra direto como antes, derivando a própria chave, sem perguntar nada ao serviço de conta. "Entrar com código de recuperação" abre um campo para digitar o código (maiúsculas, minúsculas, espaços e hífens não importam; um código com erro de digitação é recusado antes de ir à rede). Se o código vale, a conta abre só depois de a pessoa tocar "Criar passkey nova": o app cria uma passkey nova neste aparelho, liga a conta a ela e a cadastra no serviço. O código sozinho não deixa sessão guardada. Se o cadastro da passkey nova falha, o aparelho continua conectado e um aviso leva a Ajustes › Passkeys e recuperação para cadastrar de novo. Uma passkey ou um código sem entrada no serviço mostra "esta passkey ou este código não está ligado a uma conta neste endereço". A passkey original abre a conta sem internet em qualquer aparelho. Uma passkey extra ou o código precisa do serviço de conta a cada entrada nova com a passkey ou com o código; só uma sessão guardada no aparelho evita isso. Limite: se um gerenciador de senhas fora do padrão não devolve o identificador de uma passkey extra num aparelho onde ela ainda não está ligada, essa passkey abre ali uma conta separada e vazia em vez da conta do membro; nada da conta real é afetado, e o código ou a passkey original ainda a recuperam.
Continuar conectado. Depois de uma entrada bem-sucedida (e só então), o nó guarda o resultado PRF de 32 bytes da passkey, de onde vêm todas as chaves do membro, num banco IndexedDB próprio (varanda-session), cifrado com AES-GCM-256 por uma chave do navegador que não pode ser exportada (extractable: false) e preso a este endereço (rp.id) e a esta identidade. Ao recarregar ou reabrir, o nó reabre a sessão sozinho, sem pedir a passkey, se a passkey, o diário guardado e a sessão guardada combinam; senão apaga a sessão guardada e mostra Entrar. A sessão guardada vence depois de 30 dias sem abrir o app: aí a passkey é pedida de novo, e cada abertura renova o prazo. O que isso protege: o resultado PRF não fica gravado em claro, a chave da cifra não pode ser exportada por um script, e o registro copiado sozinho para outro endereço ou outra identidade não abre. O que NÃO protege: a chave da cifra fica no mesmo perfil do navegador que o resultado cifrado, então uma cópia do perfil inteiro dá a identidade até "Sair" ou até os 30 dias sem uso; um script rodando nesta origem pode usar a chave guardada e agir como o membro (um XSS já era comprometimento total com a identidade desbloqueada); e quem tem o aparelho ou o perfil do navegador desbloqueado pode publicar até alguém tocar "Sair" ou o prazo vencer. Um erro passageiro do IndexedDB ao reabrir também apaga a sessão guardada: a pessoa entra com a passkey de novo uma vez. Se a sessão não puder ser guardada, a entrada vale assim mesmo, só para esta carga.
Excluir conta. Em Ajustes, abaixo de "Sair" (app e web hospedada, com a passkey aberta). A tela pede ao serviço de conta um nonce e o @nome atual ao abrir (quem ainda é dono de uma página vê "Você ainda é dono de uma página" e "Abrir Páginas"), explica o que sai na hora, o que sai em até 7 dias, o que fica e que as comunidades e os grupos criados pela pessoa acabam para todos. Com o @nome digitado, "Excluir conta" pede a passkey de novo (passkey.confirm({ challenge }) com o nonce, dentro do toque), desliga os avisos do aparelho, assina o pedido (account.sign, fase delete) e o envia com a asserção da passkey, que o serviço confere com a chave pública que guardou no cadastro. Sem essa chave (contas anteriores ao registro, uma passkey criada com o código de recuperação, ou adicionada sem a confirmação de uma passkey registrada), a tela explica a espera, o botão diz "Agendar exclusão" e o pedido fica agendado por 7 dias: nada é apagado do aparelho, todos os aparelhos com a conta aberta mostram no topo "Exclusão da conta agendada para " com "Ver", e Ajustes > Excluir conta mostra a data com "Cancelar exclusão" (account.sign, fase cancel). Logo depois do vínculo Google, o app manda ao serviço a chave pública da passkey que criou a conta (src/passkeyEnrol.js), sem nada na tela; se falhar, tenta de novo na próxima abertura, até o serviço fechar a janela de uma hora. Com a asserção aceita, só com a resposta o app guarda o recibo (chave pública e data), apaga a conta do aparelho como "Recomeçar" e volta a Entrar, onde o recibo mostra o prazo, como apagar a passkey e, quando /account/status responde concluida, "Exclusão concluída" uma vez. Um resultado incerto é decidido pelo status, nunca por um segundo envio. Uma chave que o serviço diz excluída (outro aparelho, ou a mesma passkey de novo) fica na tela "Esta conta foi excluída", antes dos Termos, até "Apagar deste aparelho". Protocolo em docs/protocol.md, "Account deletion".
Sair, bloquear e Recomeçar. "Sair" (Ajustes, confirmação "Sair desta conta neste aparelho? Para voltar, use sua passkey.") tira as chaves da memória e apaga a sessão guardada; a página volta a Entrar e só a passkey abre de novo. Para isso valer mesmo se o navegador falhar, o nó grava antes uma marca no próprio armazenamento que impede reabrir qualquer sessão guardada até a próxima entrada com a passkey, e depois apaga o registro (ou, se isso falhar, o banco varanda-session inteiro); se as duas exclusões falharem, a página mostra "não foi possível sair por completo neste aparelho: tente de novo", e a identidade fica bloqueada de qualquer jeito. Os diários continuam guardados e legíveis, e a fila de saída fica. O bloqueio só na memória (lock) não apaga a sessão guardada: a próxima carga reabre. "Recomeçar" (Ajustes › Avançado) apaga a conta guardada neste aparelho, o núcleo de fotos dele, a sessão guardada e a fila de saída dessa identidade.
Convite por link de perfil. Quem abre /@nome ou /m/<chave> na instalação hospedada, sem sessão, vê no cartão Entrar o convite "@nome convidou você. Entre para seguir." ("Alguém convidou você. Entre para seguir." quando o link traz a chave) e um botão "agora não", que apaga o cartão e o convite. O link nunca é consentimento: o app só segue sozinho quando o cartão foi mostrado nesta página e uma cerimônia de passkey deu certo nesta mesma página, sem recarga no meio (quem já tinha conta e entra pelo cartão). A aceitação fica presa àquela chave e sobrevive à volta do Google, mas depois de uma recarga ela só abre o perfil: quem é novo passa pelo Google, volta, e no fim da configuração encontra o perfil de quem convidou aberto em Membro com o aviso "Para seguir @nome, toque em Seguir." — um toque confirma. O motivo: o sessionStorage não é autenticado, e um registro "aceito" plantado nesta aba (ferramentas do navegador, uma extensão) não pode virar um seguir assinado sem a pessoa ver para quem. Quem já estava conectado (ou teve a sessão restaurada ao carregar) só tem o perfil aberto, em Membro, com "Seguir"; nada é seguido sozinho. Consequência: se uma pessoa conectada toca em Sair com um convite pendente, o cartão aparece e entrar de novo conta como aceitar. O convite fica no sessionStorage desta aba (varanda-profile-invite, no máximo 1 h), que sobrevive à ida ao Google e à volta em /?conta= e morre com a aba; qualquer caminho /@… ou /m/… apaga antes o convite guardado (um inválido é então ignorado) e a barra de endereço é limpa para /. Logo depois da primeira cerimônia o app relê o estado da passkey para a chave ser conhecida antes do passo do Google, mesmo quando a recuperação termina sem sincronizar (sem rede). O seguir automático (follow.add) acontece assim que as abas aparecem. A volta do Google de quem acabou de criar a conta não abre mais a folha Ajustes › Conta, então o perfil abre em Membro por cima de A Rua logo que as abas aparecem; para quem já tinha certificado e volta do vínculo do Google feito em Ajustes › Conta, a folha ainda abre uma vez e o seguir espera ela fechar: o perfil abre em Membro e o aviso é "Agora você segue @nome." ("Você já segue @nome." se já seguia). Se a busca do @nome falha (sem rede, 429/5xx, tempo esgotado), o convite é mantido, um aviso diz "Sem conexão: o perfil abre quando a conexão voltar." e a busca é repetida após 15 s, 30 s e depois a cada 60 s (no máximo 10 tentativas) e quando a conexão volta; um @nome que não existe mais avisa "Não encontramos esse @nome.". Num navegador embutido (Instagram, TikTok…) sem passkey com PRF, o cartão mostra o convite, "Para entrar e seguir, abra este link no Chrome ou no Safari." e o controle de copiar/compartilhar com o link refeito a partir do convite guardado. Se o sessionStorage não grava, o perfil abre nesta carga, mas o convite não sobrevive à recarga do Google; se a volta do Google acontece fora da aba que a iniciou (possível em alguns apps instalados), o convite se perde e a pessoa procura quem convidou em Seguindo. Só na web hospedada; não há links universais.
Entrar também funciona sem rede se o autenticador da passkey funcionar sem rede nessa plataforma. Se o aparelho já tem o certificado de membro, vai direto às abas, com ou sem rede: A Rua, Seguindo e Diário mostram o que está guardado nele, com a nota "Sem internet" embaixo da barra do topo. Sem conexão não dá para sincronizar nem recuperar um diário num aparelho novo. Um aparelho sem certificado ainda espera a sincronização de recuperação enquanto há rede. Depois de Entrar, o app pede navigator.storage.persist(); Ajustes também oferece "manter os dados neste aparelho".
O que a pessoa precisa saber (a tela diz o essencial):
- Sem passkey e sem código, a identidade se perde. A passkey original, as passkeys extras e o código de recuperação abrem a mesma conta; sem nenhum deles, a conta não pode ser recuperada, e não há exportação da chave. As entradas de recuperação ficam no serviço de conta da instalação (um texto cifrado que ele não consegue abrir): se o disco do serviço se perder, entre com a passkey original ou num aparelho ainda conectado e cadastre as entradas de novo. Limpar os dados do site apaga os diários guardados e perde os itens ainda não enviados da fila de saída. A mesma passkey deriva a mesma chave; com rede, o diário e o certificado que chegaram ao semeador podem voltar dele (a linha "certificado recuperado do semeador").
- Passkey criada fora da conta é outra identidade. O sistema pode oferecer outro gerenciador de passkeys (um iPhone usa as Chaves do iCloud): uma passkey criada ali pelo "criar passkey" é outra passkey, portanto outra identidade, que precisa de um certificado novo. Para a mesma conta abrir em outro gerenciador, adicione a passkey em Ajustes › Passkeys e recuperação. Uma passkey extra só funciona nesta versão do app ou mais nova: uma versão antiga, que não reconhece a marca, criaria outra identidade com ela. Se o diário guardado no navegador é de outra identidade, a página diz isso e oferece "recomeçar com esta passkey" (apaga o diário daqui; o do semeador continua sendo da chave antiga).
- Navegador sem PRF. Sem a extensão PRF não há identidade e não há alternativa. Há dois casos (textos em
apps/app/src/passkeyTrouble.js). Quando o próprio navegador diz que não consegue (sem WebAuthn, ougetClientCapabilitiessem PRF), a página diz "Este navegador não funciona com o Varanda." e sugere o Chrome, o Edge ou o Safari 18. Quando uma passkey foi criada ou escolhida mas o gerenciador de senhas que a guarda não entrega o PRF, a página diz "Não deu para entrar com essa passkey.", mostra passos numerados e o botão "tentar de novo", que volta ao cartão Entrar. Quando o navegador oferece, a página tenta pedir ao gerenciador que remova a passkey "Varanda xxxxxx" criada aqui que falhou (todas, uma vez cada), e a criação pendente e as passkeys recusadas ficam guardadas no próprio aparelho, para a página não ficar presa depois de recarregar. Se a passkey foi criada nesta página e não entregou o PRF, o passo é tocar em "tentar de novo" e criar outra, salvando num gerenciador de senhas que sincroniza entre aparelhos; se não der certo, abrir o Varanda no Safari ou no Chrome. O nó não oferece de novo, para a criação, a passkey que falhou enquanto a página estiver aberta. Uma passkey sem sincronização (chave de segurança, Windows Hello ou o perfil do navegador) é recusada na criação com o aviso de que ela ficaria presa a este aparelho; a checagem usa a flag de backup dos dados de autenticação, não uma lista de gerenciadores. Se a passkey foi escolhida em Entrar e não criada nesta página, ela pode ser a da conta, então a página nunca pede para apagá-la: só sugere tentar de novo (escolhendo outra passkey, quando o navegador não guarda uma) ou abrir em outro navegador. As passkeys criadas aqui que falharam continuam nomeadas depois de uma falha em Entrar. Num endereço com serviço de conta, quando Entrar abre neste aparelho, que não tinha diário, uma identidade sem conta (uma passkey antiga, ou uma passkey extra cujo gerenciador não devolve o identificador e que o serviço não conhece), a página mostra, antes da configuração, o cartão "Esta passkey não abriu nenhuma conta", com "Entrar com outra passkey" (esquece neste aparelho a identidade que acabou de abrir e volta a Entrar) e "Criar conta com ela" (segue como antes). O cartão nunca aparece para uma conta ligada ou excluída, nem para um diário que já estava no aparelho; sem internet, ou sem o status da conta, a entrada segue como antes, sem o cartão. Sair do cartão nunca apaga o diário deste aparelho. - Diário de antes das passkeys. Um diário antigo (com a chave gravada no navegador) não pode ser aberto nem reconstruído. Na primeira abertura, o nó apaga sozinho a chave antiga gravada no navegador (o diário continua legível, nunca mais gravável); a página oferece "apagar o diário e recomeçar" e, depois, a identidade nova precisa de um certificado novo.
- Ajustes tem "Sair" (na lista principal, na web com o nó no navegador): veja "Sair, bloquear e Recomeçar" acima. "Recomeçar", em Avançado, apaga a fila dessa identidade junto com o diário local. No fim da lista, um rodapé discreto mostra "App: web · 1a2b3c4 · 2026-11-05 · release ..." e "Servidor: 1a2b3c4" (no Android e no iOS a linha do app não traz o id da release). A linha do servidor vem do
/version.jsonda instalação (desconhecidoquando a instalação não o serve; ausente num build nativo sem instalação), e um toque copia os detalhes completos para um relatório de erro. O carimbo do app sai deEXPO_PUBLIC_VARANDA_COMMITeEXPO_PUBLIC_VARANDA_BUILD_DATE, definidos porscripts/resolve-build-info.js.
Sincronização ao publicar. Para não bifurcar o diário, antes de cada escrita (publicar, responder, perfil, certificado) o nó alcança o semeador e, depois dela, a envia. As linhas de Ajustes › Sincronização mostram isso: "sincronizando antes de publicar", "enviando ao semeador", "diário próprio escrito neste aparelho (N)" (o eco de uma escrita feita neste aparelho), "diário próprio sincronizado (N)" ou "diário próprio atrasado (N/M)". Se o semeador não responde em 15 s, a publicação não é feita. Quando a conexão com o semeador caiu há menos de 60 s (por exemplo numa implantação do semeador), a recusa é imediata, sem a espera de 15 s, e o app tenta reconectar em até cerca de 5 s nos primeiros 3 minutos de queda. Na web com o nó no navegador, essa recusa guarda a publicação ou resposta na fila de saída; sem rede, ela vai direto para a fila, sem escrever no diário.
Fila de saída. Os itens ficam no aparelho (localStorage, chave varanda-web-outbox-v2, no formato { v: 2, items }), no máximo 50 por identidade (a junção da chave antiga, abaixo, pode passar disso). O texto e o alvo (a publicação respondida) ficam lacrados: o nó do navegador os sela com uma chave derivada da PRF da passkey (RPC outbox.seal e outbox.open), e no localStorage só ficam o autor, a associação, o tipo, a data de escrita e o estado, legíveis, mais o box lacrado. O texto de um item só aparece depois de entrar com a passkey; se a identidade for bloqueada no meio da gravação, a publicação é guardada lacrada e o texto só aparece na próxima entrada. A confirmação é "guardado na fila de saída". Quando a conexão volta, a página aberta envia um item por vez, com a identidade desbloqueada, o certificado gravado, a passkey fora da recuperação, com rede e sem rodada única de sincronização ativa ou começando, pela mesma passagem de escrita (post.create / post.reply). Só sai sozinho o que foi escrito com a página aberta (nesta visita); o que ficou de uma visita anterior aparece como "guardado antes: confira o texto e toque em enviar" e espera "enviar" (ou "enviar tudo", embaixo do título da seção). O motivo: o estado da fila no localStorage não é autenticado, e qualquer script desta origem pode gravar nela enquanto a identidade está bloqueada (as ferramentas do navegador num computador compartilhado, uma extensão); sem essa regra, um texto plantado ali sairia com a chave do membro na entrada seguinte, sem ação da pessoa. A lista do que pode sair sozinho fica só na memória da página e vale uma vez, para o texto exato aprovado: se o texto guardado mudar depois, o item volta a esperar "enviar". Uma resposta na fila mostra a qual publicação ela responde ("resposta a · #N") antes de você tocar em "enviar". A data da publicação é a de quando ela entra no diário, não a de quando o texto foi escrito. Com a sincronização contínua ativa a fila é esvaziada: o nó interrompe a rodada contínua para escrever e a reinicia depois; só uma rodada única (a recuperação ou a passagem de escrita) nunca é interrompida. A regra de aprovação acima não muda. A fila recusa de imediato caracteres de controle que o diário também recusa; se não puder guardar o item, inclusive por falta de espaço ou fila cheia, o rascunho fica. As versões anteriores guardavam a fila em texto claro na chave varanda-web-outbox ({ v: 1, items }): a cada leitura os itens dela são juntados à fila nova por id (um id que já está na fila nova vale), a junção é gravada primeiro e a chave antiga só é removida se o valor dela não mudou desde a leitura; se a junção não puder ser gravada, a chave antiga fica e os itens dela ficam de fora. Os ids já juntados, ou já presentes na fila nova, ficam guardados (os 256 mais recentes, na chave varanda-web-outbox-merged), para que um item enviado ou apagado aqui não volte se a chave antiga reaparecer. Uma aba mais antiga, ainda numa versão sem o lacre, não apaga mais a fila lacrada: o que ela escreve de novo é juntado, espera "enviar" e é lacrado depois da entrada, ela passa a ver a fila vazia (o que ela escrever depois ainda é juntado, mesmo que a fila passe de 50 itens dessa identidade; aí uma publicação nova aqui é recusada como fila cheia até a pessoa enviar ou apagar algumas), e as edições dela num id já juntado são ignoradas, com duas exceções. Um item que ela já estava enviando entra como incerto (o pedido dela pode estar a caminho). Um item juntado ainda na fila guarda uma marca no próprio item, e assim toda janela da versão nova, nesta visita ou numa próxima, acompanha a aba antiga: enquanto ninguém mexeu nele aqui, se a aba antiga o mostrar enviando ou incerto, a cópia daqui passa a incerta, e se o mostrar com falha, passa a falhou; depois disso ele não sai de novo sozinho. Sumir da aba antiga não muda nada, nem uma fila vazia ou ilegível gravada por ela: depois da junção ela vê a fila vazia e grava uma fila vazia sem ter enviado nada, e ela sempre grava que está enviando antes de enviar. "Apagar" tira a marca; "enviar" e "tentar de novo" não: até este app marcar o item como enviando, um envio começado na aba antiga ainda o deixa incerto, e ele não sai daqui. Uma marca plantada só faz o item esperar. Não há trava entre as abas: se este app marcar o item como enviando antes de chegar a marca de envio da aba antiga, as duas abas o enviam. Os itens em texto claro são lacrados depois da entrada, aparecem para aprovação e nunca saem sozinhos. Depois de entrar, o app abre os itens um a um: para quando a identidade está bloqueada, a conexão fechou ou estourou o tempo, não há nó, a sessão fechou ou há pedidos demais; pula o item numa recusa definitiva (item de outra identidade, box inválido ao lacrar, erro de uso ou de validação, método desconhecido num nó mais antigo); e tenta de novo, depois de 30 s, em qualquer outro erro, enquanto a mesma identidade continuar desbloqueada. Um item só é descartado quando o box não abre (BAD_BOX ou "parâmetro inválido: box"), sem aviso. Itens fora dos limites do nó são descartados ao ler. "Apagar" remove qualquer item que não foi aberto nesta janela, em qualquer estado (inclusive sending); um item sending já aberto fica até ser reconciliado. Enquanto houver um item sending da mesma identidade, aberto nesta janela ou não, nada mais sai dela. Limite conhecido: um item sending lacrado que esta janela não consegue abrir (uma recusa definitiva, como erro de uso ou um nó mais antigo sem outbox.open) segura a fila até a pessoa apagá-lo; o Diário o mostra como enviando, com "Texto protegido até desbloquear.", e "apagar" libera a fila. Nada é reenviado sozinho. O lacre protege só o texto e o alvo, e um script que roda nesta origem ainda pode lacrar e abrir; o texto aberto fica na memória da página.
Uma publicação com fotos nunca entra na fila: ela precisa do semeador na hora. Os itens esperam no Diário, na seção Aguardando envio, nunca em A Rua, com "apagar", "enviar" nos que ficaram de uma visita anterior e, depois de falha definitiva ou incerta, "tentar de novo". Durante o envio, essas ações ficam indisponíveis. Se uma recarga deixa um item no meio do envio, o app confere o diário antes de reenviar qualquer coisa: só conta como publicado o texto que aparece acrescentado naquela tentativa, não um texto igual de outra ocasião. Se ele não está lá, o item volta à fila e, por ser de uma visita anterior, espera "enviar". Qualquer dúvida vira "incerto: pode ter sido aplicado; confira antes de repetir"; o item fica para a pessoa decidir no Diário, sem ser apagado nem reenviado automaticamente.
Conectar (uso avançado e desenvolvimento). Fora de uma instalação hospedada (por exemplo localhost), ou quando não há /varanda.json, a tela Conectar da web continua pedindo:
- a chave pública da associação (64 dígitos hexadecimais);
- o endereço do semeador:
ws://ouwss://, com servidor, porta e caminho opcionais (por exemplowss://semeador.exemplo/seeder), sem usuário, consulta nem fragmento. Numa páginahttps, sówss://(o navegador recusaws://ali).
O nó confere o semeador pelo certificado que a associação assinou para ele, como a CLI faz; a chave do semeador não é pedida. Um endereço que responde sem esse certificado não recebe nada: a sincronização mostra "peer seeder não verificado" e o aviso "o endereço configurado não respondeu como um semeador verificado".
A configuração, que não é segredo, fica no localStorage (varanda-web-config) e só é gravada depois que o nó abre com ela. Ajustes › Conexão mostra o estado ("o nó roda neste navegador"), a associação e o endereço do semeador; dá para trocar o endereço ("aplicar e reconectar" fecha o nó e o abre de novo), e a associação fica só para leitura depois que a identidade existe.
Uma janela por origem no navegador: o nó guarda o diário no IndexedDB e duas janelas gravando nele estragariam o diário. A primeira fica com o nó (Web Lock varanda-node); a outra recebe do nó a mensagem "outra aba já usa o Varanda neste navegador" (inalterada) e, na tela Conectar da web hospedada, mostra a frase simples "O Varanda já está aberto em outra aba ou janela. Feche a outra e toque em Tentar de novo.". Isso vale também entre uma janela instalada e uma aba da mesma origem. Num navegador sem a API Web Locks, não há essa proteção.
Limites desta versão (detalhes em verification.md, seções 10 e 11):
- Quem serve a página pode trocar o código dela; a chave está na memória da página enquanto a identidade está desbloqueada, e a sessão guardada pode ser usada por qualquer script desta origem (ou por uma cópia do perfil do navegador) até "Sair" ou 30 dias sem uso.
- A passkey vale para o endereço exato da página (
rp.idé o host): mudar de endereço depois exige trabalho extra. - O autenticador da passkey pode precisar de rede, conforme a plataforma; ter o app instalado não garante Entrar sem rede.
- O navegador pode negar
navigator.storage.persist(). Mesmo depois do pedido, o IndexedDB pode ser removido pelo navegador se a persistência não for concedida; a fila de saída também depende do armazenamento local, não é uma cópia no semeador. - A janela instalada e a aba da mesma origem se excluem pelo Web Lock
varanda-node. A fila de saída é um único valor nolocalStorage, atualizado por leitura, alteração e gravação: sem a API Web Locks, duas janelas poderiam rodar e guardar textos ao mesmo tempo, perdendo um dos itens. Os navegadores que podem Entrar com WebAuthn PRF (Chrome/Edge recentes e Safari 18) têm Web Locks e barram a segunda janela; sem essa API, o próprio diário já estaria desprotegido. - Dois aparelhos publicando ao mesmo tempo ainda podem bifurcar o diário, mesmo com a sincronização antes de escrever; o semeador apaga um diário bifurcado.
- Cada arquivo de um diário aberto fica inteiro na memória da aba enquanto está aberto (as gravações no IndexedDB são por página de 16 KiB, não o arquivo inteiro). O núcleo de fotos não: os dados dele são lidos por página, sob demanda, com no máximo 64 páginas de 16 KiB em cache.
Vínculo com a conta Google e @nome. Numa instalação hospedada, o passo "Escolha seu @nome" (e depois Ajustes › Conta e @nome) tem o vínculo: a pessoa escolhe um @nome e toca "vincular conta Google" (o texto visível é uma linha: "A associação guarda o vínculo com sua conta Google; o e-mail nunca vai para o seu perfil nem para o seu diário.", e o resto fica atrás do botão de informação, que abre "Por que confirmar com o Google"); a página abre o Google (só escopos openid e email), volta, recarrega, pede a passkey de novo e mostra "Confirme o vínculo com o nome @x" ("confirmar vínculo"). Ao confirmar, o serviço de conta emite o certificado de membro e o primeiro registro de @nome, e a página os grava no diário. A folha "Por que confirmar com o Google" diz que a associação registra o vínculo entre a conta Google e a conta Varanda (para liberar a conta e o @nome, atender uma ordem judicial ou bloquear a conta), que esta etapa não verifica a idade e que o @nome pode ser trocado uma vez a cada 7 dias. Depois, o cartão Identidade mostra o @nome e "trocar @nome": antes de 7 dias mostra "Você poderá trocar o @nome de novo em ." e nenhum campo; depois, um campo e a frase "Depois de trocar, você só poderá mudar de novo daqui a 7 dias." antes do botão. Quem já tem certificado (a identidade piloto, com certificado v1) também pode vincular e ganha um @nome, e o certificado dela continua v1. O Google só é aberto pela página inteira, sem script do Google dentro dela. Seguindo aceita @nome além da chave e, na web hospedada, também busca pessoas por nome ou @nome (veja Seguindo, abaixo). Nos passos da primeira configuração da web hospedada não há o link "Conexão": ele só aparece onde a pessoa pode precisar configurar o nó (app nativo, configuração manual da web).
Recorrer de um bloqueio. Na web hospedada, Ajustes › Recorrer de um bloqueio (a linha existe na web hospedada e no app com a instalação da associação, tipo web, para quem entra com passkey). Sem conta Google vinculada, a tela manda vincular em Ajustes → Conta e @nome; com ela, a explicação fica atrás de um ⓘ com o título "Como funciona o recurso": outra pessoa da equipe, que não decidiu o bloqueio, lê o pedido, e, negado o pedido, só se pode recorrer de novo em 30 dias. O texto é opcional (até 1000 caracteres), é assinado com a chave do diário e não vai para o diário nem para outras pessoas. Chave que não está bloqueada recebe "esta conta não está bloqueada". O nó nativo sem instalação e o varanda-serve não têm a linha: a chave deles não assina. Detalhes em docs/verification.md, seção 125.
Convites para entrar. Quando o operador define VARANDA_INVITES_PER_WEEK (a política vem de GET /account/invites/policy), um vínculo novo só termina com um convite. O link é /convite/<código>: a página guarda o código só na aba (sessionStorage, chave varanda-signup-invite), troca o endereço para / e mostra o botão do Google; o código não é enviado ao Google, só ao serviço de conta no início do vínculo. Sem código (ou com um inválido), o passo do vínculo mostra uma tela calma: "Para entrar, abra o link de convite que alguém da rede te enviou. Nada sobre você fica guardado enquanto o convite não for usado.". Em navegação privada que recusa o armazenamento da aba, o código fica só na memória da página e se perde na ida ao Google; abrir o link de novo resolve. Quem já é membro não precisa de convite. Ajustes › Convidar pessoas existe só na instalação hospedada (web e app nativo), só com o portão ligado e só para quem já tem o vínculo: antes de criar mostra quantos convites a pessoa pode criar por semana ("Você pode criar até N convites por semana.", da política, ou a contagem do resumo assinado quando o serviço o responde) e, depois de criar, "Restam K de N convites nesta semana." (da resposta assinada de criação; o status da conta não traz essa contagem), tem o botão "Criar link de convite", e o link novo aparece uma única vez, com copiar e compartilhar. O link vale para uma pessoa só e por 7 dias, e a cota renova toda segunda-feira, no horário de Brasília, sem acumular. Detalhes do serviço no README ("Convites") e em docs/verification.md, seção 37. Cartão de convite: em Convites, "Mandar com um cartão" junta ao link um cartão assinado (nome de quem recebe, mensagem curta e um de 13 desenhos regionais) que viaja só no fragmento #c1.<corpo> (mais o ?c= público); ao abrir, o app guarda o cartão na aba (sessionStorage, chave varanda-signup-invite-card, 24 h) ou na memória do processo no app instalado, e tira o fragmento e o ?c da barra de endereço na mesma passada em que guarda o código. O cartão só aparece depois que inviteCard.verify aceita a assinatura, antes da introdução (espera o nó por até 6 s) e, para quem passou pela configuração segurando o cartão, depois da chegada, com Seguir e Mandar um oi; nada segue ninguém sozinho, e um link /convite/... nunca vira prévia. Para mostrar quem escreveu, o app consulta o status público da conta pela chave de quem convidou (a mesma consulta de um perfil), antes do cadastro; nome e mensagem não saem do aparelho. Nos mensageiros, o link de convite mostra uma prévia com o desenho escolhido (pelo ?c= público) e, num convite vivo, "@nome te mandou um convite pra Varanda"; é o serviço de conta que a monta para robôs conhecidos, e uma pessoa no navegador abre o app como antes. Detalhes em docs/verification.md, seções 127 e 128.
Convites de surpresa. Com VARANDA_INVITE_DROPS=1 na instalação, o app hospedado, o nativo com a instalação inclusive, descobre quantos convites já abriram pelo resumo assinado (POST /account/invites/summary, invite.sign com a ação summary) e mostra isso em Ajustes › Convidar pessoas, junto de um aviso dentro do app quando um convite chega. Na instalação hospedada com vistos sincronizados, esse aviso aparece uma vez por janela de convite e por conta: o aparelho espera a primeira passagem de vistos da sessão e a chave das marcas (seen.onceKey), no máximo cerca de 4 s, também em caso de falha, para saber da marca gravada por outro aparelho da mesma passkey, e um aviso que ainda não apareceu na tela deixa de aparecer quando essa marca chega depois; um aviso já na tela fica até a pessoa agir. No nó core nativo, no varanda-serve, com o app bloqueado ou sem os Termos aceitos, vale por aparelho, como antes. Sem o recurso, o resumo responde semanal e a tela segue como antes. Não aparece dia nem hora de nenhum convite. O aviso do sistema (Web Push) é só da PWA hospedada: o app nativo não recebe push e vê o convite ao abrir. Antes do momento, criar o link responde convite-aguardando e o app mostra que o convite ainda não chegou. Ver docs/verification.md, seção 97.
Seguir ou deixar de seguir também grava um registro follow no próprio diário (protocol.md, seção 2), por isso a lista é pública (quem tem o diário vê quem a pessoa segue) e chega igual a todos os aparelhos dela. Seguindo diz isso: "Quem você segue é público e aparece igual em todos os seus aparelhos."
- Na web com o nó no navegador, seguir pede a identidade desbloqueada (senão: "identidade bloqueada: entre com a passkey") e vale na hora: a lista do aparelho muda e a mudança fica pendente, assinada com a chave da identidade (uma mudança por pessoa seguida, a mais nova vale). Mudanças gravadas no armazenamento de um perfil sem sessão, sem essa assinatura, são descartadas e nunca entram no diário, a mesma regra da fila de saída. Uma mudança que o diário já registrou (ou que ficou mais velha que o registro do diário) não é gravada de novo, então copiar ou repetir mudanças antigas não muda nada. Com o certificado gravado, o nó confere a assinatura de cada mudança e grava os registros pendentes pela passagem de escrita (alcança o semeador, grava, envia). Se falhar, aparece o aviso "aviso: seguidos ainda não enviados" e as mudanças ficam pendentes para a próxima vez.
- Os seguidos que um aparelho guardava antes desta versão nunca são publicados sozinhos: a lista antiga do aparelho não tem como ser autenticada, e uma entrada plantada nela seria publicada. Na primeira entrada depois da atualização, Seguindo mostra o cartão "Pessoas que você seguia neste aparelho" com a lista exata (só as chaves que o diário nunca mencionou), pelo nome (quem o app não conhece aparece como "Alguém sem nome" e um pedaço curto da chave), cada uma com a caixa marcada, e os botões "Publicar selecionados" e "Agora não". Só as confirmadas viram mudanças assinadas e chegam ao diário; as desmarcadas saem da lista deste aparelho. "Agora não" esconde o cartão até a próxima vez que o app abrir. Até a pessoa decidir, este aparelho mantém a lista antiga só para ele e não recebe as mudanças de seguidos feitas em outros aparelhos. Um aparelho sem nada a confirmar (um aparelho novo, ou um cujos seguidos já estão todos no diário) dá isso por resolvido sozinho e passa direto a receber os do diário.
- As mudanças feitas em outro aparelho chegam pela sincronização: quando o diário próprio está em dia, o nó aplica os registros
followe avisa a página (eventofollows.changed), que recarrega A Rua e a contagem; a rodada contínua reinicia uma vez para seguir a lista nova. Então uma pessoa seguida ou deixada em outro aparelho aparece aqui na rodada seguinte, sem ação da pessoa. - No app com configuração manual e no
varanda-serve(e na CLI), seguir grava o registro na hora, se o certificado já existe; eles não recebem os seguidos de outro aparelho pela lista local. O app instalado com a instalação se comporta como a web.
Só na web hospedada (com o nó no navegador) e no app instalado com a instalação, com a identidade desbloqueada e rede. No app, o botão "Foto" abre a biblioteca de fotos do aparelho, e a imagem é reduzida a no máximo 2048 px no lado maior e reencodada sem EXIF nem GPS: no iPhone, AVIF quando o codificador do sistema funciona, senão WebP; no Android, WebP; JPEG em último caso. Uma foto com transparência sai em WebP (PNG se o WebP falhar). GIFs ainda vão como estão. Avatar, capa de vídeo e miniatura de link não mudam. Uma publicação ou anúncio só com fotos AVIF sai sem og:image na página pública, porque nem todo leitor de links mostra AVIF. O app confere toda foto recebida com o leitor estrito (mediaBounds) antes de mostrá-la, e o serviço de contas e a CLI recusam no envio a foto que ele recusaria (acima de 16384 px de lado ou 16777216 px no total, ou de tamanho diferente do declarado). O botão "Foto" do Publicar escolhe até 10 imagens (JPEG, PNG, WebP ou GIF):
- As fotos são redesenhadas num canvas (no máximo 2048 px no lado maior) e gravadas como WebP de qualidade 0,85 quando o navegador realmente produz WebP, senão JPEG 0,85. Isso remove os metadados EXIF, inclusive a localização (GPS). Uma foto de origem acima de 50 MiB é recusada, e o resultado tem no máximo 8 MiB.
- Antes de publicar, cada miniatura tem setas para mover a foto uma posição para antes ou para depois; a primeira foto é a capa (marcada "capa"), define a forma do quadro do carrossel e é a que aparece no Mural; as setas ficam indisponíveis enquanto a publicação é enviada e não aparecem com uma foto só.
- GIFs vão como estão, sem redesenho (no máximo 8 MiB); os blocos de comentário e de aplicação do GIF ficam.
- Nada é enviado antes de a pessoa tocar "Publicar": as fotos escolhidas ficam só na memória da página, e tirar uma foto ou fechar o Publicar a descarta sem ter enviado nada. Ao tocar "Publicar", os itens vão um por vez, com progresso, para o núcleo de fotos deste aparelho (um núcleo por aparelho, assinado por uma chave derivada da passkey), e só então sai a publicação com as fotos; o texto pode ficar vazio. Um item que falha mostra "falhou · tentar de novo" e a publicação não sai. O primeiro envio de um aparelho declara o núcleo no diário antes de gravar qualquer byte da foto.
- Depois de "Publicar", os bytes enviados são públicos e permanentes no núcleo de fotos, mesmo que o envio de outro item ou a publicação falhe depois: é o único caso em que ficam bytes públicos sem publicação que os use.
- Publicação com fotos precisa de conexão: sem rede o botão fica indisponível ("Fotos precisam de internet") e ela nunca vai para a fila de saída.
- O núcleo de fotos de um aparelho guarda no máximo 256 MiB (8192 blocos de 32 KiB). Cheio, o envio falha com "espaço de fotos deste aparelho esgotado"; ainda não há troca por um núcleo novo.
No Android, a Varanda aparece na folha de compartilhar do sistema para fotos, GIFs, um vídeo, texto e links. No iOS, ela aparece por uma extensão que salva o conteúdo; a pessoa abre a Varanda e, quando o app está pronto, Publicar aparece preenchido. Na PWA instalada no Chrome do Android, ela também aparece na folha, para fotos JPEG, PNG e WebP, GIFs, um vídeo MP4, texto e links. O alvo do manifesto envia POST /compartilhar; o service worker guarda o conteúdo no cache varanda-share e abre /; o Publicar aparece preenchido quando o app está pronto. Um vídeo entra sozinho, um por vez, como uma publicação leva (com dois vídeos escolhidos, a Varanda não aparece na folha do Android nem do iOS): no Android e no iOS, um MP4 ou MOV de até 512 MiB é copiado e o Publicar o prepara como um vídeo escolhido na galeria (até 30 s, codificado de novo para caber); na PWA, só um MP4 que já cabe (até 8 MiB e 30 s), como na galeria do navegador. Fotos e vídeo não vão juntos: quando chegam os dois (no iOS e na PWA; no Android, a Varanda só aparece na folha para um vídeo sozinho), as fotos ficam e o Publicar diz que o vídeo ficou de fora; se o rascunho já tem um vídeo, o compartilhado não entra e o Publicar avisa. A foto passa pelo caminho já existente, sem EXIF nem GPS, o GIF segue animado e só as 10 primeiras fotos ficam. Nada é publicado antes de a pessoa tocar em Publicar, e o compartilhamento vale por 1 hora. Uma foto compartilhada que não abriu por um erro passageiro mostra "não foi possível abrir a foto · tentar de novo", e um toque tenta o mesmo arquivo de novo; formato não aceito e arquivo grande demais não oferecem a nova tentativa. No Android, o compartilhamento espera na pasta do próprio app que o sistema não esvazia sozinho (não no cache), e é apagado 1 hora depois mesmo com o app fechado. Na PWA, um compartilhamento que não coube no espaço do navegador abre o app com o aviso "o compartilhamento não coube no espaço do navegador", e o texto que a pessoa escrevia no Publicar (só uma publicação comum, sem resposta, citação ou Página) volta depois do recarregamento que o compartilhamento traz: fica na aba (sessionStorage), por até 1 hora, só para a mesma conta, e sai ao bloquear ou trocar de conta; as fotos do rascunho não voltam. O Safari do iOS não tem Web Share Target, e uma aba do navegador que não está instalada não aparece na folha. Mandar um compartilhamento para uma conversa não faz parte deste trabalho. Detalhes em verification.md, seções 178, 179 e 180, e em docs/verification/fix-share-leftovers.md e docs/verification/feat-share-video.md.
Exibir: numa publicação do feed, as fotos vêm primeiro e a legenda fica embaixo delas (uma citação vem depois da legenda). Uma publicação com uma foto mostra essa foto na proporção dela, entre 1:2 e 2:1, e um toque abre a tela cheia. Com 2 a 10 fotos, a publicação mostra um quadro só: a forma segue a proporção da primeira foto, presa entre 4:5 (retrato) e 1,91:1 (paisagem), como no Instagram, e as outras fotos são cortadas para preencher o quadro. Deslizar para o lado troca a foto. Os pontos ficam embaixo do quadro, no máximo 5 de cada vez, acompanhando a foto atual, e o ponto da foto atual usa a cor de destaque. A pílula "N de M" fica no canto superior direito da foto: aparece quando o carrossel surge ou a foto muda, fica 1,6 s e some num fade de 250 ms; com Reduzir movimento, some de uma vez depois dos 1,6 s. As setas dizem a posição ao leitor de tela ("Foto anterior, 2 de 5", "Próxima foto, 4 de 5"). Na web, setas redondas aparecem sobre a foto só enquanto o mouse está em cima ou o foco do teclado está no carrossel; um toque, um clique ou fechar a tela cheia com um toque nunca as deixa na tela. Um toque abre a tela cheia na mesma foto. Na tela cheia dá para deslizar, usar as setas ou o teclado (esquerda e direita), e fechar devolve a publicação à última foto vista. Na tela cheia, a foto amplia com pinça até 4x ou toque duplo a 2,5x; com a foto ampliada, deslizar não troca de foto, e arrastar para baixo em 1x fecha. Verificação em docs/verification.md seção 225. A publicação citada, dentro do cartão, mantém a grade pequena (uma, duas lado a lado, três, 2x2) e, de 5 fotos em diante, a 2x2 mostra "+N" na quarta foto (N são as fotos que não aparecem) e um toque abre todas em tela cheia. A bolha da conversa mantém a grade (uma, duas, três ou 2x2). O detalhe de um anúncio da Feira mostra o mesmo carrossel. Só a foto atual e as vizinhas são carregadas, e uma foto que já foi mostrada continua carregada. Nas publicações do feed, as fotos continuam parte do elemento único da publicação para leitores de tela, como antes (limite conhecido, para uma correção seguinte). No anúncio, a foto atual é o próprio botão "foto N de M". Com "reduzir movimento" ligado, as setas trocam de foto sem animação. Só a web hospedada e o app instalado com a instalação buscam as fotos, na rota /media do semeador na própria origem (protocol.md, seção 7): confere a descrição, exige resposta 200 sem redirecionamento, recebe exatamente o número de bytes da descrição e compara o SHA-256; só então mostra a imagem por um endereço blob: (até 64 guardados, 4 buscas por vez). No app instalado, a foto conferida vira um arquivo no cache do app, varrido na abertura. No app com configuração manual, no varanda-serve e numa página que não é a hospedada aparece um quadro neutro "foto". O semeador só serve a foto de um diário que ele admitiu e não está bloqueado. As fotos de quem o aparelho não segue (na Espiadinha, numa conversa, num perfil, numa republicação ou numa citação) são buscadas com cache: 'no-store': o aparelho não guarda nada de quem não segue, nem no cache HTTP do navegador; as próprias e as dos seguidos usam o cache longo.
Vídeos do feed continuam começando só ao tocar na capa. Depois de começar, dentro da publicação e em tela cheia, mostram o mesmo botão Silenciar som ou Ativar som, com alto-falante ou alto-falante riscado, compartilhado com os momentos. Nada toca sozinho no feed: música do Audius numa publicação só toca pelo cartão por toque, e os momentos continuam tocando vídeo e música sozinhos. Um vídeo aberto com o som silenciado toca sem som. Depois de uma recusa do navegador, a pílula Ativar som continua e faz o mesmo que o alto-falante: ativa o som por inteiro. Os controles da própria plataforma podem ativar o som só daquele vídeo, mantendo o silêncio compartilhado. O botão do app reflete esse silêncio compartilhado, mesmo quando o controle da plataforma muda o som daquele vídeo. O silêncio é guardado neste aparelho, e só nele: o registro {"v":1,"muted":bool} fica em varanda-som-mudo (localStorage na web, varanda-som-mudo.json na pasta de documentos no app nativo, pelo par soundMuteStore), lido de forma síncrona na abertura em App.js e nunca enviado a ninguém. Um registro presente mas ilegível vale como silenciado; sem registro, o som está ativado. Reabrir o app ou recarregar a página mantém a última escolha. Verificação em docs/verification.md §208.
- O cache de endereços
blob:é só em memória, também na Espiadinha. As fotos de quem a pessoa não segue (Espiadinha incluída) são buscadas comno-storee não ficam no cache HTTP; só as próprias e as dos seguidos usam o cache longo. - Uma publicação pode aparecer antes de as fotos chegarem ao semeador: a passagem de escrita confirma o diário, e os blocos das fotos vão pela sincronização contínua logo depois. Se a aba fecha ou a rede cai logo depois de publicar, quem vê a publicação recebe "foto indisponível" até esse aparelho voltar a se conectar. O app tenta de novo sozinho algumas vezes uma foto que falhou, e um toque também tenta.
- Um diário vale com no máximo 4 núcleos de fotos (os 4 declarados mais recentes), um por aparelho e sem troca. Quem publica fotos de um 5º aparelho faz o semeador largar o núcleo do aparelho mais antigo: as fotos dele respondem 404 para todos até aquele aparelho enviar uma foto nova (o que declara o núcleo de novo), e se perdem de vez se o aparelho não existe mais. Enquanto o serviço está sem emissor, o vínculo responde "indisponivel" (a cerimônia do operador está no README); o app nativo e a CLI continuam colando o certificado emitido pela associação. Detalhes e limites em verification.md, seção 12.
Na web hospedada e no app instalado com a instalação, o clipe do compositor de uma conversa abre a folha "Anexar". Hoje ela tem "Foto" (até 4 da galeria) e, quando a associação liga a busca de GIFs, "GIF" (abaixo); a mensagem de voz tem um botão próprio no compositor (abaixo). Da galeria saem até 4 imagens por mensagem; uma foto é reencodada (sem EXIF nem GPS) e um GIF vai como está. As escolhidas aparecem como miniaturas acima do campo, cada uma com um botão para tirar, e a legenda é opcional: uma mensagem pode ter só fotos. Nada é enviado antes de tocar em enviar.
- Mensagem direta: as fotos são cifradas no aparelho e vão pelo canal de mídia das conversas do semeador, sob um id aleatório, por 14 dias (protocol.md, seções 11 e 12); a chave só viaja dentro da mensagem selada. O semeador não vê a imagem nem sabe para quem ela é. Numa mensagem de quem ainda está em Pedidos de mensagem nada é baixado sozinho.
- Grupo público: as fotos vão para o núcleo de fotos de quem escreve e são públicas como o texto do grupo, buscadas como as fotos das publicações.
- Grupo privado: as fotos são cifradas no aparelho; o núcleo de fotos guarda só texto cifrado e a chave viaja dentro da mensagem selada do grupo. Só o nó decifra: o app nunca busca uma foto privada por HTTP.
- Exibir: a bolha mostra as fotos na grade (uma, duas, três ou 2x2), com a legenda embaixo. Um toque abre a tela cheia ("Abrir foto", "Fechar foto"). Na tela cheia da conversa, a foto amplia com pinça até 4x ou toque duplo a 2,5x, e arrastar para baixo em 1x fecha. Uma foto que já não existe (passaram os 14 dias, ou o aparelho de quem escreveu não a enviou) mostra "Mídia indisponível".
- Num pedido de mensagem (de quem a pessoa ainda não aceitou), nada é baixado sozinho: cada foto aparece como "Toque para ver a foto" e só é baixada e aberta depois do toque; ao aceitar o pedido, as fotos passam a abrir sozinhas. Do mesmo jeito, num pedido de mensagem um cartão de YouTube, SoundCloud, Spotify ou Apple Music fica um cartão comum, com o link no texto, até a pessoa aceitar; depois disso o player carrega como em qualquer conversa.
- As fotos abertas de mensagens diretas ficam num cache local cifrado (256 MiB, as mais antigas saem primeiro), apagado ao trancar a sessão, em Sair e ao apagar os dados do app.
- No app instalado, uma foto aberta de mensagem direta ou de grupo privado é mostrada a partir de um arquivo decifrado temporário (
<documentos>/varanda/media-read, só o app o lê). Ele é apagado quando a imagem sai do cache, ao trancar a sessão, em Sair, ao apagar os dados do app, quando o app vai para o segundo plano e na abertura do app (o que sobrou de um fechamento forçado). Ao voltar ao app, as fotos são abertas de novo. - Denunciar uma mensagem direta ou uma mensagem de grupo privado com foto: a primeira imagem é aberta da cópia do aparelho, regravada como JPEG de até 700 KB e mostrada em "Imagem que será enviada" antes do envio ("A imagem vai para a moderação, aberta."). Se não couber, a tela diz "A imagem não coube e não foi enviada.". A moderação a vê como "não conferida", e a denúncia sempre fica para uma pessoa. A denúncia de um grupo público aponta para a mensagem, sem imagem.
- No app instalado, abrir uma foto depende do fetch do worklet Bare (
apps/app/worklet/bare-fetch.js): confira num build de aparelho depois denpm run prepare:native -w apps/app(verification.md, seção 107).
Nas mesmas conversas (mensagens diretas, grupos públicos e privados), com o compositor vazio, o botão de enviar vira um microfone ("Gravar mensagem de voz"). Ele só aparece quando o nó oferece mídia para a conversa, o nó está online e o aparelho ou o navegador consegue gravar audio/mp4 (a capacidade, conferida por canRecordMp4, nunca por Platform.OS): no Android e no iOS com o expo-audio, na web com o MediaRecorder do Safari e do Chrome recente. Onde não dá para gravar audio/mp4, não há microfone nem aviso sobre ele.
- Segurar e gravar: o tempo corre na barra, com "deslize para cancelar"; arrastar para a esquerda descarta a gravação, e soltar o dedo envia. Uma gravação curta demais (um escorregão) não é enviada e a tela mostra "Segure para gravar".
- Tocar e gravar (acessibilidade): um toque no microfone grava sem segurar; "Parar" para e envia, "Cancelar" descarta.
- Limite de 2:00: aos dois minutos a gravação para sozinha e a mensagem é enviada. Uma gravação por vez, e uma mensagem de voz vai sozinha na mensagem, sem foto nem legenda.
- O microfone só é pedido quando a pessoa começa a gravar, nunca antes; sem permissão, a tela diz "Sem acesso ao microfone". Sair da tela, mandar o app para o segundo plano, trancar a sessão ou perder a conexão cancela a gravação. O app não tenta reenviar sozinho uma mensagem de voz que falhou.
- Guarda e proteção: como as fotos das conversas (acima). Mensagem direta: cifrada no aparelho, no canal de blobs sob um id aleatório por 14 dias. Grupo público: pública como o texto. Grupo privado: cifrada, só o nó decifra. O formato é
audio/mp4de até 2 minutos e 1,5 MiB; um arquivo que declara uma faixa de vídeo é recusado pelos bytes, não pelo tipo informado. Uma mensagem de voz continua só áudio. - Ouvir: a bolha "Mensagem de voz" tem tocar e pausar e mostra a duração total quando está pausada e, enquanto toca, o tempo que falta; tocar uma pausa a que estava tocando. Num pedido de mensagem, nada é baixado sozinho: a bolha mostra "Toque para ouvir" e só baixa depois do toque. Um áudio que não chega mostra "Mídia indisponível".
- Denunciar uma mensagem direta ou de grupo privado com mensagem de voz: o áudio vai aberto, como foi gravado, se tiver até 700 KB; a tela da denúncia deixa ouvir antes de enviar ("O áudio vai para a moderação, aberto."), e acima disso diz "O áudio não coube e não foi enviado.". O painel de moderação mostra "áudio não conferido", e a denúncia sempre fica para uma pessoa.
- Conferência manual: verification.md, seção 108.
Nas mesmas conversas, quando o operador configura um provedor de GIFs no serviço de conta (VARANDA_GIF_API_URL e VARANDA_GIF_API_KEY), a folha "Anexar" ganha "GIF". A opção existe só com o nó hospedado (na web hospedada e no app instalado com a instalação), que assina a sessão abaixo; com configuração manual ela não aparece. O app pergunta GET /account/gif/policy ao serviço de conta da instalação em uso e, com { enabled: false }, não mostra a opção pelo resto da sessão; sem resposta (rede, erro ou resposta inválida), também não mostra, e pergunta de novo numa próxima abertura depois de pelo menos 30 s. Trocar de instalação pergunta à nova. Que a pessoa está vinculada fica guardado por 5 minutos, para a folha "Anexar" não perguntar a cada abertura; uma sessão recusada com nao-autorizado esquece essa resposta, e a opção some na próxima abertura. Sem o provedor configurado, as outras rotas /account/gif/* respondem 404 feature-off.
- Sessão: antes da primeira busca, o nó assina um pedido só de leitura (
invite.sign, açãosummary) sobre um nonce do serviço; o serviço confere a chave do membro vinculado e devolve um token de 12 horas, enviado no cabeçalhoauthorization: Bearer <token>(que os registros de erro do proxy apagam), nunca na URL. - Busca:
POST /account/gif/searchcom o texto e o cursor no corpo JSON ({ q }ou{ q, cursor }), nunca na URL. O texto (1 a 64 pontos de código) vai do app ao serviço de conta da associação, que pergunta ao provedor de GIFs a partir do próprio endereço e com a chave da associação. O provedor nunca recebe o endereço, a conta, a chave ou um cookie do membro. A resposta ao app traz só ids opacos, largura, altura e tamanho: nenhuma URL do provedor chega ao app, e o app nunca nomeia uma URL. - Miniaturas e imagem: chegam pelo serviço de conta (
/account/gif/image/<id>?size=tiny|full), que só busca URLs da sua própria tabela de resultados recentes, em https, no host da API ou num dosVARANDA_GIF_MEDIA_HOSTS, resolvidos só para endereços públicos. - Envio: o app baixa o GIF escolhido inteiro pelo serviço de conta (até 8 MiB) e o envia como uma foto da conversa, pelo mesmo caminho e com a mesma proteção (mensagem direta cifrada no canal de blobs por 14 dias; grupo público, público; grupo privado, cifrado). Quem recebe lê a cópia do Varanda e nunca fala com o provedor.
- Limites: por membro e por dia, 120 buscas e 60 imagens inteiras; acima disso o serviço responde 429
limite-gif. O app não repete o pedido sozinho. - Registros: o serviço não guarda o texto das buscas; os registros levam só
{ event: 'gif', reason }, sem consulta, chave nem URL. - Conferência manual: verification.md, seção 111.
Com o varanda-serve não há tela Conectar, mas há os mesmos passos de identidade, certificado e nome. A associação, o bootstrap e a DHT vêm das opções do varanda-serve. O token chega no fragmento da URL (#token=...) que o varanda-serve imprime. O app o lê uma vez, tira o fragmento da barra de endereço (history.replaceState), o guarda só em memória (nem localStorage, nem cookie) e o envia em session.open; no sessionStorage fica só a marca de que a aba usa o varanda-serve, nunca o token. O navegador não envia o fragmento ao servidor. A página só conecta se foi aberta em 127.0.0.1 ou localhost. Ela não reconecta sozinha: Ajustes › Conexão tem o botão "reconectar". Se outra aba abrir a sessão, esta mostra "outra aba assumiu a conexão".
Com a instalação da associação (tipo web), o app para iOS e Android roda o mesmo nó do site e tem as mesmas telas e regras, com estas diferenças:
- Endereço. O endereço é o que foi salvo em Conectar, depois o valor do build (
EXPO_PUBLIC_VARANDA_INSTALLATION), depois o padrãohttps://bora.varanda.app, então a primeira abertura não pede o endereço. O app lê<instalação>/varanda.jsone conversa com o semeador porwss://<instalação>/seeder. A chave da associação, o bootstrap e a DHT pública ficam atrás de "Avançado" (configuração manual). - Mesma passkey, mesmo diário. A identidade é a passkey do site (WebAuthn PRF), por um módulo nativo local: no Android, o Credential Manager. A chave do diário é a mesma derivada no site, então o diário, os seguidos de outros aparelhos e as fotos são os mesmos. No iOS é preciso o iOS 18; o app declara o domínio associado
webcredentials:bora.varanda.app, e a entrada depende de a instalação publicar oapple-app-site-associationcom o app (VARANDA_IOS_APP_ID). Ainda não foi conferida num iPhone. Uma passkey sem PRF mostra o cartão "Não deu para entrar com essa passkey", com passos e "tentar de novo", e nada é derivado. - Mensagens diretas e grupos privados. O host entrega ao nó o resultado PRF da passkey (
identity.install, rpc.md 5.50), como o site faz. O nó deriva dele as chaves de mensagens diretas, a chave de caixa dos grupos privados e as chaves de escrita dos grupos, com o HKDF do worklet, porque o WebCrypto do Bare não tem HKDF. Assim Conversas,dm.enablee a manutenção de aparelho (participação automática e reenvio de chaves de grupo privado) funcionam no app como na web. Uma passkey de outra identidade é recusada antes de o PRF entrar no nó, e as mensagens guardadas no aparelho ficam como estavam. Um aparelho que entra agora recebe só o que o semeador guarda (14 dias). Conferência manual: verification.md, seção 118. - Continuar conectado. Uma sessão guardada no chaveiro do aparelho (
expo-secure-store, só neste aparelho) mantém a pessoa conectada por até 30 dias sem abrir, até tocar "Sair". - Conta Google, @nome, idade e convites. O passo do provedor roda só numa sessão de login que o próprio app abre (no Android, a Auth Tab, no navegador padrão ou, se ele não a tiver, no Chrome que veio instalado no aparelho; no iOS,
ASWebAuthenticationSession), que entrega o código de uso único só ao app. Sem essa sessão, o app pede para ligar a conta Google pelo site da instalação, entrando com a mesma passkey: é a mesma conta. O segredo fica só na memória do app. A idade volta porvaranda://idade. O convite é colado no app (links https abrem no navegador, não no app). Os links de grupo e de comunidade são a exceção:varanda:///g/<chave>evaranda:///c/<chave>abrem o app, e no Android também os links https/c/<chave>e/g/<chave>debora.varanda.app(App Links comautoVerify; os outros caminhos do site, como/@,/convite/e/account/*, ficam no navegador). Um link https que chega antes de a instalação carregar espera e é lido de novo quando ela carrega (o de outro domínio é descartado). Um link que chegou antes de as abas aparecerem espera na memória até as abas aparecerem num nó hospedado (não é descartado num nó manual). Ao compartilhar, o celular manda um link https absoluto da própria instalação. - Telas. Espiadinha, Conversas (Mensagens privadas e Comunidades, com os links
varanda:///g/<chave>evaranda:///c/<chave>), Busca (Contas e Publicações), Conversa e Membro completos, Curtidas, menções, contagens, Avisos (só a lista no app), denúncias, registro dos termos, compartilhar e a nota "Sem internet". - Fotos. Mostradas depois de conferidas por tamanho e SHA-256 e guardadas como arquivos no cache do app (varrido na abertura). Publicadas a partir da biblioteca de fotos, reencodadas sem EXIF nem GPS (AVIF no iPhone quando o codificador do sistema funciona, senão WebP; WebP no Android; JPEG em último caso); GIFs vão como estão. Escolher a foto do perfil também funciona.
- Fila de saída. Publicações sem rede esperam na fila de saída do aparelho e saem quando a conexão volta, como na web; fotos e citações não entram na fila. O texto e o alvo ficam lacrados também aqui (mesmo código do app; o arquivo
varanda-outbox.jsoncontinua o mesmo). - Serviço de conta. O app se identifica com o cabeçalho
x-varanda-client: appe usa um segredo do app e um código de resgate (README, "Vínculo pelo app nativo"; verification.md, seção 50).
Limites: não há aviso do sistema (push, APNs/FCM, issues #30 e #47), nem publicação nas lojas (#46); no Android só abrem o app os links /c/ e /g/ de bora.varanda.app (outra instalação não ganha App Links, e o build de depuração app.varanda.debug não está no assetlinks.json: abre esses links só depois de aprovação manual); no iOS, links https abrem o Safari, porque o app declara só webcredentials, sem links universais; a entrada com passkey no iOS só vale para bora.varanda.app.
Os nomes estão fixos; os detalhes visuais ainda mudam. O desenho (cores, tamanhos, componentes) está em app-design.md; as funções e o protocolo são os mesmos de antes.
A barra de baixo mostra só ícones, sem palavras (os leitores de tela continuam lendo os nomes), com a altura de sempre, 49 pt. A aba ativa fica sobre uma pílula suave (accentSoft, 48 por 32 pt, cantos redondos) atrás do ícone, que aparece em 150 ms; com Reduzir movimento ligado, aparece de uma vez. A aba Diário com a própria pessoa (foto ou iniciais) não desenha pílula, porque o anel verde já a marca. Há seis abas onde o nó é hospedado (o site e o app instalado com a instalação), nesta ordem: A Rua (uma estrada até o horizonte, com a faixa tracejada no centro: quem está na varanda vendo a rua passar), Espiadinha, Conversas (ícone de mensagem, conversas; o id interno continua comunidades), Feira (ícone feira; veja "Feira"), Busca (lupa) e Diário (a foto da própria pessoa ou as iniciais, com um anel verde quando está selecionada; abre em A Rua). Na configuração manual e no varanda-serve ficam quatro, sem Conversas nem Feira. Avisos não é aba: abre pelo sino no canto direito da barra do topo de A Rua, Espiadinha, Conversas e Busca, e por um sino branco no canto da faixa do Diário. Seguindo também não é aba: é uma lista aberta por "N seguindo" no Diário. Um botão verde, "publicar", abre a folha de Publicar por cima das abas; enquanto está apertado ele encolhe a 0,97 e escurece um pouco (opacidade 0,85), e com Reduzir movimento ligado só escurece; ele some em Conversas, na Feira e nas telas delas. Os ajustes ficam numa folha aberta pela engrenagem do cabeçalho do Diário. No app nativo e na web com o nó no navegador, a primeira configuração acontece antes das abas (veja "Primeira configuração"); na web hospedada, é só Entrar.
- Barra do topo (A Rua, Espiadinha, Conversas, Busca, Seguindo e Avisos). O título e, à direita, o sino de Avisos (em A Rua, Espiadinha, Conversas e Busca, só na versão hospedada; um ponto quando há novidade, nunca um número) e um botão de ajuda (o círculo com o "i") que abre a folha "Como funciona A Rua", "Como funciona a Espiadinha", "Como funciona Seguindo" ou "Como funcionam os Avisos"; a folha tem "Fechar" e o título como cabeçalho. O botão de informação é o único gatilho de ajuda: não há link de texto para ajuda; as linhas curtas que explicam algo terminam com um pequeno botão de informação que abre a mesma folha. O mesmo botão aparece nos passos da primeira configuração. Não há chip de sincronização. Quando o aparelho está sem rede (a dica de rede do navegador; o app com configuração manual conta sempre como com rede), uma nota calma de uma linha, "Sem internet", aparece embaixo da barra (no Diário, embaixo da área segura), no fluxo da tela, nunca por cima do conteúdo; com rede nenhuma nota de conexão aparece, nem "conectado" nem "sincronizando". A nota "Instalar o Varanda" não é de conexão: fica no fluxo, embaixo da barra, sob "Sem internet" quando as duas aparecem e embaixo da área segura no Diário. O estado detalhado da sincronização (o texto do antigo chip) fica em Ajustes › Avançado › Sincronização. Sem rede, A Rua, Seguindo e Diário continuam mostrando o que está no aparelho; a Espiadinha mantém só a lista já carregada nesta visita, se houver.
- A Rua. O feed, da mais nova para a mais antiga, numa linha do tempo contínua. Cada publicação tem avatar (iniciais do nome ou do @nome; sem nome, um glifo de pessoa; a cor vem da chave, módulo 5: azul, laranja, amarelo, vermelho, verde), o nome em negrito (o nome livre do perfil, sem
@no começo; sem nome, o @nome escrito como nome,ana; sem os dois, "sem nome"), o @nome verificado em texto suave quando existe, o tempo compacto ("agora", "5min", "3h", "2d"; a partir de 7 dias, a data, "5 nov", ou "5 nov 2025" em outro ano), as fotos da publicação (veja "Fotos e GIFs") e a barra de ações (veja "Linha de publicação"). Uma resposta mostra "respondendo a Nome"; quando quem foi respondido não é seguido, a publicação respondida é lida comdiary.peeke o nome vem dela, conferido pelo nó (na web hospedada e no app instalado; no app com configuração manual e novaranda-servefica "sem nome"). O Diário faz o mesmo com as respostas da própria pessoa. Uma republicação aparece como a publicação ORIGINAL com a linha "Nome republicou" em cima, e toda ação nela vale para a original; uma citação mostra a publicação citada num cartão. As originais e as citadas são lidas comdiary.peek(no app com configuração manual e novaranda-serve, só as de diários guardados no aparelho). Na web hospedada, as contagens vêm do índice do semeador (/index/counts, 31 por pedido) e o estado próprio de curtida e republicação deengagement.read. Nenhuma chave aparece como texto. A lista abre com 30 publicações e, ao chegar ao fim, pede páginas de 31 (FEED_LIMIT_MAX, em rpc.md) comfeed.read { before }, uma por vez, até "Isso é tudo por enquanto." (que não aparece sobre os estados vazios). A rolagem é infinita, como em todas as listas do app (Diário, Espiadinha, Avisos, Seguindo, perfis, Conversa, Curtidas): perto do fim a próxima página vem sozinha, também numa lista mais curta que a tela, que não rola, e numa lista vazia com mais páginas. Não há botão no estado normal. Uma página que falha não é repetida sozinha: só "tentar de novo" pede de novo. Depois de três páginas seguidas que a lista pediu e que não mostraram nada novo (um Diário cheio de curtidas, por exemplo), ela para e mostra "Nada novo nas últimas páginas." com o botão "carregar mais"; sair da região do fim e voltar também retoma. Enquanto os seguidos sincronizam, A Rua lê de novo sozinha quando o comprimento de qualquer diário seguido cresce depois da última leitura (linhasdownloadedenewest), também numa visita de volta em que a réplica guardada ainda não sabe que há mais. Uma lista curta relê a página mais nova. Uma lista longa ou cheia relê o trecho que já mostra, de baixo da primeira linha até a última, em páginas de 31 (no máximo 10 por leitura; uma leitura cortada continua na próxima): as publicações que chegam no meio desse trecho entram no lugar certo (no app nativo, a publicação que a pessoa lê fica parada na tela), nada do que está na tela sai, e as mais novas que a primeira linha esperam a pílula "ver novidades". Só quando essa releitura chega ao fim da lista com uma página cheia a próxima leitura automática procura abaixo da última mostrada. Enquanto um diário ainda cresce depois da última leitura, ou há leitura automática pendente, o rodapé diz "Ainda sincronizando quem você segue." em vez de "Isso é tudo por enquanto.". Puxar para baixo atualiza em todas as plataformas: no app nativo com oRefreshControl, na web com o gesto de puxar (limiar de 72 px) e, no computador, com a roda do mouse ou o trackpad no topo da lista (puxar além de 120 px; atualiza uma vez quando a roda para por 250 ms). Não há barra "Atualizar" visível: na web, um botão "Atualizar" escondido e focável aparece quando recebe o foco do teclado. A lista não recarrega sozinha quando a sincronização termina nem quando chega um diário: aparece a pílula "ver novidades", e só quando a pessoa toca nela a lista vai ao topo e recarrega; a posição de leitura nunca muda sozinha. A pílula vem das publicações novas dos diários seguidos e das publicações próprias feitas em outro aparelho; nada que a pessoa faz neste aparelho a acende (publicar, responder, curtir, republicar, seguir, perfil). Uma curtida ou republicação aparece na própria publicação na hora, e uma republicação feita aqui entra na lista na próxima carga. A pílula é só uma dica a partir das linhasdownloadede nunca uma contagem; pode, raramente, aparecer sem publicações novas. Tocar de novo a aba A Rua leva ao topo e recarrega se os dados têm mais de 60 s (ou há novidades); trocar de aba dentro de 60 s não recarrega. Depois de publicar, e quando os seguidos mudam (aqui ou em outro aparelho), a lista recarrega. No rodapé, só os diários bloqueados pela associação ganham uma frase ("Uma pessoa que você segue não aparece aqui."); diários com dados inválidos e publicações com data futura não são mostrados às pessoas. Sem seguidos, o estado vazio é "A Rua está vazia" com a ação "Seguir alguém"; com seguidos e sem nada, "Ainda não chegou nada" ("Quando as pessoas que você segue publicarem, aparece aqui."); uma falha de leitura com a lista já carregada mostra uma faixa de erro no topo e mantém as linhas; sem nada carregado, mostra o estado de erro com "tentar de novo" (o feed de uma Página mantém a regra antiga: uma leitura que falha limpa as linhas). A primeira carga mostra linhas de esqueleto. Quando os números podem estar incompletos (só no nó hospedado: a web e o app nativo ligado à instalação), a lista mostra uma linha pequena e suave, "Números incompletos", com um ⓘ; a linha tem alvo de 44 pt dentro dela, e o ⓘ abre a folha "Números incompletos" com a frase "Alguns números podem estar incompletos.". A linha não é uma publicação da lista. A lista deixa espaço para o botão de publicar não cobrir as ações da última publicação, e a pílula "ver novidades" nunca aparece sobre o estado vazio. A Rua continua mostrando os diários seguidos; quem a pessoa não segue aparece na Espiadinha. - Espiadinha. A Espiadinha mostra a publicação mais recente de cada diário que você não segue, da mais nova para a mais antiga; depois a segunda e, por fim, a terceira mais recente de cada um, do mesmo jeito: sem curtidas, sem sugestões e sem pesos escondidos. São no máximo três rodadas; "mais recente" é a publicação com maior
seq(a última escrita no diário): publicações, respostas, citações e republicações ainda valendo entram, curtidas não; a ordem dentro da rodada usa a data que o autor informou. Uma resposta mostra "respondendo a Nome" (o nome vem da publicação respondida, lida e conferida pelo nó) e uma republicação aparece como a original com "Nome republicou", como em A Rua, e a republicação de uma resposta nomeia o pai ("respondendo a Nome", também quando o pai é seu ou de um seguido). Republicações de diários que você não segue entram como as demais. A lista exclui o próprio diário (as próprias publicações já estão em A Rua; quem não segue a pessoa continua vendo o diário dela na Espiadinha dele) e os seguidos pelo conjunto efetivo, derivado dos registrosfollowdo diário próprio mais as operações pendentes. Funciona só na web hospedada: lê pelo semeador em memória, sem guardar esses diários no dispositivo. As fotos vêm sob demanda pela mesma rota/mediade A Rua, conferidas por SHA-256 e exibidas por endereçosblob:mantidos só em memória (sempre comno-store: são de quem a pessoa não segue; veja "Fotos e GIFs"). Abre com 30 itens e segue em páginas de 31 (PEEK_LIMIT_DEFAULT/PEEK_LIMIT_MAX,peek.read { after });nexttraz o cursor do último item exatamente quando a página está cheia, mesmo se incompleta por tempo ou orçamento. Puxar para atualizar reconstrói a lista; não há pílula "ver novidades". No topo há uma linha curta ("Até três publicações de cada diário que você não segue.") que termina com o botão de informação, que abre "Como funciona a Espiadinha" com a regra acima. As rodadas existem, mas a lista não as rotula: não há títulos entre elas. Cada publicação é uma linha de publicação (veja "Linha de publicação"): abre a Conversa e o perfil do autor e tem responder, republicar, citar e curtir, com os números do índice como em A Rua, mais "seguir" (nunca nas linhas do próprio diário nem antes de a chave própria ser conhecida; na linha "Nome republicou" o "seguir" é do republicador) e "denunciar"; seguir remove da lista as linhas daquele autor sem recarregar nem perder a posição de rolagem, e uma página que chega depois não as traz de volta. Seguir em outra tela também tira as linhas, sem recarregar; a lista só recarrega quando a própria pessoa publica, não ao seguir. Uma citação mostra a publicação citada num cartão, lida e conferida comdiary.peek. Os nomes vêm dos blocos lidos: podem ser "sem nome" ou um @nome antigo quando o registro mais novo está fora dos primeiros blocos e da cauda buscada. Certificados e @nomes são conferidos de novo contra os emissores revogados em cada página. Um diário bloqueado depois da carga desaparece na próxima leitura, como em A Rua. Sem candidatos: "Ninguém para espiar ainda", com a ação "publicar"; com candidatos sem publicação disponível: "Ainda não chegou nada", com a ação "atualizar"; sem conexão antes da primeira carga: "Sem conexão", com "Confira sua internet." e "tentar de novo". Uma nota conta os diários que não aparecem ("1 diário não aparece." ou "N diários não aparecem.") que termina com o botão de informação, o qual abre "Por que alguns diários não aparecem", que lista as causas reais (conta não liberada pela associação, bloqueada ou com a liberação cancelada, histórico que não confere, diário grande demais, publicação grande demais para ler, sem resposta a tempo ou sem publicação no trecho lido). Um cursor numa lista expirada (5 minutos) é recusado com "A lista expirou; atualize para continuar."; a tela mantém as linhas e pede para puxar. Os números do índice (contagens, nomes dos originais) passam por um ritmo compartilhado (no máximo 2 pedidos em andamento e 18 inícios a cada 10 s, abaixo da zona de 20 por 10 s do Caddy); um 429 com Retry-After esfria todos os pedidos pelo tempo informado (teto de 10 minutos), com até 3 novas tentativas por chamada dentro de 45 s de espera; as páginas completas de um membro ficam 5 minutos em memória (256 entradas). Se a busca dos nomes falha, uma nova tentativa roda uma vez (após o Retry-After, senão 10 s); se as contagens falham, aparece a linha "Números incompletos" com um ⓘ. Uma falha mostra o erro e permite tentar de novo; uma lista incompleta diz "A lista pode estar incompleta; puxe para atualizar.". Num nó que não é hospedado (configuração manual,varanda-serve), a aba mostra "Espiadinha indisponível" com o motivo e "Saiba mais", sem chamarpeek.read; quando a Espiadinha não está disponível por outro motivo, o título é o mesmo, com o motivo e sem "Saiba mais". As notas da Espiadinha são uma só nota de estado no alto, que a folha de ajuda repete sem contradizer; o aviso de lista vencida e o "atualizar" ficam no rodapé da lista, onde a falha aparece, ao lado da faixa de erro enquanto há linhas. A Espiadinha não tem campo de pesquisa: a pesquisa de publicações fica em Busca › Publicações. - Avisos. Não é aba: abre pelo sino (
sino) no canto direito da barra do topo de A Rua, Espiadinha, Conversas e Busca, e por um sino branco no canto da faixa do Diário, com o título "Avisos" e uma seta de voltar que leva à aba anterior. Só na versão hospedada, como antes. Mostra quem começou a seguir você, também quando você já segue essa pessoa (uma linha por seguidor), quem respondeu, citou ou mencionou você, e quem curtiu ou republicou uma publicação sua. É privado e quieto: Avisos em si não mostra contagem nem lista de seguidores; os números "N seguindo" e "N seguidores" e as listas ficam nos perfis (Diário e Membro) e são públicos (veja Diário, Membro e Pessoas). Cada linha mostra o avatar, " começou a seguir você" (ou "Alguém começou a seguir você" quando a pessoa não tem nome; nunca uma chave), o @nome verificado quando existe, o tempo relativo; a linha é um link: tocar abre o perfil da pessoa (Membro). Ao lado dela, quando nenhuma Página age e você ainda não segue a pessoa, fica o botão pequeno "Seguir de volta", que envia um só pedido, sem reenvio. Seguir de volta tira só a pílula; a linha fica. No topo, os filtros "Todas", "Menções" (menção, resposta e citação) e "Seguidores" só mudam o que é desenhado; os dias aparecem como títulos entre as linhas ("Hoje", "Ontem" ou a data), e um aviso não lido ganha um fundo suave ao lado do ponto. Um filtro sem nada mostra "Nada neste filtro". O filtro volta para "Todas" cada vez que Avisos é aberto. Respostas, citações e menções têm uma linha cada, sem pílula e sem contagem: " respondeu à sua publicação", " citou sua publicação" e " mencionou você" ("Alguém" quando a pessoa não tem nome; nunca uma chave), com o avatar de quem publicou, o @nome verificado e o tempo relativo. Tocar na linha inteira abre a Conversa dessa publicação (<chave>:<seq>); seguir de volta não tira a linha de seguir, só a pílula, e as respostas, citações e menções dela ficam. Curtidas e republicações têm uma linha cada, sem pílula e sem contagem: " curtiu sua publicação" e " republicou sua publicação" ("Alguém" quando a pessoa não tem nome; nunca uma chave), com o avatar de quem curtiu ou republicou, o @nome verificado e o tempo relativo. Uma linha por curtida e uma por republicação. Tocar na linha abre a publicação (a Conversa dela). Seguir a pessoa não tira essas linhas. Uma publicação que responde, cita e menciona você ao mesmo tempo aparece uma vez, como resposta (depois citação, depois menção). A menção vale também para um @nome antigo seu (quem muda de nome continua avisada) e nunca para a própria pessoa mencionando a si mesma. Quem ela bloqueou, a própria chave e quem deixou de seguir (também em outro aparelho, na próxima leitura) não aparecem. Quem ela já segue continua, sem a pílula "Seguir de volta". A ordem é da mais nova para a mais antiga, em páginas de 30 (NOTICES_LIMIT_DEFAULT,NOTICES_LIMIT_MAX= 64,notices.list { after }, rpc.md, 5.23), até "Isso é tudo por enquanto."; uma lista incompleta diz "Alguns avisos ainda podem chegar.". Um ponto, nunca um número: quando há um aviso que a pessoa ainda não viu, o sino ganha um ponto (leitura de tela: "Avisos, novidades"); abrir Avisos marca tudo o que foi carregado como visto e apaga o ponto. Uma linha de seguir anterior a 17/11/2026, 12:00 UTC (FOLLOW_SEEN_CUTOFF), já conta como vista e não acende o ponto, também na leitura em segundo plano: são as linhas de quem você já seguia, que antes ficavam escondidas e voltam à lista com esta versão. Uma linha antiga de outra pessoa que você ainda não tinha aberto perde só o ponto; a linha fica. A lista de vistos com enchimento fica só no aparelho:localStorage, chavevaranda-notices-seen, no formato{ v: 3, own, ids }com a chave da própria identidade (outra identidade começa vazia) e sempre exatamente 2048 entradas opacas de 32 hex (SEEN_MAX): os tokensseenque o nó do navegador calcula com o segredo da identidade (rpc.md, 5.23) misturados a tokens aleatórios de enchimento, em ordem embaralhada, de modo que quantos avisos a pessoa já viu não aparece no armazenamento. A entrada é gravada, só com enchimento, já na primeira carga da aba na web hospedada: nem a presença dela diz se algum aviso foi visto. Um aviso novo visto substitui uma entrada sorteada que não seja uma linha na tela; quem relê o armazenamento ao longo do tempo ainda percebe quando entradas mudam. Nada derivável das chaves de quem segue você é gravado, e quem lê o armazenamento com a passkey bloqueada não consegue confirmar quem seguiu. Semcrypto.getRandomValues, o que foi visto fica só na memória e nada é gravado. Uma linha sem token válido nunca é gravada nem acende o ponto. Entradas antigasv: 1(que guardavam<chave>:<seq>em claro) ev: 2(sal e resumos SHA-256 que podiam ser conferidos contra as chaves públicas) são apagadas na primeira carga hospedada; o app com configuração manual nunca grava nada. Visto em todos os aparelhos: a lista com enchimento continua no aparelho, mas os tokensseendas linhas de Avisos carregadas, as marcas de Conversas (dm.seen) e as marcas de grupo viajam para o serviço de conta num bloco cifrado de tamanho fixo, com uma chave que só os aparelhos da mesma passkey derivam; cada aparelho funde o bloco com o seu (união; a marca de um grupo só anda para a frente) e grava de volta o que mudou. O bloco é lido ao desbloquear, ao voltar a aba ao primeiro plano, ao voltar a rede e a cada 5 minutos enquanto a página está visível, e é gravado no máximo uma vez por minuto (exceto ao desbloquear), com uma espera de 30 s depois de uma marca local (abrir Avisos, uma conversa ou um grupo). Limite de migração: uma entrada antiga com enchimento só viaja quando uma linha carregada bate com ela, então outro aparelho pode mostrar esse aviso como novo até lá. Limites do bloco: 256 tokens de Avisos da pessoa e mais 4 páginas de 32 cada, 736 tokens de Conversas (um por mensagem recebida, uma janela das mais recentes: uma mensagem mais antiga que a janela pode aparecer como não lida num aparelho que nunca a leu) e 128 grupos; o mais antigo sai do bloco e pode aparecer como novo em outro aparelho. As listas locais mantêm os próprios limites. O serviço vê a chave pública da passkey, a hora e o tipo de cada pedido (leitura ou gravação) e que o tamanho do bloco é sempre o mesmo; não vê quais avisos, mensagens ou grupos foram vistos. A configuração manual, ovaranda-servee o nó core ficam só no aparelho e não sincronizam, e a identidade bloqueada não sincroniza até ser desbloqueada. "Recomeçar" num aparelho não apaga o bloco compartilhado. Um servidor que segura ou volta um bloco antigo só faz um ponto reaparecer: nunca apaga uma marca local de quem já viu, e o ponto do sino conta as marcas locais e as que vieram de outros aparelhos. A aba atualiza sozinha a cada 5 minutos (NOTICES_POLL_MS= 300000) enquanto a página está visível e há rede, mesmo com outra aba aberta (é assim que o ponto acende); também ao abrir a aba (se os dados têm mais de 60 s), ao tocar de novo na aba, ao puxar para baixo e quando os seguidos mudam (aqui ou em outro aparelho). Uma falha comum pula a próxima rodada automática. Estados, com os textos exatos: sem ninguém novo, "Ninguém novo por aqui" ("Quando alguém começar a seguir você, comentar, citar, mencionar você, curtir ou republicar uma publicação sua, aparece aqui."); semeador que só envia avisos de quem seguiu (activity: false), as linhas de seguir aparecem com a linha calma "O semeador desta associação ainda só envia avisos de quem seguiu você."; sem conexão antes da primeira carga, "Sem conexão" ("Confira sua internet.") com "tentar de novo"; semeador sem o canal, "Sem avisos por aqui" ("Os Avisos ainda não estão disponíveis nesta associação."); identidade bloqueada, o erro "identidade bloqueada: entre com a passkey" com "tentar de novo" (sem consultar o semeador enquanto estiver bloqueada); uma falha mostra o erro e permite tentar de novo. Só na web hospedada e no app instalado (a lista no app; sem aviso do sistema): com configuração manual e com ovaranda-serve(e na CLI) a aba mostra "Avisos indisponíveis" e "Disponível no site da associação ou no app ligado à instalação.", com "Saiba mais" que abre a ajuda de Avisos, sem chamarnotices.list(um nó que responde "avisos disponíveis só no navegador" ou "método desconhecido" leva ao mesmo texto, e a pergunta não se repete; num nó hospedado, em vez disso, a aba mostra "Sem avisos por aqui", sem mandar a pessoa para a web). Não há notificação do sistema nem push: o aviso só existe dentro do app aberto. Mensagens privadas continuam em Conversas, e o ponto dessa aba acende pordm.list(caixa de entrada não lida ou pedido de mensagem), separado do ponto do sino. Os nomes vêm da verificação feita no navegador, que confere cada aviso contra o diário assinado de quem o causou e decide ele mesmo o tipo (resposta, citação, menção, curtida ou republicação) a partir do registro assinado e do próprio diário (protocol.md, "Notices link"); o semeador pode esconder um aviso, mas não inventar um nem trocar o tipo. O trecho da publicação na linha mostra os endereços http, https e www como links (a mesma regra que fecha em caso de dúvida das publicações); um trecho cortado em 90 caracteres fica texto simples. - Publicar. Folha com "Cancelar", a pílula "Publicar" (desligada com o texto vazio ou acima de 1000 pontos de código), o avatar da própria pessoa, o campo "O que está rolando na varanda?", um anel de progresso e o contador (sem número abaixo de 80 % do limite; de 80 % a 90 %, "N/1000"; de 90 % em diante, quantos faltam; vermelho em 1000). Embaixo do texto, as ferramentas: o painel de emojis (cerca de 400, em 11 grupos: Carinhas, Pessoas, Gestos, Corações, Bichos e natureza, Comida, Atividades, Viagens e lugares, Objetos, Símbolos e Bandeiras, cada um com nome em português; o campo "buscar emoji" filtra pelo nome sem diferenciar acento nem maiúsculas; a grade de 44 px rola dentro do próprio painel, sem segunda folha; o emoji entra onde está o cursor, dentro do limite de 1000) e, na web hospedada com rede, "Foto" (veja "Fotos e GIFs"); com fotos, a pílula liga mesmo sem texto. Na web hospedada com rede, ao digitar
@e pelo menos 2 letras, uma faixa embaixo do campo sugere até 5 membros (avatar, nome e @nome) vindos do índice de nomes do semeador e conferidos um a um comdiary.peek; tocar em um troca o trecho por@nome(sem repetir o espaço, e sem estourar os 1000 pontos de código). Como na busca de Seguindo, o trecho digitado vai para a busca de contas do semeador, mesmo num rascunho que nunca é publicado. Não há faixa no app com configuração manual, sem rede, com o campo fechado ou com um trecho selecionado; o texto é enviado exatamente como digitado, e nenhum nome é resolvido na hora de publicar. Responder usa a mesma folha, com "respondendo a Nome" e "cancelar resposta". Citar também, com "citando Nome" e "cancelar citação": a citação pede texto (1 a 1000, com ou sem fotos), precisa de conexão e nunca vai para a fila de saída; sem rede, a pílula e o botão "Foto" ficam desligados com "Citações precisam de internet". Na web com o nó no navegador, sem rede (e sem fotos) a pílula diz "Guardar": a confirmação "guardado na fila de saída" fecha a folha, e o texto espera no Diário. O rascunho sobrevive ao fechar a folha e a qualquer falha; um pedido incerto nunca é reenviado automaticamente. Numa publicação comum no próprio diário, a folha também pode oferecer "Publicar também na web" (veja "Página pública na web"). - Seguindo. Não é aba: é uma lista aberta por "N seguindo" no Diário, com uma seta de voltar. No topo há o campo "Filtrar nesta lista" ("nome ou @nome"), que só reduz esta lista, no aparelho, sem pedir nada ao semeador; a dica "Para encontrar outra conta, use a Busca." fica atrás de um ⓘ "Sobre o filtro"; sem correspondência, "Ninguém com esse nome nesta lista.". O campo não procura nem segue por @nome ou código: colar um código de 64 letras e números não segue ninguém. Para achar e seguir outra conta, veja Busca. Tocar em "Seguindo" abre a confirmação "Deixar de seguir ?" ("esta pessoa" sem nome), e só o botão vermelho "Deixar de seguir" deixa de seguir; "Cancelar" não envia nada. O cabeçalho da lista mostra "N pessoas", e uma nota curta diz "Quem você segue é público." e termina com o botão de informação, que abre "Como funciona Seguindo" (a lista aparece igual em todos os aparelhos). Cada linha tem avatar, nome e @nome vindos de
profile.read(uma barra de carregamento enquanto o nome chega; "sem nome" se não há) e a pílula "Seguindo", que pede a confirmação "Deixar de seguir ?" e, só com o botão "Deixar de seguir", deixa de seguir e lê a lista de novo. Nenhuma linha mostra a chave. A lista é infinita, em páginas de 50 (follow.list). O avatar e o nome de cada linha abrem o perfil da pessoa (Membro). Sem ninguém seguido: "Você ainda não segue ninguém". - Pessoas (Seguindo e Seguidores de qualquer conta). Não é aba: abre por cima das abas, a partir do "N seguindo" ou do "N seguidores" do Diário ou de um Membro, com o título "Seguindo" ou "Seguidores" (
PESSOAS_TITLE,src/pessoas.js) e uma seta de voltar. Tem o campo "Filtrar nesta lista", que só reduz esta lista, no aparelho. O cabeçalho mostra o total como "N pessoas" (countLabel; "1 pessoa"). As linhas vêm do semeador (GET /index/follows/<author>/(seguindo|seguidores), páginas de 20, protocol §7) e cada uma só aparece depois de o app conferir comdiary.peeko registro de seguir assinado (type: 'follow',on: true, mesma data e mesma chave); o semeador pode omitir linhas ou apontar para um registro autêntico mais velho, mas não inventa um seguidor. Linhas que não puderam ser conferidas entram na contagem de indisponíveis. Enquanto o semeador ainda lê os diários, e na lista Seguindo de um diário que passou de um teto, a nota diz "A lista pode estar incompleta.". Sem semeador (configuração manual,varanda-serve): "Disponível no site da associação ou no app ligado à instalação.". O semeador fica sabendo de qual perfil a lista foi aberta. A lista Seguindo do próprio Diário continua descrita em Seguindo (do nó local); a dos outros e a de seguidores usam esta tela. - Busca. Aba com um só campo e duas categorias, "Contas" e "Publicações"; cada categoria guarda o próprio rascunho. O campo é arredondado, com uma lupa e um X que limpa a pesquisa. Com texto no campo, "Cancelar" aparece ao lado dele, limpa o campo e fecha o teclado. Com o campo vazio, "Buscas recentes" mostra até 8 buscas enviadas em cada categoria, a mais nova primeiro, com "Remover" em cada linha e "Limpar"; elas ficam só na memória desta sessão e somem ao trocar de conta. A folha de ajuda é "Como funciona a Busca".
- Contas. Campo "Encontrar pessoas" ("nome, @nome ou código"). Na versão hospedada (site e app instalado), um nome ou @nome busca 400 ms depois que a pessoa para de digitar ou ao tocar em Enter; um @nome também oferece a pílula "Seguir @nome" (desligada sem internet); um código de 64 letras e números mostra "Seguir"; um código incompleto mostra "Código incompleto: são 64 letras e números.". A busca usa o índice de nomes do semeador (protocol.md, seções 5 e 7) e aceita de 1 a 4 palavras, com pelo menos 2 letras ("Digite pelo menos 2 letras."). O nome e o @nome de cada linha são lidos e conferidos no diário (
diary.peek); a linha que não bate mais some. Quem o nó recusa (bloqueado, emissor revogado, não admitido) nunca aparece, nem a própria conta. Cada linha tem avatar, nome, @nome conferido e "Seguir"/"Seguindo" (a partir da lista completa de seguidos, não só da primeira página), e tocar abre o perfil da pessoa. Tocar em "Seguindo" abre a confirmação "Deixar de seguir ?" e só o botão vermelho "Deixar de seguir" deixa de seguir. Avisos: "Ninguém encontrado com esse nome.", "Não deu para conferir todo mundo agora.", "Algumas pessoas não puderam ser conferidas agora.", "Ainda montando a lista; alguém pode faltar.", "Há mais gente com esse nome. Tente um nome mais específico.", "A busca precisa de internet.", "A busca ainda não está disponível." e "Não foi possível buscar agora.". Seguir por @nome exato ou pelo código da pessoa continua pelo serviço de conta. Em qualquer instalação, inclusive no app com configuração manual e novaranda-serve, vale o código: ali só há o campo "Cole o código da pessoa (64 letras e números)." e a pílula "Seguir". Estado vazio: "Procure pessoas pelo nome ou @nome, ou cole o código de alguém.". - Publicações. Só na web hospedada e no app instalado. O campo "pesquisar por assunto" pesquisa enquanto a pessoa digita, a partir de 2 caracteres e depois de uma pausa curta, e também ao tocar em enter ou em "pesquisar"; respostas de uma busca anterior são ignoradas. Maiúsculas e acentos não importam: "ceu" encontra "Céu" e "#Céu"; a busca é por palavras inteiras (2 a 32 letras ou números), "#" é só texto e uma frase encontra as publicações que têm todas as palavras (até 8; as demais são descartadas, com o aviso "A pesquisa usou as 8 primeiras palavras."). Procura no histórico inteiro de todos os diários que o semeador admitiu, inclusive de quem você segue e o próprio, da mais nova para a mais antiga, sem pesos, em páginas de 30. O semeador só indica onde olhar (
GET /index/topic); o nó lê cada publicação comdiary.peek, confere as palavras no texto verificado e só mostra nomes vindos de campos verificados, como antes. "seguir" aparece só para quem você não segue e não remove as linhas do autor. O X do campo apaga a pesquisa. Abaixo do campo há a linha "A pesquisa ignora maiúsculas e acentos." que termina com o botão de informação (abre "Como funciona a pesquisa"). Notas: "Ainda preparando a pesquisa…" (o índice ainda está sendo montado), "Algumas publicações podem faltar." (índice incompleto), "Nada encontrado" (nenhuma publicação com essas palavras), "continuar busca" (uma página pode vir vazia com mais por procurar; só esse botão busca a próxima enquanto nenhuma linha aparece), "A pesquisa ainda não está disponível." e "Sem conexão" (com "A pesquisa precisa de conexão.", também quando a rede falha ou o tempo esgota com a pessoa em linha; um erro de conexão do nó aparece como "Sem conexão agora. Tente de novo em instantes."). Estado vazio: "Procure palavras nas publicações públicas.". Com configuração manual e com ovaranda-serve, a categoria mostra "Pesquisa indisponível" e "A pesquisa de publicações está disponível no site da associação ou no app ligado à instalação.", sem nenhum pedido. Os resultados ficam só na memória do navegador. Uma curtida feita na Busca pode demorar a aparecer nas contagens da Espiadinha até a próxima atualização dela (limite aceito).
- Contas. Campo "Encontrar pessoas" ("nome, @nome ou código"). Na versão hospedada (site e app instalado), um nome ou @nome busca 400 ms depois que a pessoa para de digitar ou ao tocar em Enter; um @nome também oferece a pílula "Seguir @nome" (desligada sem internet); um código de 64 letras e números mostra "Seguir"; um código incompleto mostra "Código incompleto: são 64 letras e números.". A busca usa o índice de nomes do semeador (protocol.md, seções 5 e 7) e aceita de 1 a 4 palavras, com pelo menos 2 letras ("Digite pelo menos 2 letras."). O nome e o @nome de cada linha são lidos e conferidos no diário (
- Conferência de palavras. Antes de publicar, o app recusa no próprio aparelho o texto com um termo de uma lista curta de termos graves (
packages/rpc/lib/blocked-terms.js, a mesma que o serviço de conta usa para um @nome novo e para o que uma Página publica; veja "Moderação e obrigações legais" em design.md). Vale para publicação, resposta, citação, momentos, mensagem e encaminhamento em grupo público, nome, bio e @nome (de membro e de Página), anúncio e avaliação da Feira, cartão de convite, nome de grupo público e de comunidade e depoimentos, inclusive ao tocar em "Mostrar no perfil" para um depoimento recebido. O rascunho fica para editar, e nada sai do aparelho nem é registrado. Mensagens diretas e grupos privados não passam por ela. Uma recusa do serviço numa Página (termo-recusado) aparece com a mesma explicação. Verificação nas seções 138 e 143 de verification.md e em verification/fix-word-check-leftovers.md. - Denunciar. Em A Rua, na Espiadinha, em Conversa e em Membro, cada publicação de outro membro tem "Denunciar" no menu "mais" (⋯) do topo da publicação; em Seguindo, cada linha tem a bandeira (rótulo de acessibilidade "denunciar" seguido do nome da pessoa, quando conhecido), e o perfil (Membro) tem a pílula "denunciar a conta", que denunciam a conta toda. Nenhuma publicação da própria pessoa tem a ação; no menu "mais" dela aparece "Apagar" (veja "Linha de publicação"). A folha "Denunciar" deixa escolher "esta publicação" (quando veio de uma publicação) ou "a conta toda", um motivo (spam, assédio, conteúdo ilegal ou outro) e uma observação opcional de até 280 caracteres, e mostra o trecho da publicação que será enviado. Uma linha visível diz "A pessoa denunciada não vê quem denunciou." que termina com o botão de informação, o qual abre "Como funciona a denúncia". "enviar denúncia" pede ao serviço de conta um desafio, assina a denúncia com a chave do membro (o nó no navegador, RPC
report.sign) e a envia; o app mostra "denúncia enviada" ou "você já tinha denunciado isso". Só vale no nó hospedado (a versão web hospedada e o app instalado com a instalação), com a passkey desbloqueada e a conta Google vinculada (sem vínculo a folha manda vincular em "Ajustes → Conta e @nome"). Há no máximo 20 denúncias por pessoa a cada 24 horas. Quem é denunciado não vê nada disso. No app instalado a denúncia segue o mesmo caminho do site, com as marcas da instalação. No app com configuração manual e novaranda-servea folha diz que denúncias só valem pela versão web no site da associação. Cancelar a folha nunca assina nem envia nada. - Acabamento das telas (PR10). Diário e Membro mostram esqueleto do cabeçalho e das linhas na primeira carga (em Membro, o do cabeçalho só enquanto
profile.readestá pendente, então Seguir, Conversar e o menu aparecem quando ele responde); um diário vazio mostra um estado vazio, com a ação de publicar só no próprio perfil e, numa Página, "As publicações desta Página aparecem aqui."; o estado do envio é um selo com ícone, as contagens quebram com texto grande, a linha "Anúncios" segue sem contagem nem prévia de capa e a região de avaliações é lida pelo leitor de tela. Avisos tem esqueleto na carga e linhas com toque suave, e títulos de data entre as linhas. A Busca tem uma só nota por vez (o resto está na folha de ajuda), distingue "nada digitado", "buscando" e "sem resultado" e oferece "Limpar"; a Busca global tem os mesmos três estados e o botão lê "Digitar código" num nó que não é hospedado. Os anéis da faixa de Momentos respondem ao toque e o leitor de tela lê o nome inteiro. O toast com ação tem alvo de 44 pt e dura mais com texto grande. Em Publicar, o contador de caracteres só é anunciado sozinho nos limiares (restam 20 e 0) e o botão de foto lê "Adicionar foto". Em Momentos, uma legenda cortada ganha "mais" e "menos" (a legenda aberta pausa o tempo; "menos" ou um passo retoma); com texto grande e pouco espaço não há "mais", e a legenda rola na altura toda. Em Introdução, "Pular" fica no canto superior direito, com 44 por 44 pt de toque. - Diário. O perfil e o diário da própria pessoa. Uma faixa em gradiente passa por trás da barra de estado, com a engrenagem dos ajustes e, ao lado dela, um círculo com o "i" que abre "Como funciona o Diário"; embaixo, avatar (88 pt; 72 pt a partir de 640 pt de largura), o nome, o @nome e a bio, lidos de
profile.read, com os links sublinhados da bio (veja "Linha de publicação"), e, numa linha, "N seguindo" (do nó local,node.info.followCount) e "N seguidores" (do semeador, só onde ele existe: na versão hospedada e no app ligado à instalação; com configuração manual e novaranda-serveaparece só "N seguindo"); tocar em "N seguindo" abre a lista Seguindo e em "N seguidores", a lista Seguidores. Os seguidores são públicos por decisão dos donos do projeto: quem usa o site da associação ou o app ligado à instalação vê esses números em qualquer conta. O número do semeador inclui só membros admitidos e visíveis nesse semeador (contas de fora da associação nunca aparecem), então pode ser menor que o "N seguindo" daqui, que conta todo seguir do nó local; os tetos de 4096 seguidos e 64 contas de fora por diário só marcam a lista Seguindo como incompleta. Enquanto o semeador ainda lê os diários, uma nota sob os números diz "A contagem pode estar incompleta.". Na versão hospedada, um sino branco no canto da faixa abre Avisos. Ao lado do avatar, na mesma linha dele, fica a pílula "Editar perfil"; "Compartilhar" é só um botão de ícone, na versão hospedada (site e app instalado). Onde o sistema permite compartilhar, o botão abre a folha de compartilhar do sistema na hora; nos outros lugares, abre a folha "Compartilhar perfil" com o link do próprio perfil (/@nome, ou/m/<chave>sem @nome), primeiro "compartilhar" (onde o navegador oferece) e depois "copiar link"; só o link/@nomeaparece como texto, e o/m/<chave>nunca é impresso. "Copiar link" fecha a folha e mostra o aviso "link copiado"; se a cópia falha, a mensagem fica na folha, ao lado do link selecionado para copiar. A chave não aparece no Diário: só em Ajustes › Avançado › Identidade técnica (atrás de "mostrar chave") e no passo "Liberar sua conta", como "Código para enviar à associação". Falta o certificado? Uma linha de aviso diz isso. Na web com o nó no navegador, "Aguardando envio" lista os textos ainda não publicados ("enviando…" durante o envio), com "apagar" e, em falhas definitivas ou incertas, "tentar de novo"; os que ficaram de uma visita anterior só saem com "enviar" (ou "enviar tudo"), porque a fila guardada no aparelho não é autenticada; a data será a do envio, quando ele passar pela sincronização antes de escrever. Em "PUBLICAÇÕES" ficam só as publicações da pessoa (citações com o cartão da citada), com fotos e a barra de ações (contagens na web hospedada), no estilo da linha do tempo, e as republicações dela ainda valendo, como a original com a linha "Você republicou" (curtidas não são listadas); os registros técnicos (perfil, @nome, certificado, seguidos, núcleo de fotos) e os blocos inválidos não aparecem. O diário é lido em páginas de 36 blocos (LOG_LIMIT_MAX,log.read { before }) até "Isso é tudo por enquanto."; sem publicações, "Você ainda não publicou". Puxar para baixo atualiza (no computador, também a roda do mouse), e a atualização depois de publicar, a feita ao puxar e a pílula "ver novidades" releem também o próprio perfil, então uma mudança feita em outro aparelho aparece depois de atualizar. A pílula "ver novidades" existe só na web, a partir da linha "diário próprio sincronizado (N)" quando o crescimento do diário próprio veio de outro aparelho; o que a pessoa faz neste aparelho não a acende; no app nativo não há esse sinal. - Posts salvos. Tela
salvos, aberta por uma linha no Diário próprio, só na web hospedada (pela convenção acima, vale também para o app instalado, onde o nó consegue reler o post de quem escreveu); não existe no app com configuração manual nem novaranda-serve. No menu "mais" de uma publicação há Salvar e, se já está salva, Tirar dos salvos; Salvar não é oferecido em linhas sem número, em conversas privadas nem em repostagens, e as próprias publicações podem ser salvas. Toasts: "Publicação salva." e "Tirado dos salvos.". A lista guarda só referências (autor, número da publicação e a hora em que salvou), só no próprio aparelho, separada por instalação e por conta, até 100 publicações, e até 8 contas por aparelho (a nona é recusada com uma mensagem, sem apagar nada). Na web fica no armazenamento do navegador; no app, no arquivovaranda-saved-posts.jsonnos documentos do app. Nenhum texto de outra pessoa é guardado e a lista em si não é enviada a ninguém, mas ao abrir a tela cada publicação é pedida ao semeador comdiary.peekpara ser conferida no diário de quem escreveu, então o semeador pode saber quais publicações o aparelho pediu. Autores bloqueados nunca são lidos. Linhas: a publicação conferida; "Publicação indisponível" com "Tirar dos salvos" (apagada, inválida ou de autor bloqueado); "Não deu para conferir agora" (a leitura falhou, inclusive quando o semeador seguiu ocupado depois das tentativas, e não há cópia anterior; sem botão de tirar; uma cópia anterior é mantida, se houver); "Carregando publicação" para o que foi salvo com a tela aberta. Quando algumas leituras falham, uma nota acima da lista avisa; puxar para atualizar lê de novo. Sem rede a tela mostra "Sem conexão no momento"; a tela de erro só aparece quando toda leitura falha na primeira carga. No celular, a lista pode entrar no backup do próprio aparelho (o iCloud, no iPhone). Ela continua no aparelho depois de "Sair" e só é esquecida quando a conta é removida do aparelho (de todas as instalações que o aparelho guardava para essa conta). Não confundir com o segmento Salvos da Feira (um segmento da tela, não uma aba), que guarda anúncios. - Hashtags tocáveis e a tela Assunto. Só onde o nó é hospedado (web hospedada e app instalado); nunca em conversas privadas nem em grupos privados. Em publicações públicas, um
#palavraé tocável. Regra do token:#seguido de letras ou números, no começo do texto ou depois de um caractere que não é de palavra, nunca dentro de um endereço (URL); o token é dobrado como o índice (minúsculas, sem acentos:#Céuviraceu) e precisa ser exatamente um token de 2 a 32 caracteres[a-z0-9]. Tocar abre a telaassunto(título#palavra), uma página cronológica montada com a mesma rota do semeador da Busca por assunto (GET /index/topic/<token>), isto é, o mesmo pedido de quem digita a palavra na Busca. A página pede ao abrir, ao puxar para atualizar, em Ver mais e, sem toque, quando o nó reconecta (cada tela Assunto aberta na pilha pede de novo). O app é mais estrito que a Busca: depois de reler cada publicação comdiary.peek, só mantém a que traz a hashtag no próprio texto verificado (não basta a palavra solta). Ordem: a data da própria publicação, da mais nova para a mais antiga, empate por autor e depois por número (seq); uma data à frente do relógio do aparelho conta como agora, e datas mais de 24 h no futuro são rejeitadas. Só uma página final encerra a lista; uma ação (abrir, puxar para atualizar, Ver mais) lê no máximo 3 páginas do índice e relê no máximo 30 publicações, e depois aparece Ver mais; uma página cortada por esse limite é lida de novo na ação seguinte. Puxar para atualizar vence um Ver mais em andamento, e "Tentar de novo" repete a ação que falhou. Sem contagens, sem assuntos do momento e sem sugestões. Como os links, o#palavrasegue como texto na legenda recolhida e no cartão da citação, e é um link dentro da linha, como o@nome, sem alvo de 44 pt. Autores bloqueados ficam fora da página e não contam como publicações que podem faltar: o app só planeja leituras depois de carregar a lista de bloqueios, e o nó recusa a leitura de autores bloqueados de qualquer forma. O semeador vê a palavra, como na Busca, e, como as releituras vão pela conexão em que o nó já anunciou o próprio diário, pode associar a palavra e as publicações pedidas à conta. Nenhuma mudança no semeador nem no protocolo; um modo do semeador para a hashtag exata é um acompanhamento registrado. - Recados. Tela
recados(título "Recados"; nunca "mural"), só onde o nó é hospedado (web hospedada e app instalado); não existe no app com configuração manual nem novaranda-serve. Um recado é um texto público de 1 a 400 caracteres deixado na página de outra pessoa; fica no diário de quem escreve. Entradas: uma linha no perfil de uma pessoa e uma linha no Diário próprio, que abrem a tela da pessoa. A tela lista os recados do mais novo para o mais antigo, com a data, e tem o campo para escrever; na própria página, "Responder" em cada recado de outra pessoa. Quem é dono da página tem a opção Quem pode deixar recado em Ajustes (Privacidade e segurança) ("Quem eu sigo", o padrão, "Todos" ou "Ninguém") e "Tirar da minha página" em cada recado (o recado continua no diário de quem o escreveu); quem escreveu tem "Apagar recado", e há "Denunciar a conta", como nos depoimentos. Recusas mostradas como o nó as devolve (por exemplo "esta pessoa só recebe recados de quem ela segue", "esta pessoa não está recebendo recados", "não pode deixar recado para si", "você bloqueou esta pessoa", "páginas não recebem recados"); sem semeador a tela mostra "semeador indisponível" e nenhum recado inventado. A lista vem deGET /index/scraps/<chave>e cada recado é relido comdiary.peek; o semeador vê quais páginas são abertas e os pares de seguir consultados. - Perfil rico. Só onde o nó é hospedado (web hospedada e app instalado); no app com configuração manual e no
varanda-serveo perfil continua só com nome, bio e foto, sem os campos novos. Editar perfil ganha, abaixo da bio, o Sobre mim (até 600 caracteres, com quebras de linha), Cidade (60), Trabalho (80), Estudos (80), Interesses (200), Aniversário (dia e mês, sem ano; 29 de fevereiro vale; "Use dia e mês que existam, como 15/03." quando não existe) e o Tema do perfil: "Padrão" (a faixa de sempre) e oito amostras redondas de 48 pt, cada uma num alvo de toque de pelo menos 44 pt e com o nome embaixo (Varanda, Floresta, Mar, Pôr do sol, Ipê, Flor, Lavanda e Terra), cada uma com um tom para o claro e outro para o escuro, a escolhida com aro na cor de destaque e marca de confirmação. Todos os campos são opcionais, e um campo vazio é gravado como vazio. Cada texto passa pela conferência de palavras dos outros textos do app antes de ir para o nó. Salvar sobre mim grava um registroprofile-aboutcom os sete campos (profile.about, RPC 5.130), que substitui o anterior: o nó web também marca como apagadas (tombstones) todas as versões vivas anteriores, na mesma gravação quando cabem, as mais antigas primeiro quando não, e o mesmo vale para Publicar humor (RPC 5.131); nome, bio e foto são gravados à parte, como antes. No perfil próprio, o editor (a semente do formulário) e a releitura do Apagar leem o próprio diário do membro, não o semeador; o formulário só destrava depois de ler o próprio diário até achar os dois registros ou chegar ao começo; uma leitura incompleta deixa o formulário travado. Se a resposta do nó não chega (uncertain), o app não reenvia: mostra "Não sabemos se foi publicado." e o botão Conferir, que relê o próprio diário. O Humor do dia (um emoji de uma lista de onze, sem o "doente", um texto de até 60 caracteres numa linha, ou os dois) é publicado por Publicar humor (profile.mood, RPC 5.131; Publicar humor fica desligado com os dois vazios), com a nota de que o humor aparece no perfil por 24 horas e de que o registro continua no seu diário, público, até ser apagado com Apagar humor (o app não diz que ele some sozinho: só deixa de ser mostrado). O app nunca publica um humor vazio; um registromoodvazio segue válido no protocolo como limpeza. Apagar. Com um Sobre mim no perfil, o editor mostra Apagar sobre mim; com um humor, Apagar humor (é a única ação para tirar o humor: o app não publica mais um humor vazio). Cada uma pede confirmação antes: "Apagar o sobre mim? Todas as versões somem do seu diário e o tema volta ao padrão. Cópias que outras pessoas já fizeram podem continuar existindo." (o humor tem o texto equivalente), com Apagar e Cancelar. A ação chamaprofile.extra.delete(RPC 5.132), que marca como apagadas todas as versões vivas daquele tipo, e não os registros mais novos apenas: um registro só mais antigo voltaria a valer. Ao dar certo, o app solta o registro (Sobre mim e tema voltam ao padrão, ou o humor some), esvazia o formulário daquele tipo e avisa "Sobre mim apagado." ou "Humor apagado.". "nada para apagar" (nada mais vivo) conta como sucesso. Se a resposta não chega (uncertain), o app não reenvia: mostra o texto padrão de incerteza e o botão Conferir, que relê o próprio diário e só dá a ação por feita quando a leitura chega ao fim sem achar registro vivo daquele tipo. Só onde o nó é hospedado, como o resto. O Diário e o Membro pintam a faixa do perfil no tema escolhido (uma faixa lisa na cor do tema, com um fio na cor de destaque embaixo; um id que o app não conhece é ignorado, e sem tema (ou com esse id) fica a faixa em gradiente de antes; a barra fixa que aparece no topo quando a faixa rola para fora continua no pôr do sol, mesmo num perfil com tema; sobre a faixa com tema, o círculo de voltar e os botões da faixa do Diário usam a cor do texto da faixa, com o ícone na cor da faixa, e a pastilha do humor usa o tom do tema), mostram o cartão Sobre mim (o texto e as linhas Cidade, Trabalho, Estudos, Interesses e Aniversário, só as preenchidas, sempre pordisplayText; sem nada preenchido o cartão não aparece) e, enquanto vale, o humor do dia numa pastilha com o emoji, o texto e "some em N h" (ou "N min"); no próprio Diário a pastilha abre a edição, com alvo de 44 pt, e no perfil de outra pessoa é só leitura. O humor vale por 24 horas pelo relógio de quem lê, nunca com data no futuro, e depois some da tela mesmo continuando no diário. Quem não tem nenhum registro novo vê o perfil exatamente como antes. Para ler, o app pede ao semeadorGET /index/profile/<chave>(só ponteiros; veja protocol.md, seção 7) e relê cada bloco comdiary.peek; sem semeador, ou com o diário ainda sendo indexado, o perfil aparece sem os campos novos, sem erro. Sorte do dia. Só no Diário próprio, um cartão "Sorte do dia" com uma frase, escolhida no aparelho entre as 63 frases que já vêm no app, pela data local e pela chave pública do diário (os 16 primeiros caracteres hex dela fazem o sal), então todos os aparelhos da mesma passkey mostram a mesma frase no mesmo dia. Nada é guardado: o número aleatório por aparelho (varanda-sorteno navegador,varanda-sorte.txtno celular) foi abandonado e é apagado uma vez. Não usa rede, não entra no diário e não é enviada a ninguém. - Fãs e Melhores amigos. Só onde o nó é hospedado (web hospedada e app instalado); no app com configuração manual e no
varanda-serveo nó não escreve nem lê esses registros (fan.setetop.setrespondem "leitura sob demanda só na versão web"). Onde ficam: no Membro (perfil de outra pessoa) há o botão Sou fã / Deixar de ser fã (FanButton, com o estado de incerteza e o botão Conferir) e a linha Melhores amigos (TopFriendsRow); o número de fãs, ao lado das contagens, abre a tela de fãs (fas); no Diário próprio, a linha Melhores amigos tem Editar (ou Escolher melhores amigos, enquanto a lista está vazia), que abre o editor (melhores-amigos); em Seguindo há o segmento Seguindo | Fãs, e o número de fãs do Diário abre a lista própria no segmento Fãs. A lista de fãs rola sem fim (carrega mais ao chegar ao fim); o único botão é mostrar mais, na tela vazia que ainda tem cursor (nenhum fã da página pôde ser conferido). Ser fã é um registro público no diário de quem é fã (fan), independente de seguir, e a lista de Melhores amigos (até 8 pessoas, na ordem escolhida) é outro (top-friends); ninguém é fã de si, lista a si, nem é fã ou melhor amigo de uma página ou de uma pessoa que bloqueou ("não pode ser fã de si", "não pode listar a si entre os melhores amigos", "páginas não têm fãs", "páginas não entram nos melhores amigos", "você bloqueou esta pessoa"). O número de fãs de uma pessoa vem do semeador e é mostrado como o de seguidores, com a nota "A contagem pode estar incompleta." quando o semeador ainda monta o índice ou a leitura não ficou completa. A lista de fãs vem do semeador, do mais novo para o mais antigo, sem ranking, e cada linha só aparece depois que o app confere, comdiary.peek, o registrofanassinado no diário do próprio fã (ligado, apontando para essa pessoa, com a mesma data); o que não se confirma não aparece e é contado como indisponível. Os Melhores amigos de uma pessoa aparecem para os outros só quando esse amigo também segue a pessoa: o app lê o registrotop-friendse, para cada amigo, ofollowque o semeador aponta no diário do próprio amigo, e mostra o amigo só se esse bloco for umfollowligado da pessoa; umfollowmais novo do amigo, já lido, desligado, vale mais que um ponteiro antigo. Quem ainda não seguiu de volta fica fora para os outros, e no perfil do próprio dono aparece como "esperando seguir de volta". Quando o amigo seguir, a linha passa a aparecer para todos sem o dono fazer nada. Ainda assim, "ainda está seguindo" e "ainda é fã" seguem como afirmação do semeador: um único bloco lido prova que o registro existe e está ligado, não que é o mais recente do amigo ou do fã. Deixar de ser fã grava um registro novo, comon: false, que desfaz o anterior; os registros anteriores, com as suas datas, continuam públicos no diário. Uma pessoa que você bloqueou não aparece nas listas (os Melhores amigos dela mostram "Você bloqueou esta pessoa. Desbloqueie para ver os melhores amigos dela."). A linha Melhores amigos mostra os avisos: "O semeador ainda está montando esta lista. Podem faltar pessoas por enquanto." enquanto o semeador monta o índice, "A leitura ficou incompleta. Podem faltar pessoas nesta lista." quando a leitura não terminou, "Você bloqueou esta pessoa. Desbloqueie para ver os melhores amigos dela." e, quando a leitura falha, "Não deu para ler os melhores amigos agora. Nada é mostrado por enquanto." e nada mais. O número de fãs mostra a nota "A contagem pode estar incompleta." nos mesmos casos. Se o próprio diário não pode ser lido por inteiro, "Sou fã" continua usável (marcar de novo é inofensivo, pois o último registro vale) e o editor parte da lista que o semeador aponta, conferida no próprio diário, ou abre vazio com um aviso quando não há nenhuma. Ao escolher, o editor recusa o que o nó recusaria ("Você já escolheu o máximo de melhores amigos.", "Você não pode escolher a si mesmo.", "Esta pessoa já está nos seus melhores amigos."), mas só recusa as pessoas que acabaram de ser adicionadas: uma pessoa bloqueada ou uma página que já está na lista pode ficar ao salvar. Só envia a lista quando a ordem ou o conjunto mudou. Escrever é mutante: sem resposta o app não reenvia e relê o próprio diário. Detalhes em protocol.md, seções 2, 5 e 7, e rpc.md 5.131 e 5.132. - Fóruns e enquetes. Só onde o nó é hospedado (web hospedada e app instalado); no app com configuração manual e no
varanda-serveo nó não escreve nem lê esses registros (choice.set,group.choose,group.topicse as opçõestopic,pollemarksrespondem "leitura sob demanda só na versão web"). Enquete do diário: em Publicar há a opção Enquete (PollEditor: pergunta mais 2 a 4 opções de até 60 caracteres, as mensagens "Coloque pelo menos duas opções.", "No máximo quatro opções.", "Preencha ou remova as opções vazias.", "Cada opção tem no máximo 60 caracteres." e "As opções precisam ser diferentes."); a publicação mostra oPollCardcom as opções, os votos e a escolha da pessoa. Antes do primeiro voto o app diz "Seu voto é público: quem vê o seu diário pode ver em quem você votou.". Os totais vêm do semeador e levam o aviso "Os totais vêm do semeador e podem estar incompletos." (ou "Ainda não deu para ler os totais."); "Quem votou" lista os votantes de cada opção, conferidos no diário de cada um. Votar de novo troca a escolha e tocar na escolhida a retira. Como Página: quem age como Página publica a enquete pelo mesmo Publicar (a açãopostda Página compoll, nunca com foto, vídeo ou prévia, nem ao responder ou citar) e vota em nome dela: o voto da Página vem da leiturastatusdela (picked) e é gravado pela açãochoice, sem sobrescrever o voto da pessoa. Um voto da Página sem resposta certa mostra o aviso de incerteza e só é reenviado, com os mesmos bytes assinados, quando a pessoa toca de novo na mesma opção. Grupos públicos: o grupo tem o segmento Tópicos ao lado da conversa (a lista de tópicos, do mais novo para o mais antigo, com o número de respostas e a última resposta), o botão de novo tópico (NewTopicSheet, um campo "Assunto" cuja primeira linha é o título, e "Adicionar enquete") e a telaTopico, com o tópico, a enquete e as respostas; a conversa continua mostrando os tópicos como mensagens comuns. Um grupo privado não tem o segmento nem a opção. Ordem de lançamento: semeadores, depois a web hospedada, depois os apps; a conferência manual está emdocs/verification/feat-foruns-enquetes.md, e as telas na lista dedocs/design-review.md. - Eventos. Só onde o nó é hospedado (web hospedada e app instalado); no app com configuração manual e no
varanda-serve,group.eventse a opçãoeventrespondem "leitura sob demanda só na versão web" e a tela não oferece evento. Publicar ganha a opção Evento (título, início, fim opcional, lugar); em grupos públicos o evento é um registro lateralgroup-eventnuma mensagem raiz, e a resposta Vou ou Talvez reaproveita os votos das enquetes (a resposta é pública). Um evento não se edita: apague, ou um admin esconde. Como Página, a Página também publica um evento (açãopostcomevent, as mesmas regras da enquete) e responde Vou ou Talvez em nome dela pela açãochoice; a resposta da Página é lida destatuse, após um resultado incerto, só é reenviada num novo toque na mesma resposta. A publicação de uma Página mostra a enquete e o evento como a de uma pessoa, mas ainda sem o link público na web. O perfil de outra pessoa ganha uma linha Eventos (e o Diário próprio um botão Eventos), que abre a tela Eventos (lida de/index/events/<autor>, com o aviso de totais incompletos) e a comunidade uma linha Agenda (group.eventsde cada grupo, só os 12 primeiros grupos públicos e a primeira página de cada um, com o aviso de lista incompleta quando algo fica de fora). O lembrete é um registro local de referência e início, guardado só no aparelho, e uma faixa no app aberto nas 24 horas antes; não há notificação do sistema (pendência anotada, sem nova dependência). Adicionar ao calendário (.ics) só na web, porque o compartilhamento nativo não anexa arquivo. - Visitas. Só onde o nó é hospedado (web hospedada e app instalado); no
varanda-servee no app com configuração manual a tela não oferece Visitas. Opcional e desligado por padrão: a folha de consentimento abre com o interruptor desligado, e ligar grava um registro públicovisits(on,at). A troca é mútua e a lista de visitantes (agrupada por dia, com precisão de um dia, só no aparelho) é apagada ao desligar. Os avisos (visits.note, no máximo 10 por dia) viajam selados pela pista silenciosavaranda/visit/1, um repositório de semeador à parte das mensagens diretas, sem acordar ninguém (não há push por aviso); um semeador sem a pista não recebe avisos e o nó não usa o repositório das mensagens diretas. Métodosvisits.set,visits.state,visits.list,visits.clear. - Varandinha. Só onde o nó é hospedado (web hospedada e app instalado); no
varanda-servee no app com configuração manual a tela não oferece o jogo. Opcional e desligado por padrão. Um jogo de varanda: a pessoa planta, rega e colhe nos vasos da própria varanda, no relógio de quem olha, e rega uma vez por dia a varanda de quem segue. Todo o estado são registros assinados (garden,garden-state,garden-help) no diário de quem joga; o semeador guarda só apontadores e o nó do navegador confere cada bloco. Quem recebe a rega vê o nome em "Quem regou". Sair marca os registros do jogo como apagados. Entra por Ajustes (abaixo de Visitas), pelo Diário e pelo perfil de um membro, este só depois de uma consulta ao apontador da varanda no semeador. Duas telas: a Varandinha e Varandas da rua. Métodosgarden.set,garden.state,garden.play,garden.help; rotas do semeador/index/garden/<dono>e/index/garden/<dono>/rua. Não há push nem aviso que chame a pessoa de volta. - Linha de publicação. O avatar e o nome abrem o perfil do autor (Membro; o próprio nome abre a aba Diário), com alvos de toque perto de 44 pt no nativo (a linha "republicou" sem "seguir" chega a cerca de 36 pt, o nome sob "republicou" a cerca de 32 pt, e a web ignora
hitSlop); o chip "Respondendo a Nome" (alvo de 44 pt) abre a publicação respondida (texto simples onde a tela não dá abertura); tocar no texto, no tempo ou no espaço vazio abre a Conversa (as fotos guardam o toque delas); na web hospedada, um@nomeno texto (também no cartão da citação) é um link: tocar, ou Enter e espaço pelo teclado, abre o perfil sem abrir a Conversa; o nome do próprio autor da linha abre sem pedido, e qualquer outro é resolvido pelo serviço de conta (só o dono atual do @nome, com "Sem conexão para abrir o @nome.", o aviso de nome não encontrado ou "Não foi possível abrir o @nome agora." nas falhas); no app com configuração manual e com ovaranda-serveo@nomesegue sem link, mas os links abaixo funcionam; "Nome republicou" abre o perfil de quem republicou; o cartão da citação abre a publicação citada (só um nível: uma citada que também cita mostra "cita outra publicação"). Uma legenda longa fica recolhida: 3 linhas quando a publicação tem fotos e 9 quando é só texto. O recolhimento só começa quando a estimativa passa do limite por 2 linhas ou mais, então uma legenda uma ou duas linhas acima fica aberta. Embaixo da legenda recolhida há um botão "mais" (com fotos) ou "ver mais" (só texto), de cerca de 44 pt de altura, com 12 pt de espaço próprio acima dele (não cobre a última linha); aberta, o botão diz "menos". O botão abre e fecha no lugar, sem abrir a Conversa, e o carrossel continua na mesma foto. Leitores de tela leem a legenda inteira pelo rótulo da publicação e ouvem o botão como "mais, ver texto completo", "ver mais, texto completo" ou "menos, recolher texto", com o estado aberto ou fechado. Enquanto recolhida, a legenda é texto simples: links e @menções só funcionam depois de aberta (o recolhimento poderia esconder parte de um endereço). No app nativo, a legenda mede as linhas reais depois do desenho e, se couber, aparece inteira sem botão; a web não mede e decide só pela estimativa pela largura, então uma legenda de exatamente 3 ou 9 linhas pode manter o botão até ser aberta uma vez. Um linkhttp://,https://ouwww.no texto da publicação, da bio do Diário ou do Membro, na mensagem de grupo e na mensagem privada fica sublinhado na cor de destaque e abre direto, sem confirmação: no navegador do aparelho, ou em nova aba na web (umwww.abre comohttps://). Tocar no link nunca abre a Conversa. No cartão da citação o link segue como texto, porque o cartão corta o texto em 6 linhas e o corte poderia esconder parte do endereço; tocar no cartão abre a publicação citada, onde o link funciona. Sóhttpehttpsviram link; um domínio sem prefixo (comoexemplo.com.br) segue como texto, e um host com caractere fora do ASCII não vira link. Um@nomedentro de um link não é link de perfil (a notificação de menção não muda), e o@nomefora de link segue como acima. O texto pendente na fila de saída e as prévias do campo de escrita não têm link. Embaixo, uma barra horizontal com responder, republicar, curtir (coração cheio quando curtido; "descurtir") e "mais" (⋯), cada uma com o número só quando ele é conhecido e maior que zero (na web hospedada, vindo do índice), em forma compacta ("12,3 mil"); o número completo só é lido por leitor de tela nos botões que abrem quem curtiu e quem republicou. No topo da publicação, ao lado do nome, ficam "seguir" (só na Espiadinha, botão de texto em destaque) e o ⋯ ("mais ações"), com alvos de 44 pt centrados na linha do nome; uma publicação só com o ⋯ não fica mais alta que o texto. A data vem depois do nome, compacta, e a partir de 7 dias como data ("5 nov", ou "5 nov 2025" em outro ano); o leitor de tela ouve a data por extenso ("3 h", "ontem", "5 nov"). Para leitor de tela, "seguir" e o ⋯ vêm depois da legenda, do "Ver mais" e da prévia das respostas, e antes da barra de ações. Segurar 350 ms no corpo, na legenda, no nome, no @nome, na data ou na linha "respondendo a" abre a mesma folha de ações (desligado com leitor de tela ligado). A barra não tem lápis, bandeira nem lixeira. Republicar abre a folha "Republicar" (ou "Desfazer republicação", quando a publicação já foi republicada) e "Citar"; sem rede, a folha traz só "Citar". "Mais" abre "Copiar link" (quando a publicação tem link), "Denunciar" (publicações de outros, com a conta conectada) e "Apagar" (publicações próprias, em vermelho, com a confirmação de sempre). Uma publicação de diário tem o link<origem>/p/<chave>/<seq>sempre que o app conhece a origem (a da instalação ou, na web, a do endereço aberto); com ele aparecem o botão "compartilhar" na barra e "Copiar link" no "mais". O link mostra a publicação só quando o autor a publicou na web (veja "Página pública na web"); nos outros casos leva ao app. Mensagens privadas, grupos e momentos não têm link, nem a publicação de uma Página quando o app sabe que é uma Página. Enquanto o perfil do autor não chegou, e sempre na Busca, uma publicação de Página também recebe o link, que então só leva ao app, porque o semeador não mostra páginas de Página. Curtir e republicar mudam na hora (otimista) e voltam atrás com a mensagem de erro selike.set/repost.setfalha; o botão fica desligado enquanto o pedido roda. Curtir e republicar funcionam também no app com configuração manual e novaranda-serve, sem contagens. Na web hospedada, o número de curtidas e o número de republicações, quando aparecem, são controles separados que abrem a lista de quem curtiu e de quem republicou; o coração liga e desliga, e o ícone de republicar abre a folha (leitura de tela: "republicar ou citar"); o número de respostas não abre lista. O número de citações não aparece na barra, porque "Citar" fica na folha de Republicar; somá-lo às republicações faria o número não bater com a lista de quem republicou. Uma linha de republicação abre a lista da publicação original. Em A Rua, um comentário entra no cartão da publicação a que pertence: em cima, "Ana comentou" ("Ana e Bia comentaram", "Ana e mais 2 comentaram"; numa republicação fica "Nome republicou"); embaixo da barra de ações, até 2 linhas de comentário de uma linha ("Nome: texto"; comentário só com foto não ocupa linha) e "Ver todos os N comentários" (ou "Ver comentários"), sem rótulo visível, num botão só que abre a Conversa no comentário mais novo; o leitor de tela ouve "Comentários." antes das linhas. O ícone de responder de uma linha da A Rua (e do Diário e das outras listas) abre a Conversa daquela publicação com a barra em foco, quando o nó está cheio e a pessoa não age como Página; senão abre a Publicar. - Página pública na web. Nas publicações próprias, o menu "mais" da linha de publicação ganha "Página pública na web" só com o nó hospedado (a web hospedada e o app instalado com a instalação) e só enquanto a instalação responde que a página pública está ligada (
GET /p/policy, chaveVARANDA_POSTS_ORIGINdo semeador, protocol.md seção 16); sem isso, ou na dúvida, a linha não aparece. Uma resposta definitiva fica guardada durante a sessão; falha de rede, erro do servidor, 408 ou 429 fazem a pergunta de novo quando o app volta a ficar online ou visível. A linha abre a folha "Página pública na web", que lê se a publicação está publicada (post.shared), pede o aceite antes de publicar ("Publicar na web",post.share) e permite tirar da web ("Tirar da web",post.unshare), RPC 5.121 a 5.123 em rpc.md. Depois de escrever, a folha diz só que o pedido foi enviado, porque o nó informa o que este aparelho escreveu, e não que o semeador já tem. Publicar nunca abre o compartilhamento: "Compartilhar" e "Copiar link" agem só no próprio toque, com o link<origem>/p/<chave>/<seq>. Quando o semeador não mostra a publicação, o link leva a/publicacao/<chave>/<seq>no app, que guarda a publicação como destino (na web, na aba, por até 1 hora, e o caminho sai da barra de endereço; no app nativo, só na memória do processo). Sem sessão, Entrar mostra o cartão "Você abriu o link de uma publicação. Entre ou crie sua conta para ver.", depois de um convite ou de um link de grupo ou comunidade, se houver; "Agora não" esquece o destino, e o cartão não dá código de entrada. Para quem não tem conta no aparelho ou no navegador, numa primeira visita (antes dos cartões de apresentação) ou numa seguinte, um cartão diz que há uma publicação esperando, com Entrar (Termos, depois Entrar com o cartão da publicação), Como funciona (os cartões de apresentação e a volta) e Agora não (segue para a apresentação numa primeira visita, ou para Termos e Entrar nas demais, e o destino fica). Com a sessão aberta, as abas na tela e o nó hospedado, a Conversa da publicação abre uma vez e o destino é apagado. Termos e Política na versão 48. Em Publicar, a caixa "Publicar também na web" aparece nas mesmas condições da linha "Página pública na web" do menu "mais" (nó hospedado, com a política/p/policyligada), e só com rede, numa publicação comum no próprio diário. Não aparece numa resposta, citação, enquete, evento, Momento nem ao publicar como uma Página; essas continuam podendo ir para a web depois, pelo "mais" da publicação. A caixa começa desmarcada toda vez que a folha abre e volta a desmarcar sempre que deixa de ser oferecida; marcada, mostra o mesmo texto de consentimento da folha. Depois que a publicação sai, o app envia umpost.sharee abre a folha "Página pública na web" dela: com o aviso "Enviado para a web..." e o link, "Compartilhar" e "Copiar link" se deu certo; se o envio falhar, a folha diz que a publicação saiu mas não foi para a web (com o motivo, quando há) e oferece "Publicar na web"; se não deu para confirmar, a folha diz o que este aparelho registrou (enviado, ou que não foi para a web) e, quando nem isso dá para ler, que o envio à web não foi confirmado, pedindo para abrir de novo. Se o nó não devolve a posição da publicação, um aviso curto diz que ela saiu mas não foi para a web e aponta o menu da publicação. Nada é reenviado automaticamente. Com a caixa marcada a publicação nunca vai para a fila de saída: se o portão de escrita não alcança o semeador, o rascunho fica em Publicar com o erro. Termos e Política seguem na versão 64, porque a seção "Página pública de uma publicação" já descreve uma escolha por publicação que pode ser retirada. - Música em publicações. Numa publicação (A Rua, Diário, perfil, conversa, Busca, Espiadinha), um cartão de YouTube, SoundCloud, Spotify ou Apple Music mostra o player do próprio provedor sem toque: não há botão para carregar nem para fechar o player, nem aviso embaixo do cartão. O quadro é montado depois que o cartão fica dentro da faixa da lista (pelo menos metade da largura e o menor entre metade da altura e 120 pt, abaixo da barra de cima e acima da barra de abas, quando a tela tem uma) ou perto dela, a até duas alturas da faixa para cima ou para baixo (
EMBED_AHEAD_BANDS= 2), em duas conferências seguidas com 500 ms de intervalo (EMBED_TICK_MS= 500,EMBED_DWELL_TICKS= 2), de modo que o player costuma estar carregado quando a pessoa chega ao cartão, sem prometer que sempre estará. Isso vale só na tela que a pessoa está olhando (a aba escolhida, sem nada empilhado por cima, ou a tela do topo da pilha), sem compositor, Ajustes, denúncia, ajuda, aviso de página ou bloqueio por cima, com o app em primeiro plano e sem foto em tela cheia aberta; em nenhuma outra tela um quadro começa a carregar. Na conversa de uma publicação (Conversa), a faixa termina no topo da barra de resposta. O cartão guardado continua no lugar até a página do provedor carregar (o evento de carga do documento do invólucro mais 500 ms, uma heurística: o app não vê se o provedor já desenhou o player), e um quadro que ainda não carregou, ou que está numa tela que não é a olhada ou sob uma folha, um menu ou a foto em tela cheia, não abre nada. Um quadro carregado em que a pessoa não tocou continua o mesmo enquanto a pessoa rola a mesma tela a qualquer distância, inclusive depois que a lista desmonta a linha, e voltar com a rolagem mostra a mesma página, no ponto da faixa em que ela está, sem recarregar o provedor. Um quadro que a pessoa não tocou também continua carregado quando a tela deixa de ser a olhada (troca de aba, tela empilhada por cima, folha, menu ou foto em tela cheia), ficando fora da vista e como o mais distante a ceder o lugar. "Tocado" é o quadro em que a pessoa encostou o dedo ou o foco entrou, ou qualquer quadro enquanto um leitor de tela está ligado ou ainda não respondeu, lido na hora de cada decisão. Um quadro tocado pode estar tocando, então fecha ao sair da tela olhada, ao ser coberto e quando outro áudio do Varanda começa depois do toque (cartão do Audius, mensagem de voz); um áudio que já tinha começado antes do toque não o fecha, e um não tocado não fecha por isso. Um quadro tocado também fecha quando seu cartão fica fora da faixa visível em duas conferências seguidas e novas (embedLeaves), com 2 s de espera depois do toque (OPEN_GRACE_MS), ou quando a lista desmontou sua linha, na próxima conferência de 500 ms da camada (EmbedLayer.js); uma linha que continua montada tem a espera de volta de cerca de 1 s descrita adiante, e na tela cheia nativa o quadro tocado continua. O toque só de leitor de tela fecha apenas um quadro que já esteve na faixa. Não há canal para dentro do quadro, então ele descarrega em vez de pausar, e o cartão guardado volta. Fora da tela cheia, quando a tela gira ou a janela muda de retrato para paisagem ou o contrário (web, PWA, iPad, Android de tela grande), um player tocado mantém o comportamento anterior: fica até outro player começar, um bloqueio ou uma troca de tela. Bloquear o app ou mandá-lo para segundo plano fecha todos, e depois eles podem voltar, em silêncio. O som de um quadro tocado pode continuar enquanto ele está carregado, embora o provedor possa pausá-lo por conta própria quando o quadro fica escondido. Nas listas deRefreshableList.js(A Rua, conversas, respostas de Conversa e outras),EmbedLayer.jsdesenha os quadros carregados numa única camada, o último filho do conteúdo de rolagem da própria lista, viarenderScrollComponentdo FlatList. A camada rola nativamente com a lista. A linha guarda um espaço vazio do tamanho do player, e a camada posiciona o quadro sobre ele, medido em relação ao contêiner do conteúdo de rolagem. A janela de linhas do FlatList e o corte de subviews fora da tela no Android não recarregam o quadro. Quando a lista desmonta a linha, o quadro continua carregado com opacidade 0, sem toques, escondido dos leitores de tela e, na web, fora da ordem de Tab. Quando a linha volta, o cartão retoma o mesmo quadro. Os cartões do cabeçalho de Conversa e a prévia do compositor ficam no próprio espaço, sem passar pela camada. A lista não desmonta seu cabeçalho. Eles seguem as mesmas regras, sem limite de distância. No máximo 4 quadros de provedor ficam carregados no app (EMBED_LIVE_MAX), incluindo a prévia do compositor; cada morte de um processo de conteúdo baixa esse teto em 1, no máximo uma vez a cada 5 s (EMBED_SHRINK_MS) e nunca abaixo de 2 (EMBED_LIVE_MIN), até o app reabrir. Um cartão que precisa de lugar marca o pedido para o quadro não tocado mais distante da faixa. Um cartão visível pode pedir a qualquer quadro não tocado, e a um tocado só quando não há nenhum não tocado parado; um cartão que só vai carregar adiante (pré-carga) pede só a um quadro não tocado pelo menos 400 pt mais longe da faixa que ele (EMBED_YIELD_GAP) e toma no máximo um lugar novo a cada 500 ms, para uma rolagem rápida não carregar vários de uma vez. Enquanto um cartão visível espera lugar, nenhuma pré-carga toma o lugar que ficar livre, por até 1 s depois do último pedido dele. O quadro marcado cede na própria conferência seguinte, em até 500 ms, só se continuar fora da faixa em duas conferências seguidas: uma medição que não responde conta como fora da vista, e uma resposta atrasada não custa o lugar a um quadro tocado. Uma linha desmontada conta como fora da vista, e a camada solta seu quadro na próxima conferência após o pedido. O pedido é retirado quando outro quadro sai ou quando o cartão que esperava deixa de esperar. Um quadro tocado nunca fecha para dar lugar a uma pré-carga. Se não há lugar, o cartão espera mostrando o cartão guardado. A linha sair dos dados da lista (publicação apagada, silenciada ou lista reiniciada) também fecha o quadro; inserir linhas no início não fecha nenhum. A exceção é a lista que lê de novo só a primeira página (a aba que volta, atualizar) e corta por um momento as linhas mais antigas: o quadro não tocado de uma linha cortada depois do novo fim fica carregado, fora da vista, por até 5 s (EMBED_CUT_MS) e volta para o cartão se a linha voltar nesse tempo; se não voltar, fecha. A lista não distingue esse corte de uma publicação apagada ou silenciada no fim do que já carregou, então o quadro não tocado dela fecha em até 5 s. Um quadro tocado fecha na hora, e quando a lista troca todos os dados por outros (uma busca nova), todos fecham na hora. Se o processo de conteúdo morre (onContentProcessDidTerminateno iOS,onRenderProcessGoneno Android), o cartão guardado volta, o teto baixa em 1 como descrito acima e o player carrega de novo após a espera normal quando o cartão está dentro ou perto da faixa. Se um cartão sai de uma linha que continua montada e nos dados da lista, como uma mensagem apagada que permanece sinalizada na conversa, a lista fecha seu quadro escondido após cerca de 1 s (duas conferências de 500 ms). Uma mensagem ocultada ou apagada enquanto sua linha está fora da janela da lista fecha o player na hora. Esse intervalo permite que um cartão que some e volta na mesma linha, como uma citação que mostra "carregando" por um momento, retome o quadro. Na web, um player fora da vista cuja linha continua montada permanece alcançável com Tab. Leitores de tela e teclado alcançam um player visível depois das linhas da lista, em vez de dentro da publicação. Os endereços dos players não pedem reprodução automática (YouTube sem autoplay, SoundCloud com auto_play=false), a permissão do quadro não inclui autoplay e o WebView nativo exige um toque para tocar mídia, então nada soa antes de a pessoa apertar o play dentro do player. Músicas completas dependem do provedor. O sandbox tem allow-popups (allow-scripts allow-same-origin allow-presentation allow-popups: sem navegar a janela de cima, sem formulários e sem downloads, e sem allow-popups-to-escape-sandbox). No app nativo, um toque num link dentro do player não carrega nada no WebView: o endereço só sai para o sistema quando é https num domínio do mesmo provedor ou num subdomínio dele, e nunca pela página de redirecionamento do YouTube (/redirect), que leva para fora dele. Na web e no PWA, o link abre outra aba, que continua no sandbox e não consegue trocar a aba do Varanda. O player do SoundCloud não mostra os botões de comprar, compartilhar e baixar (buying=false, sharing=false e download=false no endereço), porque o link de compra é quem envia a faixa que escolhe e, na web, abriria numa aba que o app não confere. Não há o link "Abrir no ": enquanto o player não está carregado, um toque no cartão guardado abre a página guardada. Um cartão mais estreito que o mínimo do provedor (YouTube abaixo de 200 pt) nunca monta quadro e mostra o cartão guardado, que abre a página num toque. Carregar um quadro não conta como tocar, então não para uma mensagem de voz, um cartão do Audius nem um momento; o app não vê o play dentro do quadro, então apertar o play num player não pausa outro áudio. O texto mostrado da publicação esconde só o link que é o próprio item do cartão (mesma página reconstruída porembedOf; youtu.be/ID e watch?v=ID são o mesmo item, outro t= é outro item); todo o resto do texto fica, e o registro guardado não muda. Depois de esconder o link, a pontuação em volta se ajeita, sem que o texto mostrado ganhe link, menção ou palavra que o texto guardado não tem: um par de parênteses ou colchetes que ficou vazio só some quando há espaço ou o limite da linha do lado de fora, a pontuação só se junta à palavra anterior quando vem seguida de espaço ou do fim do texto, e se a arrumação ainda mudasse os links ou as menções, o texto original aparece ("Olha , que legal" vira "Olha, que legal", enquanto "pala( )vra" fica "pala( )vra"). Um tempo do YouTube comot=1m30stambém é aceito. Uma medição que não responde antes da conferência seguinte conta como cartão escondido, e uma só dessas não deixa um quadro carregado ceder o lugar. Os mesmos players (nunca o do Audius) carregam também numa publicação citada (QuoteCard, onde o player fica fora da área de toque da citação e fora do invólucro de acessibilidade escondido: o nome e o horário da citação são o link que abre a publicação citada, e o player é alcançado por VoiceOver, TalkBack e teclado), nas conversas privadas e nos grupos (Bubble, em Mensagem e Grupo, onde a faixa da lista termina no topo do compositor) e na prévia do link no compositor (LinkDraftCard: Publicar, conversas privadas e grupos) assim que a prévia fica pronta, antes do envio. Na prévia do compositor, um player mais alto que um terço da janela (álbuns, playlists, sets do SoundCloud) dá lugar ao cartão guardado, e o botão de remover a prévia aparece em todos os estados. Uma folha aberta descarrega os players tocados que ficam embaixo dela e mantém os não tocados, enquanto um cartão dentro da folha mantém o seu; bloquear o app ou mandá-lo para segundo plano descarrega todos. Nos balões e nas citações, o texto mostrado esconde o link do próprio cartão do mesmo jeito (numa mensagem com formatação, o texto fica inteiro); copiar, encaminhar e responder usam o texto inteiro. Numa conversa privada ou num grupo, isso conta ao provedor que o aparelho mostrou aquele item, e quando, mas nunca o texto das mensagens. Cartões de link comuns (qualquer outro site) mostram a prévia guardada. Se a página não puder ser lida ao compor a publicação, um link de música reconhecido ainda pode ganhar cartão com o nome do provedor e sem imagem. Um link de Audius nunca carrega o player do provedor; nada do Audius toca sozinho numa publicação: o único jeito é o cartão por toque (MusicPlayerCard.js), descrito abaixo. Sem leitor de tela ligado, outro áudio do Varanda não zera mais a espera de um cartão que ainda não está carregado. Limites: na primeira vez que a tela é vista, na volta do bloqueio ou do segundo plano, numa rolagem rápida e quando um cartão mais próximo toma o lugar, o cartão guardado aparece até o player carregar. Na web, ao voltar para uma aba depois de trocar no fim de uma lista longa, a rolagem pode voltar mais acima (o navegador limita a posição enquanto a lista está escondida e mais curta), e players não tocados podem trocar de lugar e carregar de novo. Termos e Política na versão 53, com novo aceite. Conferência: verification.md, seções 186, 203, 204, 205, 207, 215, 233 e 246. - Conversa (por cima das abas, com o título "Comentários"). Abre com qualquer publicação da conversa e mostra a raiz como única publicação em destaque e, embaixo, os comentários (respostas diretas à raiz), em páginas de 50 pelo cursor do índice, até "Isso é tudo nesta conversa."; o número de comentários fica só no ícone de comentar da publicação em destaque. Em cada página vêm primeiro os comentários seus e de quem você segue, depois os outros, do mais antigo ao mais novo. Na web hospedada com rede, o índice do semeador diz onde procurar e o nó busca e confere cada publicação com
diary.peek; um comentário só fica se oreplyToassinado dele é a raiz. Notas: "Ainda montando a conversa completa…" enquanto o semeador indexa, "Algumas respostas podem faltar." quando o índice não está completo, e "N comentários indisponíveis" para os que não puderam ser lidos. Sem o semeador: "Sem conexão com o servidor agora." (com "tentar de novo"); publicação fora do índice: "Esta conversa não está disponível.". No app com configuração manual, novaranda-serveou sem rede, só a linha tocada aparece, com a nota "Conversa completa disponível na versão web, com internet." Dois níveis: um comentário que tem respostas ganha embaixo a linha "Ver N respostas" ("Ver 1 resposta"; "Ver respostas" quando a contagem é desconhecida; "Ocultar respostas" aberta), que abre a roda dele: todas as respostas da subárvore numa lista só, recuada com um fio fino, sempre o pai antes dos filhos, cada uma conferida peloreplyToassinado; uma resposta a outra resposta leva no topo a citação da mensagem que responde, e tocar na citação rola até ela e a destaca. Uma roda longa termina em "Ver mais respostas". Nenhum toque dentro da conversa troca a publicação em destaque. Deslizar para a direita num comentário ou numa resposta mira nela na barra. Aberta por uma resposta funda, a roda do comentário dela abre sozinha e a resposta é destacada. A publicação em destaque mostra a legenda inteira, sem "mais". Barra de resposta: só com o nó cheio (hospedado e com internet), uma pílula arredondada flutuante, afastada das bordas, sobre o fundo da página. Em repouso ela tem a foto da própria pessoa (a da Página, com o nome dela no campo, "Responda como Nome" ou "Comente como Nome", quando se age como uma Página: a resposta curta sai como a Página, sem o nó local, e só link ou texto longo abrem a Publicar: a Página não passa pela fila), o campo "Escreva um comentário" ("Escreva uma resposta" quando mira uma linha), um ícone de foto (rótulo "adicionar foto") e o ícone que abre o editor completo (rótulo "abrir editor completo"). Ao tocar no campo, com texto ou ao responder a outra resposta, aparece no topo da pílula a linha "Respondendo a @nome", com o botão de fechar "cancelar resposta", que volta a mira para a publicação em destaque; o botão redondo de enviar (rótulo "Responder") surge ao lado da pílula assim que o campo tem texto. Tocar no ícone de responder de uma linha mira nela. O ícone de foto abre o editor completo com o rascunho e já abre a escolha de fotos; se o editor tinha um rascunho diferente, a pessoa escolhe primeiro qual manter, e a escolha de fotos não abre sozinha. O envio rápido pela barra continua só com texto: um texto curto é enviado e aparece na hora. Uma Página também responde na barra. Texto com link, texto com mais de 1000 caracteres e a resposta da pessoa recusada pela fila abrem a Publicar com o rascunho (se a Publicar já guarda outra publicação, ela pergunta "Você tem um rascunho não publicado." com "Usar a resposta" e "Manter o rascunho"; recusar mantém o rascunho antigo com o próprio alvo de resposta ou citação). Texto com termo bloqueado mostra a recusa embaixo da barra. Um envio incerto diz que pode ter sido enviado, guarda o texto e nunca tenta de novo sozinho; como Página, enviar de novo o mesmo texto, ao mesmo alvo, reenvia a mesma resposta assinada, sem duplicar. Sem o nó cheio (sem internet, não hospedado) não há barra e o ícone de responder abre a folha Publicar; o botão de publicar não aparece na Conversa. Puxar para atualizar e falhar mantém a conversa e os ramos abertos com a nota "Não foi possível atualizar a conversa."; só a primeira leitura que falha mostra a tela de erro. - Membro (por cima das abas). O perfil de qualquer membro, com o mesmo desenho do Diário: uma faixa em gradiente atrás da barra de estado, um círculo de voltar no canto esquerdo da faixa, o avatar de 88 pt com anel à esquerda, nome, @nome e bio (de
profile.readquando o aparelho tem o diário; senão, na web hospedada, de umdiary.peekdos blocos indicados pelo índice), com os links sublinhados da bio (veja "Linha de publicação"), logo abaixo, "N seguindo" e "N seguidores" (ambos do semeador, públicos; cada um abre a lista Seguindo ou Seguidores dessa pessoa, veja Pessoas; com configuração manual não aparecem), depois a pílula "Seguir"/"Seguindo", o botão só com ícone "Mensagem" (na versão hospedada; o nome "Mensagem" é para o leitor de tela) e "denunciar a conta" (tocar em "Seguindo" abre a confirmação "Deixar de seguir ?", e só o botão vermelho "Deixar de seguir" deixa de seguir); "denunciar a conta" só na web hospedada; embaixo, as publicações e republicações dele, da mais nova para a mais antiga, em páginas do índice (/index/member), cada uma buscada e conferida comdiary.peek. Notas: "Ainda montando a lista completa…" e "Algumas publicações podem faltar."; sem nada, "Nenhuma publicação ainda". No app com configuração manual, novaranda-serveou sem rede, só o cabeçalho aparece, com a nota "Publicações completas disponíveis na versão web, com internet." Nenhuma chave aparece. - Curtidas e republicações (por cima das abas). Na web hospedada, duas abas, Curtidas e Republicações, da mais nova para a mais antiga, como o semeador afirma, em páginas de 20. Só aparecem pessoas cujo registro o nó conferiu (
diary.peek): avatar, nome e @nome; um toque abre o perfil. Notas: "Ainda montando a lista completa…", "Alguém pode faltar nesta lista." e "N pessoas indisponíveis" ("1 pessoa indisponível" quando é uma). "mostrar mais" aparece mesmo numa página vazia quando há mais ("Ninguém conferido até aqui", "A lista continua."). Fora do nó hospedado (app com configuração manual evaranda-serve), "Curtidas indisponíveis" ("Quem curtiu e quem republicou aparece no site da associação ou no app ligado à instalação, com internet."). Num nó hospedado que recusa a lista, "Lista indisponível" ("Quem curtiu e quem republicou não está disponível nesta conexão."), sem mandar a pessoa para a web. - Editar perfil. Folha com nome (1 a 80 caracteres) e bio (0 a 280), preenchida com o perfil próprio verificado de
profile.read(que lê o diário local inteiro); "Cancelar" descarta. Na web hospedada, a folha também escolhe e enquadra a foto do perfil (arrastar, botões ou teclado; o enquadramento não sobe nada, só Salvar grava) e permite remover a foto; no app com configuração manual a foto não é editável, só removível. Enquanto existe foto, o nó do núcleo recusa mudar nome ou bio ('perfil com foto: mude o nome e a bio na versão web ou tire a foto'). - Ajustes. Folha com a lista principal, para pessoas, e o resto atrás de Avançado, recolhido:
- Os itens ficam em grupos com título: "Perfil e conta", "Privacidade e segurança" e "Aparência e avisos", e "Avançado" por último; cada nota fica dentro do seu grupo, e o rodapé de versão tem três itens (app, servidor e nota), com a cópia anunciada. Nenhuma linha foi removida nem religada.
- Lista principal: o cartão do perfil no alto de "Perfil e conta" (avatar, nome, @nome e uma seta, que abre Editar perfil; enquanto o perfil não é conhecido, a linha Editar perfil aparece no lugar), Conta e @nome (o vínculo com a conta Google e o @nome, em palavras simples), Passkeys e recuperação (passkeys extras, troca da passkey deste aparelho e código de recuperação; veja "Passkeys e recuperação" acima), Avisos no aparelho (só na web hospedada, e só quando o serviço entregou a chave pública: a linha mostra "Ligados" ou "Desligados" e um toque troca o estado; sem a chave a linha não aparece; no iPhone e no iPad fora da Tela de Início a linha também não aparece e o texto explica o limite; com um service worker antigo, ligar fica bloqueado até fechar todas as janelas e abrir de novo, e desligar continua permitido), Guardar dados neste aparelho (só na web; pede
navigator.storage.persist()e diz se o navegador garantiu), Instalar o app (só na web; a linha "Abra o menu do navegador e escolha instalar o app. No iPhone: Compartilhar e depois Adicionar à Tela de Início." que termina com o botão de informação, o qual abre "Como instalar o app"; quando o navegador oferece a instalação, o botão "Instalar"; no Samsung Internet o botão nunca aparece) e, à parte, Sair (com confirmação; veja "Sair, bloquear e Recomeçar"; na web hospedada, Sair desliga os avisos deste navegador) e Excluir conta (instalação hospedada, passkey aberta; veja "Excluir conta"). Os itens que só existem com a passkey somem nos outros modos. - Termos e privacidade. Os dois documentos (Termos de Uso e Política de Privacidade, versão 3,
apps/app/src/legal.js, sujeita a revisão jurídica) em todos os modos, e o estado do aceite deste aparelho: "registrado" (o serviço de conta já tem), "pendente" (ainda vai tentar) ou "só neste aparelho" (sem vínculo Google). Fora do portão, esse último estado diz "Aceite registrado só neste aparelho." que termina com o botão de informação, o qual abre "Sobre o registro do aceite". Só a web hospedada mostra esse estado; no app com configuração manual o aceite fica só no aparelho e Ajustes mostra apenas a data. Ligar os avisos no aparelho pede o aceite da versão atual. - Aparência. Três escolhas em Ajustes › Aparência, cada uma com um ícone (celular para Sistema, sol para Claro, lua para Escuro): Sistema (segue o modo claro ou escuro do aparelho; é o padrão), Claro e Escuro. A linha da lista principal mostra a escolha atual. A escolha fica guardada só neste aparelho (no navegador, no
localStoragecom a chavevaranda-aparencia; no app, no arquivovaranda-aparencia.jsonna pasta de documentos) e não vai para a conta nem para o semeador. O app lê a escolha antes de desenhar a primeira tela, então ela não pisca no modo claro. A barra de status segue o tema: ícones claros no escuro e sobre a faixa do pôr do sol, escuros no claro. A tela de abertura nativa (iOS e Android) é creme nos dois modos e não segue a escolha; por isso o iPhone começa com ícones escuros na barra de status. Limite na web: o pré-splash e a cor da barra do navegador seguem o sistema até o JavaScript do app rodar, então com uma escolha diferente do sistema pode aparecer um quadro do modo do sistema antes do app. Nomanifest.webmanifest, obackground_colorcontinua creme (a abertura do app instalado) e otheme_coloré escuro (#101010), a cor da barra de navegação do sistema no app instalado; na web, a barra de abas é escura e opaca nos dois modos para combinar com ela (no app nativo ela segue o modo). - Avançado › Conexão. No app nativo e na web com o nó no navegador, a configuração da tela Conectar; com o
varanda-serve, o estado da conexão com ele e o botão "reconectar". - Avançado › Sincronização. Só leitura: a sincronização é automática e esta tela não tem botão de sincronizar nem de parar. Mostra o estado numa linha, com uma bolinha colorida (destaque quando sincroniza, recupera ou está automática; aviso ou perigo nos estados ruins). A frase é o texto do antigo chip: "sem rede", "sem conexão", "recuperando…", "sincronizando…", "sincronização automática", "reconectando…", "conectando…", "pausado" ou "em pausa", esta última quando a rodada contínua terminou por ociosidade e a conexão está liberada; não aparece enquanto o app espera para tentar de novo depois de uma falha), o estado da rodada ("sincronizando (contínua, execução N)", "sincronizando (única, execução N)", "recuperando (única, execução N)" ou "parada"), a última parada com o motivo (inclusive "em pausa"), "nova tentativa em N s" enquanto o app espera para tentar de novo, "conferindo o estado…" enquanto confirma com o nó o que está rodando, e, atrás de "Ver registro" (fechado no começo), as últimas 200 linhas de evento. O texto diz "Atualiza sozinho enquanto o app está aberto e com rede."
- Avançado › Identidade técnica. A chave pública (atrás de "mostrar chave"), a associação e o estado do certificado de membro; aceita colar o JSON do certificado emitido pela associação.
- Avançado › Recomeçar (sempre que há uma passkey, inclusive no app instalado), com confirmação "Apagar e recomeçar".
Na web, as folhas fecham com Escape. Escape (e, no Android, o botão voltar) fecha só a camada de cima: folha, menu, visualizador ou editor de foto; a tela de baixo só volta quando não há camada aberta, e numa subpágina de Ajustes volta para a lista.
Uma ação principal por fileira. Cada fileira tem no máximo uma pílula cheia (Seguir, Aceitar, Publicar, Salvar); as demais ações visíveis são pílulas de contorno ou ícones, e as raras ficam no botão de mais (três pontos), que abre uma folha de ações. Uma fileira de ações nunca quebra em duas linhas nem espreme um rótulo: no perfil são a pílula de seguir, o ícone de mensagem e o botão de mais; numa confirmação, a ação e Cancelar ficam empilhadas em largura total. O desenho de cada peça está em app-design.md ("Componentes").
O app guarda um cache de perfis por sessão e o preenche com profile.read (rpc.md, 5.21), que troca chaves por nome, @nome e bio. Os pedidos saem em lotes de até PROFILE_LIMIT_MAX (100) chaves, com 100 ms de espera para juntar pedidos de várias telas, um pedido por vez e pelo menos 1 s entre lotes. A chave da própria pessoa vai primeiro, depois as que estão na tela, depois as de fundo. Cada pedido de leitura interrompe a rodada contínua e o nó a reinicia depois (rpc.md, 6.1; issue #66), por isso a regra é um pedido por tela e em lote. As buscas rodam durante a sincronização contínua; só uma rodada única as pausa, porque ela terminaria de vez. As buscas de fundo (reler uma chave quando uma linha downloaded mostra que o diário dela cresceu, e as novas tentativas) esperam a rodada contínua ter 5 s de vida, para o semeador ser alcançado antes de a próxima interrupção.
profile.readlê o diário local inteiro com as mesmas regras de admissão do feed (o limite dos 42 blocos mais novos acabou) e devolve o nome, a bio e o @nome verificado. Quem o feed não mostraria volta como ausente.- Na Espiadinha, nome e @nome vêm nos próprios itens de
peek.read, sem entrar nesse cache. Espiar não cria réplica local:profile.readcontinua respondendomissingpara um diário que só foi espiado. - Em Mensagem, para um par cujo diário o aparelho não tem (
profile.readrespondemissing), o nó hospedado lê o nome, o @nome e a foto comdiary.peek(profileOnly), nos blocos indicados pelas dicasprofileSeqeusernameSeqdo índice, e confere essa leitura. Abrir a conversa já lê esse diário comdm.lookup, então o semeador não fica sabendo de nada novo. A leitura se repete a cada vez que a conversa é aberta ou volta à tela (de outra tela, com a aba visível de novo, com a conexão de volta) e a cada atualização (puxar para baixo), e a atualização pede ao índice dicas novas, sem o cache de 5 minutos. Se o índice não encontrar mais a pessoa ou o nó recusar o diário (NOT_FOUND'diário indisponível', por exemplo depois de um bloqueio da moderação da rede; um bloqueio feito pela própria pessoa não esconde o nome, como na lista de bloqueados), o nome, o @nome e a foto saem e o par volta a "Pessoa". Uma falha passageira (rede, semeador fora do ar) mantém o que está na tela. Uma leitura iniciada numa sessão anterior, ou deixada para trás ao sair da conversa, é descartada, e uma resposta deprofile.reada substitui. Conversas não lê sozinha, porque ler cada linha da lista mostraria ao semeador cada pessoa não seguida com quem se conversa. A linha passa a mostrar o nome depois que a conversa é aberta. Com configuração manual ou num nó do núcleo, que recusadiary.peek, o par continua "Pessoa". Os campos mostrados vêm só da leitura conferida, nunca do índice. - Regra do avatar:
profile.read,diary.peek,peek.readenotices.listtrazemavatarquando há foto; o círculo mostra a foto (cover) por cima das iniciais, e sem foto, ou no app com configuração manual, só as iniciais, nunca caracteres da chave. O diário próprio (Diário) usa a mesma regra, com avatar de 88 pt, e o cache de nomes guarda oavatarjunto do nome. Uma aba com pacote antigo não mostra o nome de quem tem foto até recarregar. - Quem não tem nome nem @nome aparece como "sem nome", com um glifo de pessoa neutro no avatar. Uma marca de resposta mostra "…" até o autor ser consultado (e, para quem a pessoa não segue, até a publicação respondida chegar) e só então o nome, o @nome ou "sem nome". Para quem não é seguido, o nome vem da publicação respondida, lida com
diary.peeke conferida pelo nó, e não deprofile.read. - Depois de uma reconexão ou da troca de identidade, as chaves já conhecidas (até 500, a própria sempre) são pedidas de novo.
- Um
varanda-serveou um nó antigo, semprofile.read, responde "método desconhecido": o app mostra "sem nome" em todo lugar e não repete o pedido.
Uma chave nunca aparece como texto fora de Ajustes › Avançado › Identidade técnica (atrás de "mostrar chave") e da etapa do certificado, onde a associação precisa dela, com uma exceção: o link /m/<chave> do próprio perfil é copiado e compartilhado, mas não impresso, salvo no campo selecionado quando a cópia falha. O link do perfil usa o @nome verificado, resolvido pelo serviço de contas na mesma origem (uma checagem de consistência, não uma assinatura). Todo nome, como todo texto de outros pares, passa por displayText.
Conversa é o fio de uma publicação (a publicação e as respostas). Conversas é a aba. São coisas diferentes.
Onde ficam as telas, incluindo a Espiadinha:
| Tela de antes | Onde fica |
|---|---|
| A Rua | aba A Rua |
| Espiadinha | aba Espiadinha |
| Conversas | aba Conversas (id interno comunidades, ícone de mensagem conversas; no nó hospedado: site e app instalado). Lista única; Pedidos de mensagem e Comunidades são telas empilhadas, e Nova conversa é uma folha. Mensagem, Grupo, Novo grupo, administração e Comunidade abrem por cima das abas |
| Feira | aba Feira (no nó hospedado: site e app instalado). Anúncio e Anunciar abrem por cima das abas |
| Seguindo | lista aberta por "N seguindo" no Diário |
| Avisos | o sino no canto direito da barra do topo (e na faixa do Diário), com um ponto quando há novidade |
| Busca | aba Busca (lupa): Contas e Publicações |
| Diário | aba Diário (o perfil em cima, as publicações embaixo; o botão "Compartilhar" abre a folha de compartilhar do sistema, onde ele existe, ou a folha com "compartilhar" e "copiar link" o perfil) |
| Perfil | Diário › Editar perfil |
| Publicar | botão "publicar" (folha); "responder" e "citar" em qualquer publicação |
| Sincronizar | Ajustes › Avançado › Sincronização, só o estado |
| Conexão | Ajustes › Avançado › Conexão (no app nativo, também a tela Conectar quando a configuração da instalação não carrega) |
| Identidade | Ajustes › Conta e @nome e Ajustes › Avançado › Identidade técnica (na primeira configuração, a etapa Identidade) |
Conversa, Curtidas e republicações, Membro e Seguindo abrem por cima das abas, numa pilha de telas (src/nav.js, até 20; abrir a mesma tela que já está no topo não faz nada); as abas continuam montadas embaixo e a barra de abas some enquanto há uma tela aberta. Cada abertura desliza da direita em 250 ms, e cada volta a tela desliza para a direita e sai; com movimento reduzido, a tela muda sem deslizar. Na borda esquerda (24 pt), um arrasto para a direita volta uma tela: passando de 35% da largura, ou num toque rápido, a volta se completa; senão a tela retorna. Um segundo Voltar durante o deslize é ignorado. Voltar: a seta da barra do topo, o botão Voltar do navegador (cada tela aberta é uma entrada do histórico, src/history.web.js; a seta do app também passa por history.back(), para o histórico e a pilha andarem juntos), Escape na web e o botão Voltar do Android. Uma folha aberta (Publicar, Denunciar, Ajustes) fecha primeiro. O próprio nome abre a aba Diário em vez de Membro. Bloquear, desbloquear ou recomeçar fecha as telas abertas. Na web hospedada, perfis têm link direto na própria origem da instalação, /@nome e /m/<chave> (64 hex): o app lê o caminho uma vez ao carregar, limpa a barra de endereço para / e abre Membro com "Seguir" (ou a aba Diário, se for o próprio link); quem está sem sessão vê o convite descrito em Entrar. Não há link para uma publicação.
Um pedido que muda algo e fica sem resposta (tempo esgotado ou conexão perdida) aparece como "incerto: pode ter sido aplicado; confira antes de repetir". O app nunca reenvia esse pedido sozinho. Antes de oferecer a ação de novo, ele lê o estado outra vez. Publicar relê o próprio diário: se a publicação está lá (mesmo texto e mesma resposta, criada por este envio), conta como publicada, limpa o rascunho e fecha a folha; senão o rascunho fica, com a mensagem "incerto: pode ter sido aplicado; confira antes de repetir". Editar perfil faz a mesma conferência no registro de perfil mais novo. Seguindo relê a lista depois de qualquer falha ao seguir ou deixar de seguir.
Só um nó usa um diretório de dados por vez: um segundo worklet no mesmo diretório recebe LOCKED. Na web com o nó no navegador, só uma aba por navegador abre o nó (veja "Na web, com o nó no navegador: Entrar"). Todo texto vindo de outros pares passa por displayText, do @varanda/rpc, antes de aparecer.
- As leituras de membro que abrem o armazenamento ainda interrompem a rodada contínua e o nó a reinicia (issue #66). Os lotes de nomes, o intervalo de 1 s, a janela de 5 s, a pílula no lugar da recarga automática e a regra de não recarregar a troca de aba em 60 s só reduzem o efeito. A leitura da Espiadinha (
peek.read) usa memória e não interrompe a sincronização; só a consulta inicial da chave própria pode interromper uma vez se ela ainda não estiver no cache. As linhas dela, como as de A Rua, leem o estado próprio de curtida e republicação (engagement.read) e, ao atualizar, a lista de seguidos (follow.list), que interrompem como as outras leituras. - A preferência por Wi-Fi não existe (issue #48): o app sincroniza sempre que está aberto e com rede, também com dados móveis. Na web, a sincronização automática para enquanto a aba está oculta (
sync.stoplibera a conexão com o semeador) e reinicia assim que ela volta a aparecer; a fila de saída também não envia enquanto a aba está oculta. Isso não muda o Web Lock: só uma aba por navegador pode abrir o nó. - Frescor na web hospedada: uma aba visível mantém a conexão com o semeador e vê em poucos segundos as publicações de outro aparelho; uma aba oculta só as vê quando volta a aparecer. A Espiadinha (a cada página) e os Avisos (a cada leitura) continuam abrindo uma conexão própria curta: não usam a conexão da sincronização, e cada uma ocupa por alguns segundos mais uma vaga externa do semeador. A preferência por Wi-Fi (#48) continua fora desta mudança.
- A Rua e Diário paginam para trás (
before); a Espiadinha continua por rodada comafter. Não há leitura incremental de novidades (since): dados novos pedem recarregar a primeira página. - Conversa e Membro completos só na web hospedada e no app instalado, com rede: o nó do app com configuração manual e o
varanda-servenão leem diários sob demanda ("leitura sob demanda só na versão web") e mostram o que está no aparelho, com uma nota. A leitura sob demanda depende da conexão viva com o semeador; o que vem de quem a pessoa não segue fica só na memória e nada é guardado. - Quem curtiu e quem republicou: só na web hospedada e no app instalado. A ordem, as omissões e o total são afirmações do semeador. A lista não tem botão de seguir. Uma curtida ou republicação recém-feita pode faltar até o semeador indexá-la e a lista ser atualizada.
- As contagens, a completude das listas e qual é o perfil ou @nome mais recente são afirmações do semeador; o conteúdo mostrado é sempre conferido pelo nó. O índice do semeador fica em memória, com limite: perto dele as listas avisam que algo pode faltar.
- Citar e curtir/republicar precisam de conexão na web com o nó no navegador (passam pela sincronização antes de escrever); citações nunca vão para a fila de saída. Não há contagem de visualizações. A contagem de seguidores existe só nos perfis e vem do semeador (veja Pessoas). O aviso do sistema existe só na versão web hospedada, em Ajustes, para os seis eventos do aviso no aparelho (seguir, resposta, citação, menção, curtida e republicação). Só um nível de citação aparece.
- Pesquisa por assunto (Espiadinha): só palavras inteiras (sem prefixo: "ceus" não encontra "ceu"); letras fora de a-z depois de tirar os acentos (outros alfabetos) não são pesquisáveis; limitada ao que este semeador indexou (índice em memória, com tetos; pode estar incompleto); sem "assuntos do momento"; e uma publicação ainda não pode ser apagada, então continua pesquisável até o diário sair do semeador.
- Espiadinha: só na web hospedada e no app instalado, sem cidade ou estado. O custo cresce com o número de diários: inventário incompleto após 5 s, prazo de página de 25 s ou orçamento de 16 MiB deixam a lista incompleta. São 16 diários em paralelo, um bloco por vez em cada um (até 10 s por pedido), conexão com prazo de 15 s, blocos de até 16 KiB e no máximo 64 blocos examinados por diário; registros que não são publicações podem esconder publicações mais antigas atrás desse teto. A ordem de busca é aleatória por retrato da lista. A janela parte do comprimento assinado que Hypercore verificou com o bloco 0; janelas posteriores só aceitam o mesmo comprimento e
treeHash, e uma mudança interrompe aquele diário e marca a página incompleta. Os núcleos em memória usam páginas de 64 KiB; o orçamento dos registros retidos é de 32 MiB. O nó descarta o retrato após 5 minutos mesmo ocioso; a interface pode manter as linhas até atualizar ou recarregar. Cada página que precisa buscar blocos usa uma conexão curta extra (nenhuma se a continuação já está toda em memória), contra as 32 vagas externas do semeador; cada membro hospedado já usa uma para sincronizar. Com as vagas ocupadas, a pessoa precisa tentar de novo. Só uma leitura da Espiadinha roda por vez; desconectar libera essa vaga imediatamente. - Busca de pessoas: só na web hospedada e no app instalado, com rede; casa começo de palavras do nome ou do @nome, no máximo 20 resultados e sem "mostrar mais"; nomes em outros alfabetos só aparecem pelo @nome; não há opção de sair da busca nesta versão e não há busca de assuntos do momento. Ordem, omissões e completude são afirmações do semeador (que pode apontar para um nome antigo e autêntico); quem é bloqueado com a busca aberta pode ficar nas linhas já mostradas até a próxima busca. Detalhes em verification.md, seção 22.
- Avisos (a lista no app): só na web hospedada e no app instalado, sem aviso do sistema neste. App com configuração manual,
varanda-servee CLI estão fora (mostram "Avisos indisponíveis", com "Disponível no site da associação ou no app ligado à instalação.") e continuam só com essa lista, sem aviso do sistema. Sem contagem nem lista de seguidores dentro de Avisos (ficam nos perfis). A lista em si não usa push e não tem rota HTTP. Na versão web hospedada, Ajustes tem "Avisos no aparelho": a pessoa liga, só neste navegador, um aviso do sistema com uma de seis frases (começou a seguir, respondeu ao seu post, citou seu post, mencionou você, curtiu seu post, republicou seu post). O service worker e o app só aceitam citação e menção quando orefé a publicação de quem agiu (actor:seq); um toque abre essa publicação. Uma menção cujo @nome o índice do semeador ainda não resolveu naquele instante espera na memória do semeador e gera um push só se o nome for resolvido em até 24 h (some se o semeador reiniciar); o aviso na lista aparece de qualquer jeito. Desfazer um seguir, uma curtida ou uma republicação feitos há até 5 minutos recolhe o push que ainda esperava na fila do serviço; um que já saiu, ou um desfeito depois disso, não volta atrás. No iPhone e no iPad os avisos só funcionam com o Varanda na Tela de Início (iOS 16.4 ou mais novo). O app lê o estado ao abrir Ajustes, para o toque em ligar ser o primeiroawait(pushManager.subscribe()). Sem a chave do serviço, o interruptor não aparece. "Sair" desliga os avisos deste navegador. O semeador guarda o índice só em memória, com tetos de 4096 seguidos por autor e 262144 entradas no total (acima disso a lista fica incompleta; chaves seguidas que não são membros contam no máximo 64 por autor e não deixam a lista incompleta), e pode esconder um aviso ou um "deixou de seguir" fora da cauda verificada; cada leitura usa uma conexão curta extra contra as 32 vagas externas, com prazo de 25 s e orçamento de 16 MiB (protocol.md, "Notices link"). Um seguidor que o semeador ainda está lendo pode demorar a aparecer. Respostas, citações e menções: um índice próprio em memória no semeador, com tetos de 32 por autor e destino, 1024 por autor, 262144 no total e 64 destinos ainda sem dono por autor, até 8 @nomes por publicação, 64 nomes antigos verificados por membro; passando do teto de um autor o semeador esquece só os avisos antigos dele. Um @nome encostado em um caractere fora da lista de separadores (uma letra, número ou marca de qualquer alfabeto) não vira link nem aviso: o app prefere perder um link a avisar a pessoa errada. Um semeador que só abrevaranda/notices/1só envia os avisos de seguir (a linha calma deactivity: false). Um semeador comvaranda/notices/2e semvaranda/notices/3mantém seguir, resposta, citação e menção, sem as linhas de curtida e de republicação. Curtidas e republicações vêm do índice de engajamento (noticeRows): no máximo 64 linhas por pessoa e 4096 no total, e o que passa do teto esquece as linhas mais antigas, sem contagem. Publicações com data mais de 24 h à frente ficam escondidas até a hora chegar. O @nome de uma publicação só vale como aviso para quem o tem no diário assinado; o link do @nome precisa do serviço de conta e de conexão. - Fotos, GIFs e vídeos curtos, pela web hospedada e pelo app instalado, ainda sem a comparação com listas de hashes de material ilegal prometida em design.md; o navegador só aceita um arquivo de vídeo que já cabe; um núcleo de fotos por aparelho, sem troca quando enche; apps, CLIs e semeadores antigos pulam a publicação com fotos ou com vídeo inteira. Detalhes em verification.md, seções 16, 181 e 183.
Mensagens privadas entre duas pessoas, só texto, cifradas de ponta a ponta. Existem no nó hospedado, no site e no app instalado com a instalação. O protocolo está na seção 11 de protocol.md; os métodos, em rpc.md, 5.73 a 5.81 (dm.enable, dm.lookup, dm.send, dm.pull, dm.list, dm.thread, dm.set, dm.seen, dm.reportSign). Todo texto vindo de outra pessoa passa por displayText.
No nó hospedado, a aba Conversas fica logo depois da Espiadinha, com o ícone de mensagem (conversas, o glifo message-square). O id interno da aba não muda: continua comunidades. A tela é uma lista só, com as conversas privadas e os grupos das comunidades da pessoa, do mais recente para o mais antigo. Não há mais seletor entre Mensagens e Comunidades: os grupos ficam na mesma lista, e Comunidades abre como tela própria (veja "Comunidades"). A cadeira da abertura (Splash.js, assets/cadeira.png), a cadeira da barra do topo (TopBar.js) e o ícone cadeira do estado vazio dentro de Comunidades continuam os mesmos. O ícone novo é só o da aba.
- Cabeçalho: + abre Nova conversa, o ⓘ abre "Como funcionam as Conversas" (
HELP.conversas) e o sino abre Avisos. - Busca: o campo arredondado Buscar conversas, logo acima dos filtros, filtra as linhas já carregadas; o X limpa. Com texto na busca, os fixados somem, e o filtro escolhido continua valendo.
- Filtros: Todas, Não lidas e Grupos.
- Pedidos · Comunidades: uma faixa no topo da lista, logo abaixo dos filtros, com dois alvos de 44 pt. Pedidos (o leitor de tela diz "Pedidos de mensagem") tem um ponto quando há pedido ainda não aberto (nunca uma contagem; em Não lidas, só aparece com pedido não lido), e Comunidades não tem ponto nem seta. A faixa some durante a busca.
- Linhas: avatar (pessoa redonda; grupo e comunidade em quadrado arredondado de cor, com as iniciais), nome, uma linha de prévia, hora relativa e, na cor de destaque, um ponto (conversa privada ou grupo). A prévia põe Você: à parte quando a última mensagem é da própria pessoa; num grupo, ela é "Autor: texto". Não há marcas de lido, de entrega nem de digitação.
- A lista segue a recência (
dm.list, da mais nova para a mais antiga; no empate, a chave da outra pessoa em ordem crescente). Quem a pessoa segue, uma conversa já aceita ou uma conversa em que ela mesma escreveu fica na lista. Qualquer outra pessoa cai em Pedidos de mensagem. - A aba também leva um ponto, nunca um número (
requestseunreadsão booleanos). - Carga parcial: quando parte das conversas não carregou, a lista diz "Algumas conversas ainda não carregaram." com Tentar de novo. Isso é diferente do vazio "Nenhuma conversa ainda".
- Carregando e vazio. Enquanto a lista carrega, aparecem linhas de esqueleto, nunca o vazio. Sem linhas, cada filtro tem o seu estado vazio com uma ação, e a busca sem resultado tem o seu; Nova conversa só aparece onde dá para escrever. As linhas dão retorno ao toque, alinham a hora à direita e têm um só nome para o leitor de tela (nome, prévia, hora e quantas novas); um par cujo nome é "Você" não é lido como a sua própria linha. Em Mensagens, a lista que carregou bem não oferece tentar de novo.
- Notificação: tocar numa notificação volta para a lista inteira, com o filtro Todas e a busca limpa.
O + abre a folha Nova conversa, que busca uma pessoa pelo nome. Novo grupo abre Comunidades, porque um grupo sempre fica numa comunidade. Nova comunidade cria uma comunidade. Com a busca vazia, Conversas recentes mostra até 8 pessoas da caixa.
Tela empilhada: entra deslizando e volta pela borda ou pelo Voltar. Tem linhas compactas, e tocar numa abre a conversa, onde ficam Aceitar, Recusar e Bloquear. Uma nota no topo diz "Até você aceitar, quem enviou não sabe se você leu".
- Aceitar move o pedido para a lista (
dm.setcomaccepted). Recusar esconde as mensagens deste pedido (declined); uma mensagem posterior da mesma pessoa abre um pedido novo. Aceitar e recusar não avisam a outra pessoa.
- Cabeçalho. A barra mostra o avatar, o nome e o @nome da pessoa; tocar neles abre o perfil. Um só ícone, opções da conversa, reúne bloquear, apagar e denunciar a conversa.
- Balões. As suas mensagens ficam à direita, na cor de destaque suave, e as da outra pessoa à esquerda, sobre a cor de cartão. Os balões não têm cauda; só a última mensagem de cada sequência mostra a hora, dentro do balão, embaixo à direita, e os marcadores de dia são texto suave e centralizado. "Enviada" aparece só enquanto um envio está retido ou incerto.
- Ações. Tocar longo numa mensagem abre Responder, Encaminhar, Copiar e Denunciar. Na web, com mouse ou teclado, uma seta pequena no canto do balão abre as mesmas ações. Não há botão ⋯ em cada linha.
- Deslizar para responder. Arrastar uma mensagem para a direita responde: a bolha acompanha o dedo, o ícone de resposta aparece e, a partir de cerca de 56 pt, soltar cita a mensagem na barra de resposta. Só vale com toque (o mouse seleciona o texto; quem usa mouse responde pelas ações), e só quando o deslize começa a mais de 24 pt da borda esquerda, para o gesto de voltar do sistema continuar valendo. Um movimento quase vertical rola a lista. Com Reduzir movimento a bolha fica parada e só o ícone aparece (
ui/SwipeReply.js,chatGestures.js). Tocar na barra "Respondendo a" rola até a mensagem citada, ou mostra "Mensagem fora do trecho carregado" quando ela está fora do trecho. - Ir para o fim. Com a pessoa a mais de uma tela e meia do fim, o botão ir para o fim aparece (36 pt, com área de toque maior) e, quando chegam mensagens, mostra um ponto de não lidas; a contagem fica na dica do leitor de tela. Uma chegada com a pessoa lendo mensagens antigas não move a lista; enviar a sua própria volta ao fim (
ui/JumpToEnd.js). - Citação. Tocar numa citação rola até a mensagem original e a destaca por um instante; se ela não está no trecho carregado, nada rola e aparece "Mensagem fora do trecho carregado", também anunciada ao leitor de tela.
- Sugestões. Uma conversa vazia mostra os chips Oi e Tudo bem?. Tocar num só preenche o campo (numa nova linha, se já há texto) e nunca envia.
- Encaminhar. A folha lista as conversas e os grupos recentes, e a mensagem vai a até 5 deles, em ordem, cada um com o seu estado (Na fila, Enviando…, Encaminhada, "Não deu para confirmar o envio." ou "Não foi enviada."). Um envio sem confirmação mostra Tentar de novo, que só reenvia com um toque; o app não reenvia sozinho. Fotos, GIFs e mensagens de voz são enviados de novo para o destino, cifrados quando o destino é mensagem direta ou grupo privado, para que o destino nunca leia o arquivo do original. Mídia que já não existe no aparelho nem na origem sai com "A mídia expirou", e o texto segue. Mídia privada enviada a um grupo público pede confirmação antes. A linha "Encaminhada" é afirmada só por quem encaminha, sem o nome do autor original, e não prova de onde o conteúdo veio: a marca (o campo
fwd) é posta pelo remetente. A relação de resposta do original não é mantida, e uma Página não oferece Encaminhar. Os Termos não mudam. Conferência manual: verification.md, seção 114. - Resposta. A citação mostra "Você" ou o nome de quem escreveu a mensagem citada, e nenhum nome enquanto a mensagem citada não está carregada.
- Campo de escrever. Campo arredondado com botão de emoji, sugestões de @ (só na conta hospedada e online) e botão de enviar redondo, que só aparece com texto. Com uma resposta em andamento, uma barra mostra a mensagem citada e Cancelar. A caixa fica acima da área inferior do celular.
- Formatação. O texto de uma mensagem pode ter
*negrito*(também**),_itálico_(também__),~riscado~,`código`,||spoiler||e blocos de código (uma linha de três ou mais crases, com a linguagem depois delas se houver, fechada por uma linha só de crases do mesmo tamanho). Os marcadores só abrem e fecham na borda de uma palavra, então2*3*4esnake_caseficam literais. Os marcadores viajam como texto simples: um build mais antigo mostra os marcadores crus. Links e @menções mantêm o destino exato, e texto simples nunca vira link. Uma mensagem com caractere de controle invisível mostra o texto sem estilos (os spoilers continuam cobertos). A formatação vale só nas conversas, não em publicações, legendas nem anúncios. - Bloco de código. Uma caixa com o nome da linguagem, Copiar código (depois "Copiado" ou "Não deu para copiar" por 2 s), rolagem na horizontal e, passando de 12 linhas, o botão ver tudo. Pressionar e segurar no bloco ainda abre as ações da mensagem. Uma mensagem desenha no máximo 8 blocos de código (
CODE_MAX); do nono em diante o resto da mensagem aparece como texto simples, coberto a partir do primeiro||, também nas prévias, na citação e na barra de resposta. - Spoiler. O trecho fica coberto; um toque mostra todos os spoilers daquela mensagem. O rótulo para leitor de tela é "spoiler, toque para mostrar" (no iOS o VoiceOver pode ler só a palavra "spoiler", por desenho). O cartão de prévia de um link não é desenhado quando o link só aparece dentro de um spoiler. Quem envia não monta esse cartão, num grupo (seção 195) nem numa conversa direta (seção 196).
- Botão Aa. No campo de escrever, o botão "Aa" (rótulo "formatação") abre uma fileira com Negrito, Itálico, Riscado, Código, Bloco de código e Spoiler, e a dica "Você também pode digitar negrito, itálico e
código". Um botão envolve a seleção (uma seleção no meio de uma palavra cresce até a palavra toda); tocar de novo numa seleção já envolvida tira os marcadores; Bloco de código envolve a seleção numa cerca. Texto colado com TAB ou CR é limpo, porque os registros os recusam. - Reações nas conversas diretas. Em Mensagem, cada pessoa reage a uma mensagem com um emoji (uma por pessoa, trocar ou tirar vale). As reações aparecem como fichas no canto de baixo do balão, com o emoji e a contagem (1 ou 2), e a sua vem marcada; não há "Quem reagiu", porque são só duas pessoas. No alto das ações da mensagem ficam as reações rápidas e um "+" que abre o seletor. Toques seguidos esperam 600 ms e só a última escolha é enviada (voltar à escolha inicial não envia nada). Cada reação, troca ou remoção gasta dois selos do limite diário, como uma mensagem, e nunca muda o não lido, a prévia da lista nem a ordem. A reação vale só para a mensagem em que foi feita, e só mensagens recebidas a partir desta versão aceitam reação. Uma recusa desfaz a ficha e mostra o texto do nó; uma resposta sem confirmação mantém a ficha com "Não deu para confirmar a reação." e nunca reenvia sozinha. Agindo como Página, ou numa conversa com uma Página, as fichas não aparecem; offline, trancado, com a pessoa bloqueada, em Pedidos e enquanto a consulta que confirma que a outra conta é uma pessoa não respondeu, as fichas ficam visíveis e desligadas. Um app antigo não mostra a reação nem conta nada. Conferência manual: verification.md, seção 196.
- Reações nos grupos. Em grupos públicos e privados, cada pessoa reage a uma mensagem com um emoji (uma por pessoa, trocar ou tirar vale; no máximo 12 emojis diferentes por mensagem). As reações aparecem como fichas no canto de baixo do balão, com o emoji e a contagem, e a ficha de quem é você vem marcada; tocar na sua tira a sua reação, e tocar na ficha de outro emoji passa a sua reação para ele. No alto das ações da mensagem ficam as reações rápidas e um "+" que abre o seletor de emojis. Um toque longo numa ficha, ou "Ver quem reagiu" nas ações, abre "Quem reagiu", com todos os nomes que vieram (a folha rola; "e mais N" só quando a contagem passa da lista). Offline, com o grupo trancado, com a chave pendente ou agindo como Página, as fichas continuam visíveis e desligadas; uma reação que falha some, mostra a recusa e a lista é lida de novo, sem reenviar. Uma mensagem oculta não tem fichas. Nas citações (grupos e mensagens diretas), a mensagem citada vira uma linha de texto simples, cortada em 90 pontos de código. Um link dentro de um spoiler não monta cartão de prévia no envio em grupo. Conferência manual: verification.md, seção 195.
- Prévias em texto simples. As linhas das caixas (Conversas, Mensagens), a última linha da lista de grupos, a citação de uma resposta, a barra de resposta, as prévias de encaminhar e as linhas de comunidade mostram o texto sem os marcadores, com cada spoiler trocado pela palavra "spoiler". A citação e a barra de resposta recebem o texto já limpo para a tela, em que um caractere de controle invisível vira U+FFFD; um U+FFFD conta como esse caractere, então elas cobrem o mesmo trecho que a bolha. A prévia de 140 pontos de código ou mais pode ter sido cortada pelo nó, então nada depois do primeiro
||aparece nela: a linha mostra o texto até ali e a palavra "spoiler", mesmo quando esse||é código (a || b). Conferência manual: verification.md, seção 194. - Menções. Um @nome tocado abre o perfil da pessoa. Nas conversas privadas, nos grupos e em Publicar, as sugestões de @ (a partir de 2 letras) listam pessoas e Páginas juntas; uma Página tem o chip "Página", e pessoas vêm antes quando os dois casam igualmente. Páginas encerradas ou movidas não são sugeridas, e escolher uma sugestão só escreve o @nome. Num grupo, um @nome tocado numa bolha abre o perfil da pessoa ou o diário da Página, como nas conversas privadas. Menções em conversas não criam tipo novo de aviso.
- Não há confirmação de leitura, nem aviso de entrega, nem indicador de digitação.
dm.seenapaga o ponto neste aparelho e não manda nada à outra pessoa nem ao semeador. Os outros aparelhos da mesma passkey recebem a marca só pelo bloco cifrado de vistos (veja Avisos, "Visto em todos os aparelhos"). - Responder (
dm.sendcomreplyTo) cita uma mensagem desta conversa. - Apagar conversa (
deleted) tira a conversa deste aparelho e, peloctllacrado só para a própria caixa, dos outros aparelhos da mesma pessoa. A outra pessoa fica com a cópia dela. O semeador não apaga sob pedido: só a retenção de 14 dias. As fotos guardadas da conversa saem da memória do aparelho na hora; o texto, na primeira vez que o app roda depois de 15 dias (o prazo do semeador mais um dia; a faxina só roda com o app aberto;docs/protocol.md, seção 11, "Local storage"). - Bloquear mensagens (
blocked) faz a mensagem seguinte dessa conta não aparecer. Um envio para ela responde "você bloqueou esta pessoa"; a tela mostra "Você bloqueou esta pessoa". - Denunciar (
dm.reportSign, declaraçãovaranda-dm-report-v1) manda só a mensagem escolhida, em claro, e a conta de quem enviou (a chave do diário, no campotarget), para a moderação poder bloquear a conta. Não manda o resto da conversa nem a assinatura de quem enviou. A folha diz "Só esta mensagem e a conta de quem enviou vão para a moderação. Nada mais da conversa." No painel, a citação sai com o rótulo "Texto não conferido": a assinatura prova o que quem denunciou afirmou, não que a outra pessoa escreveu aquilo. - Abrir convite. Uma mensagem com um link de convite desta instalação (
/c/ou/g/da mesma origem) mostra o botão Abrir convite, que abre a comunidade (ou o grupo, pela comunidade dele) no cartão de convite de um toque. Abrir nunca coloca ninguém: Entrar ou Pedir entrada continuam sendo o toque da pessoa. Links de outros endereços não mostram o botão. - Links. Um link
http://,https://ouwww.na mensagem fica sublinhado e abre direto, como nas publicações (veja "Linha de publicação");@nomesegue como texto. A citação de uma resposta não tem link. Uma mensagem com o botão Abrir convite fica toda sem link e sem formatação, com todas as linhas dos blocos de código e cada spoiler trocado pela palavra "spoiler", e o cartão de prévia de um link dentro de um spoiler não aparece: o botão é o caminho dentro do app, e o mesmo endereço não abre também o navegador. Um link de convite que só aparece dentro de um spoiler não mostra o botão: a mensagem fica como as outras, com o spoiler coberto até o toque. - Prévias de links. Um link colado no campo de escrever das conversas, dos grupos e de Publicar ganha um cartão de prévia (título, imagem pequena de 64 pt e o endereço, sem descrição), montado uma só vez por quem envia: no app nativo pelo próprio aparelho, na web hospedada pelo serviço de conta da associação, que lê a página do próprio endereço e não guarda nada. No rascunho, o cartão tem um X para descartar; anexar uma foto tira o cartão; se a página não responde ou não tem dados, a mensagem segue só com o texto e o link (em Publicar, um link reconhecido de YouTube, SoundCloud, Spotify ou Apple Music ainda ganha um cartão com o nome do provedor e sem imagem, veja "Música em publicações"; nas conversas e nos grupos, só um vídeo do YouTube ganha esse cartão, com a miniatura do vídeo e, com ela, o player). No celular, um link que redireciona (um encurtador, por exemplo) fica sem prévia, porque o aparelho não segue redirecionamentos, e a imagem só vem do mesmo site da página ou, num link de YouTube, SoundCloud, Spotify ou Apple Music, dos domínios de imagem do próprio provedor (uma imagem servida de outro domínio fica de fora); na web, o serviço segue até 3 redirecionamentos, conferindo cada endereço. O cartão vai dentro da mensagem ou da publicação, e quem recebe vê só os dados guardados nela, sem buscar nada no site, exceto num cartão de YouTube, SoundCloud, Spotify ou Apple Music, cujo player carrega quando o cartão fica visível (veja "Música em publicações"); tocar no cartão abre o link, mas um toque na capa de um player de música não faz nada. A chave Prévia de links em Ajustes desliga a montagem (os cartões recebidos continuam aparecendo). Termos versão 24. Conferência manual: verification.md, seção 117.
- No perfil (Membro), o ícone Mensagem (sem rótulo visível; o nome "Mensagem" é para o leitor de tela) abre a conversa com essa pessoa.
- Só no nó hospedado. Na configuração manual e no
varanda-servea barra tem quatro abas, sem Conversas nem Feira. Os métodosdm.*respondem "mensagens diretas disponíveis só no navegador", edm.reportSignresponde "assinatura disponível só no navegador". - O conjunto do semeador dura 14 dias (
DM_RETENTION_MS). Um aparelho offline por mais tempo perde o que a varredura já tirou. - O nó acha o
dm-keyda outra pessoa na réplica local ou, sem réplica, varrendo a parte mais nova do diário (dm.lookup: no máximoDM_LOOKUP_WINDOWS= 8 janelas dePEEK_WINDOW= 36 blocos, da mais nova para a mais antiga, além do bloco 1). Umdm-keymuito antigo, num diário longo, pode ficar de fora até essa pessoa abrir o app de novo. O app publica odm-keyde cada membro uma vez por sessão destravada, sem precisar abrir Conversas. Enquanto a outra pessoa não tem chave, a conversa mostra "Esta pessoa ainda não recebe mensagens" e um botão "verificar de novo", em vez do campo de escrever. - Há uma chave de caixa por identidade. A troca de geração publica um
dm-keycomgenmaior. Envelopes ainda no conjunto, lacrados para a geração antiga, não são abertos. - O primeiro envio logo depois de ligar pode responder "o limite de envio de hoje acabou" até a primeira recarga de selos terminar. Os selos são RSA cegos,
DM_STAMPS_PER_DAY= 200 por membro e por dia de Brasília. A carteira (DM_STAMP_WALLET= 20, recarregada abaixo deDM_STAMP_WALLET_LOW= 10) enche durante a sincronização. - No app instalado não há aviso do sistema: a novidade aparece com o app aberto, pelo
dm.pullao voltar para o primeiro plano, ao puxar para atualizar e a cada 5 minutos com o app visível, e pelo ponto. Na web hospedada, com os avisos no aparelho ligados, o aviso diz só "Pode haver uma mensagem nova na Varanda", sem nome e sem texto, no máximo um a cada 15 minutos (dm-wake). O aviso não fica na tela do aparelho que acabou de enviar uma mensagem ou mexer em pasta (por 120 s, inclusive com as gravações pendentes que sobem ao destravar e os envios da página), e não fica na tela de aparelho nenhum enquanto uma janela da Varanda estiver visível e em foco: essa janela recarrega as Conversas no lugar. Nesses casos o aviso é mostrado em silêncio e fechado na hora, nunca deixado sem mostrar, porque o Safari revoga a assinatura de um push sem aviso. Como o aviso não diz quem escreveu, um aviso de outra pessoa que chegue nesses 120 s também some; um aviso entregue depois (até um dia) aparece. Os outros aparelhos da mesma pessoa podem receber o aviso normalmente. Duas limitações conhecidas: uma pasta mexida com o aparelho travado pode ser enviada antes de a página estar pronta para receber o evento, então esse aviso ainda pode aparecer no aparelho que enviou; e um aviso que chega muito rápido, antes do marcador de envio, também pode aparecer (docs/verification.md§112 registra se isso acontece). Como o serviço manda no máximo um aviso a cada 15 minutos para todo mundo, uma resposta que chegue nesse intervalo depois de um envio próprio não gera aviso e aparece no próximodm.pull, como já acontecia. Com a janela em foco e a identidade travada, a releitura espera o destravar. - A cópia neste aparelho fica lacrada com
crypto_secretboxsob uma chave derivada da passkey (DM_LOCAL_HKDF_SALT,DM_LOCAL_HKDF_INFO).
As Comunidades reúnem conversas em grupo, só de texto. Uma Comunidade contém Grupos, públicos ou privados, sob a mesma moderação, e toda comunidade nasce com o grupo Geral. Não há grupo fora de uma comunidade. Elas existem no nó hospedado, no site e no app instalado com a instalação. As regras de moderação e de retenção estão em design.md ("Grupos públicos" e "Grupos privados"); o protocolo, na seção 10 de protocol.md.
No nó hospedado (site e app instalado), Comunidades é uma tela empilhada que abre a partir de Conversas e volta para a lista, não uma aba própria. A tela tem Minhas comunidades (as que a pessoa criou ou em que entrou, cada uma com o nome, o papel e o avatar quadrado), o + da barra do topo (Nova comunidade) e Buscar grupos públicos (grupos privados nunca aparecem). Não há campo para colar link: quem participa manda o link pelo Compartilhar da comunidade, e quem recebe toca nele. Tocar numa comunidade a abre. A lista é lida de novo ao puxar a tela e quando algo muda. Se o nó não responde aos métodos novos, a lista mostra o erro de carregamento em vez de esconder a entrada. O ponto da aba Conversas não mudou: ele aparece quando algum grupo seguido mudou desde que a aba, ou o grupo, esteve na frente.
- Nova comunidade. Folha com o nome e a entrada aberta ou com aprovação. Criar a comunidade cria também o Geral.
A tela da comunidade é a lista dos seus grupos. A barra do topo mostra o avatar, o nome e, embaixo, só o número de membros ("N membros"), e tem ícones de compartilhar e de informações. O ícone de informações abre Informações da comunidade (veja a seção seguinte), também enquanto a comunidade ainda chega a este aparelho. Entrar, o cartão de convite e a lista de grupos ficam aqui; o resto da administração fica em Informações.
- Cartão de convite. Quem ainda não participa vê um cartão com o nome, a entrada, o número de membros e, quando a comunidade já está neste aparelho, os administradores, com um só botão: Entrar ou Pedir entrada, e a frase "Participar é público: sua entrada fica registrada no seu diário.". Abrir um link nunca coloca ninguém na comunidade: só o toque grava a entrada no diário. Quando o aparelho ainda não tem nada da comunidade, o cartão vem do índice do semeador e, quando a resposta da entrada é pendente, mostra "Enviado. Aguardando a comunidade chegar a este aparelho.". Depois de sair, a nota de entrada antiga some. Quem já participa não vê o cartão.
- Entrar e Pedir entrada. Numa comunidade aberta o botão é Entrar; numa com aprovação, Pedir entrada. Entrar na comunidade leva aos grupos dela.
- Grupos. Lista com o Geral primeiro, marcado como grupo principal; cada linha mostra o nome atual do grupo, mesmo que o Geral tenha sido renomeado. Novo grupo só aparece para quem criou a comunidade, e só no aparelho que a criou. Quando quem criou voltou depois de sair (
repairemcommunity.info), cada grupo, menos o Geral, mostra Tirar da lista, com a confirmação "Tirar este grupo da lista da comunidade? Ele deixa de aparecer aqui e ninguém mais escreve nele." (chamacommunity.removeGroup). Comrepairligado e algum grupo tirado (dropped), a tela mostra a seção Tirados da lista: cada grupo aparece pelo nome (lido emgroup.infoquando a raiz está no aparelho; senão, "Grupo tirado da lista", nunca a chave) e tem Devolver à lista, com a confirmação "Devolver este grupo à lista da comunidade?" (chamacommunity.removeGroupcomundo). - Última mensagem e não lidas. Cada linha mostra quem escreveu por último e o texto, a hora e, quando há, um ponto na cor de destaque no lugar da contagem de mensagens não lidas (o leitor de tela continua lendo o número). A sua própria última mensagem mostra "Você:" em destaque, desenhado à parte do texto, para que o nome de um par nunca se passe por ele. Mensagem escondida aparece só como "mensagem escondida"; num grupo privado que este aparelho não consegue abrir, a linha não mostra texto cifrado. Abrir o grupo zera o ponto neste aparelho e, pelo bloco de vistos, nos outros aparelhos da mesma passkey (veja Avisos, "Visto em todos os aparelhos"); nada sai daqui para o grupo nem para as outras pessoas. Em todos os aparelhos, a contagem de um grupo segue a marca compartilhada: um grupo que outro aparelho leu por inteiro sai da contagem aqui também, e o ponto da aba (
comunidades) some quando nenhum grupo tem não lidas. O bloco guarda até 128 grupos; um grupo que sai dele pode voltar como não lido em outro aparelho. Voltar à lista relê as contagens, e elas continuam depois de recarregar o app (na web, a página). A marca de lido fica por aparelho, para no máximo 512 grupos; um grupo cuja marca foi descartada (a menos marcada recentemente) volta a contar como nunca lido. A primeira visita pode mostrar não lidas antigas até cada grupo ser aberto. Só a tela do grupo que está no topo marca como lido: um grupo coberto por outra tela continua sendo relido, mas não marca; quando volta ao topo, marca as mensagens mais novas sem recarregar. A lista é relida depois de cada tentativa de marcar (respondida ou não), quando volta ao topo e quando algum grupo listado muda. - Sem a comunidade neste aparelho. Enquanto o aparelho não tem a comunidade, a lista vem do índice do semeador: o cartão de convite, Compartilhar e os grupos, sem última mensagem nem não lidas.
- Em todos os aparelhos. Uma comunidade que a pessoa criou ou em que entrou por outro aparelho da mesma passkey aparece aqui depois da sincronização, e a leitura funciona. Enquanto os dados da conta ainda chegam, a comunidade aparece como "aguardando sincronização" e não oferece Entrar. Quando a pessoa já participa, mas este aparelho ainda não escreve, aparece o cartão Participar neste aparelho ("Sua conta já participa. Este aparelho costuma entrar sozinho depois da sincronização; se ainda não entrou, toque para participar por ele."). Um aparelho novo da mesma passkey entra sozinho, depois da sincronização, nas comunidades e nos grupos em que a conta já está. A entrada é um registro público e gasta uma das 8 vagas de escrita da conta por comunidade ou grupo; por isso o app deixa de entrar sozinho quando a conta já usa 6 das 8, e o cartão Participar neste aparelho continua para a pessoa decidir. Nessa reserva, o primeiro toque só mostra o aviso e um segundo toque participa. Com um nó que informa
frozenRoom(rpc.md 5.59), o aviso diz que desconectar um aparelho antigo em Ajustes, Aparelhos conectados, devolve a vaga, ou, quando a reserva de congelados acabou (frozenRoom0), que ali desconectar pode não devolver (um corte em 0 ainda libera a vaga enquanto a conta tem liberações); com um nó mais antigo, o aviso continua dizendo que a vaga não volta. Se a entrada for recusada com as 8 vagas em uso, o erro diz "Para liberar a vaga, desconecte um aparelho antigo em Ajustes, Aparelhos conectados." Depois do toque o cartão some até a leitura seguinte responder, para o mesmo aparelho não gastar duas vagas; se o toque ficar sem resposta, o app lê de novo e o cartão volta se ainda faltar o registro, sem repetir o pedido sozinho. Numa comunidade com aprovação, o aparelho novo espera um administrador aceitar, e os outros grupos entram depois disso. O app com configuração manual tem o próprio diário e não recebe as comunidades de outro aparelho. - Estados da lista. Esqueletos ao carregar, e as linhas dos grupos alinhadas às de Conversas, com remetente e hora lidos pelo leitor de tela. Sem grupos, um estado vazio. Na tela Comunidades, a busca mostra um só aviso por vez (ainda indexando, pode estar incompleta ou nenhum grupo achado) e, sem comunidades, o vazio explica o limite de grupos e oferece criar. Os nomes na caixa de comunidades têm retorno ao toque e quebram em até duas linhas.
Tocar no nome da comunidade ou no ícone de informações abre a tela de informações. O topo mostra o avatar, o nome e, quando a comunidade já chegou, uma linha com a entrada (aberta ou com aprovação), o número de membros, o de administradores e o seu papel. Enquanto a comunidade ainda chega, o título é "Comunidade ainda chegando", a linha some e a tela mostra só Compartilhar e a nota "Aguardando a sincronização desta comunidade.". Ações e linhas aparecem conforme o papel de quem olha, nesta ordem: Compartilhar, Sair ou Desistir, Concluir saída, Convidar, Membros e Pedidos (para quem modera), Quem pode convidar e Ajustes (para quem criou).
-
Compartilhar. Abre a folha de compartilhar do sistema ou copia o link
/c/<chave>e avisa "Link copiado"; o link nunca aparece como texto cru. Qualquer pessoa pode compartilhar. -
Sair e Desistir. Quem já pediu entrada vê Desistir do pedido no lugar de Sair, que retira o pedido (some da lista da administração). Sair da comunidade, ou ser banido, vale para todos os grupos dela. Reentrar não ressuscita a participação antiga. Quem criou a comunidade recebe, antes de sair, o aviso: "Você criou esta comunidade: depois de sair, não poderá mais nomear administradores nem criar grupos, mesmo que volte. Ao voltar, ainda poderá mudar o nome e a entrada, tirar grupos da lista e tirar o cargo de administradores."
-
Em outro aparelho da conta. Sair aparece só no aparelho que participa; um pedido feito neste aparelho continua com Desistir do pedido. Renomear, Entrada, Administradores e Quem pode convidar (de quem criou) só aparecem no aparelho que criou a comunidade, ou com
repairligado, porque aí a gravação não passa pela raiz; no segundo aparelho de quem criou, um aviso diz "Novo grupo, Ajustes e Quem pode convidar só funcionam no aparelho que criou a comunidade.". Pedidos e Membros só aparecem onde este aparelho tem o cargo, e nos outros um aviso explica. -
Concluir saída. Quando a saída de quem criou a comunidade foi interrompida antes de terminar (
leavePendingemcommunity.info), a tela mostra o botão Concluir saída. A confirmação diz que a saída foi interrompida e que concluir grava o que falta; confirmar chamacommunity.leave, e o botão some quando a saída termina. Concluir saída nunca força a saída. -
Sair mesmo assim. Quem criou a comunidade pode ouvir de Sair que ainda falta algo, e cada espera tem a própria confirmação:
- dados da comunidade ("este aparelho ainda não baixou tudo da comunidade: aguarde para sair"): "Este aparelho ainda não baixou tudo desta comunidade. Sair mesmo assim? O que ainda não chegou aqui não vai contar."
- outros aparelhos ("aguarde a sincronização dos seus aparelhos nesta comunidade para sair"): "Outro aparelho seu ainda não terminou de sincronizar esta comunidade. Sair mesmo assim? O que ele fez e ainda não chegou aqui pode deixar de valer."
- grupos ("aguarde a sincronização dos grupos da comunidade para sair"): "Alguns grupos desta comunidade ainda não chegaram a este aparelho. Sair mesmo assim? Nesses grupos, o que você fez como criador antes deixa de valer."
Sair mesmo assim chama
community.leavede novo comforceigual às esperas aceitas até ali mais esta. Se aparecer outra espera, a tela pergunta de novo; uma espera já aceita que se repete aparece como erro. -
Convidar. Quem criou a comunidade e os administradores veem a seção Convidar (os membros também, quando a regra é Membros podem convidar). A pessoa digita @nome, nome ou código, ou escolhe na busca, vê quem é e toca em Convidar. O app confere
dm.lookup: se a pessoa ainda não usa as Conversas, mostra "Essa pessoa ainda não usa as Conversas. Mande o link pelo Compartilhar."; se usa, manda uma mensagem privada (dm.send) com o texto "Convite para a comunidade X na Varanda: " e avisa "Convite enviado pelas Conversas.". A nota na tela diz "O convite chega como mensagem privada. A pessoa só entra se tocar em Entrar.". As Conversas escondem do semeador quem escreveu a quem (seção 11 de protocol.md), então o convite é privado; ele chega em Pedidos de mensagem quando a pessoa não segue quem convidou. Se o envio ficar incerto, a tela diz "Não deu para confirmar se o convite foi enviado. Tente de novo: a mensagem não se repete." e mostra Tentar de novo, que reenvia o mesmo texto (o nó nunca duplica a mensagem); nunca é automático. O convite não aprova a entrada, e os administradores não veem "convidado por". -
Quem pode convidar. Quem criou a comunidade e os administradores veem o bloco "Quem pode convidar", com Só administradores (o padrão) e Membros podem convidar; tocar na opção que não está marcada muda a regra (precisa de internet; se a resposta se perder, o app pede para conferir e nunca repete a mudança sozinho). Um convite só avisa a pessoa: quem recebe escolhe se entra. Esse ajuste decide quem vê o botão Convidar, acima.
-
Pedidos e Membros. Pedidos (aprovar ou recusar) e Membros (com banir e desbanir) aparecem para quem modera.
-
Ajustes. Nome, entrada (aberta ou com aprovação) e administradores. Nome e entrada continuam editáveis por quem criou, também depois de voltar (
community.meta): a criadora escolhe um administrador por @nome entre os membros. O @nome é conferido no serviço de conta e a tela mostra quem será adicionado antes de confirmar.
A tela de um grupo mostra, sob o cabeçalho, a linha da comunidade, a conversa, da mensagem mais antiga para a mais nova, com a mais nova embaixo, e a caixa para escrever. Puxar a tela para baixo atualiza a conversa. O texto das mensagens mantém as quebras de linha e tem os mesmos links sublinhados das publicações; uma mensagem oculta não tem link.
- Cabeçalho. A barra mostra o nome do grupo e "N membros", e um só ícone de ajustes do grupo, que não aparece quando a pessoa age como página. Abaixo do cabeçalho, uma linha pequena e tocável leva à comunidade. O painel da página aparece uma vez, sob o cabeçalho.
- Balões. Como nas conversas privadas: as suas à direita e as da outra pessoa à esquerda, sem cauda, e só a última mensagem de cada sequência mostra a hora, dentro do balão. Cada pessoa forma as suas sequências. Na primeira mensagem de uma sequência de outra pessoa aparece o nome, numa cor fixa para cada pessoa, e o avatar fica ao lado da última.
- Ações. Tocar longo abre Responder, Copiar, Esconder ou Mostrar, Banir e Denunciar, conforme as permissões de cada um. Responder não aparece quando a pessoa age como página.
- Respostas. Uma resposta real mostra a citação na nova bolha. Tocar na citação rola até a mensagem original, quando ela está carregada, e a resposta continua aparecendo depois de recarregar o app.
- Deslizar para responder, ir para o fim e sugestões. Valem como em Conversa (veja lá). Tocar numa citação não carregada, ou na barra "Respondendo a" quando a citada está fora do trecho, mostra "Mensagem fora do trecho carregado". Num nó sem hospedagem a tela diz "Comunidades indisponíveis" (decidido por
node.hosted). - Em todos os aparelhos. Um grupo que a pessoa criou ou em que entrou por outro aparelho da mesma passkey aparece aqui depois da sincronização, e a leitura funciona. Quando a pessoa já está no grupo, mas este aparelho ainda não escreve, a caixa de escrever dá lugar ao cartão Participar neste aparelho. Um aparelho novo da mesma passkey entra sozinho no grupo depois da sincronização, e o toque só é preciso se a conta já usa 6 das 8 vagas de escrita do grupo (a entrada é um registro público). Nessa reserva, o primeiro toque só mostra o aviso e um segundo toque participa; o aviso e a recusa com as 8 vagas em uso seguem
frozenRoom(rpc.md 5.42) como na comunidade. Se este aparelho ainda não escreve na comunidade, o toque primeiro faz este aparelho participar da comunidade. Depois que este aparelho já participa, se uma mensagem ainda não pode sair, a caixa avisa "Este aparelho ainda não pode escrever aqui. Aguarde a sincronização.". Numa comunidade com aprovação, o aparelho novo espera um administrador aceitar e a caixa avisa "Este aparelho precisa da aprovação de um administrador para escrever.". Num grupo privado, o aparelho que criou o grupo ou o de um administrador envia as chaves ao aparelho novo sozinho e o histórico abre sem toque; até lá, e a caixa responde "aguardando nova chave", também quando o aparelho já participa e só falta a chave. Depois do toque em Participar neste aparelho o cartão some até a leitura seguinte responder, e Sair do grupo só aparece no aparelho que participa. O app com configuração manual tem o próprio diário e não recebe as comunidades de outro aparelho. - Formatação. As mensagens do grupo (e das conversas de comunidade) têm a mesma formatação das conversas privadas: negrito, itálico, riscado, código, blocos de código com Copiar código e ver tudo, e spoiler, além do botão Aa no campo de escrever (veja "Conversa"). A última linha da lista de grupos mostra texto simples, com "spoiler" no lugar do segredo.
- Ocultar e banir aparecem conforme o papel de quem olha. A autora de uma mensagem e quem modera podem ocultá-la; o banimento é feito na comunidade e vale para todos os grupos dela. Ocultar tira a mensagem da conversa e não apaga as cópias que outros aparelhos já têm.
- Denunciar. Cada mensagem de outra pessoa que não está escondida tem "denunciar", que leva o grupo e a posição da mensagem; num grupo privado, a citação é o texto aberto neste aparelho.
- Quem ainda não entrou na comunidade (por exemplo, abriu um link
/g/) é levada primeiro à tela da comunidade, onde entra ou pede entrada; se ainda ficar no grupo, vê o que ele mostra a quem não é membro e, depois de uma entrada recusada por falta da comunidade, o botão Entrar na comunidade. Num grupo privado nunca vê mensagens. Quem pediu entrada vê "Aguardando aprovação" e quem foi banido vê o aviso de banimento. - Grupo sem comunidade. Um grupo cuja comunidade este aparelho ainda não conhece abre sem o selo. Se o nó o marca como sem comunidade, a caixa de escrever avisa que o grupo não pertence a nenhuma comunidade e nada é enviado.
- Mensagens anteriores carregam em páginas pelo botão "Mensagens anteriores" ou sozinhas quando a pessoa, depois de rolar, chega perto do topo (uma vez a cada aproximação). Depois de um erro, só o botão carrega; quando uma tentativa dá certo, o carregamento automático volta na próxima vez que a pessoa sair do topo e voltar.
- Grupo privado. As mensagens são cifradas e seguem a comunidade: quem sai ou é banido deixa de receber as novas. Quando há mensagens que este aparelho não consegue ler, a conversa mostra a contagem delas. Se o grupo aguarda uma nova chave, a caixa responde "aguardando nova chave" e nada é enviado até um administrador gerar a chave ou a chave chegar.
Novo grupo (aberto pela comunidade, só para quem a criou, no aparelho que a criou; administradores moderam, mas não criam grupos) pede o nome e a visibilidade pública ou privada; também oferece a Entrada (aberta ou com aprovação; um grupo privado sempre pede aprovação). Ajustes do grupo mostra no topo o avatar, o nome e "N membros" (só os membros ativos, sem os banidos), com Compartilhar (o convite) e Sair do grupo (quando sair é permitido) no cabeçalho. Nas linhas ficam Nome (só quem criou a comunidade), Pedidos, Membros (cada administrador aparece uma vez, com o selo "administrador"; "Tirar admin" fica na própria linha, só para quem criou a comunidade), Banidos e Gerar nova chave (em grupo privado); sair do Geral não tira a pessoa da comunidade. Escape fecha a folha sem sair da tela. Gerar nova chave abre uma nova época para as mensagens seguintes; o app nunca mostra a chave.
Quem pode convidar (Ajustes do grupo): o mesmo bloco, visível para quem criou o grupo e para os administradores, com Só administradores (o padrão) e Membros podem convidar. Um convite só avisa a pessoa, quem recebe escolhe se entra. Esse ajuste decide quem vê Convidar para o grupo, abaixo.
Convidar para o grupo (Ajustes do grupo): mesmo fluxo da comunidade, com o texto da forma de grupo ("Convite para o grupo G da comunidade X na Varanda: "), visível para quem pode convidar (criação, administradores e, com Membros podem convidar, os membros). A regra só controla o botão: qualquer pessoa ainda pode mandar o link pelo Compartilhar ou colá-lo numa mensagem.
Cada comunidade tem um link /c/<chave> e cada grupo, um link /g/<chave>, com a chave em hexadecimal. Abrir o link leva à comunidade (ou ao grupo) na web hospedada e, como varanda:///c/<chave> ou varanda:///g/<chave>, no app instalado, com as mesmas regras de entrada. Na web hospedada, o link /c/ ou /g/ tocado fica guardado na aba (sessionStorage, chave varanda-entry-link, por no máximo 1 h) para sobreviver à recarga do passo do Google. Enquanto a pessoa não entrou, a tela Entrar avisa "Você recebeu um convite para uma comunidade. Entre para ver e participar." (ou "...para um grupo...") com agora não, que descarta o link; num navegador embutido, avisa "Para participar, abra este link no Chrome ou no Safari." com copiar e compartilhar, sem desenhar o link como texto. O link é descartado logo antes de a tela abrir e quando a instalação muda, e recarregar depois de aberto não o reabre. Um cartão de convite de perfil pendente tem prioridade sobre ele. Os links só se compartilham pelo botão Compartilhar; o celular compartilha um link https absoluto da própria instalação. Grupos privados nunca aparecem na busca.
- Menu da pessoa. Na lista de Membros da comunidade (que só criador e administradores veem), cada pessoa tem um menu (o botão de mais ou um toque longo) com Conversar em particular, Ver perfil e as ações de administração. No grupo, as ações de uma mensagem de outra pessoa também têm Conversar em particular. A conversa privada abre com ela e nada da comunidade vai junto: nem texto, nem nome, nem foto de um grupo privado.
- Mensagem em particular a partir de uma publicação. Uma publicação de outra pessoa, na Rua, numa conversa ou num perfil, tem Mensagem em particular nas ações (só no nó hospedado, nunca na própria publicação nem na de uma página). Os itens do feed não dizem se o autor é uma Página, então a ação ainda aparece enquanto o app não sabe disso. Ao tocar, o app pergunta ao índice de membros do semeador e ao nó (
page.read): se o autor é uma Página, abre o aviso "Conversar com a página" (uma vez por página e por conta: na instalação hospedada com o estado de vistos sincronizado, a marca vai no bloco de vistos e outro aparelho da mesma passkey não repete o aviso; no nó core nativo e novaranda-serve, uma vez por aparelho. Esse aviso não espera a primeira passagem de vistos: nos primeiros instantes depois de Entrar em outro aparelho, antes de a primeira passagem responder, ele ainda pode se repetir), que explica a cifra de ponta a ponta, e depois a conversa da página, sem o chip de contexto. Quando a página ainda não tem chave de mensagens publicada, o aviso diz que a mensagem chega quando ela ativar as Conversas; uma página antiga, de antes desta mudança, ainda publica a chave antiga, e as mensagens enviadas a ela só são lidas depois que a dona ativa (e se perdem se ficarem mais de 14 dias sem ativação). Só uma página confirmada pelo nó é recusada quando está encerrada ou mudou de chave ("Esta página não recebe mensagens.", nada abre) e fica guardada como página, e aí a ação some das publicações desse autor. Uma página conhecida só pela dica do semeador recebe o aviso e abre sem o chip, mas nunca é recusada: a dica não é confiável e não pode calar a mensagem de uma pessoa. A conversa privada abre com um chip acima do campo: "Sobre a sua publicação de 5 nov", o começo do texto e o ícone de foto quando há. A pessoa precisa escrever algo; ao enviar, a mensagem começa comSobre a sua publicação "<até 60 caracteres>" (5 nov):(ou "Sobre a sua foto", para uma foto sem texto), seguida do que ela escreveu, e o chip some. O X do chip tira o contexto sem enviar nada. Enquanto o chip está ali, o microfone some: uma mensagem de voz iria sem o contexto. O contexto nunca vira resposta a uma mensagem da conversa, e só a tela da conversa que está no topo usa o chip.
- Só no nó hospedado (site e app instalado). O app com configuração manual e o
varanda-servemantêm as quatro abas, sem Conversas nem Feira; onde uma tela de Comunidades aparecer, ela mostra "Comunidades indisponíveis", como Avisos mostra "Avisos indisponíveis". - Só texto: sem fotos nem GIFs.
- Uma comunidade é sempre pública (só os grupos podem ser privados). Os grupos e comunidades do protocolo v1 foram descartados na atualização.
- As não lidas são por aparelho, no máximo 512 grupos marcados; a aba Comunidades mostra só o ponto, sem número.
- Sem resposta a uma mensagem específica e sem remover administrador da comunidade nas telas.
- Salas de áudio ao vivo ficam fora (veja "Fora do piloto").
Qualquer membro pode bloquear outro pelo menu Mais de uma publicação ou pelo perfil da pessoa. Só no nó hospedado (node.hosted): o app nativo com a instalação e a web. Um toque abre uma confirmação que diz o que o bloqueio faz e o que não faz: a pessoa não é avisada e, como os diários são públicos, ainda pode ver o que você publica.
- O que some. Publicações, respostas e citações da pessoa, e o que ela republica, em A Rua, Espiadinha, Busca, conversas de publicações, perfis e Avisos. Uma citação dela numa publicação de outra pessoa aparece como "Publicação indisponível". O nó aplica a regra ao ler (
docs/rpc.md5.111);PostRowe Avisos só limpam na hora o que já está na tela (src/memberBlocks.js). - Mensagens. O bloqueio inclui o Bloquear mensagens das Conversas. A conversa que já existe fica na lista, sem mensagens novas. Nela, o botão vira Desbloquear e desfaz o bloqueio inteiro.
- Seguir. Bloquear deixa de seguir a pessoa, com um registro público comum que não diz que houve bloqueio. Desbloquear não volta a seguir.
- Avisos push (web). O serviço de conta não sabe quem foi bloqueado, então quem filtra é o service worker (
scripts/sw.js), com a lista que a página informa (src/pushBlocks.web.js): o aviso aparece em silêncio e fecha na hora, porque o WebKit revoga a assinatura de um push que não mostra nada. No app nativo não há Web Push. - Desfazer. Em Ajustes, Pessoas bloqueadas, ou no perfil da pessoa, que mostra "Você bloqueou esta pessoa" e Desbloquear. A lista lê só o nome e o @nome (
diary.peekcomprofileOnly). - Busca de contas. A pessoa ainda aparece em Contas: é um dos caminhos para abrir o perfil e desfazer.
- Listas. Quem curtiu, quem republicou, Seguidores e Seguindo deixam a pessoa de fora antes de conferir as linhas. Na Busca de publicações e na conversa de uma publicação, uma linha dela conta como indisponível, como qualquer diário que o nó não lê.
- A lista acompanha a passkey pelo bloco cifrado de vistos (
docs/protocol.md, seção 14): bloquear num aparelho vale nos outros na passada seguinte de vistos, sem mudança no servidor. Um aparelho com a versão anterior do app não recebe a lista e fica sem o visto entre aparelhos até atualizar. Passa o limite das 128 mudanças mais recentes, a mudança mais antiga fica só no aparelho onde já estava. - Não entram: mensagens de grupos e comunidades, e anúncios da Feira. A dobra de um grupo não obedece à lista de propósito: o bloqueio de um membro não pode mudar quem está no grupo.
- A lista vale para a pessoa, também ao agir como uma Página.
- Toque duplo para curtir. Só no app nativo (iOS e Android); na web, o duplo clique continua selecionando texto. O toque duplo curte e nunca descurte, com um coração de 64 pt sobre a publicação. Um toque simples abre a conversa depois de 280 ms; um toque em outra publicação ou em outro botão cancela essa abertura. Leitores de tela abrem a conversa na hora e nunca curtem. Limite aceito: um arrasto que começa fora de qualquer publicação, dentro desses 280 ms, não cancela a abertura.
- Desfazer. Só o "Desfazer" do aviso "Republicado" (4 s) desfaz, e só depois que a republicação foi gravada com sucesso: antes disso, o aviso diz "Aguarde um instante e tente de novo.". Desfazer manda desligar a republicação, sem republicar de novo. Não há desfazer para curtida, apagar nem seguir. Limites aceitos: um desfazer durante a atualização puxada pode deixar a contagem uma a mais até a próxima atualização; o desfazer atualiza só a tela que mostrou o aviso; um desfazer enquanto uma curtida da mesma publicação está pendente não entra na fila (o botão de republicar da linha continua desfazendo).
- Fio da conversa. Na Conversa, uma linha de 2 pt liga o avatar da publicação respondida ao da publicação em destaque. A linha não recebe toques, e a publicação em destaque mantém a barra verde à esquerda.
Uma Página é o diário de um negócio ou projeto, com @nome próprio, um dono e até 16 administradores. O serviço de conta escreve no diário da página em nome deles; o protocolo está na seção 12 de protocol.md e as hipóteses de dados em design.md (LGPD). Só no nó hospedado (site e app instalado).
-
Páginas: lista das páginas que a pessoa é dona ou administra, com um + na barra do topo para Nova página.
-
Nova página: pede o nome e o @nome da página. O @nome vem do mesmo conjunto dos @nomes de pessoas, e um nome usado nunca é dado a outra conta ou página (uma página renomeada pode retomar o próprio nome anterior depois do período de espera; o nome de uma página encerrada fica queimado para sempre).
-
Ajustes da página: perfil da página, administradores (só o dono convida e remove), aceitar ou recusar convites e passar a página para outra pessoa, o que só vale se ela aceitar. O dono anterior continua administrador até ser removido.
-
Página em Membro: o perfil público da página, com a lista pública de administradores (@nomes de quem aceitou) e o selo de página na Busca.
-
Publicar como: o chip do composer escolhe entre a própria pessoa e uma página; a publicação sai no diário da página, inclusive com enquete ou evento (só como publicação nova na raiz: responder e citar seguem sem eles; Momento, o link de compartilhar na web e a fila offline continuam só da pessoa). A Página também vota nas enquetes e responde aos eventos. Um erro incerto nunca publica de novo sozinho.
-
Seguir como a página: a página segue uma pessoa ou outra página pelo perfil dela; a lista de quem a página segue é pública.
-
A Rua da página: as publicações dos 64 seguidos mais recentes da página, no mesmo estilo de A Rua. Quem a página segue além desses 64 não aparece ali.
-
Fotos em páginas: uma página publica fotos e GIFs como uma pessoa, com as mesmas regras de imagem (veja "Fotos e GIFs").
-
Conversas como página: quem administra lê e envia mensagens da página em Conversas, com o cabeçalho "como página". A outra pessoa vê a página, não o administrador. Como a pessoa, a página envia fotos, GIFs, mensagem de voz, cartão de link e proposta da Feira com o cartão, e encaminha mensagens com a mídia; o aparelho de quem administra sela as mídias com os próprios selos. Na primeira abertura, a dona recebe a folha de ativação: importa a caixa antiga, quando houver, gera a chave da página neste aparelho e usa Enviar chave para entregar um envelope selado a cada administrador. As mensagens ficam cifradas de ponta a ponta nos aparelhos, e o serviço só assina o digest do envio. Ao remover um administrador, a dona precisa trocar a chave para que ele deixe de ler mensagens novas. Se a chave publicada não confere com a que o aparelho guarda, aparece um aviso e esse aparelho não envia como a página até receber a chave certa. Mensagens que nenhum aparelho administrador coleta em 14 dias se perdem. Termos e Política na versão 33.
-
Encerrar e mudar a chave: só o dono vê, em Ajustes da página. "Encerrar página" pede duas confirmações que citam o @nome: as publicações deixam de aparecer para quem está com o aplicativo em dia, as cópias que alguém já guardou continuam existindo e o @nome nunca mais é dado a ninguém. "Mudar a chave" serve para quando o dono desconfia que a chave vazou: a página ganha uma chave nova com o mesmo @nome e os mesmos administradores, e a tela mostra a chave nova. Quem segue continua vendo as publicações antigas, e o perfil da chave antiga mostra "Esta página mudou para uma nova chave" com "Ver a página nova" e "Seguir a chave nova"; o toque é a forma manual. O aparelho também segue a chave nova sozinho, uma vez, depois de conferir a mudança (Termos 15); no nó core isso se desliga com
VARANDA_NO_PAGE_MIGRATE=1. Uma publicação na chave antiga depois da mudança (por quem tiver a chave vazada) não aparece. O app segue no máximo 4 mudanças em sequência. Uma página encerrada mostra "Esta página foi encerrada", sem Seguir nem outras ações, e fica cinza em Páginas, assim como a que mudou de chave. Um pedido incerto mostra "Tentar de novo", que reenvia o mesmo pedido assinado, sem assinar outro. O limite diário de mudanças responde "Limite de mudanças atingido, tente amanhã". Verificação emdocs/verification.mdseção 87. -
Avisos da página: o dono e os administradores veem em Avisos quem começou a seguir a página, também quando a página já segue essa conta (uma linha por seguidor; a pílula "Seguir de volta" não aparece enquanto uma Página age), as respostas, as citações, as menções e as curtidas e republicações das publicações dela (com um semeador sem
notices/3, só as quatro primeiras), com o cabeçalho "como página". O serviço de conta lê esses avisos em nome deles (Termos 15), responde só a quem administra, no máximo 8 leituras por minuto por página, e nenhum push vai para uma página. Verificação emdocs/verification.mdseção 88. -
Comunidades como a página: quem administra escolhe "Agir como" a página em uma comunidade ou grupo e a página entra, sai, lê e escreve ali, como membro com o @nome dela. Em comunidade de aprovação ela fica "pedida" até os administradores a admitirem. A página nunca cria, admite, bane, nomeia, oculta nem troca a chave de um grupo. Em grupo privado, o nó do aparelho administrador lê e sela as publicações com a caixa da página, que fica nos aparelhos administradores, e o serviço só acrescenta o bloco selado pelo escritor da página. Depois de trocar a caixa da página ou remover um administrador, aparece Renovar chave dos grupos: cada grupo privado fica
rekey-pending, "aguardando nova chave", até os administradores do grupo admitirem o escritor novo e uma época nova cobrir a saída. Nesse estado a página não publica e pode mostrar "Alguém publicou antes" se o escritor mudou antes do envio. Depois de "Mudar a chave", a chave nova volta para as mesmas comunidades e grupos; ao encerrar, a página sai de todos. Verificação na seção 149. Termos e Política na versão 34. -
Nó core (delegado): um nó core (CLI ou
varanda-serve) administra páginas com uma chave de delegado guardada no aparelho (private/page-actor.json,page register), que aparece com o diário do nó e não com um @nome. O delegado aceita os Termos pelo comandopage terms. A CLI fala com o serviço de conta emVARANDA_ACCOUNT_ORIGIN(https) e nunca reenvia um pedido sozinha. No app nativo com o nó core, quando o nó informa uma origem https da conta (accountOriginnonode.info, que ovaranda-serve --account-origin https://<host>também publica), o primeiro uso de Páginas registra o delegado, aceita os Termos com ele e só então cria; a chave do delegado aparece copiável com "convites chegam por esta chave". A interface web dovaranda-servenão oferece Páginas: o serviço de conta não responde a outra origem do navegador (sem CORS), e só o fetch do app nativo, que não envia origem, chega a ele. Uma conta ligada ao Google não registra delegado para o próprio diário. Verificação em seção 89.
- Só no nó hospedado, ou no app nativo com um nó core que informa uma origem https da conta: o app com configuração manual sem essa origem, e a interface web do
varanda-serve, não têm Páginas. Avisos, Conversas e comunidades como a página seguem os limites dessas telas (só no nó hospedado); no nó core, os avisos da página vêm pela CLI (page notices). - Até 16 administradores por página; A Rua da página mostra só as publicações dos 64 seguidos mais recentes; os demais não aparecem ali.
- As Conversas da página não acompanham a mudança de chave: a chave nova começa uma caixa nova.
Esta parte muda como as telas se comportam ao rolar e como as linhas aparecem. Não muda dados nem o que vai ao nó. Os passos de conferência estão em docs/verification.md §91.
- Ao rolar um perfil, a faixa de 96 pt sai da tela e aparece no topo uma barra de 44 pt, somada à área segura, com o nome e os botões da faixa: no Diário, ajuda, engrenagem e sino; no Membro, voltar. Sem "Reduzir movimento", a barra surge aos poucos; com ele ligado, surge de uma vez.
- A barra só recebe toques quando os botões da faixa já saíram da tela, então cada botão responde uma vez só. No Membro, a seta de voltar da faixa fica desligada enquanto a barra está ativa.
- Depois que as abas do perfil passam sob a barra, uma cópia delas fica fixa logo abaixo da barra, e só existe enquanto está fixa.
- No Diário, a pílula "ver novidades" fica abaixo da barra, ou abaixo das abas quando elas estão fixas, e segue tocável.
- No topo do perfil, a tela é a mesma de antes. Os limites exatos da troca estão em
apps/app/src/profileBar.js.
- Cada linha tem um selo verde de 20 pt no canto do avatar, com o ícone do tipo: seguir, resposta, citar, menção, curtida (coração) e republicação. Tipo sem ícone não tem selo.
- O nome aparece em negrito e o resto da frase em peso normal. A linha abre o mesmo lugar de antes, e o leitor de tela lê a mesma frase.
- Embaixo do nome e da ação, o @nome verificado de quem agiu (quando existe), na linha suave de sempre, e, numa linha própria, o começo da publicação entre aspas (até 90 caracteres), em outra cor. A prévia nunca ocupa o lugar do @nome: uma publicação que diz "@maria" não pode se passar pelo @nome de quem a escreveu. Linhas de quem começou a seguir não têm prévia. O leitor de tela lê a linha inteira: a ação, o @nome, a prévia e "não lido". Uma prévia cuja leitura falhou duas vezes ganha nova tentativa quando a lista é recarregada por inteiro (puxar para atualizar); a atualização automática a cada 5 minutos não tenta de novo. As prévias vêm das leituras do próprio diário no nó; nada é buscado de fora. O tempo fica à direita, e uma linha não lida tem um ponto.
- Os Avisos não mostram a divisão "Novos" e "Anteriores".
- Entre dias diferentes aparece um marcador: "hoje", "ontem" ou dia e mês ("D mmm"), com o ano quando não é o ano atual. O dia é o do aparelho.
- Mensagens seguidas do mesmo lado formam um grupo quando cada uma cai até 5 minutos da primeira do grupo, no mesmo dia e sem pílula de convite entre elas. Dentro do grupo, os cantos do lado de quem enviou ficam mais fechados, e a última bolha tem uma pequena cauda. Cada bolha mostra a hora dentro dela; "Enviada" aparece só enquanto um envio está retido ou incerto.
- Pressionar e segurar uma mensagem abre as ações (Responder, Copiar, Denunciar); na web, com mouse ou teclado, uma pequena seta no canto da bolha abre as mesmas ações. Não há confirmação de leitura nem avatar nas mensagens privadas.
- Música do Audius. Na publicação do diário, a ferramenta de ícone com o nome acessível Música abre o seletor quando a conta está vinculada, o nó está ligado à instalação da associação e a música está habilitada. Ela não aparece ao publicar como página. Escolher uma página descarta o rascunho de música, e voltar a publicar como pessoa não o recupera. Um rascunho de música não pode ser enviado como página. O seletor busca Faixas ou Playlists. Cada linha de faixa mostra a capa ou o azulejo gerado, o título e "artista · m:ss". Uma playlist mostra o título e o artista com o número de faixas, no mesmo lugar. Com as capas ligadas na associação (
VARANDA_AUDIUS_COVERS=1, ainda desligadas por padrão), o seletor mostra a capa pequena e o editor pede a de 480 px porPOST /account/audius/art?size=480, só na memória. Os tamanhos têm entradas separadas no cache do serviço. Sem a maior, o serviço usa a pequena; se a maior falhar como imagem, só começa uma nova busca da pequena se ela ainda couber no prazo de 20 s da resposta, abaixo dos 25 s do cliente. Um app anterior continua recebendo a capa pequena semsize=480. Sem capa, ou com as capas desligadas, continua o azulejo gerado no aparelho. Numa faixa, Ouvir prévia toca 15 s a partir do início, e Parar prévia interrompe. Só uma prévia toca por vez. A prévia só toca depois de confirmar a busca do ponto inicial; se não conseguir, avisa e não toca desde zero. Escolher uma faixa ou uma playlist abre o mesmo editor, para confirmar. Numa publicação do diário os chips são 15 s e Faixa inteira. Num momento, o editor oferece só o trecho. No trecho, uma janela fixa de 15 s fica sobre uma faixa de barras decorativas, derivadas do id da faixa, que desliza por baixo dela. Numa faixa com menos de 15 s, a janela é a faixa inteira e não há início para arrastar. O horário de início fica acima da janela. O valor acessível anuncia os tempos. As ações são Avançar um segundo e Voltar um segundo. Na web, as setas andam um segundo, Home vai ao começo e End vai ao último início. A busca do ponto acontece ao soltar. O editor reutiliza um único ticket de reprodução entre os arrastos e as voltas. A prévia repete o trecho até 8 vezes e então pausa. Com Reduzir movimento, o avanço na janela troca de lugar de uma vez. Concluído fica na linha de cima da folha e Voltar volta à busca. No compositor, a escolha é um adesivo com a mesma capa, ou com o azulejo gerado quando não há capa: tocar reabre o editor no início escolhido, o X remove, e os nomes acessíveis são Editar música e Remover música. - A escolha aparece no adesivo descrito acima, com o título e uma segunda linha ("artista · início" no trecho, "artista · Faixa inteira" na faixa, "Playlist · N faixas" na playlist), com a capa na memória do aparelho quando a associação a repassa, e com o azulejo gerado quando não há. A capa não entra no que fica guardado. O que fica guardado leva a fonte Audius e o link para a página do item. É preciso escrever ao menos um caractere; o adesivo e as fotos não vão juntos. Música não entra na fila de publicações só de texto sem rede. Um link de
audius.cocolado pode virar o mesmo adesivo: com a música disponível e as prévias ligadas, o compositor tenta resolver o link pelo serviço de conta, sem buscar a página diretamente no aparelho, também no app nativo. Digitar em outra parte do texto não cancela nem repete o pedido; remover o link durante o pedido cancela, e recolocá-lo inicia uma nova tentativa. Só uma tentativa concluída, com o adesivo mostrado ou falha, não se repete no mesmo uso do compositor. Depois de publicar ou fechar o compositor, qualquer link pode ser tentado de novo. Se a resolução falhar, o link fica como texto, sem adesivo no compositor do diário. Desligar as prévias ou dispensar o adesivo impede essa montagem automática. Quando a música não está disponível, o link segue o tratamento comum de prévias, assim como nas conversas e nos grupos. - Na leitura de uma publicação de texto, resposta ou citação aberta como publicação própria, um trecho ou uma faixa do Audius aparece como o cartão por toque (
MusicPlayerCard.js): capa ou azulejo gerado, título, artista, selo 15 s no trecho, fonte Audius, botão redondo (Ouvir, Ouvir trecho ou Ouvir playlist) e link Abrir no Audius. Nada toca sozinho e não há adesivo de música na leitura. O app pede?covers=1&info=1na busca, no item e na resolução de link:info=1acrescenta gênero (até 40 pontos de código) e ano (1900 a 2100, derelease_date) às faixas, nunca às playlists. Seminfo=1, o serviço mantém as chaves antigas. A capa só é pedida depois da resposta do item e fica só na memória. - Só o toque começa a música: Ouvir, Ouvir trecho ou Ouvir playlist pede o item e o áudio ao serviço de conta, e só então a capa. Antes do toque o cartão mostra só campos guardados e o azulejo gerado, sem consultar disponibilidade, item, capa ou áudio. Um cartão tocado pausa (faixa e playlist) ou para (trecho e carregando) quando fica quase todo fora da faixa visível, conferido a cada 500 ms depois de 2 s de espera (
musicLeaves); nunca volta a tocar sozinho, e não lê nem muda o silêncio compartilhado. Trocar de aba ou de tela (publicação, compositor, Ajustes), abrir a foto, bloquear ou ir para segundo plano também interrompe. Folha, menu e perda de rede não interrompem. Um cartão tocado antes não impede um player de provedor, e o contrário continua valendo pelas regras de exclusividade de áudio. - O cartão do Audius não tem botão de som: ele não depende do silêncio compartilhado, que governa só os vídeos do feed e os momentos. Os limites diários, o orçamento compartilhado do provedor e a resposta de política
{ enabled, moments }não mudam. - Todo cartão do Audius, playlists incluídas, é o cartão por toque e toca com som mesmo com o silêncio compartilhado. Depois do item respondido, pode pedir a capa enquanto ativo. A faixa inteira mantém controle de posição e a playlist tem próxima e anterior; num trecho menor que 15 s desse cartão, o selo mostra a duração real depois de carregar o item. Trocar de tela para o áudio e descarta pedidos pendentes. Sem instalação, na configuração manual ou no
varanda-serve, aparece de imediato o cartão comum de link; nos outros modos, uma conferência de disponibilidade negativa ou falha faz o player virar cartão comum. O cartão dentro de uma citação e os balões de conversas privadas e grupos continuam cartões comuns, e o rascunho do compositor mantém só o adesivo de edição e sua prévia por toque. Nenhum frame do Audius é carregado. O registro não muda:previewe mídia nunca vão juntos, e música com fotos ou vídeo numa publicação continua recusada. Verificação: verification.md, seção 246, que substitui o início automático e o adesivo das seções 204 e 208, sem reescrevê-las. Os quatro players incorporados e a regra do leitor de tela continuam como antes. - O avatar de 40 pt ganha, ao lado, o nome em negrito e o
@nome, acima do campo de texto. - O anel de progresso muda de tom: verde até 90 % do limite, âmbar a partir de 90 % e vermelho acima do limite. O contador só mostra o número a partir de 80 % do limite (de 80 % a 90 %, "N/1000"); a partir de 90 %, mostra quantos caracteres faltam, negativo quando passa do limite.
- No app nativo, uma vibração de sucesso marca a publicação enviada de fato, não a que vai para a fila de saída. Uma vibração de aviso marca a nota de limite de caracteres.
- A folha tem uma alça no topo no Android, no iOS e na web. O campo não ganha anel de foco.
No nó hospedado, o perfil mostra uma faixa de comunidades acima das abas, abaixo das ações, com até 8 comunidades (ícone e nome); com mais de 8, Ver todas (N) abre a lista inteira. Tocar numa comunidade a abre. Sem comunidades, a faixa não aparece.
- No seu Diário: Suas comunidades, as comunidades em que você foi admitido (criou, administra ou é membro); pedidos pendentes não entram.
- No perfil de outra pessoa: só Comunidades em comum, as comunidades em que vocês dois foram admitidos, conferidas na lista de membros que você já pode abrir, sem quem foi banido. A lista completa das comunidades da outra pessoa nunca aparece, porque participar de uma comunidade pode revelar interesses sensíveis. O app confere no máximo 8 das suas comunidades, uma de cada vez.
O perfil (o seu Diário e o de outra pessoa) tem as abas Publicações e Mural. O Mural é uma visão das publicações públicas com foto que a pessoa já fez: não há cópia, nenhuma publicação nova e nenhum prazo de expiração. Cada foto abre a conversa da publicação. Respostas e republicações nunca aparecem no Mural, nem citações.
- As fotos vêm das páginas que a tela já leu: o Mural não faz leitura própria. Se faltar foto, ele lê as páginas mais antigas, até um limite. Depois disso, mais fotos só chegam pelo botão "Ver mais".
- Sem internet, ou fora do nó hospedado, o perfil de outra pessoa mostra o aviso de sempre e não tem a aba Mural.
- No seu Diário, o Mural vazio diz que as fotos publicadas aparecem ali. Publicar continua no botão de escrever de sempre, sem um segundo botão.
- Uma foto com várias imagens tem um selo no canto. As células que completam a última fileira ficam vazias.
- A aba Respostas continua fora desta etapa. Uma resposta do Diário é o campo
record.replyTode um registro dentro dolog.readpaginado, e não há leitura só de respostas.
Um depoimento é um texto curto que uma pessoa escreve sobre outra, para aparecer no perfil de quem recebe. Só existe no nó hospedado.
- Quem escreve: qualquer membro, para outra pessoa que já recebe mensagens (tem chave de mensagens). Ninguém escreve para si. O texto tem até 400 caracteres.
- Selado até a pessoa mostrar: o texto vai selado para quem recebe. Os outros sabem só que houve um depoimento de uma pessoa para a outra, nunca o texto, até que quem recebeu escolha mostrar.
- Aba Depoimentos: a terceira aba do perfil, ao lado de Publicações e Mural, no seu Diário e no perfil de outra pessoa. Só aparece no nó hospedado; fora dele o perfil fica com as duas abas. A aba mostra todos os depoimentos à mostra, o mais novo primeiro. Sem nenhum, ela diz "Nenhum depoimento ainda"; no perfil de outra pessoa, quando você pode escrever um, também diz "Toque em ⋯ no perfil para escrever um depoimento.". A aba escolhida continua a mesma depois de abrir uma publicação e voltar.
- Depoimentos para aprovar: no seu Diário, a aba Depoimentos começa com a linha fixa "Depoimentos para aprovar (N)", quando há algum, e com a linha "Enviados". As duas abrem a tela Depoimentos. Lá, cada depoimento em "Para aprovar" tem três escolhas: Mostrar no perfil publica o texto no seu diário, Guardar só para mim leva a linha para a seção "Guardados", que só você vê (com a nota "Só você vê. Quem escreveu não fica sabendo."), e Recusar tira a linha da lista depois de uma confirmação ("Recusar depoimento?": "some da sua lista em todos os seus aparelhos. Quem escreveu não fica sabendo."). Guardar e recusar não gravam registro em diário nenhum e não chamam a rede: a escolha fica só no nó e vai para os outros aparelhos da mesma passkey pelo documento cifrado de vistos (
testimonial.decide, rpc.md 5.100). Quem escreveu vê só "Enviado" em Enviados e não sabe se o depoimento foi guardado, recusado ou nem visto; se retirar o depoimento, ele some de Guardados também. Em "Guardados" cada linha ainda pode ser mostrada no perfil ou recusada. A lista antiga "Agora não" de um aparelho (só daquele aparelho) é levada uma vez, ao abrir a tela, para decisões de guardado, sem sobrepor uma escolha já feita. A linha fixa do Diário fica "Depoimentos para aprovar (N)", e, havendo guardados, "Depoimentos guardados (N)". - Remover do perfil: tira do seu perfil o depoimento daquela pessoa. Ele não volta para a lista de aprovar; só um depoimento novo da mesma pessoa volta.
- Retirar depoimento: quem escreveu pode retirar o próprio depoimento a qualquer momento, pelo botão de mais da linha ou do perfil. Ele some do perfil de quem recebeu, mesmo que já estivesse à mostra.
- Folhas: o título é curto e fixo (Escrever depoimento, Retirar depoimento?, Remover do perfil?), para não ser cortado no celular. O nome da pessoa fica no corpo: "Para " no campo de escrever e no texto das confirmações.
- Denunciar a conta: cada depoimento à mostra tem Denunciar a conta, na folha de mais da linha.
- Tela Depoimentos: as linhas "Depoimentos para aprovar" e "Enviados" da aba, no seu Diário, abrem a tela com Para aprovar, No seu perfil e Enviados, os que você escreveu e ainda não retirou.
- Sem curtidas, sem contagem e sem respostas. O texto vindo de outra pessoa passa por
displayTextantes da tela.
Um momento é uma foto, um GIF ou um vídeo de até 15 segundos e 4 MiB com até 200 caracteres de texto, que aparece para quem segue você por 24 horas. Só existe no nó web (navegador ou worklet nativo), o nó hospedado: fora dele, nem a faixa, nem o modo Momento, nem as linhas do Diário aparecem. O contrato está em docs/rpc.md 5.113 e os passos de conferência em docs/verification.md §123, §187 e §199.
- Faixa de momentos em A Rua: no topo da lista, uma faixa que rola de lado com anéis de 56 pt e o nome embaixo. O seu vem primeiro, "Você": com um "+" quando você não tem momento no ar (abre Publicar já em Momento), ou com o seu momento quando há. Depois vêm as pessoas com algum momento que você ainda não viu neste aparelho (anel em faixas do pôr do sol) e, por último, as que você já viu (anel fino na cor de contorno). Sem nenhum momento e sem como publicar, a faixa não aparece.
- Visto: o app marca como visto cada momento que o visualizador mostrou. Onde o nó é hospedado, a marca acompanha os aparelhos da mesma passkey, guardada no documento cifrado de vistos; nos demais, fica só neste aparelho. Em nenhum caso grava registro nem avisa ninguém. Não há contagem de visualizações.
- Visualizador: abre por cima das abas, preto nos dois temas. Uma barra de progresso por momento da pessoa; tocar na metade direita passa para o próximo, na esquerda volta; segurar pausa; deslizar para baixo ou o botão de fechar fecha. Deslizar para os lados troca de pessoa (para a esquerda, a próxima; para a direita, a anterior), mesmo quando a pessoa tem mais momentos: na primeira pessoa, deslizar para a direita repete o momento na tela, e depois da última, deslizar para a esquerda fecha. Um arrasto segue a direção em que começou: um arrasto para baixo que se desvia para o lado ainda fecha, e um deslize para os lados nunca fecha. Trocar de pessoa dá um toque leve de háptico. Com a ajuda, o menu ou a folha de apagar abertos por cima, os deslizes são ignorados. Sem música, cada foto passa sozinha depois de 5 s, parado enquanto você segura ou com um menu aberto, e nunca com "Reduzir movimento" ligado. Com música na foto e som ativado, a barra espera o áudio começar, como descrito abaixo. Um vídeo usa esse mesmo relógio pela sua duração, até 15 s, e toca com seu próprio som quando o som da sessão está ativado, ou sem som quando silenciado; música no registro de vídeo é ignorada. O cabeçalho tem Silenciar som ou Ativar som só em vídeos e em momentos com música habilitada. É o mesmo silêncio da sessão do feed: o botão nunca passa nem pausa o momento. A pílula Ativar som após uma recusa do navegador num vídeo continua e ativa o som por inteiro, como o botão do cabeçalho. Os controles Reproduzir, Próximo momento e Ativar som atendem ao bloqueio de reprodução, movimento reduzido e som bloqueado. Depois do último momento de uma pessoa vem a próxima da faixa, e no fim o visualizador fecha. Começa no primeiro momento que você ainda não viu. A foto vem do nó; se ela já saiu do servidor, aparece "Foto indisponível" no lugar, sem erro.
- Música no visualizador: com
VARANDA_AUDIUS_MOMENTSligado, uma referência válida e a conta vinculada (audiusReady), o momento tenta tocar um trecho de 15 segundos a partir do segundo gravado (start), se o som da sessão está ativado. O visualizador confere a política e o vínculo da conta, sem consultarnode.info, inclusive com o som silenciado, mas não pede o trecho de um momento aberto em silêncio até ativar o som. Esse momento usa os 5 s comuns da foto, sem espera de 3 s. Ao ativar o som nele, espera até 3 s pela música e a barra reinicia em 15 s quando ela começa; no Safari e no PWA do iOS, o navegador pode exigir outro toque em Tocar música. Com som ativado, enquanto espera essas respostas e o áudio começar, a barra fica em zero por até 3 s no total (MUSIC_START_WAIT_MS). Esse tempo só conta quando o visualizador não está pausado. Foto carregando, dedo segurando, menu aberto, outra tela por cima ou app em segundo plano preservam o que falta dos 3 s. Se a resposta ou o áudio demoram mais, começa a passagem comum de 5 s da foto. Uma resposta negativa ou falha de disponibilidade (onUnavailable), inclusive o bloqueio de áudio sem gesto, inicia esses 5 s de imediato. Quando o áudio começa pela primeira vez nesse momento, mesmo atrasado, a barra volta a zero e passa a durar 15 s (MUSIC_HOLD_MS). Uma resposta positiva atrasada, sozinha, não reinicia a barra. Com som ativado, uma reconexão (node.epoch) zera a barra e abre nova espera de até 3 s; os 15 s só começam com o áudio do novo player. O momento mostra um adesivo com o título e o artista. Depois que a música daquele momento começa a tocar, o adesivo pode mostrar a capa que o serviço de conta repassa, só na memória da sessão do app, e a capa continua ao silenciar; sem capa, ou antes de a música tocar, fica o azulejo gerado. Um toque alterna o mesmo silêncio da sessão (Silenciar música / Ativar música), compartilhado com o cabeçalho e o feed. O link Audius (nome acessível Abrir no Audius) abre a página da faixa. Um equalizador pequeno se move enquanto toca e dá lugar ao ícone de mudo ao silenciar. Com o momento mostrado assentado (a música dele tocando, ou sem música e com a foto carregada) e o visualizador por cima e visível, o app adianta o único próximo momento, o mesmo passo de um toque: o anel seguinte começa no primeiro item ainda não visto. São duas etapas. A resposta da faixa e o ticket são pedidos sempre à frente. O áudio do trecho de 15 s é aberto à frente quando a música do momento mostrado já começou, foi dada como indisponível ou o momento não tem música; se o limite de retransmissões por membro já foi atingido, o serviço troca uma retransmissão antiga pela nova. Depois que só o prazo de 3 s terminou (o áudio atual pode ainda estar carregando), o adiantamento pede só a resposta e o ticket, sem abrir o áudio. Esse player é criado, posicionado no início, nunca toca e nunca toma a reprodução. Na web, o player adiantado fica pausado e enche o buffer (preloadauto). A política e o vínculo da conta também são conferidos quando só o próximo momento tem música. Ao chegar nesse momento, o que já está pronto é usado. Com o player aberto à frente, o som começa junto com a foto e a barra. Se o áudio não foi aberto à frente, o momento abre o player com o mesmo ticket na hora em que aparece, sem novo uso de item nem de toque. Há no máximo um adiantamento, um por momento mostrado e por destino. Com o som da sessão silenciado, nada é adiantado, e silenciar larga o adiantamento que ainda não foi usado. Ele é largado na hora quando o visualizador fecha, fica coberto, o app vai para segundo plano, a conta ou a conexão (node.epoch) muda, ou o próximo momento muda. Depois de 18 s sem uso (PRELOAD_IDLE_MS, abaixo do corte de ociosidade de 20 s do serviço), só o player de áudio adiantado é largado: a resposta da faixa e o ticket ficam, e o momento abre um player novo com esse ticket quando aparece, sem novo uso de item nem de toque. Um adiantamento só com o ticket, depois que só o prazo de 3 s terminou, não tem player nem o prazo de 18 s. Um adiantamento largado, com a época de reprodução (playbackEpoch) mudada, ou com o ticket a 60 s ou menos do fim, é ignorado e o momento carrega como antes. Só uma recusa definitiva do pedido de item ou de toque (comolimite-musica) ou um início inválido conta como a carga daquele momento: nada é pedido de novo sozinho, a foto fica os 5 s de sempre, e tocar de novo carrega normalmente. Se o áudio adiantado falha, o momento abre um player novo com o mesmo ticket quando aparece, sem novo uso de item nem de toque. Um player pronto que falha depois de ser entregue não é carregado de novo. O primeiro momento de uma visita ainda carrega quando aparece, então a foto pode surgir enquanto a barra espera até 3 s. A resposta da faixa fica na memória por até 10 minutos, por membro e origem, no máximo 32 entradas, e sai no bloqueio, na saída, no reset e na troca de conta. Tickets não ficam em cache. O áudio nunca é armazenado: vive só no player. A capa continua só depois que a música daquele momento está tocando. A espera de 3 s (MUSIC_START_WAIT_MS), a passagem de 5 s e o reinício de 15 s (MUSIC_HOLD_MS) não mudam. Com Reduzir movimento, vale o mesmo único adiantamento: depois de 18 s sem uso, só o player de áudio adiantado é largado, a resposta da faixa e o ticket ficam, e o momento abre um player novo com esse ticket quando aparece, sem novo uso de item nem de toque. Um navegador que recusa tocar sozinho ainda mostra Tocar música, e o toque toca o player pronto sem pedido novo. O mesmo código compartilhado roda no Android, no iOS e na web, com o player de fluxo nativo ou o elemento de áudio, sem ramo de plataforma. Um momento seguinte em vídeo não é adiantado. No custo do dia, um momento assistido gasta 1 uso de item (0 quando a resposta já está lembrada), 1 uso de toque e, em geral, 2 aberturas de áudio, como hoje. Um adiantamento que ninguém usa gasta o mesmo uso de item e o mesmo uso de toque, no máximo um por momento mostrado. Se o adiantamento falha sem resposta certa (sem rede, tempo esgotado ou erro do serviço), ou fica de lado porque a reprodução mudou ou o ticket está a 60 s do fim, o momento carrega do zero quando aparece e pode gastar mais um uso de toque (e de item, se a resposta não estiver lembrada). As aberturas de áudio desse adiantamento só entram quando o áudio foi aberto à frente, e esse gasto só se perde se a pessoa sair antes de chegar ao momento. O cliente não limita as aberturas de áudio: um seek ou uma retomada abre mais. Um início inválido continua sem gastar uso de toque.limite-musicainterrompe o adiantamento até o visualizador reabrir. Uma troca de conexão ou de conta (node.epoch) monta a tela de Momentos de novo e conta como reabrir: o par já tentado pode ser adiantado outra vez, gastando mais um uso de toque, e depois delimite-musicao próximo adiantamento é tentado de novo. Segurar no máximo dois players, o mostrado e o próximo, não garante permanecer dentro das 2 retransmissões do serviço: ao passar delas ele troca uma retransmissão antiga que já recebe áudio, e responde 503 quando não há qual trocar (uma em cada um de dois outros tickets, ou só aberturas ainda esperando o provedor), como um serviço antigo responde sempre. Um 503 na carga à frente não é repetido, e o momento carrega quando aparece. Largar um adiantamento não revoga o ticket: o serviço guarda 8 por membro, e o nono aposenta o mais antigo. O serviço de conta e os limites dele não mudam. - O adesivo mostra o título e o artista, com o texto passado por
displayText, e a capa só depois que a música daquele momento começa a tocar (antes disso, o azulejo gerado), só na memória da sessão do app. Um toque nele alterna Silenciar música e Ativar música e muda o mesmo silêncio da sessão. Silenciar um trecho que já toca o pausa, sem mudar os 15 s do momento; ativar o som o retoma sem novo pedido de áudio. Se o momento foi aberto em silêncio, ativar o som pede o trecho pela primeira vez, como descrito acima. O equalizador pequeno do adesivo se move enquanto toca e dá lugar ao ícone de mudo ao silenciar. Com Reduzir movimento, o equalizador fica parado. A página da faixa abre pelo link Audius (nome acessível Abrir no Audius). Abrir esse link pausa o visualizador até a pessoa voltar. Se o visualizador não chegar a ficar oculto, a pausa termina após 1 s (LINK_HOLD_GRACE_MS). Com a música desligada, sem referência válida ou sem vínculo da conta, fica a foto silenciosa de 5 s. Falhas podem mostrar "Não foi possível começar nesse ponto" ou "Música indisponível agora". Se o aparelho bloqueia o áudio sem um gesto, aparece Tocar música. Verificação emdocs/verification.md§208. - Mandar o app para segundo plano ou cobrir o visualizador com outra tela, como denúncia ou ajuda, interrompe a música. Ao voltar, aparece Tocar música. O toque busca o trecho de novo e toca desde o início escolhido. Se o áudio já havia começado, isso não reinicia a barra. Se o reinício for bloqueado por falta de gesto, Tocar música continua disponível e a barra mantém o tempo restante dos 15 s. O fim normal do trecho não oferece Tocar música. Voltar à esquerda quando já está no primeiro momento reinicia também a música, com nova espera pelo áudio e barra em zero. Se o app ignora um fechamento durante uma transição entre telas, a música só pausa e depois retoma de onde estava, junto com o tempo restante da barra. Um app, uma web, uma CLI ou um semeador de antes desta música não mostra o momento que a leva.
- Responder: abre a conversa privada com quem publicou, com o chip de contexto do momento acima do campo (a ponte da conversa privada). Não há resposta pública, curtida nem contagem.
- Reagir: na linha de ações do momento de outra pessoa (nunca no seu), seis emojis rápidos, com o mesmo bloqueio de mensagens do Responder (passkey para desbloquear). Tocar envia uma mensagem privada à autora ou ao autor (
dm.sendcommoment), sem nada público, sem contagem e sem registro no diário. Na conversa dela aparece uma bolha de reação com o emoji e, só enquanto o momento ainda aparece (24 h, não apagado,moment.lookup), uma miniatura; um vídeo mostra um azulejo no lugar. A miniatura vem do nó; em Pedidos de mensagem ela só aparece depois de aceitar a conversa. Numa conversa aberta, as bolhas do mesmo momento dividem uma consulta a cada 15 s e uma leitura da imagem; a miniatura sai da memória quando a última delas sai da tela ou o momento deixa de aparecer, e uma falha tira a miniatura de todas, mas a próxima bolha daquele momento que aparece consulta de novo e, se der certo, a miniatura volta em todas; um momento fora do ar ou passado das 24 h não é consultado de novo. Cada reação gasta dois selos de envio e o app nunca a envia de novo sozinho. - Seu momento: no seu, o botão de mais tem Apagar (confirmação "Apagar momento?"), e a frase "O momento sai dos servidores em até 14 dias." fica atrás de um ⓘ titulado "Sobre seus momentos" (abrir o ⓘ pausa a reprodução; a folha de apagar mostra a frase). Novo momento fecha o visualizador e abre Publicar em Momento.
- Publicar em Momento: no topo de Publicar, a escolha "Publicação | Momento" (só para uma publicação comum: não ao responder, citar ou publicar como Página). Um momento leva exatamente uma foto (Escolher foto, depois Trocar foto) ou um vídeo (Vídeo) e até 200 caracteres, com o contador. O rascunho da publicação fica guardado enquanto você está em Momento e volta em Publicação. Com a chave de mensagens bloqueada, o app pede para desbloquear com a passkey. Se não der para confirmar o envio, o rascunho fica até você conferir em Seus momentos, no Diário: o app nunca envia de novo sozinho. O botão Música aparece só no nó hospedado, com
momentMusic: trueemnode.info,moments: truena política do serviço e conta vinculada (audiusReady). O compositor só consultanode.infonesse nó, ao abrir Momento com a política ligada, uma vez pornode.epoch, inclusive se a consulta falhar. A política é desligada por padrão e qualquer falha mantém a música indisponível. O seletor oferece só o trecho de 15 segundos, sem faixa inteira e sem playlist. A escolha aparece num adesivo, só na memória do aparelho, com a capa quando a associação a repassa, ou com o azulejo gerado, o título e "artista · m:ss", o início do trecho: tocar reabre o editor no início escolhido, e Remover música tira a música. O adesivo e esse botão só aparecem enquanto a música em momentos está disponível, pela mesma condição usada no envio: a música mostrada é a que será enviada. Música só acompanha foto, inclusive GIF. O botão Música fica oculto com vídeo preparado ou em preparação. Com música escolhida, Vídeo mostra "A música vai só com foto: remova a música" antes de abrir o seletor. O envio de vídeo nunca inclui música. O diário guarda só o id da faixa e o segundo de início ao lado dela, sem título, artista, capa ou endereço. - No seu Diário: abaixo do topo do perfil, nunca como quarta aba, a linha "Seus momentos (24 h)" com o número de momentos no ar (abre o visualizador) e a linha recolhida "Momentos anteriores (N)", que abre a lista dos seus momentos que já passaram das 24 h, com a data, o começo do texto e Apagar no botão de mais. As duas somem quando não há nada.
- A regra das 24 horas: quem lê esconde o momento quando passam 24 h da hora dele. Um momento datado mais de 10 minutos à frente do relógio espera a hora chegar, então uma data adiantada não estica as 24 h. Esconder não é apagar: o texto fica no seu diário até você apagar, e por isso ele aparece em "Momentos anteriores".
- A mídia: vai para o depósito anônimo de blobs dos servidores (o mesmo das fotos das mensagens), com a chave pública no registro: quem lê o seu diário pode abrir a foto ou o vídeo. Os servidores apagam a mídia em até 14 dias. Cópias que outras pessoas fizeram não voltam: sumir não é apagar.
- Leitura adiantada: enquanto o visualizador está por cima, descoberto e com o app visível, ele mantém lida a foto do momento atual, dos dois próximos (na ordem em que "próximo" anda) e do anterior do mesmo anel, para que passar de um momento a outro, ou voltar, não espere a rede. Com o visualizador coberto ou o app em segundo plano, mantém só o atual. As leituras adiantadas começam uma de cada vez, e só enquanto há menos de duas leituras de foto de momento sem resposta; a foto do momento em que a pessoa toca ou para o qual passa começa na hora, mesmo acima disso. Uma leitura sem resposta depois de 30 s deixa de contar nesse limite, mas a leitura adiantada para enquanto duas dessas seguem sem resposta. Uma leitura lenta nunca é pedida de novo nem descartada: a resposta que chega depois ainda vale, e cada pedido de pedaço ao semeador termina em até 30 s. Um vídeo só é lido antes quando é o próximo item. Uma foto lida antes sai da memória quando nenhuma tela precisa dela, quando o momento expira ou no máximo 5 minutos depois (se ainda for preciso, é lida de novo); a foto na tela fica enquanto é mostrada, até o momento expirar; uma falha não fica guardada. Bloquear ou sair da conta ainda apaga tudo, inclusive os arquivos de leitura do nativo.
- Aquecimento em A Rua: no nó hospedado, com A Rua na aba ativa, o app visível, o semeador verificado e 3 s sem nada em andamento, o app lê a foto (nunca um vídeo, nunca a música) do primeiro anel de momentos ainda não vistos que não seja o seu, para que o primeiro toque na faixa abra rápido. Essa foto aquecida também sai da memória no máximo 5 minutos depois de lida, como qualquer foto lida antes.
- O texto vindo de outra pessoa passa por
displayTextantes da tela.
A Feira é o lugar de anúncios da rede: produtos, serviços e procuras ("Procura-se") de quem mora perto. Cada anúncio é um registro assinado no diário de quem anuncia (ou da Página), como uma publicação; o semeador só monta o índice de busca, em memória, e a página pública. O formato está em protocol.md, seção 15. Só existe no nó hospedado (site e app instalado com a instalação), e só quando a instalação liga a Feira; senão a aba diz "A Feira não está aberta nesta instalação".
- No topo, quatro segmentos: Na cidade (a busca), Meus (os próprios anúncios, ou os da Página quando a pessoa age como Página), Salvos (os anúncios salvos neste aparelho) e Buscas (as buscas salvas, veja "Buscas salvas").
- Na cidade, sem estado e cidade lembrados: uma vitrine com o título "Onde você quer comprar e vender?", os estados, o campo Cidade, o botão Ver anúncios e "Como funciona" com quatro passos (Anuncie, Converse, Combine, Avalie). Sem estado e cidade, a folha de localização pede "Escolha o estado e escreva a cidade.". O estado e a cidade ficam guardados só neste aparelho (no navegador, no
localStoragecom a chavevaranda-feira-location; no app, no arquivovaranda-feira-location.jsonna pasta de documentos) e nunca vão para a conta; se não der para guardar, a nota é "Não foi possível lembrar a cidade neste aparelho.". Não há busca no país inteiro: UF e cidade são sempre exigidas. - Na cidade, com cidade: o cabeçalho tem um só campo de busca, com o placeholder Buscar na Feira (o leitor de tela diz Palavras), e dentro dele, à direita, o ícone Filtros (o leitor de tela diz "Filtros"; um ponto marca ordem ou faixa de preço ativas); abaixo vem um chip com a cidade (o leitor de tela lê "Trocar cidade, agora São Paulo, SP") que abre a folha Localização (27 estados e a cidade, Ver anúncios), e uma fileira de discos de categoria de 48 pt, com o nome embaixo (Todas e as categorias da Feira; o selecionado fica escuro, com ícone claro). Categoria e tipo de anúncio são filtros do servidor.
- Os anúncios aparecem numa grade de tiles que vai de borda a borda, com 2 pt entre eles: foto em 4:5 (ou o ícone da categoria), com o preço num chip sobre uma faixa escura embaixo da foto, o título numa linha e o selo (Reservado, Vendido, Procura, "Situação desconhecida") num chip no canto superior esquerdo. A cidade não aparece no tile, mas o leitor de tela a lê. No anúncio de outra pessoa, uma estrela no canto superior direito ("Salvar" ou "Salvo") guarda ou tira o anúncio dos Salvos deste aparelho, a mesma lista do Salvar da tela Anúncio, sem abrir o anúncio; cada toque faz uma só gravação e nada é repetido sozinho. Colunas: 1 abaixo de 360 px ou com texto grande, 2 abaixo de 600 px, 3 abaixo de 900 px; como a casca do app limita o conteúdo a 640 px, o máximo no app é 3. Enquanto carrega, aparecem tiles de esqueleto (nunca em Buscas). Salvar busca continua à mão enquanto há uma busca por cidade.
- A folha Filtros da Feira tem "Ordenar por" (Recentes, Menor preço, Maior preço), "Faixa de preço" (De e Até, com vírgula, por exemplo 10,50) e "Tipo de anúncio". Limpar fica no cabeçalho da folha; De e Até ficam numa linha, cada um com "R$" na frente; Aplicar é o último item da lista, e com o teclado aberto rola-se até ele e um toque aplica. Ordem e faixa só reordenam e filtram os anúncios já carregados; com uma delas ativa, a Feira carrega sozinha até 5 páginas; se ainda há mais páginas, a nota "Ordem e faixa de preço valem para os anúncios já carregados" aparece embaixo da grade. Sem resultado: "Nenhum anúncio por aqui ainda." com Limpar filtros e Trocar cidade; se a cidade pesquisada não é a última que teve anúncios neste aparelho, aparece também Ver anúncios em , , que aplica essa cidade.
- O botão Anunciar é um botão redondo de 56 pt com "+", sobre a grade (o leitor de tela diz "Anunciar"), e abre o formulário por cima das abas, já com o estado e a cidade lembrados. O formulário tem quatro passos (Fotos, O que é, Preço e lugar, Revisão), com uma barra fina de progresso sob a barra do topo (o leitor de tela diz "Passo N de 4") e as ações do passo numa barra embaixo, que sobe acima do teclado: Continuar (ou Publicar anúncio, na Revisão), com Voltar como link de texto abaixo. O passo de fotos usa uma grade de três colunas, com "Capa" na primeira foto e botões nos cantos para remover e reordenar ("Remover foto" mostra "Foto removida." com Desfazer por 8 s, e a foto volta ao lugar de onde saiu; só em Anunciar). O valor tem máscara de centavos e teclado numérico, também em Editar anúncio; cada passo mostra só os próprios erros, e a Revisão mostra uma prévia em tile, a confirmação "Público na web e em buscadores" e Publicar anúncio. O botão voltar do Android e o Escape na web voltam um passo; no primeiro passo, com conteúdo, perguntam "Descartar anúncio?" (Descartar ou Continuar editando). Limite conhecido: o gesto de borda do iOS e o histórico do navegador saem na hora, sem a pergunta. Editar anúncio continua com o formulário único, com a mesma grade de fotos (que também reordena) e Salvar numa barra embaixo. Publicado, o anúncio abre no lugar do formulário (Voltar não volta para o formulário enviado). Se o envio não teve resposta, a tela diz "Não sabemos se o anúncio foi publicado. Confira em Meus anúncios antes de anunciar de novo." A barra mostra Tentar de novo (o mesmo pedido) e Descartar, e nada é reenviado sozinho.
- As linhas vêm do índice do semeador e são só uma dica: a tela Anúncio relê o anúncio do diário de quem anunciou. Depois de um apagamento, uma linha do índice pode mostrar "Situação desconhecida" no lugar do status por cerca de 1 minuto, até o semeador reler o diário.
- Sem rede: "Conecte-se para consultar a Feira.". Índice incompleto: "Alguns anúncios podem faltar. Puxe para atualizar.".
De cima para baixo: fotos (de borda a borda, no alto), preço, título, Compartilhar e Salvar como botões de ícone logo abaixo do título (Salvar é uma estrela, cheia quando salva), a descrição (o título "Descrição" só aparece quando há texto), o status ("Reservado", "Vendido" ou "Encontrado" numa procura; disponível não mostra selo) e o cartão de quem anunciou (avatar e nome; tocar abre o perfil). No nó hospedado, o cartão tem Ver todos os anúncios, que abre a grade de quem anunciou. Sob o nome aparece "Na Varanda desde <mês/ano>", a data do certificado de membro de quem anunciou, lida do bloco 0 público do diário e conferida pelo nó; sem ela (certificado ilegível, emissor revogado ou pessoa bloqueada), a linha some. Não há linhas de nome verificado nem de quem você segue: não têm fonte de dados. Ações:
- Uma barra fixa embaixo da tela tem as ações principais: para quem vê o anúncio, Conversar e, só em produto ou serviço com preço, Fazer oferta; para quem anunciou (ou administra a Página que anunciou), com rede, só Editar. As mensagens de ação ("Link copiado.", erro ao salvar, "Não deu para continuar agora. Tente de novo.") aparecem dentro da barra enquanto ela está na tela. Com texto grande, os botões ficam empilhados, e o fim da tela nunca fica atrás da barra. Num anúncio de Página, a nota da Página aparece uma vez antes de Conversar ou Fazer oferta.
- Conversar abre a conversa direta com quem anunciou (ou com a Página) com um rascunho pronto, por exemplo "Olá! Tenho interesse no seu anúncio "…" na Feira: ", e o cartão do link. Nada é enviado até a pessoa tocar em enviar. Na conversa, um cartão de anúncio tem o botão "Ver anúncio", que abre a tela Anúncio. Um link de anúncio que só aparece dentro de um spoiler não mostra o botão nem vira o anúncio de "Fazer oferta".
- Fazer oferta abre a conversa com quem anunciou e, já aberta, a folha "Fazer oferta" para este anúncio (mesmo que a conversa já tenha o link de outro). Nada é enviado até Enviar oferta; fechar a folha não envia nada, e voltar à mesma conversa não reabre a folha.
- Compartilhar copia ou compartilha o link público do anúncio ("Link copiado.").
- Salvar / Salvo: guarda só neste aparelho.
- Denunciar fica no botão de mais ações da barra do topo, que abre a folha Anúncio com Denunciar em cor de perigo; essa abre a folha de denúncia com o anúncio (veja "Denúncias de anúncio").
- Para quem anunciou (ou administra a Página que anunciou), com rede: os botões de status ("Reservado", "Vendido", "Encontrei" numa procura, e a volta para disponível) e Apagar, que pede "Confirmar: apagar" e avisa que as avaliações do anúncio se apagam com ele e não passam para um anúncio novo. Apagar tira o anúncio do índice e a página pública passa a responder "Anúncio não encontrado".
- Abaixo do anúncio, as avaliações, com a nota "avaliações confirmadas pelo anunciante" (veja "Avaliações").
Editar abre "Editar anúncio" ("Editar anúncio da página" quando a pessoa age como Página): o mesmo formulário de Anunciar, sem trocar o tipo. Título, descrição, valor, unidade, categoria, lugar e fotos mudam; as fotos atuais ficam, saem ou ganham novas, que só sobem no Salvar. Antes da primeira edição a tela avisa: "A primeira versão (título, texto e fotos) continua no seu diário até você apagar o anúncio. A página pública mostra a versão nova.". O link público /f/<diário>/<seq> não muda; a prévia passa a mostrar a versão nova.
- Salvo, a tela volta para o anúncio, que é lido de novo.
- Se outro aparelho editou antes: "Este anúncio mudou em outro aparelho. Recarregue para editar a versão atual.", com Recarregar ("Recarregar traz a versão atual e descarta o que você mudou aqui.").
- Sem resposta, nada é reenviado sozinho: o formulário fica travado com Tentar de novo (o mesmo pedido) e Descartar.
- Só o dono edita: "Só quem publicou este anúncio pode editá-lo.".
Numa conversa que tem o link de um anúncio da outra pessoa, aparece Fazer oferta. A folha "Fazer oferta" pede o Valor (R$) e Enviar oferta manda o link da oferta com o texto (por exemplo "Ofereço …"). Uma Página manda a oferta só como texto com o link, e uma Página responde em texto com o link.
- Quem anunciou vê Aceitar e Recusar na oferta aberta mais recente. Aceitar abre "Aceitar oferta", com o valor e a nota "Ao aceitar, você assina um consentimento que deixa esta pessoa publicar uma avaliação do seu anúncio. Você não escolhe as estrelas, e isso não é um pagamento.", e o botão Aceitar e assinar. A assinatura vai na resposta ("Aceitei sua oferta de …"); Recusar responde "Recusei sua oferta de …".
- A oferta não é um pagamento: o pagamento é combinado entre as pessoas, fora do aplicativo.
- As ofertas existem só na conversa: o estado é lido das mensagens cada vez, e nada fica guardado em outro lugar. Uma oferta, um aceite ou uma recusa sem resposta só é reenviado por Tentar de novo. Um aceite de quem não é o dono do anúncio é ignorado.
Depois de um aceite com a assinatura, só quem fez a oferta vê Avaliar na conversa. A tela Avaliar pede de 1 a 5 estrelas e um "Comentário (opcional)", com a nota "A avaliação fica pública no anúncio. Ela não é prova de pagamento.". Sem resposta, nada é reenviado sozinho ("Não sabemos se a avaliação foi publicada. Confira o anúncio antes de avaliar de novo.", com Tentar de novo e Descartar).
- Uma Página não avalia por enquanto: "Uma página não avalia anúncios por enquanto. Para avaliar, use o seu perfil.".
- Na tela Anúncio e no perfil (Membro), as avaliações vêm com "avaliações confirmadas pelo anunciante" e só aparecem as que o nó conferiu, uma por pessoa e anúncio (a mais nova vale). Uma avaliação sem o consentimento assinado não aparece, nem a de quem entrou na rede há menos de 7 dias (conta a data do certificado de quem avalia, no relógio de quem lê).
Na cidade, com uma busca feita, Salvar busca guarda a busca neste aparelho ("Busca salva neste aparelho."), até 10 ("Você já tem 10 buscas salvas. Remova uma para salvar outra."). O segmento Buscas lista as buscas salvas, cada uma com "N novos" (anúncios novos desde a última vez que a busca foi aberta; "N+ novos" quando a busca tem mais páginas que a contada); sem nenhuma: "Você ainda não tem buscas salvas neste aparelho." com o botão Buscar na cidade, que volta ao segmento Na cidade. A lista de uma cidade marca "N novos desde a última visita" e depois "Anteriores", por cidade e só na ordem Recentes; a primeira visita a uma cidade não marca nada.
- As contagens são feitas ao abrir a Feira, ao voltar ao aplicativo e a cada 15 minutos com o aplicativo aberto em primeiro plano, online e hospedado, no máximo a cada 15 minutos, olhando a primeira página de cada busca, e ficam só no aparelho; offline, ficam as últimas contagens. Não há aviso push nem busca em segundo plano.
- Com alguma busca com anúncios novos, a aba Feira ganha um ponto, que também é atualizado a cada 15 minutos enquanto o aplicativo está aberto, em qualquer aba.
/f/<diário>/<seq>é a página pública do anúncio, servida pelo semeador: abre no navegador, sem conta, com título, preço, cidade e fotos, e com as etiquetas OpenGraph, então um aplicativo de mensagens mostra a prévia. É indexada por buscadores enquanto o anúncio está disponível ou reservado; um anúncio vendido mantém a página, comnoindex, e sai dositemap.xml. O botão da página é "Entrar para conversar" ("Entrar para oferecer" numa procura)./anuncio/<diário>/<seq>é o mesmo anúncio dentro do app: é para onde aquele botão leva. Na web hospedada, o app lê/anuncio/…(e também/f/…, quando chega até ele) uma vez ao carregar, limpa a barra de endereço para/e guarda o anúncio na aba (sessionStorage, chavevaranda-feira-listing, no máximo 1 h), para ele sobreviver ao Google, aos Termos e à configuração. Com as abas na tela, a tela Anúncio abre uma vez; nada é enviado nem seguido sozinho.- No app instalado,
varanda:///anuncio/<diário>/<seq>e os links https/anuncio/…e/f/…da própria instalação abrem a tela Anúncio quando as abas aparecem. Um link de outro domínio é descartado. - Com o app instalado, um link
/anuncio/…da instalação abre direto no app: no Android pelos App Links (verificados peloassetlinks.json), no iOS pelos links universais, depois que a instalação publica oapple-app-site-associationcomapplinks. A página pública/f/…continua no navegador, para manter a prévia; ela mostra também "Já tem o app? Abrir no app", que leva avaranda:///anuncio/<diário>/<seq>, porque o iOS mantém no Safari um toque num link do mesmo site. - O link que Compartilhar usa é sempre o público,
<origem da instalação>/f/<diário>/<seq>, com o número do anúncio original: uma edição troca o conteúdo, o link continua o mesmo.
Quem chega por um link de anúncio sem conta vê no Entrar o cartão "Anúncio da Feira" com "Entre para falar com quem anunciou.". Quando a instalação liga as entradas da Feira e a rede é por convite, o cartão mostra o botão Pedir entrada: só esse toque pede ao serviço de conta um código de entrada (nunca sozinho, nunca repetido; uma falha passageira mostra Tentar de novo), cobrado das entradas semanais de quem anunciou só quando o código é usado, e o cadastro segue como sempre; numa rede aberta nenhum código é pedido. Com a verificação de idade ligada, Pedir entrada aparece primeiro no passo da idade, porque a verificação já pede o código; com o código da Feira, o app abre a verificação pela rota própria da Feira (POST /account/feira/idade, o mesmo pedido, com limite por endereço na borda), e um limite dessa rota mostra "Muitas tentativas de verificação. Tente de novo amanhã.". O anúncio só abre no fim, quando as abas aparecem. Se as entradas de quem anunciou acabaram: "Quem anunciou não tem mais entradas nesta semana. Peça um convite a alguém da rede ou tente na próxima semana.". Com as entradas da Feira desligadas e a rede por convite: "Entre para falar com quem anunciou. Por enquanto, entrar pede um convite: peça um link a alguém da rede.". Um anúncio apagado ou com a Feira desligada: "Este anúncio não abre uma entrada agora: ele saiu do ar ou a Feira está desligada.".
Quem age como Página (o seletor de Publicar) anuncia em nome dela, e "Meus" mostra os anúncios da Página. Conversar com um anúncio de Página abre a conversa com a Página; na primeira vez para aquela Página (por conta na instalação hospedada com vistos sincronizados, desbloqueada e com os Termos aceitos; por aparelho nos demais casos), vem antes a mesma folha do perfil dela, "Conversar com a página", que explica que as mensagens ficam cifradas entre a pessoa e os aparelhos administradores, e traz "Continuar" e "Cancelar". Se a dona ainda não ativou as Conversas, as mensagens só são lidas depois que ela ativa (e se perdem depois de 14 dias); os administradores leem depois de receberem a chave por Enviar chave. A caixa da Página guarda o cartão do anúncio que o membro mandou, e uma mensagem não coletada por nenhum aparelho administrador em 14 dias se perde.
"Denunciar" na tela Anúncio abre a mesma folha das outras denúncias, com o título do anúncio; a denúncia vai sempre para uma pessoa da moderação (a IA não decide anúncios). No painel de moderação ela aparece como "anúncio", com o filtro "Anúncios", o link da página pública e "Ver anúncio".
Com a Vitrine (EXPO_PUBLIC_VARANDA_VITRINE=1, veja development.md), a aba Feira aparece com anúncios de exemplo (produtos, um serviço, uma procura e um anúncio de Página, um deles editado), uma conversa com uma oferta aceita e avaliações (uma delas com um consentimento inválido, que não aparece), para capturas de tela, sem conta. Os dados estão em apps/app/src/vitrine/fixtures.js.
No perfil de um membro ou de uma Página (nó hospedado), a linha "Anúncios" (com ícone e seta, acima das abas) abre a lista dos anúncios daquela pessoa ou Página, na mesma Feira, sem abas, filtros nem o botão Anunciar. Anúncio vendido ou velho continua na lista com o selo; autores bloqueados não aparecem. Sem anúncios, a tela diz "Nenhum anúncio por aqui.".
- Numa conversa da Página (agindo como Página), o cartão de um anúncio aparece sem a miniatura: o app ainda não lê as fotos da caixa da Página.
- Depois de um apagamento, uma linha do índice pode mostrar "Situação desconhecida" por cerca de 1 minuto, até o semeador reler o diário.
- Editar anúncio, propostas, avaliações, alertas de busca salva e os links no app nativo são conferidos em
docs/verification.mdseção 133; os passos desta etapa estão na seção 132.
- Salas de áudio ao vivo (Comunidades): pedem transmissão em tempo real entre aparelhos. Os grupos de texto estão na seção Comunidades, no nó hospedado (site e app instalado).
- Selo Gente da Gente: pede critério para "construtivo" e quem concede.
- Denúncias, Espiadinha, Avisos e Conversas no app com configuração manual e com o
varanda-serve: hoje só a versão web hospedada e o app instalado com a instalação oferecem a Espiadinha, os Avisos e as Conversas (mensagens privadas e Comunidades) e denunciam (de A Rua, Espiadinha, Conversa, Membro, Seguindo e Mensagens). - Avisos do sistema (push) e publicação nas lojas no app instalado: fora desta etapa (issues #30, #47 e #46).
Os pontos em aberto de cada um estão em design.md.