VPS 4 Builder
57 lines
3.2 KiB
Markdown
57 lines
3.2 KiB
Markdown
# newwhats.clube67.com — Tarefas / Pendências (checklist)
|
||
|
||
> Lista mestra de pendências do motor ↔ satélites. Sincronizada com a task list
|
||
> da sessão. Atualizar marcando `[x]` ao concluir e mover detalhes para a doc de
|
||
> estado correspondente. Última revisão: 28/jun/2026.
|
||
|
||
## Regra de ouro (registro bidirecional)
|
||
- Cada **plugin satélite é único do projeto onde está instalado** (ex.: o
|
||
`newwhats` do `mercado.clube67.com` ≠ o de outro projeto).
|
||
- **Toda mudança no plugin deve ser registrada no motor, e toda mudança no motor
|
||
que afete o contrato deve ser registrada em cada plugin.** Ver
|
||
[integracao-satelites.md](integracao-satelites.md) (contrato central) e o
|
||
`INTEGRACAO-MOTOR.md` dentro de cada plugin.
|
||
- O **plugin é um braço inteligente do motor** — não duplica lógica; consome,
|
||
alimenta e configura o motor.
|
||
|
||
## Integração satélite ↔ motor (faseado)
|
||
- [x] **Fase 1** — Contrato documentado (`integracao-satelites.md`).
|
||
- [x] **Fase 2** — Compatibilidade de API: alias `GET /secretaria/numbers` no ext-api.
|
||
- [ ] **Fase 3** — Validar config/conexão (`newwhats_url`, `integration_key`,
|
||
`api_token`, `webhook_secret`) do satélite → motor (dev/prod) + HMAC do webhook.
|
||
_Bloqueado: requer credenciais reais._
|
||
- [ ] **Fase 4** — Rodar `sync-knowledge` end-to-end (satélite → motor) e validar RAG.
|
||
_Bloqueado: requer satélite rodando + Fase 3._
|
||
- [ ] **Fase 5** — Satélite consumir `messages.transcription` do motor e **remover
|
||
`media-transcribe.js`** redundante. Unificar fonte da chave Gemini
|
||
(`cfg.gemini_key` vs `process.env.GEMINI_API_KEY`).
|
||
|
||
## Wasabi / mídias
|
||
- [x] Upload fire-and-forget + proxy público de leitura (avatares e mídias).
|
||
- [x] `StorageProvider.deletePrefix(prefix)` (delete por prefixo).
|
||
- [x] **Index de mídias** — `GET /api/instances/:id/media-index` (chat/tipo/período,
|
||
byType, paginado). Ver [wasabi-midias.md](wasabi-midias.md).
|
||
- [x] **Delete em lote** — `POST /api/instances/:id/media-batch-delete`, coordenado
|
||
**DB ↔ Wasabi**, dryRun por padrão + `deleteObjects` em lote.
|
||
- [ ] Index por tamanho (bytes) — falta coluna `mediaSize`.
|
||
- [ ] Reconciliação DB ↔ bucket (achar órfãos).
|
||
- [ ] Política de retenção (arquivar/descartar áudio após transcrição salva).
|
||
|
||
## Ativação do WhatsApp (trajeto inteligente)
|
||
- [ ] Transformar `POST /` + `POST /:id/connect` em um **trajeto guiado e idempotente**
|
||
que cria e configura a conta no motor automaticamente (instância, pair/tenant,
|
||
setor + secretária default, webhook, engine, detecção Business). Ver
|
||
[ativacao-whatsapp.md](ativacao-whatsapp.md). O satélite orquestra como braço do motor.
|
||
|
||
## Inbox / Secretária (já entregue nesta frente)
|
||
- [x] Transcrição/descrição no motor (Gemini) → `messages.transcription`.
|
||
- [x] Exibição da transcrição no inbox (🎤 áudio / 👁 imagem) + socket `message:transcription`.
|
||
- [x] Memória de longo prazo por contato (`sec_contact_memory`).
|
||
- [ ] Ritmo humano da Secretária (typing + delay + quebra em 2–3 msgs).
|
||
- [ ] Resposta em áudio (TTS) — opcional.
|
||
|
||
## Validações pendentes de ambiente
|
||
- [ ] Pareamento do WhatsApp dev (avatares/fixados) quando o aparelho voltar.
|
||
</content>
|
||
</invoke>
|