Feat/test by AxelPCG · Pull Request #6 · AxelPCG/techshop

AxelPCG · 2026-05-12T00:57:52Z

title: [DOCS]: Atualiza documentação com novas features e backlog

Descrição

Este PR atualiza a documentação do projeto para refletir o planejamento de novas funcionalidades. As principais alterações incluem:

Criação de um novo PRD (PRD_AUTH.md) para a funcionalidade de Autenticação e Perfis de Usuário.
Atualização do BACKLOG.md para consolidar todas as User Stories (do MVP e de Autenticação), incluindo links para as issues recém-criadas no GitHub.

Esta atualização centraliza o planejamento e facilita o rastreamento do desenvolvimento das próximas features.

Tipo de Alteração

Marque com um x as caixas que se aplicam:

Bug fix (alteração não-disruptiva que corrige um problema)
New feature (alteração não-disruptiva que adiciona funcionalidade)
Breaking change (correção ou funcionalidade que faria com que a funcionalidade existente não funcionasse como esperado)
Documentation (adiciona ou atualiza a documentação)
Refactoring (nenhuma alteração funcional, apenas melhoria de código)

Como Isso Foi Testado?

Como esta é uma alteração puramente de documentação, não há testes de código a serem executados. A verificação foi feita revisando os arquivos gerados para garantir que o conteúdo está correto e os links para as issues estão funcionando.

Revisão visual dos arquivos BACKLOG.md e PRD_AUTH.md.
Verificação dos links para as issues no GitHub.

Checklist

Meu código segue as diretrizes de estilo deste projeto.
Eu realizei uma auto-revisão do meu próprio código.
Eu comentei meu código, particularmente em áreas de difícil compreensão.
Eu fiz as alterações correspondentes na documentação.
Minhas alterações não geram novos avisos (warnings).
Eu adicionei testes que provam que minha correção é eficaz ou que minha funcionalidade funciona.
Testes de unidade novos e existentes passam localmente com minhas alterações.

…ent API

Copilot

Pull request overview

Este PR amplia o projeto TechShop com um fluxo de carrinho + checkout, incluindo uma página HTML estática para simulação, testes unitários e um workflow de CI para rodar a suíte de testes.

Changes:

Adiciona rotas FastAPI para carrinho (/cart/add, /cart) e checkout (/checkout) e serving de estáticos em /app.
Introduz orquestração de checkout com “serviços” (estoque, frete, desconto, pagamento) e um frontend simples em static/index.html.
Adiciona testes unitários para ShoppingCart e um workflow de CI com uv + pytest-cov.

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 18 comments.

Show a summary per file

File	Description
uv.lock	Atualiza lockfile do `uv` (inclui novas deps como pandas/numpy).
pyproject.toml	Adiciona `pandas` como dependência de runtime.
src/main.py	Implementa rotas de carrinho/checkout e monta arquivos estáticos.
src/checkout.py	Implementa orquestração de checkout e serviços auxiliares.
src/models.py	Adiciona modelo `UserData`.
static/index.html	Página estática para simular chamadas ao backend.
tests/test_cart.py	Testes unitários para `ShoppingCart`.
.github/workflows/ci.yml	Novo workflow de CI para instalar deps e rodar testes com cobertura.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'


+        pip install uv
+        uv --version
+    - name: Install dependencies
+      run: uv sync


 requires-python = ">=3.12"
 dependencies = [
    "fastapi>=0.136.1",
+    "pandas>=3.0.3",


+def test_discount_empty_cart(product_1):
+    """
+    Testa o cálculo de desconto para um carrinho vazio (caso de borda).
+    """
+    # Arrange
+    cart = ShoppingCart()
+


+    def charge(self, amount: float, user_id: int) -> Dict[str, Any]:
+        print(f"--- Processando pagamento de R$ {amount:.2f} para o usuário {user_id}... ---")
+        if 0 < amount < 9999:
+            print("--- Pagamento APROVADO (simulado) ---")
+            return {"status": "pagamento_aprovado", "transaction_id": "xyz123abc"}
+        else:
+            print("--- Pagamento RECUSADO (simulado) ---")
+            raise ConnectionError("Falha ao processar pagamento: valor inválido.")
+


+                cartDetailsDiv.innerHTML = `<pre>${JSON.stringify(data, null, 2)}</pre>`;
+            } catch (error) {
+                console.error('Erro ao buscar carrinho:', error);
+                cartDetailsDiv.innerHTML = `<p style="color: red;">${error.message}</p>`;
+            }


+                checkoutStatusDiv.innerHTML = `<h3>Compra Finalizada!</h3><pre>${JSON.stringify(data, null, 2)}</pre>`;
+                fetchCart(); // Atualiza o carrinho (deve estar vazio)
+            } catch (error) {
+                console.error('Erro no checkout:', error);
+                checkoutStatusDiv.innerHTML = `<p style="color: red;">${error.message}</p>`;
+            }


+def product_1():
+    """Retorna um produto de exemplo com preço 10.00."""
+    return Product(id=1, name="Test Product 1", price=10.00, category="Test")
+
+@pytest.fixture
+def product_2():
+    """Retorna um produto de exemplo com preço 50.00."""
+    return Product(id=2, name="Test Product 2", price=50.00, category="Test")
+
+@pytest.fixture
+def product_expensive():
+    """Retorna um produto caro para testar descontos."""
+    return Product(id=3, name="Expensive Product", price=600.00, category="Test")
+
+@pytest.fixture
+def product_very_expensive():


+@app.post("/cart/add", response_model=CartItem, tags=["Carrinho"])
+def add_to_cart(item: CartItem, cart: ShoppingCart = Depends(get_cart)):
+    """
+    Adiciona um item ao carrinho de compras do usuário.
+
+    Se o produto já existir no carrinho, a quantidade será somada.
+    """
+    cart.add_item(item.product, item.quantity)
+    return item
+
+@app.get("/cart", tags=["Carrinho"])
+def get_cart_details(cart: ShoppingCart = Depends(get_cart)):
+    """
+    Retorna os detalhes do carrinho de compras do usuário, incluindo
+    os itens, o subtotal e o total com descontos aplicados.
+    """
+    return {
+        "items": cart.items,
+        "subtotal": cart.calculate_total(),
+        "total_with_discount": cart.calculate_total_with_discount(),
+    }
+
+@app.post("/checkout", tags=["Checkout"])
+def perform_checkout(user_data: UserData, cart: ShoppingCart = Depends(get_cart)):
+    """


…tication and user profiles

Copilot

Pull request overview

Copilot reviewed 11 out of 13 changed files in this pull request and generated 14 comments.

Comments suppressed due to low confidence (4)

src/main.py:23

StaticFiles(directory="static") depende do CWD (pode quebrar quando o app é iniciado fora da raiz do repo). Para tornar mais robusto, resolva o caminho com base no arquivo (ex.: Path(__file__).../static).

# Monta a pasta 'static' para servir arquivos estáticos (nosso frontend)
app.mount("/app", StaticFiles(directory="static", html=True), name="static")

pyproject.toml:11

O texto do PR descreve uma alteração “puramente de documentação”, mas este PR também adiciona dependências (ex.: pandas/httpx), novos módulos/rotas FastAPI, testes e workflow de CI. Ajuste a descrição/título para refletir o escopo real ou separe em PRs menores (docs vs código) para facilitar revisão e rastreabilidade.

    "fastapi>=0.136.1",
    "pandas>=3.0.3",
    "pydantic>=2.13.4",
    "uvicorn>=0.46.0",

tests/test_main.py:30

Pelas diretrizes do projeto (docs/DIRETRIZES_IA.md), os testes devem seguir o padrão AAA (Arrange/Act/Assert). Aqui vários testes não separam explicitamente essas fases (alguns têm só asserts). Padronizar melhora legibilidade e manutenção.

# Testes para a rota /cart/add
def test_add_to_cart_success(mock_cart, sample_cart_item):
    response = client.post("/cart/add", json=sample_cart_item.model_dump())
    assert response.status_code == 200
    assert len(mock_cart.items) == 1

tests/test_checkout.py:33

Os testes deste arquivo nem sempre seguem explicitamente o padrão AAA exigido nas diretrizes (docs/DIRETRIZES_IA.md). Padronizar com blocos/Comentários de Arrange/Act/Assert em cada teste melhora consistência e facilita revisão.

# Testes para StockValidator
def test_stock_validator_success(sample_cart_item):
    validator = StockValidator()
    assert validator.validate([sample_cart_item]) is True

+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'


+from typing import List, Dict, Any
+from .models import CartItem, UserData
+
+# --- Protocolos para Injeção de Dependência ---
+
+class StockValidatorProtocol:
+    def validate(self, items: List[CartItem]) -> bool: ...
+
+class ShippingServiceProtocol:
+    def calculate(self, items: List[CartItem]) -> float: ...
+
+class DiscountServiceProtocol:
+    def calculate(self, total_value: float, user: UserData) -> float: ...
+
+class PaymentServiceProtocol:


+    def validate(self, items: List[CartItem]) -> bool:
+        print("--- Validando estoque... ---")
+        for item in items:
+            # Lógica de estoque mockada
+            mock_stock = 10


+class StockValidator:
+    """Valida o estoque dos itens (implementação mock)."""
+    def validate(self, items: List[CartItem]) -> bool:
+        print("--- Validando estoque... ---")


+from typing import List, Dict, Any

-app = FastAPI()
+from .models import CartItem, UserData, Product
+from .cart import ShoppingCart


+def test_checkout_empty_cart(mock_cart):
+    response = client.post("/checkout", json=UserData(id=1, name="Test", email="a@a.com", is_vip=False).model_dump())
+    assert response.status_code == 400


@@ -0,0 +1,152 @@
+import pytest
+from unittest.mock import MagicMock, patch


+    return UserData(id=1, name="VIP User", email="vip@test.com", is_vip=True)
+
+@pytest.fixture
+def regular_user():
+    return UserData(id=2, name="Regular User", email="regular@test.com", is_vip=False)


+Implementar um sistema de autenticação seguro que permita aos usuários criar contas, fazer login/logout e gerenciar um perfil básico. Isso é fundamental para personalizar a experiência de compra e permitir o rastreamento de pedidos.
+
+#### 2. Requisitos Funcionais
+*   **US8:** Como um novo usuário, quero poder me cadastrar na plataforma usando e-mail and senha para ter uma conta pessoal.


+class PaymentService:
+    """Serviço que interage com a API de pagamento."""
+    def __init__(self, payment_api: FakePaymentAPI):
+        self.payment_api = payment_api


AxelPCG added 4 commits May 10, 2026 22:19

feat: implement initial checkout processing logic with simulated paym…

7084489

…ent API

refactor: refatoração checkour-chaos

f4f13b3

feat: add static frontend e integração com FastAPI

6f4ee33

Refactor code structure for improved readability and maintainability

fc99f57

Copilot AI review requested due to automatic review settings May 12, 2026 00:57

fix: set PYTHONPATH environment variable for test coverage

3c5490b

Copilot started reviewing on behalf of AxelPCG May 12, 2026 00:58 View session

Copilot AI reviewed May 12, 2026

View reviewed changes

AxelPCG added 6 commits May 12, 2026 17:21

feat: add coverage configuration to pytest settings

38647ea

feat: add unit tests for checkout process and cart functionality

1e54269

feat: update CI workflow to install development dependencies

dd3e97c

feat: update CI workflow to install development dependencies correctly

c3dff17

feat: add step to create virtual environment in CI workflow

e1323d7

feat: update backlog and add product requirements document for authen…

ca12b5b

…tication and user profiles

AxelPCG requested a review from Copilot May 12, 2026 23:03

Copilot started reviewing on behalf of AxelPCG May 12, 2026 23:04 View session

Copilot AI reviewed May 12, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Feat/test - #6

Feat/test#6
AxelPCG wants to merge 11 commits into
mainfrom
feat/test

AxelPCG commented May 12, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		@@ -0,0 +1,152 @@
		import pytest
		from unittest.mock import MagicMock, patch

Conversation

AxelPCG commented May 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Descrição

Tipo de Alteração

Como Isso Foi Testado?

Checklist

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

AxelPCG commented May 12, 2026 •

edited

Loading