Sprint 04 — 08/06 a 19/06¶
Foco: Observabilidade e Governança — Planejamento Visual, Suporte a Projetos de Migração e Módulo AMS
O que há de novo¶
Melhorias na Área de Planejamento¶
A aba de Planejamento ganhou uma nova área dedicada ao backlog em organização: "Em Planejamento". Stories ainda não alocadas em iterações podem ficar agrupadas nessa área, facilitando a visão do que está pendente de refinamento.
A gestão de iterações também evoluiu: agora é possível editar e excluir iterações diretamente pelo Portal. Duas novas opções de filtragem tornam a leitura do board mais limpa — um toggle para ocultar stories já implementadas e outro para exibir a hierarquia de épico/feature/story na lista da iteração.
Flag de Impedimento em Stories¶
Stories bloqueadas agora podem ser marcadas com uma flag de impedimento, com preenchimento obrigatório de justificativa. A justificativa fica visível como um banner de destaque na tela de detalhes do Work Item, dando visibilidade imediata ao time sobre o motivo do bloqueio.
Suporte a Projetos de Migração¶
O AMia passa a suportar um novo tipo de projeto: Migração. A plataforma agora oferece um fluxo completo para levantar e documentar sistemas legados que precisam ser modernizados:
- Interface de criação de projetos do tipo Migração no Portal
- Agente de Levantamento Funcional (Reverse Functional Survey) — mapeia as funcionalidades do sistema de origem
- Agente de Levantamento Arquitetural (Reverse Architecture Survey) — captura a arquitetura atual do sistema
- Agente de Visão para Migração — gera a visão do novo sistema com base no levantamento
- Adaptação dos agentes de Arquitetura, Design e Story Mapping para o contexto de migração
- Agente de Detalhamento de Work Items especializado para projetos de migração
- Prompts dedicados para todos os agentes acima
Reorganização Interna — Multi-Schema e Módulo Coding¶
O Core passou por uma reorganização estrutural para suportar múltiplos schemas de banco de dados. O schema ams foi criado e o DbContext configurado para multi-schema. Internamente, as entidades, commands/queries, contracts, configurações EF e controllers do módulo Coding foram realocados em seus respectivos subdiretórios — sem impacto funcional, mas preparando a base para a expansão do módulo AMS.
O Portal acompanhou a mesma reorganização: pages, services e models do módulo Coding foram movidos para subdiretórios dedicados.
Base do Módulo AMS — Clientes, Atendentes e FAQs¶
A fundação do módulo AMS (Atendimento e Suporte) começa a ser estabelecida neste sprint:
- Modelagem de Clientes e Atendentes — entidades, relacionamentos e configurações de banco de dados
- Modelagem de FAQs — estrutura de perguntas e respostas gerenciadas por cliente
- Endpoints de gestão de FAQs — criação, listagem, edição e remoção de FAQs via API
- Endpoint de Callback de Qualidade do FAQ — suporte ao retorno assíncrono do agente de qualificação de FAQs
Documentação Técnica com MkDocs¶
A documentação do AMia agora está publicada e acessível via MkDocs com tema Material. Esta sprint entregou:
- Configuração do MkDocs no repositório
AMia-Roadmap - Seção de Release Notes com histórico navegável de iterações
- Seção de Arquitetura com diagrama C4, componentes e ADRs
- Pipeline de CI/CD para publicação automática a cada merge na branch principal
Registro de Issues via Agentes¶
A Feature 7.2 — Rastreabilidade de Issues via Agentes foi concluída integralmente nesta sprint. Os agentes do AMia agora participam ativamente da identificação e registro de problemas ao longo de todo o ciclo de vida do projeto.
Agentes de Spec (7.2.4) — durante as interações de chat de refinamento e especificação, os agentes detectam automaticamente inconsistências, ambiguidades ou conflitos nas definições e os registram como issues via tool register_project_issue, sem que o desenvolvedor precise sair do fluxo de trabalho.
Agente de Codificação (7.2.6) — durante a implementação de stories, o agente de codificação passou a instruir explicitamente o registro de issues sempre que identificar impedimentos técnicos, divergências entre spec e código existente, ou decisões que impactem outras stories.
O resultado prático é uma rastreabilidade contínua de issues cobrindo as fases de especificação e construção — complementando a visibilidade já existente no Portal (chip no header, drawer lateral e tela de Gestão).
Prompts e Governança¶
- Os prompts locais do MCP Server foram removidos; os prompts dos agentes passam a ser gerados e versionados no repositório dedicado
amia-solutions - O Agente de Refinamento foi enriquecido com contexto de stories da feature e features do épico, tornando o refinamento de work items mais preciso e contextualizado
Stories Entregues¶
| Código | Descrição |
|---|---|
| 11.1.1 | [Agents] Enriquecer Contexto do Agente de Refinamento com Stories da Feature e Features do Épico |
| 11.2.1 | Área 'Em Planejamento' na Aba de Planejamento |
| 11.2.2 | Flag de Impedimento em Stories |
| 11.2.3 | Edição e Exclusão de Iteração |
| 11.2.4 | Banner de Justificativa de Impedimento na Tela de Detalhes do Work Item |
| 11.2.5 | Toggle para Ocultar Stories Implementadas na Área de Iteração |
| 11.2.6 | Ajuste de Layout da Área 'Em planejamento' na Aba de Planejamento |
| 11.2.7 | Toggle 'Exibir Hierarquia' na Área de Iteração |
| 12.1.1 | [Core] Adicionar Tipo MIGRATION ao Enum de ProjectType e Configurar Agentes |
| 12.1.2 | [Portal] Interface de Criação de Projeto do Tipo Migração |
| 12.2.1 | [Agents] Agente de Levantamento Funcional para Migração |
| 12.2.2 | [Agents] Agente de Levantamento Arquitetural para Migração |
| 12.3.1 | [Agents] Agente de Visão para Projetos de Migração |
| 12.3.2 | [Agents] Adaptação dos Agentes de Arquitetura, Design e Story Mapping para Migração |
| 12.3.3 | [Agents] Agente de Detalhamento de Work Items para Migração |
| 12.4.1 | [Prompts] Prompt do Agente Reverse Functional Survey para Migração |
| 12.4.2 | [Prompts] Prompt do Agente Reverse Architecture Survey para Migração |
| 12.4.3 | [Prompts] Prompt do Agente Vision para Migração |
| 12.4.4 | [Prompts] Prompt do Agente Story Mapping para Migração |
| 13.1.1 | [Core] Criar Schema ams e Configurar DbContext para Multi-Schema |
| 13.2.1 | [Core] Reorganizar Entidades do Domain em Módulo Coding |
| 13.2.2 | [Core] Reorganizar Commands e Queries do Application em Módulo Coding |
| 13.2.3 | [Core] Reorganizar Contracts (Requests/Responses) em Módulo Coding |
| 13.2.4 | [Core] Reorganizar EF Configurations do Repository em Módulo Coding |
| 13.2.5 | [Core] Reorganizar Controllers V1 em Módulo Coding |
| 13.3.1 | [Portal] Reorganizar Pages do Módulo Coding em Subdiretório |
| 13.3.2 | [Portal] Reorganizar Services do Módulo Coding em Subdiretório |
| 13.3.3 | [Portal] Reorganizar Models do Módulo Coding em Subdiretório |
| 13.5.1 | [Core] Modelagem de Clientes e Atendentes |
| 14.1.1 | [Core] Modelagem de FAQs |
| 14.1.2 | [Core] Endpoints de Gestão de FAQs |
| 14.1.4 | [Core] Endpoint de Callback de Qualidade do FAQ |
| 2.5.4 | Prototipar e Homologar a Feature de Registro e Gestão de Bugs |
| 5.3.1 | Configuração do MkDocs com tema Material no repositório AMia-Roadmap |
| 5.3.2 | Seção de Release Notes com histórico de iterações |
| 5.3.3 | Seção de Arquitetura com diagrama C4, componentes e ADRs |
| 5.3.4 | Pipeline de CI/CD para publicação automática do MkDocs |
| 6.2.1 | Remover Prompts Locais do MCP |
| 6.2.2 | Gerar Prompts do Solutions no Repo Dedicado |
| 7.2.4 | [Prompts] Detecção e Registro de Inconsistências nas Interações de Chat com Agentes de Spec |
| 7.2.6 | [Prompts] Prompt do Agente de Codificação para Uso da Tool register_project_issue |
| 7.5.4 | Protótipo da Área Admin |