Sothis/omnichannel-backend
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

DOCS: Atualizado dodoumentação pós criação de novo modulo

Rafael Alves Lopes 2026-05-29 17:04:26 -03:00
parent 71c88513c6
commit b38ac11dcd
2 changed files with 40 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
Admin.md

@ -20,6 +20,8 @@ Sustenta o painel administrativo e parte do painel supervisor:
- areas/especialidades; - areas/especialidades;
- conteudos da IA. - conteudos da IA.
O fluxo do agente virtual e a configuracao de triagem ficam no modulo `knowledge-base`, mantendo o prefixo `/admin/knowledge` por compatibilidade.
## Endpoints principais ## Endpoints principais
| Metodo | Rota | Perfis | Descricao | | Metodo | Rota | Perfis | Descricao |

21
Knowledge-Base-e-Agente-Virtual.md

@ -2,10 +2,14 @@
Base tecnica: Base tecnica:
- Controller: `src/modules/admin/knowledge-base.controller.ts` - Module: `src/modules/knowledge-base/knowledge-base.module.ts`
- Service: `src/modules/admin/knowledge-base.service.ts` - Controller: `src/modules/knowledge-base/knowledge-base.controller.ts`
- Service: `src/modules/knowledge-base/knowledge-base.service.ts`
- Repository: `src/modules/knowledge-base/repositories/knowledge-base.repository.ts`
- Prefixo: `/admin/knowledge` - Prefixo: `/admin/knowledge`
O modulo fica separado de `admin` porque a responsabilidade principal nao e administracao de usuarios, e sim configuracao do agente virtual. O prefixo HTTP foi mantido para nao quebrar o frontend e as rotas ja documentadas.
## Responsabilidade ## Responsabilidade
Permite configurar o fluxo do Agente Virtual Sothis: Permite configurar o fluxo do Agente Virtual Sothis:
@ -56,8 +60,21 @@ O WhatsApp chama `routeIncomingMessage()` em `whatsapp-assignment.service.ts`. E
3. deteccao por keyword/area; 3. deteccao por keyword/area;
4. fallback para suporte. 4. fallback para suporte.
## Arquitetura interna
```text
Controller -> Service -> Repository -> DatabaseService
```
- Controller: contrato HTTP, roles e documentacao Swagger.
- Service: regra de negocio do bot, validacao da arvore, normalizacao de keywords e montagem da resposta.
- Repository: queries SQL para `bot_flow_*`, `bot_triage_*` e `area_routing_keywords`.
- DatabaseService: acesso ao PostgreSQL.
## Code review ## Code review
- Fluxo builder e fluxo legado coexistem; manter claro qual esta ativo. - Fluxo builder e fluxo legado coexistem; manter claro qual esta ativo.
- Publicacao de versao deve ser protegida por perfil. - Publicacao de versao deve ser protegida por perfil.
- Textos do bot devem ser revisados para acento e tom. - Textos do bot devem ser revisados para acento e tom.
- O schema nao e criado em runtime; tabelas e seeds iniciais devem vir das migrations do repositorio de deploy.
- Proximo passo recomendado: formalizar DTOs de criacao/edicao do fluxo.