Checklist de produção — deploy do SUOT SDK em produção

use Suot\Fiscal\Core\Config\FiscalConfig;
use Suot\Fiscal\Core\Enum\Environment;

$config = FiscalConfig::builder()
    ->environment(Environment::Producao)
    ->cnpj(cnpj: $_ENV['SUOT_FISCAL_CNPJ'])
    ->certificate(
        path:     $_ENV['SUOT_FISCAL_CERT_PATH'],
        password: $_ENV['SUOT_FISCAL_CERT_PASSWORD'],
    )
    ->build();

# .env (produção — nunca commitar este arquivo)
SUOT_FISCAL_ENV=producao
SUOT_FISCAL_CNPJ=00000000000191
SUOT_FISCAL_CERT_PATH=/run/secrets/certificado.pfx
SUOT_FISCAL_CERT_PASSWORD=senha_muito_segura

use Suot\Fiscal\Cte\Application\Cte;
use Suot\Fiscal\Cte\Operation\Issue\IssueCteResult;
use Suot\Fiscal\Core\Exception\InfrastructureException;
use Suot\Fiscal\Core\Result\RetryMode;
use Psr\Log\LoggerInterface;

final class IssueCteService
{
    public function __construct(
        private readonly Cte $cte,
        private readonly LoggerInterface $logger,
    ) {}

    public function issue(string $operationId): IssueCteResult
    {
        try {
            $result = $this->cte->issue()
                ->forOperation($operationId)
                ->inProduction()
                // … cadeia tipada …
                ->handle();
        } catch (InfrastructureException $e) {
            $this->logger->critical('Falha de infraestrutura SEFAZ', [
                'message'     => $e->getMessage(),
                'operationId' => $operationId,
            ]);
            throw $e;
        }

        if ($result->isAuthorized()) {
            // Host: persistir accessKey, protocolNumber, submittedDocumentXml, responseXml
        }

        if ($result->isRejected()) {
            $failure = $result->failure();
            $this->logger->warning('CT-e rejeitado', [
                'code'        => $failure?->code,
                'operationId' => $operationId,
                'retryMode'   => $result->retryPolicy()?->mode->value,
            ]);
            // Host: AfterCorrection / QueryBeforeRetry / Never conforme RetryMode
        }

        return $result;
    }
}