Arquitetura do Projeto

restaurantix-frontend/
├── public/                          # Arquivos estáticos
│   ├── icons/                      # Ícones da aplicação
│   ├── images/                     # Imagens e logos
│   └── favicon.ico                 # Favicon
├── src/
│   ├── app/                        # App Router (Next.js 14)
│   │   ├── (auth)/                # Grupo de rotas de autenticação
│   │   │   ├── login/             # Página de login
│   │   │   └── layout.tsx         # Layout para auth
│   │   ├── (dashboard)/           # Grupo de rotas do dashboard
│   │   │   ├── dashboard/         # Página principal
│   │   │   ├── orders/            # Gestão de pedidos
│   │   │   ├── products/          # Gestão de produtos
│   │   │   ├── settings/          # Configurações
│   │   │   └── layout.tsx         # Layout do dashboard
│   │   ├── api/                   # API Routes (se necessário)
│   │   ├── globals.css            # Estilos globais
│   │   ├── layout.tsx             # Layout raiz
│   │   ├── loading.tsx            # Loading UI global
│   │   ├── error.tsx              # Error UI global
│   │   ├── not-found.tsx          # 404 page
│   │   └── page.tsx               # Página inicial
│   ├── components/                # Componentes reutilizáveis
│   │   ├── ui/                    # Componentes base (shadcn/ui)
│   │   │   ├── button.tsx
│   │   │   ├── card.tsx
│   │   │   ├── input.tsx
│   │   │   └── ...
│   │   ├── layout/                # Componentes de layout
│   │   │   ├── header.tsx
│   │   │   ├── sidebar.tsx
│   │   │   ├── footer.tsx
│   │   │   └── navigation.tsx
│   │   ├── forms/                 # Componentes de formulário
│   │   │   ├── login-form.tsx
│   │   │   ├── order-form.tsx
│   │   │   └── product-form.tsx
│   │   ├── charts/                # Componentes de gráficos
│   │   │   ├── revenue-chart.tsx
│   │   │   ├── orders-chart.tsx
│   │   │   └── metrics-card.tsx
│   │   └── features/              # Componentes específicos
│   │       ├── auth/              # Componentes de autenticação
│   │       ├── orders/            # Componentes de pedidos
│   │       └── dashboard/         # Componentes do dashboard
│   ├── lib/                       # Utilitários e configurações
│   │   ├── utils.ts               # Funções utilitárias
│   │   ├── api.ts                 # Cliente da API
│   │   ├── auth.ts                # Configuração de auth
│   │   ├── validations.ts         # Schemas de validação
│   │   └── constants.ts           # Constantes da aplicação
│   ├── hooks/                     # Custom hooks
│   │   ├── use-auth.ts            # Hook de autenticação
│   │   ├── use-orders.ts          # Hook para pedidos
│   │   ├── use-local-storage.ts   # Hook para localStorage
│   │   └── use-debounce.ts        # Hook de debounce
│   ├── store/                     # Estado global (Zustand)
│   │   ├── auth-store.ts          # Store de autenticação
│   │   ├── orders-store.ts        # Store de pedidos
│   │   └── ui-store.ts            # Store da UI
│   ├── types/                     # Definições de tipos
│   │   ├── index.ts               # Tipos gerais
│   │   ├── auth.ts                # Tipos de autenticação
│   │   ├── orders.ts              # Tipos de pedidos
│   │   └── api.ts                 # Tipos da API
│   └── styles/                    # Estilos adicionais
│       └── components.css         # Estilos de componentes
├── .env.local                     # Variáveis de ambiente locais
├── .env.example                   # Exemplo de variáveis
├── .gitignore                     # Arquivos ignorados pelo Git
├── eslint.config.mjs              # Configuração ESLint
├── .prettierrc                    # Configuração Prettier
├── components.json                # Configuração shadcn/ui
├── next.config.js                 # Configuração Next.js
├── package.json                   # Dependências e scripts
├── tailwind.config.ts             # Configuração Tailwind
├── tsconfig.json                  # Configuração TypeScript
└── README.md                      # Documentação do projeto

import { dirname } from "path";
import { fileURLToPath } from "url";
import { FlatCompat } from "@eslint/eslintrc";

const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);

const compat = new FlatCompat({
  baseDirectory: __dirname
});

const eslintConfig = [
  ...compat.extends("next/core-web-vitals", "next/typescript"),
  ...compat.config({
    rules: {
      "no-console": "warn",
      "no-unused-vars": ["warn", { argsIgnorePattern: "^_" }],
      "@typescript-eslint/no-unused-vars": "error",
      "@typescript-eslint/no-explicit-any": "warn",
      "prefer-const": "error",
      "no-var": "error",
      "object-shorthand": "error",
      "prefer-template": "error"
    }
  }),
  {
    files: ["**/*.ts", "**/*.tsx"],
    languageOptions: {
      parserOptions: {
        project: "./tsconfig.json"
      }
    }
  },
];

export default eslintConfig;

{
  "arrowParens": "always",
  "trailingComma": "all",
  "endOfLine": "auto",
  "bracketSpacing": true,
  "singleQuote": true,
  "semi": true,
  "tabWidth": 2,
  "printWidth": 100,
  "jsxSingleQuote": false,
  "bracketSameLine": false,
  "quoteProps": "as-needed",
  "proseWrap": "preserve"
}

{
  "compilerOptions": {
    "target": "ES2017",
    "lib": ["dom", "dom.iterable", "esnext"],
    "allowJs": true,
    "skipLibCheck": true,
    "strict": true,
    "noEmit": true,
    "esModuleInterop": true,
    "module": "esnext",
    "moduleResolution": "bundler",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "jsx": "preserve",
    "incremental": true,
    "plugins": [
      {
        "name": "next"
      }
    ],
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"],
      "@/components/*": ["./src/components/*"],
      "@/lib/*": ["./src/lib/*"],
      "@/hooks/*": ["./src/hooks/*"],
      "@/store/*": ["./src/store/*"],
      "@/types/*": ["./src/types/*"]
    }
  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
  "exclude": ["node_modules"]
}

# API Configuration
NEXT_PUBLIC_API_URL=http://localhost:3333
NEXT_PUBLIC_APP_NAME=Restaurantix
NEXT_PUBLIC_APP_VERSION=1.0.0   

import { z } from 'zod'

const envSchema = z.object({
  NEXT_PUBLIC_API_URL: z.string().url(),
  NEXT_PUBLIC_APP_NAME: z.string().min(1),
  NEXT_PUBLIC_APP_VERSION: z.string().min(1) 
})

export const env = envSchema.parse({
  NEXT_PUBLIC_API_URL: process.env.NEXT_PUBLIC_API_URL,
  NEXT_PUBLIC_APP_NAME: process.env.NEXT_PUBLIC_APP_NAME,
  NEXT_PUBLIC_APP_VERSION: process.env.NEXT_PUBLIC_APP_VERSION 
})

// Uso: import { env } from '@/lib/env'
// const apiUrl = env.NEXT_PUBLIC_API_URL

{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "lint": "next lint",
    "lint:fix": "next lint --fix",
    "type-check": "tsc --noEmit",
    "format": "prettier --write .",
    "format:check": "prettier --check .",
    "clean": "rm -rf .next out node_modules/.cache",
    "analyze": "ANALYZE=true next build",
    "test": "vitest run",
    "test:watch": "vitest --watch",
    "test:coverage": "vitest --coverage",
    "test:ui": "vitest --ui"
  }
}

# Desenvolvimento
npm run dev              # Iniciar servidor de desenvolvimento
npm run type-check       # Verificar tipos TypeScript
npm run lint            # Verificar problemas de código
npm run format          # Formatar código

# Build e Deploy
npm run build           # Build para produção
npm run start           # Iniciar servidor de produção
npm run analyze         # Analisar bundle size

# Manutenção
npm run clean           # Limpar cache e builds
npm audit fix           # Corrigir vulnerabilidades
npm outdated            # Verificar dependências desatualizadas

# Testes
npm run test           # Executar testes
npm run test:watch     # Executar testes em watch mode
npm run test:coverage  # Gerar cobertura de testes
npm run test:ui        # Executar testes com interface gráfica

# Testes com Vitest
npm run test           # Executar testes
npm run test:watch     # Executar testes em watch mode
npm run test:coverage  # Gerar cobertura de testes
npm run test:ui        # Executar testes com interface gráfica