ROADMAP.md

Roadmap: nfse-php

Este pacote é a fundação do ecossistema. O foco é garantir contratos sólidos e modelos de dados ricos.

📅 Fases

Fase 1: Estrutura de Dados (DTOs)

• Mapear campos do Excel (ANEXO_I...) usando atributos #[MapInputName].
• Implementar Dps, Prestador, Tomador, Servico, Valores.
• Adicionar validações (Constraints) nos DTOs.
• Testes unitários de validação.

Fase 2: Serialização

• Implementar Serializer para XML (padrão ABRASF/Nacional).
• Garantir que a serialização respeite os XSDs oficiais.

Fase 3: Assinatura Digital

• Criar SignerInterface.
• Implementar adaptador para assinatura XML (DSig).
• Suporte a certificado A1 (PKCS#12).

Fase 4: Utilitários

• Helpers para cálculo de impostos (simples).
• Formatadores de documentos (CPF/CNPJ).
• Gerador de IDs (DPS/NFSe).

Fase 5: Documentação & Busca 🚀

• Docusaurus com busca local.
• Documentação de DTOs e Assinatura.
• Tutoriais avançados.

Fase 6: Web Services (Próximo) 📅

• Integração com Web Services da SEFIN Nacional.
• Envio de DPS.
• Consulta de NFSe.
• Eventos e Cancelamentos.

Fase 7: Testes E2E & CI/CD 📅

• Testes end-to-end com ambiente de homologação.
• GitHub Actions para CI/CD.
• Releases automáticas.