samfert · staging-devin-ai-integration · Jan 9, 2026 · Jan 9, 2026 · Jan 9, 2026 · Jan 9, 2026
diff --git a/app/Api/V1/Controllers/Autocomplete/AccountController.php b/app/Api/V1/Controllers/Autocomplete/AccountController.php
@@ -40,6 +40,10 @@
 
 /**
  * Class AccountController
+ *
+ * Controlador da API responsavel pelo autocomplete de contas.
+ * Fornece sugestoes de contas para campos de busca com suporte
+ * a filtragem por tipo e exibicao de saldo.
  */
 class AccountController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/BillController.php b/app/Api/V1/Controllers/Autocomplete/BillController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class BillController
+ *
+ * Controlador da API responsavel pelo autocomplete de faturas.
+ * Fornece sugestoes de faturas/assinaturas para campos de busca
+ * com informacoes de nome e status ativo.
  */
 class BillController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/BudgetController.php b/app/Api/V1/Controllers/Autocomplete/BudgetController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class BudgetController
+ *
+ * Controlador da API responsavel pelo autocomplete de orcamentos.
+ * Fornece sugestoes de orcamentos para campos de busca
+ * com informacoes de ID e nome.
  */
 class BudgetController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/CategoryController.php b/app/Api/V1/Controllers/Autocomplete/CategoryController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class CategoryController
+ *
+ * Controlador da API responsavel pelo autocomplete de categorias.
+ * Fornece sugestoes de categorias para campos de busca
+ * com informacoes de ID e nome.
  */
 class CategoryController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/CurrencyController.php b/app/Api/V1/Controllers/Autocomplete/CurrencyController.php
@@ -34,6 +34,10 @@
 
 /**
  * Class CurrencyController
+ *
+ * Controlador da API responsavel pelo autocomplete de moedas.
+ * Fornece sugestoes de moedas para campos de busca com
+ * informacoes de codigo, simbolo e casas decimais.
  */
 class CurrencyController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/ObjectGroupController.php b/app/Api/V1/Controllers/Autocomplete/ObjectGroupController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class ObjectGroupController
+ *
+ * Controlador da API responsavel pelo autocomplete de grupos de objetos.
+ * Fornece sugestoes de grupos para campos de busca com
+ * informacoes de ID e titulo.
  */
 class ObjectGroupController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/PiggyBankController.php b/app/Api/V1/Controllers/Autocomplete/PiggyBankController.php
@@ -34,6 +34,10 @@
 
 /**
  * Class PiggyBankController
+ *
+ * Controlador da API responsavel pelo autocomplete de cofrinhos.
+ * Fornece sugestoes de cofrinhos para campos de busca com
+ * informacoes de saldo, moeda e grupo de objetos.
  */
 class PiggyBankController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/RecurrenceController.php b/app/Api/V1/Controllers/Autocomplete/RecurrenceController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class RecurrenceController
+ *
+ * Controlador da API responsavel pelo autocomplete de recorrencias.
+ * Fornece sugestoes de transacoes recorrentes para campos de busca
+ * com informacoes de titulo e descricao.
  */
 class RecurrenceController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/RuleController.php b/app/Api/V1/Controllers/Autocomplete/RuleController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class RuleController
+ *
+ * Controlador da API responsavel pelo autocomplete de regras.
+ * Fornece sugestoes de regras de automacao para campos de busca
+ * com informacoes de titulo e descricao.
  */
 class RuleController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/RuleGroupController.php b/app/Api/V1/Controllers/Autocomplete/RuleGroupController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class RuleGroupController
+ *
+ * Controlador da API responsavel pelo autocomplete de grupos de regras.
+ * Fornece sugestoes de grupos de regras para campos de busca
+ * com informacoes de titulo e descricao.
  */
 class RuleGroupController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/TagController.php b/app/Api/V1/Controllers/Autocomplete/TagController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class TagController
+ *
+ * Controlador da API responsavel pelo autocomplete de tags.
+ * Fornece sugestoes de tags para campos de busca
+ * com informacoes de ID e nome da tag.
  */
 class TagController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/TransactionController.php b/app/Api/V1/Controllers/Autocomplete/TransactionController.php
@@ -36,6 +36,10 @@
 
 /**
  * Class TransactionController
+ *
+ * Controlador da API responsavel pelo autocomplete de transacoes.
+ * Fornece sugestoes de transacoes para campos de busca
+ * com informacoes de descricao e ID do grupo.
  */
 class TransactionController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Autocomplete/TransactionTypeController.php b/app/Api/V1/Controllers/Autocomplete/TransactionTypeController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class TransactionTypeController
+ *
+ * Controlador da API responsavel pelo autocomplete de tipos de transacao.
+ * Fornece sugestoes de tipos (deposito, saque, transferencia) para
+ * campos de busca com informacoes de ID e tipo.
  */
 class TransactionTypeController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Chart/AccountController.php b/app/Api/V1/Controllers/Chart/AccountController.php
@@ -40,6 +40,10 @@
 
 /**
  * Class AccountController
+ *
+ * Controlador da API responsavel por graficos de contas.
+ * Gera dados para graficos de saldo de contas ao longo do tempo
+ * com suporte a conversao de moedas.
  */
 class AccountController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Chart/BalanceController.php b/app/Api/V1/Controllers/Chart/BalanceController.php
@@ -20,6 +20,10 @@
 
 /**
  * Class BalanceController
+ *
+ * Controlador da API responsavel por graficos de balanco.
+ * Gera dados para graficos de receitas e despesas agrupados
+ * por periodo com suporte a conversao de moedas.
  */
 class BalanceController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Chart/BudgetController.php b/app/Api/V1/Controllers/Chart/BudgetController.php
@@ -44,6 +44,10 @@
 
 /**
  * Class BudgetController
+ *
+ * Controlador da API responsavel por graficos de orcamentos.
+ * Gera dados para graficos de gastos vs orcado, incluindo
+ * valores restantes e excedidos por periodo.
  */
 class BudgetController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Chart/CategoryController.php b/app/Api/V1/Controllers/Chart/CategoryController.php
@@ -42,7 +42,11 @@
 use Illuminate\Support\Facades\Log;
 
 /**
- * Class BudgetController
+ * Class CategoryController
+ *
+ * Controlador da API responsavel por graficos de categorias.
+ * Gera dados para graficos de gastos por categoria
+ * com suporte a conversao de moedas.
  */
 class CategoryController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Controller.php b/app/Api/V1/Controllers/Controller.php
@@ -52,6 +52,11 @@
 /**
  * Class Controller.
  *
+ * Classe base abstrata para todos os controladores da API V1.
+ * Fornece funcionalidades comuns como gerenciamento de parametros,
+ * validacao de headers HTTP, conversao de moedas e serializacao JSON API.
+ * Todos os controladores da API devem estender esta classe.
+ *
  * @SuppressWarnings("PHPMD.CouplingBetweenObjects")
  * @SuppressWarnings("PHPMD.NumberOfChildren")
  */

diff --git a/app/Api/V1/Controllers/Data/Bulk/TransactionController.php b/app/Api/V1/Controllers/Data/Bulk/TransactionController.php
@@ -34,12 +34,9 @@
 /**
  * Class TransactionController
  *
- * Endpoint to update transactions by submitting
- * (optional) a "where" clause and an "update"
- * clause.
- *
- * Because this is a security nightmare waiting to happen validation
- * is pretty strict.
+ * Controlador da API responsavel por operacoes em massa de transacoes.
+ * Permite atualizar transacoes em lote usando clausulas "where" e "update"
+ * com validacao rigorosa por questoes de seguranca.
  */
 class TransactionController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Data/DestroyController.php b/app/Api/V1/Controllers/Data/DestroyController.php
@@ -51,6 +51,10 @@
 
 /**
  * Class DestroyController
+ *
+ * Controlador da API responsavel pela exclusao em massa de dados.
+ * Permite excluir orcamentos, faturas, cofrinhos, regras, categorias,
+ * tags, contas e transacoes de forma massiva.
  */
 class DestroyController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Data/Export/ExportController.php b/app/Api/V1/Controllers/Data/Export/ExportController.php
@@ -36,6 +36,10 @@
 
 /**
  * Class ExportController
+ *
+ * Controlador da API responsavel pela exportacao de dados.
+ * Permite exportar contas, faturas, orcamentos, categorias,
+ * cofrinhos, recorrencias, regras, tags e transacoes em CSV.
  */
 class ExportController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Data/PurgeController.php b/app/Api/V1/Controllers/Data/PurgeController.php
@@ -42,6 +42,10 @@
 
 /**
  * Class PurgeController
+ *
+ * Controlador da API responsavel pela limpeza de dados excluidos.
+ * Remove permanentemente registros que foram soft-deleted
+ * como orcamentos, faturas, contas e transacoes.
  */
 class PurgeController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Expense/AccountController.php b/app/Api/V1/Controllers/Insight/Expense/AccountController.php
@@ -34,8 +34,9 @@
 /**
  * Class AccountController
  *
- * Shows expense information grouped or limited by date.
- * I.e. all expenses grouped by account + currency.
+ * Controlador da API responsavel por insights de despesas por conta.
+ * Exibe informacoes de despesas agrupadas por conta de origem
+ * ou destino com suporte a filtragem por periodo.
  */
 class AccountController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Expense/BillController.php b/app/Api/V1/Controllers/Insight/Expense/BillController.php
@@ -35,6 +35,10 @@
 
 /**
  * Class BillController
+ *
+ * Controlador da API responsavel por insights de despesas por fatura.
+ * Exibe informacoes de despesas agrupadas por fatura/assinatura
+ * com suporte a conversao de moedas.
  */
 class BillController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Expense/BudgetController.php b/app/Api/V1/Controllers/Insight/Expense/BudgetController.php
@@ -35,6 +35,10 @@
 
 /**
  * Class BudgetController
+ *
+ * Controlador da API responsavel por insights de despesas por orcamento.
+ * Exibe informacoes de despesas agrupadas por orcamento
+ * incluindo despesas sem orcamento definido.
  */
 class BudgetController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Expense/CategoryController.php b/app/Api/V1/Controllers/Insight/Expense/CategoryController.php
@@ -35,6 +35,10 @@
 
 /**
  * Class CategoryController
+ *
+ * Controlador da API responsavel por insights de despesas por categoria.
+ * Exibe informacoes de despesas agrupadas por categoria
+ * incluindo despesas sem categoria definida.
  */
 class CategoryController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Expense/PeriodController.php b/app/Api/V1/Controllers/Insight/Expense/PeriodController.php
@@ -34,6 +34,10 @@
 
 /**
  * Class PeriodController
+ *
+ * Controlador da API responsavel por insights de despesas por periodo.
+ * Exibe o total de despesas em um periodo especifico
+ * com suporte a conversao para moeda primaria.
  */
 class PeriodController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Expense/TagController.php b/app/Api/V1/Controllers/Insight/Expense/TagController.php
@@ -35,6 +35,10 @@
 
 /**
  * Class TagController
+ *
+ * Controlador da API responsavel por insights de despesas por tag.
+ * Exibe informacoes de despesas agrupadas por tag
+ * incluindo despesas sem tag definida.
  */
 class TagController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Income/AccountController.php b/app/Api/V1/Controllers/Insight/Income/AccountController.php
@@ -34,8 +34,9 @@
 /**
  * Class AccountController
  *
- * Shows income information grouped or limited by date.
- * I.e. all income grouped by account + currency.
+ * Controlador da API responsavel por insights de receitas por conta.
+ * Exibe informacoes de receitas agrupadas por conta de destino
+ * ou origem com suporte a filtragem por periodo.
  */
 class AccountController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Income/CategoryController.php b/app/Api/V1/Controllers/Insight/Income/CategoryController.php
@@ -35,6 +35,10 @@
 
 /**
  * Class CategoryController
+ *
+ * Controlador da API responsavel por insights de receitas por categoria.
+ * Exibe informacoes de receitas agrupadas por categoria
+ * incluindo receitas sem categoria definida.
  */
 class CategoryController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Income/PeriodController.php b/app/Api/V1/Controllers/Insight/Income/PeriodController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class PeriodController
+ *
+ * Controlador da API responsavel por insights de receitas por periodo.
+ * Exibe o total de receitas em um periodo especifico
+ * com suporte a conversao para moeda primaria.
  */
 class PeriodController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Income/TagController.php b/app/Api/V1/Controllers/Insight/Income/TagController.php
@@ -34,6 +34,10 @@
 
 /**
  * Class TagController
+ *
+ * Controlador da API responsavel por insights de receitas por tag.
+ * Exibe informacoes de receitas agrupadas por tag
+ * incluindo receitas sem tag definida.
  */
 class TagController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Transfer/AccountController.php b/app/Api/V1/Controllers/Insight/Transfer/AccountController.php
@@ -32,6 +32,10 @@
 
 /**
  * Class AccountController
+ *
+ * Controlador da API responsavel por insights de transferencias por conta.
+ * Exibe informacoes de transferencias entre contas de ativos
+ * com suporte a filtragem por periodo.
  */
 class AccountController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Transfer/CategoryController.php b/app/Api/V1/Controllers/Insight/Transfer/CategoryController.php
@@ -35,6 +35,10 @@
 
 /**
  * Class CategoryController
+ *
+ * Controlador da API responsavel por insights de transferencias por categoria.
+ * Exibe informacoes de transferencias agrupadas por categoria
+ * incluindo transferencias sem categoria definida.
  */
 class CategoryController extends Controller
 {

diff --git a/app/Api/V1/Controllers/Insight/Transfer/PeriodController.php b/app/Api/V1/Controllers/Insight/Transfer/PeriodController.php
@@ -33,6 +33,10 @@
 
 /**
  * Class PeriodController
+ *
+ * Controlador da API responsavel por insights de transferencias por periodo.
+ * Exibe o total de transferencias em um periodo especifico
+ * com suporte a conversao para moeda primaria.
  */
 class PeriodController extends Controller
 {