Transcrição Segmentação

Cliente comum usado por cifila e mdcfila para enviar mídia à API de transcrição/segmentação e devolver transcrições ao sistema de origem.

O mesmo commit deve ser implantado nos dois ambientes. Diferenças entre os hosts ficam exclusivamente no arquivo .env, na quantidade de instâncias systemd e nos nomes dos servidores passados a events-server.py.

Processos

• events-server.py <server>: identifica arquivos dos programas e insere a fila local.
• send_files.py: envia URLs públicas para /v1/segmentation/receive_url_file_program.
• get_transcriptions.py: recebe transcrições e atualiza/entrega os dados no ambiente local.

get_transcriptions.py não confirma status na API Beta. O próprio endpoint get_transcriptions move arquivos com program_id > 0 para queue_segmentation, permitindo que o nó de segmentação os processe.

Configuração

Copie .env.example para .env e preencha os valores do ambiente. Nunca versione .env. As diferenças esperadas incluem OWNER_ID, diretórios, servidor público de arquivos, proxy, credenciais e quantidade de workers.

O proxy é opcional e configurado por HTTP_PROXY_URL. Uploads MP4 podem usar um timeout separado através de MP4_REQUEST_TIMEOUT.

Serviços

Os templates em services/ assumem uma virtualenv em /opt/transcricao-segmentacao/venv:

systemctl enable --now transcricao-events-server@NOME.service
systemctl enable --now transcricao-get-transcriptions@1.service
systemctl enable --now transcricao-send-files.service

Crie quantas instâncias de get-transcriptions forem necessárias em cada host. O código e o commit implantado devem permanecer iguais.

Validação

python -m py_compile config.py events-server.py get_transcriptions.py send_files.py
rg "update_transcription_status" .
git status --short