Sothis/omnichannel-backend
3
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
API e regras de negócio da plataforma Omnichannel
28 Commits 1 Branch 0 Tags 421 KiB
TypeScript 97.2%
JavaScript 2.7%
b2aa1a7712
Go to file
Rafael Lopes b2aa1a7712
Some checks are pending
Deploy Dev / deploy (push) Waiting to run
Details
DOCS: Adicionado README file
2026-05-27 17:23:05 -03:00
.gitea/workflows FIX: Corrige caminho do Workflow 2026-04-02 16:38:42 -03:00
scripts FEAT: Implementa controle de notas de agentes e contatos de clientes 2026-05-19 17:58:48 -03:00
src FEAT: Coleta do contúdo de IA 2026-05-27 09:30:36 -03:00
.env.example FEAT: Implementa módulo de autenticação com JWT 2026-05-08 17:10:50 -03:00
.gitignore CHORE: Atualizado gitignore do backend 2026-05-27 17:02:05 -03:00
Dockerfile FEAT: Implementa módulo de autenticação com JWT 2026-05-08 17:10:50 -03:00
nest-cli.json FEAT: Implementa módulo de autenticação com JWT 2026-05-08 17:10:50 -03:00
package-lock.json FEAT: Implementa chat funcional Whatsapp com atribuição de usuario 2026-05-18 11:14:17 -03:00
package.json PERF: Criado script para manter a porta 3001 sempre disponível 2026-05-19 09:28:26 -03:00
README.md DOCS: Adicionado README file 2026-05-27 17:23:05 -03:00
test-api.js FEAT: Implementa chat funcional Whatsapp com atribuição de usuario 2026-05-18 11:14:17 -03:00
test-chats.js FEAT: Implementa chat funcional Whatsapp com atribuição de usuario 2026-05-18 11:14:17 -03:00
tsconfig.build.json FEAT: Implementa módulo de autenticação com JWT 2026-05-08 17:10:50 -03:00
tsconfig.json FEAT: Implementa módulo de autenticação com JWT 2026-05-08 17:10:50 -03:00

README.md

Omnichannel Backend

Node.js NestJS TypeScript PostgreSQL Socket.IO JWT WhatsApp

Backend da plataforma Omnichannel da Sothis, responsavel por autenticacao, atendimento, integracao com WhatsApp, gestao administrativa, contatos, base de conhecimento e servicos de apoio ao painel web.

Este repositorio contem apenas a API. Para subir o projeto completo com frontend, backend e configuracao de deploy, utilize o repositorio de orquestracao:

https://chaleiradev.sothistelecom.com/Sothis/omnichannel-deploy

Stack

  • Node.js
  • NestJS
  • TypeScript
  • PostgreSQL
  • Socket.IO
  • whatsapp-web.js
  • JSON Web Token para autenticacao
  • LDAP/AD e Microsoft OAuth como provedores de login configuraveis

Documentacao da API

A documentacao detalhada das rotas fica disponivel no Swagger do backend no ambiente publicado.

Para documentacao tecnica complementar do backend, decisoes, modulos e operacao, acesse a wiki:

https://chaleiradev.sothistelecom.com/Sothis/omnichannel-backend/wiki

Execucao local

Instale as dependencias:

npm install

Crie o arquivo de ambiente a partir do exemplo:

cp .env.example .env.development

Configure as variaveis de banco, JWT, CORS e integracoes no .env.development.

Execute em modo desenvolvimento:

npm run dev

Por padrao, a API usa a porta configurada em PORT ou BACKEND_PORT. Se nenhuma variavel for definida, utiliza 3001.

Build e producao

Gere o build:

npm run build

Execute a versao compilada:

npm start

Estrutura principal

  • src/infra: configuracao, banco de dados, logger e infraestrutura compartilhada.
  • src/modules/auth: autenticacao, JWT, LDAP/AD e Microsoft OAuth.
  • src/modules/admin: recursos administrativos, base de conhecimento, contatos e controles de acesso.
  • src/modules/whatsapp: conexao WhatsApp, QR Code, mensagens, transferencia e eventos em tempo real.
  • src/modules/attendance: apoio as regras de atendimento.
  • src/modules/call, src/modules/chat e src/modules/home: modulos de apoio as telas e fluxos do frontend.

Observacoes

  • O banco de dados nao e criado por este repositorio. A configuracao deve apontar para uma instancia PostgreSQL existente.
  • Arquivos locais como .env*, logs, dist, dumps e sessoes do WhatsApp ficam fora do Git.
  • Para operacao completa, deploy e atualizacao em producao, consulte o repositorio omnichannel-deploy.