Skip to main content

Levantamento de requisitos - Modelo Atual

Levantamento de Requisitos: EscopoVix


1. Visão Geral e Escopo


Objetivo: Automatizar a triagem de e-mails comerciais das empresas Autvix e Advix Soluções , classificando-osutilizando deLLM acordopara comclassificar odemandas portfóliocontra uma base de serviços para reduzir o tempo operacional de análise manual.(BUS).


Principais Metas:

  • ValidarTriagem automaticamenteautomática sede solicitações estãvia e-mail e anexos.
  • Redução dentro ou fora do escopo.
  • Persistirtempo dadosoperacional estruturados para análise gerencial em dashboards.
  • Reduzire atrasos na resposta ao clientecliente.
  • Persistência final.de dados para auditoria e análise via Metabase.

2. Requisitos Funcionais (RF)

ID

Descrição

OrigemReferência Técnica

RF01

O sistema deve capturarCapturar e-mails recebidose emanexos comercial@autvix.com.brdas caixas comerciais e comercial@advixsolucoes.com.br.salvar no OneDrive.

Power Automate/ Microsfot APIAutomate

RF02

OIdentificar sistemao deve extrairremetente e convertervalidar anexosse noso formatosdomínio já existe na base de contatos.

Tabela .zipcontacts, .pdf, .excel e .html para texto plano ou .csv.

Scripts Python / GitHub

RF03

OConverter sistemaanexos deve classificar as demandas em: Dentro do Escopo, Fora do Escopo, Não é Solicitação ou Oportunidade Externa(.pdf, .xlsx, .zip) para texto para processamento pelo LLM .

LLMScripts (gpt-oss:120b)Python

RF04

O sistema deve persistir metadados doClassificar e-mail,mails remetenteem categorias pré-definidas com nível de confiança e classificação em banco de dados MySQL.justificativa.

SQLAlchemyLLM / Pydanticgpt-oss:120b

RF05

OMonitorar sistemaa devesaúde monitorardos pastasserviços emde tempo realingestão e reprocessar falhas com políticas de retry e debounce.processamento.

WatchdogTabela (Linux)service_heartbeat

RF06

OArmazenar sistemao devecorpo gerardo dashboardse-mail comem KPIs de volume por dia, tipo de contatoHTML e domínios.texto plano para rastreabilidade.

Metabase/Tabela Grafanaemails

3. Requisitos Não Funcionais (RNF)

ID

Categoria

Descrição

  • RNF01 - Integridade Referencial:

 O sistema deve garantir que nenhum e-mail seja órfão de um contato ou de uma classificação através de chaves estrangeiras (FK).

  • EscalabilidadeRNF02 - Desempenho de Busca:

    • Suporte Utilização de índices (KEY) em campos críticos como tipo, recipient, domain e received_at para modelosotimizar os dashboards.

  • RNF03 - Padronização de grandeCaracteres: porteTodo (LLMo 120B)banco hospedadosdeve utilizar o charset utf8mb4_unicode_ci para suportar caracteres especiais e emojis de e-mails.
  • RNF04 - Disponibilidade: O status do sistema deve ser reportado via heartbeat em servidorintervalos dedicadoregulares.

    • 4. Ubuntu.

    RNF02

    Confiabilidade

    GerenciamentoModelo de schemaDados de(Arquitetura do Banco)

    O banco de dados viaMySQL migraçõesé versionadaso (Alembic).

    RNF03

    Observabilidade

    Logs estruturados em formato JSON para integraçcoração comda ferramentaspersistência comodo ELKEscopoVix, estruturado da seguinte forma:

    A. Núcleo de Comunicação

    • contacts: Gerencia os remetentes. Classifica o tipo entre CLIENTE, PORTAL ou CloudWatch.

    RNF04

    Segurança

    Armazenamento intermediário em OneDrive para rastreabilidadeDESCONHECIDO e históricomarca dese análise.

    RNF05

    Integridade

    Validação rigorosacontato dejá dadosestá viacadastrado Pydanticno antessistema legiado (is_cadastrado).

  • emails: Armazena os metadados da inserçãmensagem, o caminho da pasta no banco de dados.

    • 4. Arquitetura e Tecnologias

    Stack Tecnológica:

    • Ingestão: Microsoft Power Automate ou Microsoft graph api.
    • Armazenamento: Microsoft OneDrive (montadofolder_path), viaa FUSE/onedrivercontagem node Linux)anexos oue localmenteo viaconteúdo graph-api.textual.

    ProcessamentoB. Central: Servidor Ubuntu executando Python 3.10+.
  • Inteligência Artificial:e Classificação

    • classifications: ModeloArmazena o veredito do modelo gpt-oss:120b.
      • Tipos permitidos: comparandoDENTRO_ESCOPO, solicitaçõesFORA_ESCOPO, comANALISE_TECNICA, a Base de Serviços (BUS)NAO_SOLICITACAO.
      • Persistência:Campos de IA: Bancoconfidence (0 a 1) e reasoning (explicação lógica da IA para aquela decisão).

    C. Apoio e Monitoramento

    • cliente: Tabela de Dadosreferência MySQLpara 8.0cruzamento comde SQLAlchemy.dados de domínio, CNPJ e Razão Social.
    • Visualização:service_heartbeat: MetabaseRegistra rodandose o serviço watcher ou processor está running, stopped ou em Dockererror, Compose.incluindo metadados em JSON para diagnóstico.

    5. RegrasFluxo de NegócioDados e ClassificaçPipeline

    1. Ingestão: Power Automate salva e-mail no OneDrive.
    2. Detecção

      : O watcher detecta a nova pasta.

    3. Identificação: O sistema devebusca seguirou acria lógica de decisão baseada na Base de Serviços (BUS) fornecidaregistro em CSV.


        contacts via domínio do e-mail.
      • Aceitar Prospecção:Processamento: QuandoO houverLLM compatibilidadeanalisa o texto e gera um registro em classifications com o portfólio (ex: pedidos de proposta)reasoning.
      • Recusar Educadamente:Finalização: DemandasO fora da área de atuação.
      • Análise Manual: Casos onde a solicitação estáregistro em linksemails oué portaisatualizado externoscom (Oportunidadeo Externa).classificacao_id e marcado como processado.
      • Ignorar: Newsletters, convites ou comunicações institucionais.


    Back to top