Skip to content

refactor: migrate custom Python test tooling to PHP - #19

Merged
YvesCesar merged 3 commits into
mainfrom
refactor/php-native-test-suite
Nov 19, 2026
Merged

YvesCesar merged 3 commits into
mainfrom
refactor/php-native-test-suite

Conversation

@vitormattos

Copy link
Copy Markdown
Member

Objetivo

Padronizar em PHP o codigo proprio de testes e utilitarios do repositorio, preservando Ansible/YAML e o Python interno necessario ao Ansible. Nenhuma mudanca de producao, inventario ou deploy.

Alteracoes

  • Substitui os cinco arquivos Python proprios por PHP (protecoes de credenciais, isolamento de tenant, testes da role Talk e WebRTC), sem deixar arquivos .py rastreados.
  • PHPUnit com testes unitarios e de integracao; Composer, Psalm, PHPStan, PHPCS e Infection como ferramenta opcional.
  • Verificador de segredos preserva teste de commits intermediarios e nunca relata valores.
  • Mailcow: templates sao renderizados pelo proprio Ansible; validacoes em PHP; testes offline em PHP 8.4 e 8.5 preservados.
  • Talk: testes PHPUnit reproduzem verificacoes de seguranca, topologia Docker, idempotencia, validacao negativa, Coturn e reconexao de sinalizacao.
  • WebRTC: biblioteca danog/php-rtc-webrtc, dois participantes Janus, ICE/DTLS/SRTP, frame Opus e keyframe VP8 real; valida recepcao de audio/video e payloads.
  • CI por arquivo com QA PHP e integracao isolada de Janus/Coturn, sem host de cliente.

Validacao local

  • composer qa: passou (23 testes, 2.372 assertions, Psalm, PHPStan, PHPCS).
  • bash roles/nextcloud-mailcow-provision/tests/check.sh: passou em PHP 8.4/8.5, renderizacao Ansible e runner E2E.
  • PHPUnit suite Talk com RUN_HPB_INTEGRATION=1: passou (12 testes, 58 assertions).
  • Teste WebRTC real com PHP 8.4 em Docker isolado: WEBRTC_AUDIO_VIDEO_MEDIA_PASS, 8 quadros de audio e 12 de video, peers connected; os payloads conferem.
  • Scanner de credenciais e git diff --check: passaram.
  • Commit assinado com GPG e DCO.

Limites e revisao

  • Nao houve deploy nem homologacao em host de cliente. O runner PHP depende de dependencias Composer apenas no ambiente de testes.
  • O codigo PHP legado da role Mailcow continua implantado como scripts autocontidos. Seus testes de contrato existentes estao integrados ao PHPUnit; o proximo trabalho separado pode extrair regras para classes PSR-4 e ampliar a analise estatica do legado, sem mudar o comportamento em producao.
  • Conferir CI do PR antes de merge. Merge nao autoriza deploy.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
…de standards

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@YvesCesar
YvesCesar self-requested a review November 18, 2026 19:27

@YvesCesar YvesCesar left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@vitormattos . Deixei alguns pontos de revisão, pode dar uma olhada?

Comment thread tests/Talk/Media/MediaCollector.php Resolved
Comment thread tests/Unit/SecretLiteralGuardTest.php Resolved
Comment thread composer.json Resolved
Comment thread docs/static-credential-guard.md Resolved
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@YvesCesar
YvesCesar merged commit f7180ca into main Nov 19, 2026
19 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants