SAILE Music — Pacote de Engenharia e Biblioteca de Skills

Versão: 1.0.2
Data-base: 2026-08-05
Status: arquitetura, banco e implementação de referência prontos para desenvolvimento

Este pacote define a engenharia de um aplicativo de música para Android mobile/tablet, Android TV, Amazon Fire TV/Firestick e Web/PWA, apoiado por um Media Gateway Python.

Decisões centrais

• yt-dlp executa somente no Gateway.
• Reprodução usa HTTP progressivo com Range, buffer e cache.
• Fire TV/Firestick é streaming-only, sem download offline persistente.
• O Gateway aceita no máximo dez usuários cadastrados.
• SQLite guarda contas, Argon2id, sessões, ownership, playlists e outbox.
• Um repositório GitHub privado recebe automaticamente apenas snapshots JSON versionados dos metadados de playlists.
• Senhas, e-mails, tokens, cookies, banco SQLite, áudio e URLs efêmeras nunca são sincronizados.

Android / Fire TV / Web PWA
            |
        HTTPS / LAN
            |
     SAILE Media Gateway
  Auth + SQLite + yt-dlp + player jobs
            |
   outbox transacional / worker serial
            |
 Repositório GitHub privado de metadados

Implementação entregue nesta versão

O diretório reference/gateway_sync contém código executável para:

• trigger SQLite que rejeita a 11ª conta;
• cadastro e autenticação Argon2id;
• isolamento de playlists por usuário;
• bloqueio de downloads em Android TV e Fire TV no banco;
• outbox transacional;
• exportador JSON canônico com SHA-256;
• cliente GitHub Contents API;
• worker automático de sincronização;
• validação por JSON Schema;
• testes unitários e de integração.

Comece aqui

1. Leia START_HERE.md.
2. Leia ENGINEERING_CONSTITUTION.md.
3. Leia SAILE_MUSIC_MASTER_SPEC.md.
4. Leia os ADRs em docs/10-adr, especialmente ADR-0006.
5. Para contas e sync, abra skills/17-user-accounts-github-sync.md.
6. Execute os testes da referência.

cd reference/gateway_sync
python -m pip install -r requirements.txt
PYTHONPATH=. python -m unittest discover -s tests -v

Estrutura relevante

saile_music_engineering_pack/
├── contracts/github-metadata/       # schemas dos snapshots
├── metadata/v1/manifest.json        # manifesto inicial vazio
├── reference/gateway_sync/          # implementação executável
├── docs/01-architecture/
├── docs/03-data/
├── docs/10-adr/
├── skills/
└── .github/workflows/               # validação dos metadados

Limite legal e de plataforma

O produto não deve copiar layout, marca ou identidade visual do YouTube Music. O uso de yt-dlp, cache e download deve ficar restrito a conteúdo que o usuário tenha autorização para acessar e armazenar. Não implemente bypass de DRM, paywall, login, restrição regional ou controles de acesso.

Resultado esperado do MVP

Até dez usuários conseguem entrar, manter playlists privadas, reproduzir em Android, Web e Fire TV e receber sincronização automática dos metadados pelo Gateway. Download offline confiável existe no Android mobile/tablet; Fire TV permanece sem download.