DOCS: Atualizado dodoumentação pós criação de novo modulo
parent
71c88513c6
commit
b38ac11dcd
2
Admin.md
2
Admin.md
@ -20,6 +20,8 @@ Sustenta o painel administrativo e parte do painel supervisor:
|
||||
- areas/especialidades;
|
||||
- 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
|
||||
|
||||
| Metodo | Rota | Perfis | Descricao |
|
||||
|
||||
@ -2,10 +2,14 @@
|
||||
|
||||
Base tecnica:
|
||||
|
||||
- Controller: `src/modules/admin/knowledge-base.controller.ts`
|
||||
- Service: `src/modules/admin/knowledge-base.service.ts`
|
||||
- Module: `src/modules/knowledge-base/knowledge-base.module.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`
|
||||
|
||||
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
|
||||
|
||||
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;
|
||||
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
|
||||
|
||||
- Fluxo builder e fluxo legado coexistem; manter claro qual esta ativo.
|
||||
- Publicacao de versao deve ser protegida por perfil.
|
||||
- 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.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user