Files
millions/docs/00_PROJECT_BRIEF.md
2026-04-21 10:53:35 +01:00

1.5 KiB

Project Brief

Nome provisório

App de Gestão Operacional para Revenda de Roupa

Resumo

Aplicação web para gerir o ciclo operacional de um pequeno negócio de revenda de roupa, desde a encomenda ao fornecedor até ao envio ao cliente final.

Objetivo principal

Reduzir o tempo e os erros na gestão de encomendas, receção de mercadoria, controlo de stock, preparação de artigos para venda, registo de vendas e gestão de envios.

Público-alvo

Pequeno negócio de revenda de roupa com operação manual e necessidade de controlo simples, rápido e rastreável.

Problemas principais

  • Dificuldade em controlar o que foi encomendado e o que falta receber
  • Dificuldade em registar stock após receção
  • Dificuldade em saber que artigos estão prontos para venda
  • Dificuldade em controlar vendas e perceber rapidamente para quem enviar

Objetivo da V1

Criar um MVP operacional que permita controlar:

  1. encomendas ao fornecedor
  2. receções parciais e totais
  3. inventário por estado
  4. vendas e envios pendentes

Stack tecnológica selecionada

  • Next.js 16 com App Router
  • TypeScript
  • PostgreSQL
  • Prisma ORM
  • Supabase (database, auth, storage)
  • Tailwind CSS
  • shadcn/ui
  • React Hook Form
  • Zod

Princípios técnicos

  • Uma única codebase full-stack na V1
  • Backend implementado dentro do projeto Next.js
  • Arquitetura simples, modular e orientada ao domínio
  • Documentação Markdown como fonte de verdade
  • Projeto preparado para desenvolvimento assistido por agentes de IA