# 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".