Skip to content

ddouglss/SaborDaVilaAppClean

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🍔 Sabor da Vila App

Aplicativo mobile profissional para gerenciamento completo de vendas, controle de estoque e administração de múltiplas lojas da lanchonete Sabor da Vila.

Desenvolvido com Expo + React Native + TypeScript, oferece uma experiência robusta e intuitiva para proprietários e administradores gerenciarem seus negócios de forma eficiente.


🌟 Funcionalidades Principais

👥 Sistema Multi-Usuário

  • Autenticação segura com registro e login
  • Múltiplas lojas por usuário
  • Sistema de roles (Usuário/Administrador)
  • Isolamento de dados por loja
  • Troca dinâmica entre lojas

📊 Dashboard Inteligente

  • Resumo de vendas do dia
  • Produtos em baixo estoque
  • Vendas recentes
  • Navegação rápida para funcionalidades

💰 Gestão de Vendas

  • Registro rápido de vendas
  • Desconto automático do estoque
  • Histórico completo com filtros
  • Relatórios em PDF e Excel

📦 Controle de Estoque

  • Gerenciamento completo de produtos
  • Alertas de estoque baixo
  • Adição/remoção de produtos
  • Controle de quantidades mínimas

🛡️ Painel Administrativo

  • Backup/Restauração do banco de dados
  • Estatísticas detalhadas do sistema
  • Exportação de dados
  • Limpeza de dados de teste
  • Gerenciamento de usuários

📱 Interface Adaptativa

  • Android: Navegação por Drawer (menu hambúrguer)
  • iOS: Navegação por abas inferiores
  • Design responsivo e moderno
  • Dark theme com cores profissionais

🔐 Credenciais de Administrador

Para acessar o painel administrativo:

  • Email: admin@sabordavila.com
  • Senha: admin123

📸 Screenshots

Android

Menu Dashboard Vendas Estoque

iOS

Dashboard iOS Vendas iOS Estoque iOS


🚀 Tecnologias

Core

  • Expo SDK 54 - Framework principal
  • React Native - Framework mobile
  • TypeScript - Tipagem estática
  • Expo Router - Navegação baseada em arquivos

Banco de Dados

  • Expo SQLite - Banco local
  • Migrations automáticas
  • Transações para integridade

UI/UX

  • Lucide React Native - Ícones modernos
  • React Native Reanimated - Animações fluidas
  • Custom Components - Interface consistente
  • Dark Theme - Design profissional

Funcionalidades Avançadas

  • Expo File System - Gerenciamento de arquivos
  • Expo Document Picker - Seleção de arquivos
  • Expo Sharing - Compartilhamento de dados
  • Expo Print - Geração de PDF
  • AsyncStorage - Cache e sessões

🛠️ Instalação

Requisitos

  • Node.js 18+
  • npm ou yarn
  • Expo CLI (opcional)

Quick Start

  1. Clone o repositório:
git clone https://github.com/ddouglss/SaborDaVilaAppClean.git
cd SaborDaVilaAppClean
  1. Instale as dependências:
npm install
# ou
yarn install
  1. Inicie o servidor de desenvolvimento:
npx expo start
# ou com cache limpo
npx expo start --clear
  1. Execute em dispositivos:
# Android
npx expo start --android

# iOS
npx expo start --ios

# Web (limitado)
npx expo start --web

📁 Arquitetura do Projeto

src/
├─ app/                     # 📱 Rotas e Telas (Expo Router)
│  ├─ tabs/                 # 📋 Navegação por abas
│  │  ├─ _layout.tsx        # Layout das abas (iOS)
│  │  ├─ index.tsx          # 🏠 Dashboard
│  │  ├─ sales.tsx          # 💰 Gestão de Vendas
│  │  ├─ inventory.tsx      # 📦 Controle de Estoque
│  │  ├─ my-shops.tsx       # 🏪 Minhas Lojas
│  │  └─ DebugScreen.tsx    # 🛠️ Debug/Admin
│  ├─ _layout.tsx           # Layout principal (Drawer Android)
│  ├─ index.tsx             # Tela inicial
│  ├─ login.tsx             # 🔐 Login
│  ├─ register.tsx          # 📝 Cadastro
│  ├─ settings.tsx          # ⚙️ Configurações
│  └─ create-first-shop.tsx # 🏪 Primeira loja
├─ components/              # 🧩 Componentes Reutilizáveis
│  ├─ Button.tsx            # Botões customizáveis
│  ├─ Card.tsx              # Cards informativos
│  ├─ Header.tsx            # Cabeçalho com navegação
│  └─ Input.tsx             # Campos de entrada
├─ context/                 # 🌐 Contextos Globais
│  └─ AuthContext.tsx       # Autenticação e estado
├─ database/                # 🗃️ Camada de Dados
│  ├─ database.ts           # Conexão SQLite
│  ├─ authRepository.ts     # Usuários e lojas
│  ├─ productRepository.ts  # Produtos
│  ├─ salesRepository.ts    # Vendas
│  └─ exportDatabase.ts     # Exportação de dados
├─ services/                # ⚙️ Serviços de Negócio
│  ├─ authService.ts        # Autenticação
│  ├─ shopService.ts        # Gerenciamento de lojas
│  ├─ adminService.ts       # 🛡️ Funcionalidades admin
│  └─ reportService.ts      # 📊 Relatórios e exports
├─ types/                   # 📋 Definições TypeScript
│  ├─ auth.ts               # Tipos de autenticação
│  └─ sales.ts              # Tipos de vendas
├─ hooks/                   # 🎣 Hooks Customizados
│  ├─ useDatabase.ts        # Hook do banco
│  └─ useShopData.ts        # Dados da loja ativa
├─ utils/                   # 🛠️ Utilitários
│  └─ shopUtils.ts          # Funções auxiliares
└─ assets/                  # 📁 Recursos Estáticos
   └─ screenshots/          # Capturas de tela

🎯 Principais Funcionalidades

🔐 Autenticação & Usuários

  • Sistema de registro com validação
  • Login seguro com hash de senha
  • Validação de CPF/CNPJ
  • Sessões persistentes
  • Sistema de roles (User/Admin)

🏪 Gestão Multi-Loja

  • Criação de múltiplas lojas
  • Troca dinâmica entre lojas
  • Isolamento completo de dados
  • Gerenciamento de lojas ativas

💼 Vendas & Estoque

  • Registro rápido de vendas
  • Controle automático de estoque
  • Alertas de estoque baixo
  • Histórico completo de vendas
  • Dashboard com métricas em tempo real

📊 Relatórios & Exports

  • Relatórios PDF (vendas, estoque, produtos)
  • Exportação para Excel (CSV)
  • Estatísticas detalhadas
  • Dados filtráveis por período

🛡️ Administração

  • Backup completo do banco de dados
  • Restauração de backups
  • Estatísticas do sistema
  • Limpeza de dados de teste
  • Gestão de usuários

🎨 Design & UX

🎨 Tema Visual

  • Cores principais: #09090B, #18181B, #FFFFFF
  • Accent: #10B981 (verde)
  • Secundárias: #A1A1AA, #71717A
  • Dark theme moderno e profissional

📱 Responsividade

  • Layout adaptativo para diferentes tamanhos
  • Navegação otimizada por plataforma
  • Componentes reutilizáveis e consistentes

🔧 Scripts Disponíveis

# Desenvolvimento
npm run start           # Inicia o Metro Bundler
npm run start:clear     # Inicia com cache limpo

# Compilação
npm run android         # Build/emula Android
npm run ios             # Build/emula iOS
npm run web             # Executa no navegador

# Manutenção
npx expo install        # Atualiza dependências do Expo
npx expo doctor         # Diagnóstico do projeto

🚦 Status do Projeto

Concluído

  • Sistema de autenticação multi-usuário
  • Gestão completa de lojas
  • Controle de vendas e estoque
  • Dashboard com métricas em tempo real
  • Sistema administrativo
  • Relatórios e exportações
  • Interface adaptativa (Android/iOS)

🔄 Em Desenvolvimento

  • Sincronização em nuvem
  • Notificações push
  • Análise avançada de dados
  • Sistema de backup automático

👨‍💻 Desenvolvedores

Douglas Souza Silva

Andressa Bonfim de Araujo

Alison Longuinho Oliveira


📄 Licença

Este projeto é privado e proprietário da equipe Sabor da Vila.


🤝 Contribuições

Este é um projeto proprietário. Para contribuições ou sugestões, entre em contato com a equipe de desenvolvimento.


🍔 Sabor da Vila - Gerenciamento Profissional de Lanchonetes

About

Sistema de gestão para a Lanchonete Sabor da Vila - Aplicativo mobile para controle de vendas e estoque.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors