# Omnichannel Frontend

![React](https://img.shields.io/badge/React-18.x-61DAFB)
![Vite](https://img.shields.io/badge/Vite-5.x-646CFF)
![JavaScript](https://img.shields.io/badge/JavaScript-ESM-yellow)
![React Router](https://img.shields.io/badge/Router-React%20Router-red)
![Socket.IO](https://img.shields.io/badge/Realtime-Socket.IO-black)

Frontend da plataforma Omnichannel da Sothis, responsavel pelas telas de atendimento, chat em tempo real, painel administrativo, painel operacional, gestao de contatos, configuracoes, base de conhecimento e integracoes.

Este repositorio contem apenas a interface web. 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

- React
- Vite
- JavaScript com ES Modules
- React Router
- Socket.IO Client
- CSS modularizado por contexto de tela

## Documentacao

Para documentacao do projeto completo, deploy, ambientes e operacao, acesse:

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

Para documentacao tecnica complementar do frontend, modulos e telas, acesse a wiki:

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

## Execucao local

Instale as dependencias:

```bash
npm install
```

Execute em modo desenvolvimento:

```bash
npm run dev
```

O Vite normalmente sobe a aplicacao em:

```txt
http://localhost:5173
```

## Build e preview

Gere o build:

```bash
npm run build
```

Execute o preview local do build:

```bash
npm run preview
```

Por padrao, o preview utiliza:

```txt
http://localhost:3000
```

## Estrutura principal

- `src/modules/auth`: login e integracoes de autenticacao.
- `src/modules/attendance`: abertura e acompanhamento de atendimentos.
- `src/modules/chat`: chat em tempo real e edicao rapida de contato.
- `src/modules/call`: painel do atendente.
- `src/modules/home`: telas iniciais e direcionamento por perfil.
- `src/modules/management`: painel administrativo, dashboard, contatos, IA, canais, integracoes e configuracoes.
- `src/routes`: rotas principais da aplicacao.
- `src/shared`: componentes, hooks, estilos e servicos compartilhados.

## Observacoes

- Este frontend depende da API do `omnichannel-backend`.
- A URL do backend deve ser configurada conforme o ambiente de execucao.
- Para operacao completa, deploy e atualizacao em producao, consulte o repositorio `omnichannel-deploy`.