# 📋 Escopo do Trabalho – Log/Auditoria no Jitsi (Prosody)
## Objetivo
Desenvolver e configurar um **módulo de auditoria para Jitsi/Prosody**, que registre de forma confiável **quando cada usuário entra e sai de uma sala**, incluindo:
* Nome do usuário (displayName configurado na interface Jitsi)
* Sala em que entrou/saiu
* Data e hora de entrada
* Data e hora de saÃda
Esses dados deverão ser registrados em arquivo de log e/ou enviados para um endpoint http/rest (caso possÃvel), de forma a possibilitar auditoria posterior.
---
## Escopo Detalhado
1. **Ambiente**
* Jitsi Meet rodando via **docker-compose**, com os serviços `web`, `prosody`, `jicofo` e `jvb`.
* Customizações devem ser feitas preferencialmente no container **Prosody**, que é responsável por gerenciar presença dos usuários.
2. **Requisitos de Auditoria**
* Capturar os eventos de **entrada e saÃda** de cada participante das salas (MUC).
* Associar o **displayName** (nome digitado pelo usuário no join da conferência) sempre que disponÃvel.
* Gravar em log no formato:
```
2025-09-11 15:20:10 [JOIN] room=sala1 user=Maria
2025-09-11 15:45:42 [LEAVE] room=sala1 user=Maria
```
* Logs devem ficar disponÃveis em volume mapeado do Docker (`./Config/prosody/logs/`).
3. **Implementação Técnica**
* Desenvolvimento de um **módulo customizado do Prosody (Lua)** que utilize os hooks:
* `muc-occupant-joined`
* `muc-occupant-left`
* Extração do campo `<nick>` ou `<displayName>` da presença XMPP.
* Escrita em arquivo de log **ou** integração via http post para api externa (opcional, se for viável).
4. **Entregáveis**
* Código do módulo Lua (`
mod_audit_log.lua`) funcionando.
* Ajustes na configuração do Prosody (`
jitsi-meet.cfg.lua` ou `
custom.cfg.lua`) para carregar o módulo.
* Instruções claras de instalação e uso (README).
---
## Diferenciais
* Experiência prévia com **custom modules no Prosody**.
* Experiência com **Jitsi Meet (Docker)**.
* Conhecimento em XMPP (presença e MUCs).
---
Atualmente nosso docker composer utiliza as seguintes versões:
image: jitsi/web:stable-8719
image: jitsi/prosody:stable-8719
image: jitsi/jvb:stable-8719
image: jitsi/jicofo:stable-8719
Contexto Geral do Projeto
Atualmente utilizamos o jitsi para conferencias em nossa plataforma, porém sem log de auditoria. Agora precisas implentar esse log de auditoria no jitsi.
Prazo de Entrega: Não estabelecido