Developer / Ferramentas Internas
Documentação interna da equipe H1 Tech. Diferente das outras abas (que descrevem o produto para o usuário final), aqui ficam os assuntos de engenharia/operação: como fazer deploy, quais bancos de dados são suportados, como rodar os testes end-to-end, como o licenciamento funciona e como esta própria documentação é construída.
Linguagem: português, mas comandos, flags e exemplos de código ficam em inglês (como aparecem no código).
Conteúdo
| Página | Para quê |
|---|---|
| Políticas e Boas Práticas de Desenvolvimento | Políticas da H1TECH para versionamento, pull requests, CI/CD, testes, segurança de credenciais, separação de ambientes, ferramentas de operação e backups. |
| DevOps & Deploy | Subir/atualizar o stack (license server + back/front do H1 Tech) num VPS com os scripts do DevOps/docker. |
| VPS (onde rodamos) | Lista dos servidores de deploy — os dois da Hostinger (77 / 92) e o host novo atrás de VPN (WireGuard + Portainer). |
| Adicionar um novo tenant (grupo) | Provisionar um novo grupo comercial: banco + .env dedicado via new-group.sh, licença, deploy e Nginx. |
| Bancos Suportados (Postgres / SQL Server) | Como o backend roda em Postgres ou SQL Server (DB_ENGINE), imagens por engine, migrations e como escolher. |
| Banco de dados do deploy | Playbook prático: prover o banco de um deploy (container via script, externo/gerenciado, ou tudo de uma vez) — Postgres ou SQL Server, com árvore de decisão. |
| Migrations e Seed | Como migrations e seed rodam (automático no boot do container), HSBR_RUN_SEED, e o verbo migrate.sh para a licença. |
| Modelo de Dados | Entidades, relações e diagrama ER do schema Prisma do backend (banco ga6). |
| Testes E2E | Rodar a suíte Playwright via Docker (Postgres ou SQL Server) ou contra um ambiente já de pé. |
| Licenciamento | Modos de licença (online / offline), produtos, enforcement e como gerar a licença de um deploy. |
| Como funcionam os docs | Como este site Docusaurus é organizado e como adicionar páginas/abas. |
Mapa rápido dos repositórios
Tudo vive lado a lado em Documents/H1/:
HSBR-Gestao-Ativos-Back— API Express + Prisma. Dual-engine: Postgres ou SQL Server, escolhido porDB_ENGINE.HSBR-Gestao-Ativos-Front— front Next.js + a suíte E2E (Playwright) eme2e/.h1-license-server— servidor de licenças (Next.js + worker), fonte das licenças.h1-license-sdk— SDK de licença consumido pelo back.DevOps— orquestração de deploy (DevOps/docker/é o caminho atual).docs— este site (Docusaurus).