Sprint 05 — 22/06 a 30/06¶
Foco: Módulo Clientes, Fundação do amIA-Ingest e Base do Módulo AMS
O que há de novo¶
Área Admin e Gestão de Acessos¶
O AMia ganha uma nova Área Admin, acessível por um ícone de engrenagem no header exclusivo para Administradores da Plataforma. A tela de Configurações centraliza a gestão de administradores — cadastro, edição e remoção — com validação de conta via Azure AD e acesso exclusivamente via OAuth, sem geração de senhas. Cards de módulos (Coding, AMS, People) permitem navegar entre as configurações específicas de cada área; o módulo Coding já exibe métricas de Horas Salvas e Tempo Salvo comparadas ao mês anterior.
A gestão de Gestores AMS segue o mesmo padrão de segurança, com pesquisa e seleção de contas diretamente no Azure AD.
Módulo Clientes¶
Um novo módulo de Clientes passa a integrar a navegação global, visível no header para Administradores da Plataforma e Gestores AMS. A entidade Client foi migrada do schema ams para o schema core, tornando-se uma entidade transversal da plataforma, enquanto Attendant passou a referenciar o cliente sem acoplamento de chave estrangeira entre schemas.
A listagem de clientes é exibida em grade, com busca por nome, paginação e contagem de propostas e projetos por cliente. Administradores podem cadastrar e editar clientes diretamente pelo Portal, com validação de nome único e URL de logo. A página de detalhe do cliente traz a aba Dados, com informações cadastrais, website e um painel de gestão de contatos — as demais abas (Propostas, Projetos, AMS) já estão estruturadas e serão habilitadas em sprints futuras.
Fundação do Serviço amIA-Ingest¶
O novo serviço amIA-Ingest, responsável pela vetorização de conteúdo para busca semântica, teve sua fundação completamente estabelecida nesta sprint:
- Repositório e estrutura base do projeto Python, seguindo o padrão dos demais serviços do amIA
- Pipeline de CI/CD no Azure DevOps com build, publicação de imagem no ACR e deploy blue-green
- Provisionamento do App Service via Terraform nos ambientes de dev e prod
- Secrets e tokens de integração configurados no Key Vault e nos Variable Groups
Vetorização de FAQs e Documentos no pgvector¶
O módulo AMS avança na construção da base de conhecimento para atendimento:
- Agente de Qualificação de FAQ — avalia automaticamente a qualidade de FAQs submetidos com base em cinco critérios, aprovando ou reprovando com feedback detalhado
- Vetorização de FAQs aprovados — FAQs aprovados são automaticamente vetorizados e indexados na tabela
faq_chunksdo pgvector, com upsert em caso de refinamento - Agente de Extração de Conteúdo e Metadados de Documentos — lê documentos enviados por atendentes, extrai o texto completo e infere título, tipo e resumo via LLM antes da revisão humana
- Vetorização de documentos aprovados — o conteúdo revisado é dividido em chunks com overlap, vetorizado e indexado na tabela
document_chunks, com rastreamento de status (Indexing,Indexed,Failed)
Histórico de Conversas do Chat IA¶
O chat com os agentes de IA no Portal agora preserva o histórico da conversa por contexto e por usuário, armazenado localmente no navegador (Local Storage), sem qualquer chamada ao servidor. O histórico é isolado por usuário e por contexto, com janela deslizante de até 10 mensagens.
Documentação de Onboarding¶
Foi publicado no MkDocs um guia passo a passo de configuração do ambiente e conexão ao MCP Server, cobrindo pré-requisitos por sistema operacional, instalação de dependências e uma seção de troubleshooting com os erros mais comuns — permitindo que novos desenvolvedores executem seu primeiro command de codificação assistida sem suporte individual.
Stories Entregues¶
| Código | Descrição |
|---|---|
| 5.2.1 | Guia Passo a Passo de Configuração do Ambiente e Conexão ao MCP Server |
| 7.5.1 | Estrutura e Acesso à Área Admin |
| 7.5.2 | Cadastro e Gestão de Administradores do Sistema |
| 7.5.5 | Cadastro e Gestão de Gestores AMS |
| 7.5.6 | Migração de Client para o Schema Core e Remodelagem de Attendant |
| 7.5.7 | Navegação Global — Módulo Clientes no Header |
| 7.5.8 | Listagem de Clientes |
| 7.5.9 | Cadastro e Edição de Cliente |
| 7.5.10 | Detalhe do Cliente — Aba Dados e Gestão de Contatos |
| 11.2.8 | Histórico de Conversas do Chat IA no Portal |
| 13.4.1 | [Ingest] Criar Repositório e Estrutura Base do amIA-Ingest |
| 13.4.2 | [Ingest] Criar Pipeline CI/CD no Azure DevOps |
| 13.4.3 | [Infra] Provisionar App Service do amIA-Ingest no Terraform |
| 13.4.4 | [Infra] Adicionar Secrets do amIA-Ingest no Key Vault e Variable Groups |
| 14.1.3 | [Agents] Agente de Qualificação de FAQ |
| 14.1.6 | [Ingest] Vetorização de FAQs Aprovados no pgvector |
| 14.2.3 | [Ingest] Vetorização de Documentos Aprovados no pgvector |
| 14.2.6 | [Agents] Agente de Extração de Conteúdo e Metadados de Documentos |