Documenta estrutura inicial do Victor Hub

docs/01-visao-geral.md

@@ -0,0 +1,26 @@
+# 01 - Visao Geral
+
+O Victor Hub e uma central pessoal de servicos em VPS.
+
+## Stack base
+
+- Ubuntu Server
+- Docker
+- Docker Compose
+- Nginx Proxy Manager
+- Cloudflare DNS
+- Registro.br
+- Tailscale
+
+## Servicos ativos
+
+- Homepage
+- Portainer
+- Uptime Kuma
+- n8n
+- FileBrowser
+- Gitea
+
+## Servico desativado
+
+- BookStack, substituido pela documentacao em Markdown no Gitea.

docs/02-arquitetura.md

@@ -0,0 +1,24 @@
+# 02 - Arquitetura
+
+## Estrutura geral
+
+Internet -> Cloudflare DNS -> VPS Oracle -> Nginx Proxy Manager -> Containers Docker.
+
+## Diretorio principal
+
+/opt/victor-hub
+
+Subpastas principais:
+
+- stacks
+- data
+- backups
+- scripts
+- secrets
+- docs
+
+## Rede Docker principal
+
+Rede: proxy
+
+Servicos publicados por subdominio devem estar conectados a rede proxy.

docs/03-dns-cloudflare.md

@@ -0,0 +1,26 @@
+# 03 - DNS e Cloudflare
+
+## Dominio
+
+hubvictor.com.br
+
+## Nameservers no Registro.br
+
+- ara.ns.cloudflare.com
+- charles.ns.cloudflare.com
+
+## IP publico da VPS
+
+147.15.33.41
+
+## Subdominios ativos
+
+- painel.hubvictor.com.br
+- proxy.hubvictor.com.br
+- portainer.hubvictor.com.br
+- status.hubvictor.com.br
+- arquivos.hubvictor.com.br
+- n8n.hubvictor.com.br
+- git.hubvictor.com.br
+
+O subdominio wiki.hubvictor.com.br foi usado para BookStack, mas sera desativado ou redirecionado futuramente.

docs/04-nginx-proxy-manager.md

@@ -0,0 +1,19 @@
+# 04 - Nginx Proxy Manager
+
+## URL
+
+https://proxy.hubvictor.com.br
+
+## Funcao
+
+Gerenciar proxy reverso, certificados Let's Encrypt, subdominios e encaminhamento para containers.
+
+## Proxy Hosts ativos
+
+- painel.hubvictor.com.br -> homepage:3000
+- status.hubvictor.com.br -> uptime-kuma:3001
+- n8n.hubvictor.com.br -> n8n:5678
+- arquivos.hubvictor.com.br -> filebrowser:80
+- git.hubvictor.com.br -> gitea:3000
+- portainer.hubvictor.com.br -> portainer:9000
+- proxy.hubvictor.com.br -> nginx-proxy-manager:81

docs/05-portainer.md

@@ -0,0 +1,13 @@
+# 05 - Portainer
+
+## URL
+
+https://portainer.hubvictor.com.br
+
+## Funcao
+
+Gerenciar containers, volumes, redes e stacks Docker pela interface visual.
+
+## Atencao
+
+Servico sensivel. Deve ter senha forte e protecao adicional.

docs/06-n8n.md

@@ -0,0 +1,17 @@
+# 06 - n8n
+
+## URL
+
+https://n8n.hubvictor.com.br
+
+## Funcao
+
+Central de automacoes.
+
+## Banco
+
+Usa PostgreSQL proprio no container n8n-postgres.
+
+## Volume de dados
+
+/opt/victor-hub/stacks/06-n8n/n8n_data

docs/07-filebrowser.md

@@ -0,0 +1,17 @@
+# 07 - FileBrowser
+
+## URL
+
+https://arquivos.hubvictor.com.br
+
+## Funcao
+
+Gerenciador web dos arquivos da VPS.
+
+## Diretorio exposto
+
+/opt/victor-hub/data
+
+## Atencao
+
+Servico sensivel. Nao armazenar documentos criticos sem politica de seguranca e backup.

docs/08-gitea.md

@@ -0,0 +1,17 @@
+# 08 - Gitea
+
+## URL
+
+https://git.hubvictor.com.br
+
+## Funcao
+
+Git privado e documentacao oficial do Victor Hub.
+
+## Repositorio principal
+
+vhiago26/victor-hub-infra
+
+## Regra
+
+Nunca subir senhas, tokens, chaves SSH privadas ou arquivos .env com credenciais reais.

docs/09-uptime-kuma.md

@@ -0,0 +1,18 @@
+# 09 - Uptime Kuma
+
+## URL
+
+https://status.hubvictor.com.br
+
+## Funcao
+
+Monitorar disponibilidade dos servicos.
+
+## Monitores recomendados
+
+- painel.hubvictor.com.br
+- proxy.hubvictor.com.br
+- portainer.hubvictor.com.br
+- n8n.hubvictor.com.br
+- arquivos.hubvictor.com.br
+- git.hubvictor.com.br

docs/10-tailscale.md

@@ -0,0 +1,15 @@
+# 10 - Tailscale
+
+## Funcao
+
+Rede privada para acesso seguro a VPS.
+
+## Consultar IP privado
+
+Comando:
+
+tailscale ip -4
+
+## Uso recomendado
+
+Futuramente, servicos administrativos podem ser restritos para acesso apenas via Tailscale.

docs/11-backup.md

@@ -0,0 +1,20 @@
+# 11 - Backup
+
+## Itens criticos
+
+- docker-compose.yml das stacks
+- .env.global
+- volumes do Gitea
+- banco do Gitea
+- dados do n8n
+- banco do n8n
+- dados do FileBrowser
+- configuracoes do Nginx Proxy Manager
+
+## Diretorio local de backups
+
+/opt/victor-hub/backups
+
+## Pendencia
+
+Criar rotina definitiva de backup com dumps de banco e copia externa.

docs/12-seguranca.md

@@ -0,0 +1,17 @@
+# 12 - Seguranca
+
+## Pontos sensiveis
+
+- proxy.hubvictor.com.br
+- portainer.hubvictor.com.br
+- n8n.hubvictor.com.br
+- arquivos.hubvictor.com.br
+- git.hubvictor.com.br
+
+## Pendencias
+
+- fechar portas diretas 81 e 9000
+- revisar regras da Oracle Cloud
+- aplicar Access List no Nginx Proxy Manager
+- revisar cadastros publicos
+- manter senhas fortes

docs/13-recuperacao.md

@@ -0,0 +1,22 @@
+# 13 - Recuperacao
+
+## Ver containers
+
+docker ps -a
+
+## Ver logs
+
+docker logs nome-do-container --tail=100
+
+## Reiniciar uma stack
+
+cd /opt/victor-hub/stacks/NOME-DA-STACK
+docker compose restart
+
+## Subir uma stack
+
+docker compose up -d
+
+## Parar uma stack
+
+docker compose down