Como CUSTOMER, eu quero:
  - Navegar e buscar produtos
  - Adicionar produtos ao carrinho (futuro)
  - Fazer um pedido com múltiplos itens
  - Ver meu histórico de pedidos
  - Cancelar um pedido não pago em até 30 minutos
  - Pagar por um pedido
  - Ver status do pagamento

Como ADMIN, eu quero:
  - Gerenciar produtos (CRUD)
  - Ver todos os pedidos
  - Cancelar qualquer pedido
  - Processar reembolsos
  - Ver estatísticas de negócio

Execução bem-sucedida

CREATE TABLE users (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL UNIQUE,
    email VARCHAR(100) NOT NULL UNIQUE,
    password_hash VARCHAR(255) NOT NULL,
    role VARCHAR(20) NOT NULL DEFAULT 'CUSTOMER',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

CREATE TABLE products (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(200) NOT NULL,
    sku VARCHAR(20) NOT NULL UNIQUE,
    price DECIMAL(10,2) NOT NULL,
    stock INT NOT NULL DEFAULT 0,
    category VARCHAR(50),
    status TINYINT NOT NULL DEFAULT 1,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    INDEX idx_product_name (name),
    INDEX idx_product_category (category)
);

CREATE TABLE orders (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    user_id BIGINT NOT NULL,
    order_number VARCHAR(20) NOT NULL UNIQUE,
    status VARCHAR(20) NOT NULL DEFAULT 'PENDING',
    total_amount DECIMAL(10,2) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    INDEX idx_order_user (user_id),
    INDEX idx_order_status_created (status, created_at DESC),
    FOREIGN KEY (user_id) REFERENCES users(id)
);

CREATE TABLE order_items (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    order_id BIGINT NOT NULL,
    product_id BIGINT NOT NULL,
    quantity INT NOT NULL,
    unit_price DECIMAL(10,2) NOT NULL,
    subtotal DECIMAL(10,2) NOT NULL,
    FOREIGN KEY (order_id) REFERENCES orders(id),
    FOREIGN KEY (product_id) REFERENCES products(id)
);

CREATE TABLE payments (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    order_id BIGINT NOT NULL UNIQUE,
    transaction_id VARCHAR(50) UNIQUE,
    method VARCHAR(20) NOT NULL,
    status VARCHAR(20) NOT NULL DEFAULT 'PENDING',
    amount DECIMAL(10,2) NOT NULL,
    paid_at TIMESTAMP NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (order_id) REFERENCES orders(id)
);

CREATE TABLE

// Resposta de sucesso
public record ApiResponse<T>(
    int code,
    String message,
    T data,
    Instant timestamp
) {
    public static <T> ApiResponse<T> success(T data) {
        return new ApiResponse<>(200, "OK", data, Instant.now());
    }
    public static <T> ApiResponse<T> created(T data) {
        return new ApiResponse<>(201, "Created", data, Instant.now());
    }
}

// Resposta paginada
public record PagedResponse<T>(
    List<T> content,
    int page,
    int size,
    long totalElements,
    int totalPages
) {}

// Execução bem-sucedida

# Listar produtos com paginação, ordenação e filtragem
GET /api/v1/products?page=0&size=20&sort=price,desc&category=electronics&minPrice=100&maxPrice=999

// Comando executado com sucesso

# Documento de Design do Sistema OrderFlow

## 1. Requisitos de Negócio
- Sistema de gerenciamento de pedidos de e-commerce
- 4 módulos: Usuário, Produto, Pedido, Pagamento
- 2 papéis: CUSTOMER, ADMIN
- Expectativa: 10.000 DAU, 1.000 pedidos/dia

## 2. Stack Tecnológico
- Java 17 + Spring Boot 3.2.x
- MySQL 8.0 + Spring Data JPA
- Redis 7 + Caffeine (cache de dois níveis)
- Spring Security + JWT (OAuth2 Resource Server)
- Implantação Docker + Kubernetes

## 3. Design do Banco de Dados
- 5 tabelas: users, products, orders, order_items, payments
- Índices em colunas de consulta de alta frequência

## 4. Especificação de API
- API RESTful com versionamento (/api/v1/)
- Autenticação JWT Bearer
- Formato de resposta unificado: ApiResponse<T>
- Paginação: parâmetros page, size, sort

## 5. Requisitos Não Funcionais
- Latência P99 < 100ms
- Taxa de erro < 0,1%
- Disponibilidade > 99,9%
- Cobertura de testes automatizados > 80%