Smart Vision

Smart Vision é um projeto universitário desenvolvido durante a minha graduação em Ciência da Computação: uma aplicação web para gestão de estoque no varejo óptico. É um trabalho acadêmico, não um produto comercial, e ainda está em desenvolvimento.

Meu papel

Desenvolvedor principal. Projetei as tabelas do banco de dados e construí a maior parte do back end e do front end, do modelo de dados à interface.

Contexto

O projeto toma o varejo óptico como domínio. Os produtos desse setor têm atributos técnicos que ferramentas genéricas de estoque modelam mal: graus de lentes, lotes de lentes de contato com data de validade e tratamentos como o antirreflexo.

Escopo

• Catálogo de produtos organizado por categoria: armações e óculos de sol, lentes oftálmicas, lentes de contato e insumos de laboratório.
• Entradas e saídas de estoque, especificadas como capacidades separadas.
• Conciliação de inventário, para comparar o estoque registrado com o contado.
• Alertas de reposição para itens que ficam abaixo de um limite.
• Trilha de auditoria: as movimentações são registradas com o operador e um motivo padronizado, e guardadas em um log de eventos no backend.
• Autenticação com contas de membros.

Arquitetura

Interface Streamlit
        |
Camada de serviços em Python
  Cliente Xano, validação,
  autenticação, catálogo
        |  REST
Backend Xano
  autenticação, endpoints
  de estoque, log de eventos
        |
Banco de dados relacional

A interface nunca fala diretamente com o backend. Uma camada de serviços em Python encapsula a API REST do Xano, valida os dados e concentra as regras de negócio em um só lugar.

Práticas de engenharia

• Testes automatizados com pytest: 12 módulos de teste cobrindo o cliente Xano, as regras e os contratos de inventário, as saídas de estoque, os alertas, a autenticação e o catálogo de produtos.
• Especificação primeiro: as funcionalidades são descritas com OpenSpec (proposta, design, especificação e tarefas) antes da implementação. O repositório contém as specs do catálogo de produtos, da saída de estoque e da conciliação de inventário.
• Backend versionado: o workspace do Xano (grupos de API, tabelas e funções) é exportado e mantido no repositório junto com o código.

Stack

Python 3.11+, Streamlit, Xano (API REST), pytest e OpenSpec.

Links

• Código-fonte no GitHub