Izzispark Docs

Bem-vindo à documentação técnica da Izzispark.

Este site é gerado a partir de arquivos Markdown usando mdBook e serve como fonte centralizada de conhecimento sobre:

  • Plataforma — infraestrutura, serviços, domínios, DNS
  • Projetos — BeerSales, Hermes, e outros
  • Dashboard — snapshots atualizados automaticamente
  • Decisões — Architecture Decision Records (ADRs)
  • Guias — procedimentos operacionais

💡 Uso

ComandoDescrição
mdbook serveServidor dev com hot-reload
mdbook buildGera HTML estático em book/
mdbook build -oBuild + abre no navegador

🔗 Links

📋 Dashboard

Última atualização: {{timestamp}}

Métricas

IndicadorValorStatus
Uptime99.9%✅
Latência média45ms✅
Erros 5xx0.01%✅

Serviços

ServiçoStatusPorta
Traefik✅80/443
OpenBao✅8200
Bridge WhatsApp✅3000
Docsify Dashboard✅8083

Últimos Incidentes

Nenhum incidente ativo.

Infraestrutura

Servidor

ItemValor
ProvedorHostinger VPS
IP31.97.165.203
SODebian 13
Kernel6.12.85+deb13-amd64
Docker✓
Traefikv3.6 (reverse proxy)

Stack

Serviços:
  - Traefik        # Reverse proxy + TLS
  - OpenBao        # Secrets management
  - Kratos/Hydra   # Identity & OAuth2
  - Komodo         # Container management
  - mdBook         # Documentação

Serviços

ServiçoSubdomínioPorta InternaStack
Websiteizzispark.cloud80Docker
Authauth.izzispark.cloud4455Kratos
OpenBaobao.izzispark.cloud8200OpenBao
Komodohost.izzispark.cloud—Komodo
Docsdocs.izzispark.cloud80mdBook
Totemtotem.izzispark.cloud8080—
Odysseusodysseus.izzispark.cloud7000Odysseus
Linklink.izzispark.cloud8080—
Previewpreview.izzispark.cloud8000HTTP server

Domínios & DNS

Domínios

DomínioProvedorUso
izzispark.cloudHostingerPrincipal
portopsiquiatria.med.br—Cliente

DNS — izzispark.cloud

@          A  31.97.165.203
www        A  31.97.165.203
auth       A  31.97.165.203
bao        A  31.97.165.203
bosso      A  31.97.165.203
docs       A  31.97.165.203
host       A  31.97.165.203
link       A  31.97.165.203
odysseus   A  31.97.165.203
preview    A  31.97.165.203
totem      A  31.97.165.203

TLS

Todos os subdomínios usam Let's Encrypt via Traefik (certresolver: letsencrypt).

Para adicionar novo subdomínio

  1. Criar registro A no Hostinger apontando para 31.97.165.203
  2. Adicionar labels Traefik no container Docker
  3. Traefik obtém certificado automaticamente

Monitoramento

Health Checks

ServiçoEndpointIntervalo
Traefik:80/health30s
OpenBao:8200/v1/sys/health30s

Logs

# Traefik
docker logs komodo-traefik-1 -n 50

# Aplicação específica
docker logs <container-name> -f

Alertas

  • Pingdom / UptimeRobot (externo) — futuramente
  • ntfy.sh (Odysseus) — notificações push

Observabilidade

  • Logs: Docker logs + journald
  • Métricas: Traefik metrics endpoint
  • Uptime: Verificar periodicamente via cron

BeerSales

Sistema de gestão para distribuição de bebidas (E-Get - Santa Cruz do Sul, RS).

Stack

ComponenteTecnologia
Portal (frontend)TanStack Start
API (backend)Bun + Elysia
BancoPostgreSQL 16
Domínio prodbosso.izzispark.cloud
Domínio stagingstaging.bosso.izzispark.cloud
Repositóriojosafaps/bosso-dashboard

Equipe

PapelPessoaContato
PO/ClienteRenan Bossorenan@bosso.io
DevJosafá—

Hermes Agent

Agente AI autônomo da Nous Research. Opera via WhatsApp integrado com ferramentas locais.

Versão

ItemValor
Modelodeepseek-v4-flash
Provedoropencode-go
RuntimeBun v1.3.14
Skill ativaobsidian-wiki-vault

Integrações

  • WhatsApp (Baileys)
  • OpenBao (secrets management)
  • Deepgram (STT - transcrição de áudio)
  • GitHub (vault sync via FIT)

Architecture Decision Records

ADRTítuloDataStatus
001Documentação com mdBook2026-07-01✅ Aceito

Guias

Em construção.

Estrutura esperada

  • setup-dev.md — Configuração do ambiente de desenvolvimento
  • deploy.md — Procedimento de deploy
  • troubleshooting.md — Problemas comuns e soluções