Biblioteca de Trades e Ativos - Personal Finance Backend

Este projeto contém a lógica de negócios e os modelos de dados específicos para o gerenciamento de Trades (transações de compra/venda de ativos) e Assets (ativos como ações, criptomoedas, etc.).

Propósito

O objetivo desta biblioteca é encapsular toda a lógica de criação, leitura, atualização e exclusão (soft-delete) de trades e ativos. Ela interage com serviços externos (como o market-data-service para buscar detalhes de ativos) e com o banco de dados via personal-finance-backend-shared.

Conteúdo Principal

• routers/trades.py: Define endpoints para a criação, listagem e exclusão (soft-delete) de trades.
• routers/assets.py: Define endpoints para a listagem e gerenciamento de ativos.

Regras de Plano (Acesso)

As rotas desta biblioteca estão protegidas por plano mínimo plus:

• GET/POST /api/trades/*
• GET/POST /api/assets/*

Usuários free recebem 403 com payload de plan_upgrade_required. Isso garante consistência com a política de monetização do backend-core.

Tecnologias

• Framework: FastAPI (seus routers são usados por outros serviços)
• Busca de Dados Externos: Utiliza httpx para comunicação com o market-data-service.
• Banco de Dados: Interage com o PostgreSQL através da personal-finance-backend-shared.
• Dependências Locais:
  • personal-finance-backend-shared: Para acesso aos modelos, crud e utilitários.

Como Usar (Instalação como Dependência)

Este projeto não é um serviço executável por si só. Ele é projetado para ser instalado como uma dependência local por outros serviços do backend (ex: personal-finance-backend-core).

Para incluir esta biblioteca como uma dependência editável em outro serviço (por exemplo, no requirements.txt do personal-finance-backend-core), adicione a seguinte linha no requirements.txt do serviço consumidor:

-e ./personal-finance-backend-trades-assets

Importante: Certifique-se de que o contexto de build do Docker (Dockerfile) ou o script de build (dockerbuild.sh) do serviço consumidor está copiando corretamente o diretório personal-finance-backend-trades-assets para o local esperado para que o pip install -e funcione.