Repository navigation
Mini Market - Customers Frontend
Esta release entrega a interface web do módulo de clientes do mini mercado, desenvolvida em React + TypeScript e estruturada para facilitar a gestão de clientes, produtos, pagamentos e compras em um ambiente de mini mercado.
Principais funcionalidades
- Gestão de Clientes: Cadastro, atualização, busca por nome ou ID, e exibição de lista de clientes com cartões personalizados.
- Gestão de Produtos: Listagem, visualização e gerenciamento de produtos disponíveis para compra.
- Pagamentos: Visualização e controle de pagamentos realizados pelos clientes.
- Compras: Fluxo de compras com exibição de produtos, carrinho, cálculo de percentuais e histórico de compras.
- Login e Controle de Usuários: Tela de login e gerenciamento de sessão.
- Leitura de QR Code: Integração para leitura de QR Codes, facilitando operações rápidas no ponto de venda.
- Interface Responsiva: Layout adaptado para diferentes dispositivos, com estilos centralizados e componentes reutilizáveis.
- Feedback ao Usuário: Mensagens de feedback e modais para confirmação de ações e exibição de informações.
- Mockups e Dados de Teste: Estrutura para simulação de dados e testes de interface.
- Configuração Modular: Separação clara entre componentes, páginas, serviços, handlers e tipos, facilitando manutenção e evolução do projeto.
Estrutura do Projeto
src/Components: Componentes reutilizáveis (Cards, Modais, Navbar, Tabelas, etc.)
src/Pages: Páginas principais do sistema (Clientes, Produtos, Home, Recebidos, Login)
src/Services: Serviços para integração com APIs de clientes, produtos e usuários
src/Handlers: Lógica de manipulação de dados e requisições
src/Types: Tipagens TypeScript para maior segurança e clareza
src/Utils: Utilitários e funções auxiliares
Configuração via .env (suporte a variáveis de ambiente para fácil adaptação entre ambientes).
Observações
- Projeto preparado para integração com backend e APIs REST.
- Utiliza Vite para build e desenvolvimento rápido.
- Estrutura pronta para deploy em ambientes como Vercel.