🚀 Projeto Vendas (Vue 3 + Vue Router + Docker Compose)

Um sistema de gestão de vendedores e vendas, feito com Vue 3, Vue Router e pronto para rodar com Docker Compose.

---

📋 Sobre o Projeto

Este é um projeto frontend de controle de vendas e vendedores, com autenticação simples via token (localStorage). Inclui rotas protegidas, navegação dinâmica e uma arquitetura organizada para facilitar a manutenção. O projeto foi configurado para rodar facilmente com Docker Compose, ideal para desenvolvimento local e ambientes de staging.

Feito com as melhores práticas e ferramentas modernas, ele combina velocidade, simplicidade e escalabilidade.

---

🧰 Tecnologias Utilizadas

• Vue.js v3 — Um framework progressivo, performático e versátil para interfaces web.
• Vue Router — Sistema de roteamento oficial para Vue, flexível e fácil de usar.
• TypeScript (opcional) — Para tipagem estática e maior segurança no código.
• Vite — Ferramenta de build rápida e moderna, baseada em módulos ES nativos.
• Yarn — Gerenciador de pacotes rápido, confiável e escalável.
• Docker & Docker Compose — Para facilitar o setup de ambiente consistente e reproduzível.

---

🛠️ Como Rodar o Projeto com Docker Compose (Primeira Instalação)

🐳 Passo a passo

1. Clone o repositório:

   git clone https://github.com/edgarleite/lwsa-sales-system-frontend.git
   cd lwsa-sales-system-frontend

2. Suba os contêineres (construção automática):

   docker compose up -d --build

   Isso irá:

   • Baixar as dependências
   • Construir a imagem Docker
   • Iniciar o app automaticamente

3. Acesse no navegador:

   👉 http://localhost:3000

4. (Opcional) Para parar o contêiner:

   docker compose down

---

🔁 Recriar Imagem Sem Cache (Opcional)

Se quiser garantir que tudo seja reconstruído do zero (útil se houve alterações nas dependências ou configurações):

docker compose build --no-cache
docker compose up -d

---

🌐 Rotas Disponíveis

Rota	Nome	Protegida?	Observação
/	Dashboard	Sim	Página inicial
/login	Login	Não	Para usuários não autenticados
/register	Register	Não	Cadastro de novos usuários
/sellers	SellersList	Sim	Lista de vendedores
/sellers/create	SellerCreate	Sim	Cadastrar novo vendedor
/sellers/:id/edit	SellerEdit	Sim	Editar dados do vendedor
/sellers/:id/sales	SalesBySeller	Sim	Ver vendas por vendedor
/sales	SalesList	Sim	Lista de todas as vendas
/sales/create	SalesCreate	Sim	Registrar nova venda
/sales/:id/edit	SalesEdit	Sim	Editar venda existente
/admin/reports	AdminReports	Sim	Relatórios administrativos

---

🔒 Autenticação

O projeto utiliza um sistema básico de autenticação baseado em token armazenado no localStorage.

• Rotas protegidas exigem que o usuário esteja autenticado.
• Rotas de convidado (/login, /register) redirecionam usuários logados para o dashboard.

---

🗂️ Estrutura do Projeto

src/
├── views/              # Telas do app
│   ├── auth/           # Login e Registro
│   ├── dashboard/      # Página inicial
│   ├── sellers/        # CRUD de vendedores
│   ├── sales/          # CRUD de vendas
│   └── admin/          # Área administrativa
├── router/             # Configuração das rotas
├── components/         # Componentes reutilizáveis
├── services/           # Serviços de API (se aplicável)
└── App.vue             # Componente principal

---