first commit

docs/ENV_REAL_INTEGRATION_STATUS.md

@@ -0,0 +1,51 @@
+# Status real do `.env` legado TIM/FIRST
+
+Esta versão removeu a duplicidade do `.env.example` e do `mcp_servers/legacy_tim_mcp/.env.example`.
+
+## Decisão aplicada
+
+- `TIM_MCP_USE_MOCK=false` por padrão.
+- Mock só é usado quando você definir explicitamente `TIM_MCP_USE_MOCK=true`.
+- Os defaults reais encontrados no `agent_contas_first` original foram copiados.
+- Secrets e URLs que não existiam no original continuam vazios de propósito.
+
+## Defaults efetivamente encontrados no original
+
+| Variável nova | Valor preenchido | Origem no legado |
+|---|---|---|
+| `TIM_PROFILE_BILL_URL` | `http://10.151.3.100:8000` | `TIM_URL_PERFIL_FATURA` / `tim_profile_bill_url` |
+| `TIM_QUERY_VAS_URL` | `http://10.151.3.100:8000` | `TIM_URL_CONSULTA_VAS` / `TIM_CONSULTA_URL` / `tim_query_url` |
+| `TIM_BLOCK_VAS_URL` | `http://10.151.3.100:8000/customers/v1/partialServiceBlocking` | `TIM_URL_BLOQUEIO_VAS` / `TIM_BLOQUEIO_URL` / `tim_block_url` |
+| `TIM_CLIENT_ID` | `AIAGENTCR` | `tim_default_client_id` |
+| `TIM_USER_ID` | `AIAGENTCR` | usado como default nos commands/SR |
+| `TIM_DEFAULT_CSP_ID` | `740` | `tim_default_csp_id` |
+| `TIM_DEFAULT_CHANNEL` | `APP` | `tim_default_channel` |
+| `TIM_BLOCK_VAS_OPERATION_TYPE` | `block` | `tim_block_operation_type` |
+| `TIM_BLOCK_VAS_PAYLOAD_MODE` | `auto` | `tim_block_payload_mode` |
+| `TIM_BLOCK_VAS_ACCEPT_ENCODING` | `gzip,deflate` | `tim_block_accept_encoding` |
+
+## Valores que permanecem vazios
+
+Permanecem vazios porque o pacote original não trouxe valores reais para eles:
+
+- `TIM_COMPLETE_INVOICES_URL`
+- `TIM_CONTRATO_URL`
+- `TIM_BILL_PDF_URL`
+- `TIM_PROTOCOL_URL`
+- `TIM_CUSTOMER_CONTESTATION_URL`
+- `TIM_SERVICE_REQUEST_STATUS_URL`
+- `TIM_CANCEL_VAS_URL`
+- `TIM_SMS_URL`
+- `TIM_TRACKING_ACTIVITIES_URL`
+- todos os `*_AUTH`, `TIM_AUTHORIZATION_OAM`, `TIM_CN_FIELD`, `TIM_TYPE_FIELD`
+
+## Onde alterar
+
+Para executar localmente:
+
+```bash
+cp .env.example .env
+cp mcp_servers/legacy_tim_mcp/.env.example mcp_servers/legacy_tim_mcp/.env
+```
+
+Depois preencha apenas os endpoints/secrets que existirem no seu ambiente.