PayFlow

Sistema completo de gestao de faturas, clientes e pagamentos.

Tech Stack

• Framework: Next.js 14 (App Router)
• Language: TypeScript (strict mode)
• Styling: Tailwind CSS v3
• Components: shadcn/ui + Radix UI
• Database: Supabase (PostgreSQL)
• ORM: Prisma 5
• Validation: Zod v4
• Testing: Vitest + Playwright

Features

• Autenticacao com email/senha e Google OAuth
• Dashboard com metricas e graficos
• CRUD de clientes
• Gestao de faturas com itens
• Registro de pagamentos
• Tema claro/escuro
• Row Level Security (RLS)

Getting Started

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local

# Generate Prisma client
npx prisma generate

# Run development server
npm run dev

Environment Variables

NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
DATABASE_URL=your-database-url
DIRECT_URL=your-direct-url

Scripts

npm run dev          # Start development server
npm run build        # Production build
npm run lint         # ESLint
npm run typecheck    # TypeScript check
npm run test         # Unit tests
npm run test:e2e     # E2E tests
npm run format       # Prettier format

Project Structure

src/
├── app/             # Next.js App Router pages & API routes
├── components/      # React components (UI + features)
├── hooks/           # Custom React hooks
├── lib/             # Configuration (Prisma, Supabase, utils)
├── repositories/    # Data access layer
├── schemas/         # Zod validation schemas
├── services/        # Business logic layer
├── tests/           # Test files
├── types/           # TypeScript type definitions
└── utils/           # Utility functions