Funcionalidade community_public - BrunodosSantosVaz/big-bang GitHub Wiki
Comunidade e painéis públicos
Funcionalidade BB-F-005 · requisito RF-BB-005 · versão documentada 3.0.1 · código 21eebbb0dab96eaee455ec4a6e291384dc1e81c5.
Finalidade
Publicar as boas-vindas da IA sem duplicação e tornar painéis públicos somente após auditoria do conteúdo.
Atores
Pessoa responsável pelo projeto, IA com posse confirmada e automações explicitamente autorizadas.
Pré-condições
Repositório e raiz corretos, versão instalada e configuração compatível. Para operações de escrita, exige-se autorização vigente, branch adequada e acesso ao recurso envolvido; consultas não conferem permissão adicional.
Fluxo principal
Consultar Discussions e seu marcador; criar o post na categoria real quando ausente; auditar os cards e campos; mudar somente public; conferir acesso anônimo read. Auditar títulos, vistas, nomes/opções de campos e valores tipados; tipos sem suporte ou paginação incompleta bloqueiam publicação. Recém-criado vazio só recebe recibo automático com título autorizado e dados padrão; privado existente sempre exige recibo atual.
Validações
Rascunhos e itens privados ou ocultos bloqueiam publicação; conteúdo existente exige recibo correspondente ao digest atual.
Alternativas e erros
Acesso negado, categoria ausente, paginação não auditada ou papel anônimo diferente de leitura tornam a validação inconclusiva ou reprovada.
Permissões
Leitura usa permissões mínimas do repositório. Operações locais respeitam a posse e worktree; escrita no GitHub exige acesso explícito. Esta funcionalidade não concede novas permissões a visitantes nem substitui decisões exigidas pelo fluxo.
Resultados
Resultado esperado: Publicar as boas-vindas da IA sem duplicação e tornar painéis públicos somente após auditoria do conteúdo. O retorno e os arquivos afetados são conferidos pelos cenários rastreados abaixo; falha impede considerar a operação concluída.
Projetos v3 usam um único quadro público: a chave paineis.quadro da configuração de comunidade substitui as três chaves planejamento, execucao e bugs, e a validação lê anonimamente só esse quadro. O formato anterior com três painéis continua aceito para sistemas que ainda o usam. O quadro único precisa estar público (somente leitura) depois da auditoria do conteúdo.
Referência da implementação
Os símbolos abaixo compõem o inventário real do módulo, incluindo auxiliares internos; não representam APIs públicas independentes.
community_public.py
| Símbolo | Linha |
|---|---|
discussion_state |
38 |
welcome |
59 |
enable_discussions |
92 |
project_state |
96 |
_nested_flag |
119 |
audit_created_project |
127 |
audit_digest |
148 |
anonymous_project |
152 |
ensure_public_project |
176 |
verify |
199 |
payload |
162 |
Cenários e rastreabilidade
.bigbang/tests/test_community_public.py:test_first_post_is_created_in_real_repository_category.bigbang/tests/test_community_public.py:test_existing_welcome_is_not_reposted.bigbang/tests/test_community_public.py:test_disabled_discussions_is_diagnostic_not_silent_success.bigbang/tests/test_community_public.py:test_anonymous_reader_cannot_edit_public_board.bigbang/tests/test_community_public.py:test_anonymous_editor_or_login_redirect_blocks_validation.bigbang/tests/test_community_public.py:test_new_empty_public_project_can_be_published.bigbang/tests/test_community_public.py:test_unknown_field_value_stops_audit_without_mutation.bigbang/tests/test_community_public.py:test_creation_audit_rejects_nondefault_options_and_title.bigbang/tests/test_community_public.py:test_draft_or_private_item_is_never_published.bigbang/tests/test_community_public.py:test_existing_text_requires_reviewed_audit_before_becoming_public.bigbang/tests/test_community_public.py:test_empty_existing_board_with_sensitive_custom_field_needs_audit.bigbang/tests/test_community_public.py:test_single_board_reads_only_that_board.bigbang/tests/test_community_public.py:test_three_board_layout_still_reads_all_three
Requisitos · Matriz de rastreabilidade · Referência CLI