Maps a Player entity to a PlayerResponseDTO. @param user the Player entity to map @return a PlayerResponseDTO containing the mapped data

Debits a specified amount from a single account. @param accountId The ID of the account to be debited. @param amount The value to be debited. @param

POST /api/v1/money/transfer <p> Initiates a fund transfer from the authenticated player's account to a specified destination. The request body must be

The central, private logic for processing any single financial transaction. <p> This method handles fetching the account, validating the amount, updat

Credits a specified amount to a single account. @param accountId The ID of the account to be credited. @param amount The value to be credited. @param

A private helper method to find a user by their ID, providing a consistent error message if the user is not found. @param userId The UUID of the user

Centraliza a lógica para definir os parâmetros de distribuição de idade para cada função. @param role A função do membro da equipe. @param random A

Gera uma amostra aleatória de uma distribuição Beta. @param alpha O primeiro parâmetro de forma (α). @param beta O segundo parâmetro de forma (β).

Orquestra a criação de uma instância de CrewMember. @return Um objeto {@link CrewMember} pronto para ser persistido.

Executes the fund transfer operation. <p>This method is the single entry point for this use case. It is marked as {@code @Transactional} to ensure tha

Maps a Studio entity to a StudioResponseDTO. @param studio the Studio entity to map @return a StudioResponseDTO containing the mapped data

Retrieves a paginated list of all transactions where {@code isPrivate} is false. <p>This method is annotated with {@code @Cacheable("public_transacti

Finds all transactions that are marked as public (i.e., where {@code isPrivate} is false). <p>This method leverages Spring Data JPA's query derivatio

A private helper method to find the destination account based on the DTO. <p>This method encapsulates the logic for resolving the destination entity's

A private helper method to find an optional associated production. @param productionId The ID of the production to find. Can be null. @return The {@l

Gera um valor de criatividade artística para uma determinada função. @param role A função do membro da equipe (ex: ATOR, DIRETOR). @return Um inteiro

Gera uma data de nascimento considerando se o profissional possui educação formal. Profissionais com educação formal terão idades mínimas baseadas no

Gera um gênero com base na faixa etária (adulto ou não). <p> Para não-adultos, a simulação usa uma divisão binária (Masculino/Feminino) 50/50, simplif

Gera um valor de popularidade inicial para um membro da equipe.

Gera um nível de produtividade aleatório para um membro da equipe. <p> A produtividade é simulada como um valor entre 0 e 100.

Gera uma data de nascimento aleatória e realista para um determinado papel na equipe. @param role A função do membro da equipe (ex: ATOR, DIRETOR). @

Gera uma especialidade aleatoria.

Retrieves the balance of the studio account owned by a given user. @param userId The unique identifier of the user who owns the studio. @return An {@

Retrieves the balance of the personal account for a given user. @param userId The unique identifier of the user whose balance is being requested. @re

Obtém parâmetros de distribuição de idade considerando educação formal. @param role A função do membro da equipe. @param hasEducation Se possui educa

Verifica se a idade é adequada para um profissional com educação formal. @param role A função do membro da equipe. @param age A idade a ser verificad

Determina se um profissional de determinado papel deveria ter educação formal baseado em probabilidades realistas da indústria. @param role A função

Valida se uma idade está dentro do intervalo permitido para um papel. @param role O papel do membro da equipe. @param age A idade a ser validada. @r

Valida se uma data de nascimento é aceitável para um determinado papel. @param role O papel do membro da equipe. @param birthDate A data de nasc

Retorna todos os jogadores. @return Lista de todos os jogadores.

Retorna todos os jogadores ativos. @return Lista de jogadores ativos.

Verifica se o email já está cadastrado, exceto para o jogador atual. @param email O email a ser verificado. @param currentPlayerId O ID d

Gera uma data de nascimento automaticamente determinando se o profissional deve ter educação formal baseado na probabilidade do papel. @param role A

GET /api/v1/money/balance <p> Retrieves the balance of the currently authenticated player's personal account. Requires authentication. @param userIdS

GET /api/v1/money/balance/my-studio <p> Retrieves the balance of the studio account owned by the currently authenticated player. Requires authenticati

Verifica se a idade gerada corresponde a um adulto (18 anos ou mais). @param age A idade a ser verificada. @return {@code true} se a idade for 18 ou

GET /api/v1/money/transactions/public <p> Retrieves a paginated list of all public financial transactions. This endpoint is public and does not requir

Retorna um jogador específico pelo ID. @param userId ID do jogador a ser buscado. @return Detalhes do jogador encontrado. @throws EntityNotFoundExcep

Agendado para gerar e salvar um novo CrewMember em intervalos fixos.

Transfers funds from a source account to a destination account. <p> This operation is transactional. It is composed of a debit from the source and a c

Valida se uma data de nascimento é apropriada para um profissional com educação formal. @param role O papel do membro da equipe. @param birthDat