Files
Dashboard/README.md
2025-11-29 21:06:58 -03:00

43 lines
1.8 KiB
Markdown

# Dashboard Telseg
Instruções rápidas para clonar o repositório e subir o ambiente via Docker.
## Como clonar
- Via HTTPS: `git clone https://gitea.notetec.xyz/tiago/Dashboard.git`
- Se o repositório for privado, use seu usuário e senha/token:
`git clone https://<usuario>:<token>@gitea.notetec.xyz/tiago/Dashboard.git`
## Como subir com Docker
1. Entre na pasta do projeto: `cd Dashboard`
2. (Opcional) Crie um `.env` na raiz para ajustar variáveis usadas pelo `docker-compose.yml`:
```env
POSTGRES_DB=telseg
POSTGRES_USER=telseg
POSTGRES_PASSWORD=telseg
JWT_SECRET=troque_este_valor
ADMIN_USER=admin
ADMIN_PASSWORD=admin123
```
Se não criar o `.env`, esses valores padrão serão usados.
3. Suba os serviços: `docker compose up -d --build`
4. Verifique se está tudo de pé: `docker compose ps`
## Acessos e portas
- Dashboard: http://localhost:4242
- Adminer (banco): http://localhost:8081 — host `db`, usuário `telseg`, senha `telseg`, base `telseg`
- Postgres: porta 5432 exposta localmente (opcional)
## Sobre o Cofre de Senhas (HTTPS)
- O cofre usa WebCrypto do navegador (PBKDF2 + AES-GCM). Para funcionar, o navegador exige contexto seguro (HTTPS ou localhost).
- Se acessar via IP/HTTP (ex.: `http://192.168.x.x:4242`), o botão de desbloquear pode não responder. Use HTTPS (mesmo com certificado self-signed) ou acesse via `https://` atrás de um proxy reverso.
## Parar os serviços
- `docker compose down` para parar
- `docker compose down -v` se também quiser descartar os volumes do Postgres (dados serão perdidos)
## Como atualizar no servidor (após já ter clonado)
1. Entre na pasta do projeto onde você já fez o clone: `cd Dashboard`
2. Baixe as últimas alterações: `git pull`
3. Reconstrua e reinicie os containers: `docker compose up -d --build`
4. Verifique o status: `docker compose ps`