Ícone La Craia LA CRAIA :: BANCADA v0.2.0-dev • GPLv3+ • SISTEMA DISSIDENTE [ 🚀 COCKPIT WEB ]
SISTEMA: ALIMENTADO SIMBIOSE: ENGATADA GANHO: 11 (OVERDRIVE)
CADERNO DE MONTAGEM DO PAREDÃO • ZINE TÉCNICO DE CAMPO

LA CRAIA

Streaming por Grafo de Afinidade & HUD Simbiótico de Letras

Documentação unificada do ecossistema La Craia. Uma máquina de som de guerrilha, fora dos silos corporativos, combinando reprodução gapless com pre-caching preditivo em Debian, bancada web colaborativa e companion flutuante universal.

Caderno 01: Por Que La Craia Existe

Streaming de música não é um problema resolvido. É um problema sequestrado. As plataformas dominantes monetizam o tempo de atenção do ouvinte como produto, enquanto enterram a autonomia sonora sob camadas de algoritmo treinado para maximizar permanência na plataforma — não a qualidade da experiência de quem ouve. La Craia é a resposta de bancada a esse sequestro.

[ PROBLEMA 01: ALGORITMO CORPORATIVO ]

Curadoria como Prisão

Spotify, YouTube Music e similares recomendam músicas que maximizam cliques patrocinados e permanência na plataforma. O gosto do ouvinte é calibrado pelo interesse comercial de gravadoras e anunciantes, não pela afinidade acústica real entre faixas.

[ PROBLEMA 02: DEPENDÊNCIA DE CONECTIVIDADE ]

Silêncio nos Túneis e Quedas de Rede

Serviços de streaming comerciais exigem conexão constante. Em estradas serranas, festas de campo e zonas sem cobertura, a música simplesmente para. La Craia pré-cacheia faixas por antecipação contínua e opera 100% offline no disco local quando necessário.

[ PROBLEMA 03: POLUIÇÃO VISUAL E FRICÇÃO ]

Interfaces Invasivas

Serviços comerciais foram desenhados para capturar a atenção com banners e publicidade. La Craia Simbiótyka projeta a letra sincronizada de forma limpa, direta e flutuante sobre qualquer aplicativo ou reprodutor, sem atrito e com autonomia total.

📡 [ TRANSMISSÃO DE CABINE ]
La Craia não é um produto corporativo. É uma ferramenta de uso pessoal e comunitário, construída com ódio de algoritmo vigilante e paixão pelo som livre que toca nas ruas, festas, casas e estradas. Software Livre GPLv3+ — o código é seu para estudar, modificar e redistribuir.
[ PRINCÍPIO 01: SOBERANIA ACÚSTICA ]

Grafo Próprio, Sem Telemetria

O motor de similaridade acústica roda em SQLite local no servidor central. Nenhum dado de escuta é enviado para servidores de terceiros. O grafo é seu, cresce com sua escuta e funciona sem internet.

[ PRINCÍPIO 02: ZERO DISTRAÇÃO ]

HUD Simbiótico, Não Invasivo

O companion Android intercepta a mídia silenciosamente e projeta apenas o necessário: a letra exata, no milissegundo exato, com duck automático de volume quando o GPS fala. Sem notificações, sem banners, sem friction.

[ PRINCÍPIO 03: AUTONOMIA TOTAL ]

Self-hosted, Self-sufficient

Backend roda em qualquer Debian/Ubuntu com cargo run. Sem subscriptions, sem APIs pagas obrigatórias, sem rastreamento. Se o servidor Linux tiver disco e CPU, La Craia funciona para sempre.

✨ [ O PULO DA TRAVESTI ]
La Craia é software de guerrilha com acabamento de produção. Brutal na estética, preciso na engenharia. O mesmo cuidado que foi para o algoritmo de similaridade foi para a textura de compensado naval no CSS. Uma máquina visivelmente remendada que funciona melhor do que a alternativa polida.

Caderno 02: Arquitetura do Paredão (lacraia-core)

O servidor central opera em host Linux (Debian/Ubuntu). Ele combina banco SQLite local com grafo de adjacência de similaridade acústica, motor de resolução e streaming nativo em Opus com suporte a HTTP Range Requests (206 Partial Content).

[ COMPONENTE 01 ]

Grafo em SQLite

Tabelas tracks e similarity_edges armazenam conexões ponderadas. Toda busca em fontes online é gravada localmente para alimentar autonomia futura.

[ COMPONENTE 02 ]

Queue Daemon

Loop em background assegura que as próximas 2 faixas do grafo estejam 100% resolvidas e cacheadas em disco antes do término da música atual.

[ COMPONENTE 03 ]

Streaming Opus 206

Servido em /cache/{id}.opus permitindo seek instantâneo com zero transcodificação adicional no momento da reprodução.

🦂 [ VENENO NA CARNE ]
O higienizador acústico expurga áudios com divergência de tempo excessiva (>15s) ou com títulos adulterados por gravações piratas de celular em shows. O filtro garante apenas gravações originais de estúdio.
⚡ [ FIO DESENCAPADO ]
Se a van entrar em túneis ou trechos serranos sem sinal 4G/5G, o Queue Daemon recua imediatamente para o grafo local, assegurando zero segundos de silêncio na cabine.
[ BASH :: COMPILAÇÃO E DISPARO DO CORE ]
# Disparar o orquestrador com cache persistente e porta configurada:
PORT=8080 LACRAIA_CACHE_DIR=/var/cache/la-craia cargo run -p lacraia-core

Caderno 03: La Craia Simbiótyka (Android HUD)

Micro-aplicativo Android em Kotlin estruturado como Foreground Service desacoplado. Não possui activity persistente e não interfere na tela cheia do condutor.

[ CAPTURA SIMBIÓTICA ]

MediaSession Listener

Intercepta metadados e posições de milissegundos de qualquer reprodutor do sistema operacional sem exigir modificação no player original.

[ SEGURANÇA VEICULAR ]

GPS Audio Ducking

Atenua automaticamente a música para 20% do volume quando Waze ou Google Maps emitem comandos de voz na rodovia, restaurando suavemente em seguida.

[ FLOATING PILL ]

Overlay 56dp no WindowManager

Pílula flutuante translúcida com botões táteis (≥48dp) e letra sincronizada milissegundo a milissegundo logo acima dos alertas de trânsito.

✨ [ O PULO DA TRAVESTI ]
Toda letra capturada via LRCLIB é armazenada no SQLite do telefone. Ao repetir a mesma canção em estradas isoladas, a sincronização milissegunda ocorre com zero latência e sem gastar franquia de dados móveis.

Caderno 04: Protocolo de Sincronia WebSocket

Quando o som principal toca na central fixa (servidor Linux / Debian) e smartphones ou tablets atuam como controle e HUD, o endpoint /ws orquestra a comunicação bidirecional em JSON.

📡 [ TRANSMISSÃO DE CABINE ]
O broadcast STATE_UPDATE pulsa a cada 1000ms transmitindo estado, posição atual em ms e flag de letra. Ao plugar um novo tablet, o servidor entrega o snapshot de imediato no primeiro frame.
[ JSON :: TELEMETRIA EMITIDA PELO SERVIDOR ]
{
  "type": "STATE_UPDATE",
  "payload": {
    "track": {
      "id": "trk_01",
      "title": "Rebel Rebel",
      "artist": "David Bowie",
      "durationMs": 274000
    },
    "playback": {
      "state": "PLAYING",
      "positionMs": 35200
    },
    "hasLrc": true
  }
}

Caderno 05: Zine de Campo, Tooling & Roadmap

Bancada de comandos operacionais para teste local, script de automação única e o mapa de evolução da suíte automotiva.

✨ [ O PULO DA TRAVESTI ]
Para orquestrar o backend com banco populado, fila antecipada engatada e o navegador aberto no painel de controle com uma única instrução, basta disparar ./demo.sh --open.
[ BASH :: DISPARO DA DEMONSTRAÇÃO COMPLETA ]
# Clonar e iniciar o backend com seeding automático e painel no navegador:
git clone ssh://git@codeberg.org/lumenpink/lacraia.git
cd lacraia
./demo.sh --port 8080 --open
[ BASH :: COMPILAÇÃO LINUX DESKTOP NATIVO ]
# Executar o player Dioxus compilado como binário nativo WebKitGTK no Linux:
cargo run -p lacraia-app --features desktop
⚡ [ FIO DESENCAPADO ]
Todas as operações de versionamento, commits atômicos pareados e auditoria do repositório devem seguir rigorosamente o padrão cccp: nunca invoque git commit diretamente.

Caderno 06: Manual de Identidade Visual

A estética de La Craia nasce da colisão entre o exoesqueleto segmentado do quilópode, a performance histórica e debochada de Lacraia nos palcos do funk dos anos 2000, e a gambiarra engenhosa dos paredões de som em compensado naval. O visual não é um "tema bonitinho" — é uma máquina de som furiosa, viva e visivelmente remendada.

📡 [ TRANSMISSÃO DE CABINE ]
A interface gráfica não simula vidro translúcido nem papel polido. Ela reproduz a textura áspera da chapa de aço com pintura bate-pedra, compensado naval cortado no serrote e fita isolante amarela remendando a fiação exposta.
Lacraia · Patrona do Paredão ARTE OFICIAL · RETÍCULA HALFTONE
👑 [ A PATRONA: LACRAIA (1977–2011) ]

A aplicação La Craia presta homenagem a Lacraia (1977–2011), lendária dançarina, performer, DJ de música eletrônica e ícone travesti negra e periférica que revolucionou os palcos do funk carioca e a televisão brasileira com MC Serginho.

Com saltos acrobáticos, figurinos em cetim fluorescente e uma alegria radical e inegociável, ela desafiou o preconceito e abriu caminhos para a dissidência de corpos periféricos. O software La Craia herda sua audácia: autonomia sonora, velocidade bruta e liberdade absoluta.

Tokens Cromáticos Oficiais

--madeira-compensado #2b1d14 • Carcaça Base
--ferro-bate-pedra #151618 • Módulo Chassi
--fucsia-furacao #ff0055 • Choque de Palco
--veneno-eletrico #d4ff00 • Pata de Lacraia
--alta-voltagem #ffb700 • Atenção de Bordo
--glitter-roxo #8000ff • Deboche Noturno
--fio-massa-verde #00ff66 • LED OK
--curto-circuito #ff2200 • Pico / Clipping
Potenciômetro de Ganho
11.0 / 11 (MÁXIMO)
"Não paramos no 10. Quando a máquina exige potência bruta na rodovia, a escala é empurrada para além do limite de fábrica."
🦂 [ VENENO NA CARNE ]
O Manual de Identidade Visual completo, incluindo as regras de micro-assimetria dos switches, as texturas de compensado, os callouts e as diretrizes de tipografia, está disponível em docs/design-system.md no repositório.