obsidian-vault/Infra-Network/HANDOFF-RENTLY-2026-10-07.md

HANDOFF — Rently / RentCharge (2026-10-07)

Operador: Roger · Assistente: Claude (sessão no laptop C:\LAPTOP\remitly-p2p) Objectivo: continuar o trabalho noutra máquina sem perder contexto. Sem segredos neste ficheiro — chaves SSH e passwords ficam fora do vault.

Detalhe completo da sessão: SPEC-SESSION-2026-10-06.

---

1. Onde está tudo (VM500 · ssh vm500 via big-myvexx/Tailscale)

Ambiente	Onde	URL
PRD	Docker rently-prod · compose /home/mini/rently-prod/docker-compose.prod.yml · Postgres rently-prod-db-1 · :8000/:3000	https://rently.myvexx.com
TEST	Docker rently-test · compose /home/mini/rentcharge-test/docker/docker-compose.test.yml · Postgres rently-test-db-1 · :8010/:3010	https://rently-test.myvexx.com
Código	/home/mini/rentcharge · Forgejo myvexx/rently · main = o que corre em PRD	git.itecnologys.com/myvexx/rently
Backups	/home/mini/rently-backups/ (pg_dump antes de cada deploy)	—

• /home/mini/rentcharge (systemd SQLite) é a instalação antiga e inactiva — não é PRD.
• Fonte usada para gerar imagens TEST/PRD: /home/mini/rentcharge-test/{backend,frontend}; contexto backend docker/build/backend-ctx/app.
• Push para Forgejo a partir da VM já funciona sem prompt (credential store do utilizador mini).

2. Regras de trabalho (Roger)

1. Alterar só em TEST; Roger testa; PRD só com "pode aplicar na PRD".
2. Antes de PRD: backup Postgres, tag :pre-<data> das imagens, paragem ~1 min.
3. Entregar a funcionalidade a funcionar (não planos). UI nova reutiliza o design existente (ex.: modal Credit settlement).
4. Se pedido, congelar utilizador durante correcções (is_active=false + revogar sessões) e reactivar logo a seguir.

3. Feito em 2026-10-06/07 (em PRD)

Commit	O quê
ffa801f	Balance Import + Credit Payout (modal "Credit Book balance")
985c5b4	Payout v2: créditos em aberto, uso parcial, encontro de contas automático, tabela credit_payout_allocations
9be3065	Repo sincronizado com o código que corre em PRD (+ docker/)
3ea7a34	Credit Book: payouts em todas as vistas (credit_book_delta); HO Remittance report já não rebenta com adjustment/payout

• Conta da casa SA-FAC "Facilities - Salvation Army" (id 211, sem renda, BANK_ACCOUNT) para Cash sales DONATION / LAUNDRY_TILL. Não usar quarto "SA" (é o balde do Staff Credit Book, id 209).

4. Pendente

• Regras Closing Till / Cycle Start — Roger enviou o bloco 1 e pediu para aguardar o próximo bloco antes de mexer:
  • todo o Save statement diário deve aparecer em Week EOD files (Cycle Start) e nunca ficar imutável;
  • quinta-feira, Save EOD for Closing Till marca a hora e separa antes/depois do corte;
  • o Cycle Start lista todos os dias + after-cut da semana anterior + before-cut do dia actual.
  • Dúvidas em aberto: vários saves no mesmo dia; imutabilidade depois do Freeze; save depois do corte; segundo clique na mesma quinta.
  • Hoje em PRD: regra 2026-10-01-r1; after-cut EOD-20261001-37722C (€129) aparece "used · immutable"; dias 02–06/10 gravados com for_eow=0 não aparecem.
  • .cursor/rules/eow-cycle-start-rules.mdc contradiz SPEC-CLOSING-TILL-FREEZE-ARCHIVE.md.
• Branch wip/closing-till-after-cut-011 (trabalho de terceiros, não publicado): corrigir risco de libertar after-cut já usado noutro freeze antes de publicar.
• Segurança: trocar passwords que apareceram em chat/ficheiros (conta Forgejo, root/mini das VMs, comentários em ~/.ssh/config, docs/HANDOFF-VM500-RENTLY-ACCESS.md, ACCESS-CT130-OBSIDIAN.md). Deploy key vm500-rently-deploy sem uso (SSH do Forgejo inacessível).

5. Retomar noutra máquina

1. Instalar Claude desktop (mesma conta) e Tailscale (rede itecnologys).
2. Copiar por pendrive (nunca por email/chat), para os mesmos caminhos:
   • C:\Users\roger\.ssh\ (config + chaves big_myvexx_id_rsa, vm500_rentcharge, …)
   • C:\Users\roger\.claude\projects\C--LAPTOP-remitly-p2p\ (memória + histórico)
   • C:\LAPTOP\remitly-p2p\
3. Testar ssh vm500 hostname → PROJETOS.
4. Abrir o Claude em C:\LAPTOP\remitly-p2p e dizer "continuar o Rently — ler HANDOFF-RENTLY-2026-10-07".