Adicionar Home

Home.md

@@ -0,0 +1,34 @@
+# Documentacao do Backend
+
+Esta pasta documenta a API e os modulos backend do Omnichannel.
+
+## Indice
+
+- [`api-overview.md`](./api-overview.md): visao geral da API, padroes e riscos atuais.
+- [`auth.md`](./auth.md): autenticacao LDAP/AD, Microsoft OAuth, JWT e sincronizacao de usuario.
+- [`access-control.md`](./access-control.md): usuarios, perfis, areas e controle administrativo.
+- [`admin.md`](./admin.md): endpoints e responsabilidades do modulo administrativo.
+- [`agent.md`](./agent.md): presenca, pausa, notas e operacao do agente.
+- [`whatsapp.md`](./whatsapp.md): chats, mensagens, midias, templates, atribuicao e abertura ativa.
+- [`knowledge-base.md`](./knowledge-base.md): fluxo do bot, arvore de decisao e base de conhecimento da IA.
+- [`contacts.md`](./contacts.md): agenda e perfil de contatos.
+- [`database.md`](./database.md): migrations, compose, banco e pontos de deploy.
+
+- [`chat-whatsapp.md`](./chat-whatsapp.md): documentacao historica do chat WhatsApp.
+
+## Leitura recomendada para code review
+
+1. `api-overview.md`
+2. `auth.md`
+3. `whatsapp.md`
+4. `admin.md`
+5. `database.md`
+
+## Estado atual
+
+O backend ja possui boa parte das regras de produto, mas ainda precisa de hardening para producao:
+
+- guards JWT nas rotas privadas;
+- autorizacao por perfil no backend;
+- rotina formal de migrations;
+- testes para roteamento, atendimento e permissao.