chore: establish project baseline

deploy/agent-windows/README.txt

@@ -0,0 +1,18 @@
+GTI Fiscal Agent 1.0.0-rc1 - pacote Windows
+==========================================
+
+Arquitetura: Hub central --HTTPS--> Agent Windows --local--> Firebird do SGV. O Hub nunca acessa o Firebird.
+Este pacote NAO contem segredos (token do Agent e senha do Firebird sao informados localmente).
+
+Requisitos no host do cliente: Python 3.12 (64 bits) no PATH, cliente Firebird (fbclient.dll, o mesmo do SGV),
+acesso HTTPS ao Hub, uma conta Firebird somente leitura.
+
+Passo a passo (PowerShell como Administrador, dentro desta pasta):
+  .\gti-agent.ps1 install        cria o venv, instala as dependencias, registra o servico "GTIFiscalAgent" (nao inicia)
+  .\gti-agent.ps1 configure      (ou: configure -FromTemplate .\pilot-construcao.env.example) grava o .env local com ACL restrita
+  .\gti-agent.ps1 preflight      PREFLIGHT=PASS|FAIL e os bloqueios, se houver
+  .\gti-agent.ps1 start          so inicia se o preflight passar
+  .\gti-agent.ps1 status | stop | restart | uninstall [-Purge]
+
+Modo do piloto: FISCAL_MODE=DRY_RUN e FIREBIRD_WRITES=0. Nesse modo o Agent e tecnicamente incapaz de escrever no Firebird.
+Detalhes: docs/PILOT_DEPLOYMENT.md e docs/OPERATIONS.md do repositorio.