HOG Invest

Organização do Projeto

• etc/ - Documentos e Outros arquivos relacionados ao Projeto
  • DBModel/ - Modelos do Banco de Dados
• src/ - Códigos do Sistema
• root/ - UI do Sistema, pasta publicada pela URL

Requisitos e Defnições

Lançamento das Operações stockOperation

Requisitos

• Deverão ser lançadas (ou importadas) as operações realizadas pelo usuário, como compra, venda, subscrição, doação (donatário ou doador), etc.. Operações compulsórias como bonificações, resgates, mudanças de tickers, incorporações, etc., deverão ser tratadas automaticamente pelo sistema com base em 'conhecimento público' e não lançadas manualmente.
• O sistema deve permitir um lançamento de 'ajuste', tanto para aumentar quanto para decrementar a quantidade de ativos da carteira, talvez para lançar operações que o sistema ainda não contemple.
• Em caso de troca de ticker, incorporação, merge e outras operações em que o ticker troque por algum motivo, o lançamento deve conter a referência para o ticker atual e para o ticker original da operação, para efeitos de rastreabilidade.

Arquitetura

• Campos do Lançamento:
  • idUser: Referência à tabela de user - Para saber de quem é o lançamento
  • idStock: Referência à tabela de stock - Deve sempre estar relacionado com o ticker em que a quantidade atual pertence, mesmo que a operação tenha sido realiza com outro ticker ou stock (casos de merge, incorporação, troca de ticker, etc)
  • idStockOriginal: Referência à tabela de stock - Segundo relacionamento para manter o relacionamento com a Stock original da operação (antes de qualquer migração). Quando não há alterações do ticker em que a operação foi realizada deve ter o mesmo valor de idStock.
  • date: Data em que a operação foi realizada.
  • operation: Enumeração que indica a operação realizada:
    • BUY - Compra
    • SELL - Venda
    • SUBSCRIPTION - Subscrições (mesmo efeito que a compra, mas registra que não há nota de corretagem)
  • quantity - Quantidade de ativos envolvidos na operação
  • grossValue - Valor Bruto (Calculado somente pela quantidade de ativos * seu preço unitário), não considera corretagem, impostos, emolumentos, etc.
  • netValue - Valor Líquido (calculado considerando o valor efetivamente movimentado, incluindo as taxas, emolumentos, etc. - NÃO DEVE INCLUIR OS IMPOSTOS DE RENDA RETIDOS)
  • irrf - Valor do Imposto de Renda retido na fonte nas operações de venda.