# Implantacao por escritorio

## Objetivo

Padronizar a ativacao de um escritorio parceiro no fluxo:

`SEFIN -> base local -> icms.vcnodigital.com -> app.vcnodigital -> cliente`

## Pacote minimo

- 1 maquina Windows dedicada ao `sefin_browser.py`
- Google Chrome atualizado
- pasta canonica de saida `DARES/<ano>`
- token de controladora no `icms.vcnodigital.com`
- acesso da controladora ao `app.vcnodigital` da Peramix
- operador responsavel pela validacao inicial

## Checklist tecnico

1. cadastrar a controladora no ICMS
2. validar `companyId` e `apiBaseUrl` da controladora
3. entregar token Bearer exclusivo da controladora
4. configurar a pasta local canonica do escritorio
5. validar emissao de uma guia normal
6. validar reemissao pontual com `targetDueDate`
7. validar importacao no VC Digital
8. validar `mark-exported`
9. validar `mark-delivered`
10. validar entrega ao cliente no WhatsApp

## Regras obrigatorias

- publicar apenas `guia_pdf` real
- nunca enviar `extrato-only` como se fosse guia
- o app da Peramix consome so a API do `icms.vcnodigital.com`
- remissao pontual deve usar `due-options` antes de criar job
- controladora nao compartilha token com outra carteira

## Parametros operacionais

- ano padrao: `ano atual`
- expansao: `ano anterior` apenas quando houver necessidade real
- worker ocioso: encerra para liberar RAM
- `auto-year fallback`: para no primeiro ano util
- abas auxiliares: fechadas agressivamente ao iniciar e concluir cada guia

## Teste de aceite

Uma implantacao so entra em producao quando passar nestes 4 testes:

1. guia normal publicada com `guia_pdf` real
2. guia vencida reemitida com data real escolhida
3. app da Peramix importa e marca `mark-exported`
4. envio ao cliente retorna `mark-delivered`

## Operacao diaria

- abrir painel `/operations/sla`
- conferir pendencias de entrega final
- conferir falhas de job dos ultimos 7 dias
- conferir reemissoes acima do normal
- atuar primeiro em guias ja importadas e ainda nao entregues