Ir para o conteúdo

Protótipos de Interface (UI/UX)

Esta seção apresenta os wireframes de alta fidelidade para todos os atores identificados nos requisitos. O objetivo é validar a usabilidade e garantir que cada papel tenha sua interface definida.

O projeto adota uma estratégia de Interface Unificada (Streamlit): todas as telas são web, acessíveis via navegador, com layouts responsivos adaptados à função.

1. Módulo Público (Acesso Livre)

1.1. Consulta de Preços (Usuário Público)

Status: Build (Implementado) A interface principal do produto. Design "buscou, achou", focada na entrega rápida do valor consolidado.

  • Filtros: Marca → Modelo → Ano (Cascata).
  • Visualização: KPIs de preço e gráfico de tendência histórica.

Usuario

1.2. Cadastro de Parceiro (Lojista)

Status: Spec-only Tela de "Landing Page" onde um lojista pode solicitar seu credenciamento para receber visitas.

  • Funcionalidade: Formulário de auto-cadastro (Nome da Loja, CNPJ, Endereço).
  • Fluxo: Ao enviar, gera uma pendência para aprovação do Coordenador Regional.

Lojista

2. Módulo Operacional (Campo & Tático)

2.1. Coleta Mobile (Pesquisador)

Status: Spec-only Interface web responsiva (formato smartphone) para digitação ágil dentro das lojas.

  • UX: Campos grandes, input numérico otimizado e upload opcional de fotos.

Pesquisador

2.2. Rotinas e Scripts Auxiliares

Como esse papel não será implementado, foi feito dois scripts python para auxiliar no desenvolvimento da UI.

Carga Inicial (Seed Data)

  • Função: src/seed_data.py
  • Lógica: Gera milhares de registros de price_collections distribuídos nos últimos 13 meses, simulando variações de preço por região e depreciação temporal.
  • Uso: Essencial para evitar que a aplicação inicie "vazia" em novos ambientes.

Scriptbatch mensal

Scriptbatch mensal

Script Batch (ETL)

  • Função: src/batch_etl.py
  • Lógica:
    1. Extract: Busca coletas brutas no banco.
    2. Transform: Agrupa por Marca/Modelo/Ano/Região e calcula a média ponderada.
    3. Load: Insere ou atualiza (Upsert) a tabela monthly_averages (otimizada para leitura).
  • Execução: Projetado para rodar mensalmente ou sob demanda.

Scriptbatch mensal

2.2. Gestão Regional (Coordenador)

Status: Spec-only Dashboard para controle de qualidade e gestão da equipe local.

  • Validação: Tabela para aprovar/rejeitar coletas (destaque para outliers).
  • Roteiros: (Futuro) Interface para definir quais lojas os pesquisadores visitarão.

Coordenador

3. Módulo Administrativo (Backoffice)

3.1. Gestão de Catálogo (Gerente)

Status: Spec-only Responsável pela padronização dos dados. É aqui que se evita duplicidade (ex: "Fiat" vs "FIAT").

  • Ação: Cadastro de novas Marcas e Modelos que aparecerão na busca pública.

Gerente

3.2. Controle de Acesso (Administrador)

Status: Spec-only Interface técnica para gestão de usuários do sistema.

  • Ação: Criar contas para Gerentes, Coordenadores e Pesquisadores, definindo seus perfis (RBAC).

Administrador