Pomar

Plante empresas perenes, viva dos frutos.

O Pomar e um sistema pessoal e auto-hospedado pra quem investe em acoes de dividendos com horizonte de decadas: ele coleta fontes primarias (fatos relevantes da CVM/IPE) e noticias, classifica cada evento contra os kill criteria que VOCE escreveu na tese de cada empresa, manda push no celular quando um gatilho real aparece, e registra suas decisoes num journal auditavel. A filosofia embutida: noticia ruim com fundamento intacto e ruido (ou oportunidade de aporte); venda so se discute quando um criterio de quebra de tese, escrito com antecedencia e a sangue frio, e atingido — confirmado em fonte primaria e decidido por um humano. O sistema vigia o pomar; quem colhe (ou corta uma arvore) e voce.

Inspiracao: o metodo de investimento em setores perenes e dividendos popularizado por Luiz Barsi Filho. Este projeto e independente, nao tem qualquer vinculo, participacao ou endosso dele ou de sua familia.

Mapa do codigo

theses/            teses versionadas — a config que governa o cerebro
src/pomar/core/    config, banco, schema (contrato entre as partes)
src/pomar/ingest/  coletores idempotentes (so escrevem raw_events)
src/pomar/brain/   classificador LLM (le bruto, escreve veredito)
src/pomar/notify/  push ntfy
src/pomar/web/     dashboard flask + htmx (le tudo, escreve decisions)
src/pomar/cli.py   porta de entrada unica: `pomar <cmd>`
nix/module.nix     producao: usuario, db, timers, web, backup
flake.nix          devShell + export do modulo NixOS

Desenvolvimento (qualquer maquina com nix; ou so python+uv)

nix develop        # python + uv + psql pinados
uv sync            # cria .venv a partir do uv.lock
uv run pomar --help

Com um postgres local: uv run pomar initdb, cadastra empresa com uv run pomar add-company TAEE11 "Taesa" --cvm-name TAESA, e roda uv run pomar ingest ipe, uv run pomar classify, uv run pomar web.

Producao (NixOS)

1. Checkout em /var/lib/pomar/app (dono: usuario pomar).

2. Secrets em /etc/pomar/env (root:pomar 640):

   ANTHROPIC_API_KEY=...
   POMAR_NTFY_TOPIC=pomar-seunome-x7k2m9
   

3. Importar nix/module.nix no configuration.nix (ou o flake) e services.pomar.enable = true;, depois nixos-rebuild switch.

4. Uma vez: sudo -u pomar uv run --project /var/lib/pomar/app pomar initdb e cadastrar as empresas com pomar add-company.

Atualizar: sudo -u pomar git -C /var/lib/pomar/app pull (o uv re-sincroniza sozinho no proximo run). Logs: journalctl -u pomar-ipe (idem -news, -classify, -web, -backup).

Suas teses sao privadas

Este repo e publico e por isso NAO contem estrategia de ninguem: so o template theses/EXEMPLO4.yaml. Suas teses reais (empresas, preco-teto, kill criteria) devem viver num segundo repo, privado:

# ex.: repo privado "pomar-theses" com TAEE11.yaml, BBSE3.yaml...
# no servidor:
git clone git@github.com:VOCE/pomar-theses.git /var/lib/pomar/theses

O classificador le o diretorio apontado por POMAR_THESES_DIR (opcao services.pomar.thesesDir, default /var/lib/pomar/theses). No desenvolvimento local, o .gitignore ja impede commit acidental de qualquer theses/*.yaml que nao seja o exemplo.

Licenca e aviso

Codigo sob licenca MIT (ver LICENSE): use, copie, modifique a vontade.

O Pomar e uma ferramenta de organizacao e monitoramento de informacao publica. Nada aqui — codigo, template de tese, exemplos — constitui recomendacao de investimento, e o software vem sem qualquer garantia. As decisoes (e os resultados) sao sempre do dono da carteira.