@marcos_feitoza/personal-finance-frontend-feature-dashboard 1.0.0

package/.circleci/config.yml

@@ -0,0 +1,23 @@
+version: 2.1
+
+jobs:
+  release:
+    docker:
+      - image: circleci/node:latest
+    steps:
+      - checkout
+      - run:
+          name: Install dependencies
+          command: npm install
+      - run:
+          name: Run semantic-release
+          command: npx semantic-release
+
+workflows:
+  build-and-release:
+    jobs:
+      - release:
+          filters:
+            branches:
+              only:
+                - main

package/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "fcf2c11572af6f390246c056bc905eca609533a0"
+  channel: "stable"
+
+project_type: package

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# 1.0.0 (2025-11-22)
+
+
+### Bug Fixes
+
+* add currency class ([99d9217](https://github.com/MarcosOps/personal-finance-frontend-feature-dashboard/commit/99d9217d571d15e709b1a16d3845d3e72a244683))
+* add date logs ([45e0a40](https://github.com/MarcosOps/personal-finance-frontend-feature-dashboard/commit/45e0a40ac9dd690b902e6c345e8bbec9247c8b09))
+* add ignore and more estilo ([ad1c97a](https://github.com/MarcosOps/personal-finance-frontend-feature-dashboard/commit/ad1c97a4cc267788d92a0912696d0dba3240609a))
+* add new classes ([973d2c7](https://github.com/MarcosOps/personal-finance-frontend-feature-dashboard/commit/973d2c71a0798ba1020c6456267e37dcbad936a7))
+* dark mode funcionando ([f4d9417](https://github.com/MarcosOps/personal-finance-frontend-feature-dashboard/commit/f4d9417ee9ad686273397a8bd925fb81407b82ef))
+
+
+### Features
+
+* add avatar ([a1b720a](https://github.com/MarcosOps/personal-finance-frontend-feature-dashboard/commit/a1b720aa0cd8fd3a70ffcfdac7e7049066416c8f))
+
+## 0.0.1
+
+* TODO: Describe initial release.

package/LICENSE

@@ -0,0 +1 @@
+TODO: Add your license here.

package/README.md

@@ -0,0 +1,39 @@
+<!--
+This README describes the package. If you publish this package to pub.dev,
+this README's contents appear on the landing page for your package.
+
+For information about how to write a good package README, see the guide for
+[writing package pages](https://dart.dev/tools/pub/writing-package-pages).
+
+For general information about developing packages, see the Dart guide for
+[creating packages](https://dart.dev/guides/libraries/create-packages)
+and the Flutter guide for
+[developing packages and plugins](https://flutter.dev/to/develop-packages).
+-->
+
+TODO: Put a short description of the package here that helps potential users
+know whether this package might be useful for them.
+
+## Features
+
+TODO: List what your package can do. Maybe include images, gifs, or videos.
+
+## Getting started
+
+TODO: List prerequisites and provide or point to information on how to
+start using the package.
+
+## Usage
+
+TODO: Include short and useful examples for package users. Add longer examples
+to `/example` folder.
+
+```dart
+const like = 'sample';
+```
+
+## Additional information
+
+TODO: Tell users more about the package: where to find more information, how to
+contribute to the package, how to file issues, what response they can expect
+from the package authors, and more.

package/analysis_options.yaml

@@ -0,0 +1,4 @@
+include: package:flutter_lints/flutter.yaml
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options

package/lib/personal_finance_frontend_feature_dashboard.dart

@@ -0,0 +1,5 @@
+/// A Calculator.
+class Calculator {
+  /// Returns [value] plus 1.
+  int addOne(int value) => value + 1;
+}

package/lib/screens/home_screen.dart

@@ -0,0 +1,694 @@
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:personal_finance_frontend_core_ui/widgets/salary_form.dart';
+import 'package:personal_finance_frontend_core_ui/widgets/expense_form.dart';
+import 'package:personal_finance_frontend_core_ui/widgets/investment_form.dart';
+import 'package:personal_finance_frontend_feature_reports/screens/salary_report_screen.dart';
+import 'package:personal_finance_frontend_feature_charts/screens/salary_chart_screen.dart';
+import 'package:provider/provider.dart';
+import 'package:personal_finance_frontend_feature_reports/screens/expense_report_screen.dart';
+import 'package:personal_finance_frontend_feature_charts/screens/expense_chart_screen.dart';
+import 'package:personal_finance_frontend_feature_reports/screens/summary_report_screen.dart';
+import 'package:personal_finance_frontend_feature_management/screens/manage_transactions_screen.dart';
+import 'package:personal_finance_frontend_feature_reports/screens/move_money_report_screen.dart';
+import 'package:personal_finance_frontend_feature_investments/screens/investment_account_screen.dart';
+import 'package:personal_finance_frontend_feature_investments/screens/rrsp_sun_life_screen.dart';
+import 'package:personal_finance_frontend_feature_investments/screens/crypto_account_screen.dart';
+import 'package:personal_finance_frontend_feature_charts/viewmodels/salary_chart_viewmodel.dart';
+import 'package:personal_finance_frontend_feature_reports/viewmodels/expense_report_viewmodel.dart';
+import 'package:personal_finance_frontend_core_services/services/transaction_service.dart';
+import 'package:personal_finance_frontend_core_ui/utils/currency_input_formatter.dart';
+import 'package:personal_finance_frontend_core_services/models/payment_method.dart';
+import 'package:intl/intl.dart';
+import 'package:personal_finance_frontend_feature_management/screens/reconciliation_screen.dart';
+import 'package:personal_finance_frontend_core_ui/widgets/app_widgets.dart';
+import 'package:personal_finance_frontend_core_ui/utils/theme_notifier.dart';
+import 'package:personal_finance_frontend_core_services/providers/auth_provider.dart';
+import 'package:personal_finance_frontend_core_ui/widgets/user_profile_avatar.dart';
+
+class HomeScreen extends StatefulWidget {
+  const HomeScreen({Key? key}) : super(key: key);
+
+  @override
+  _HomeScreenState createState() => _HomeScreenState();
+}
+
+final String currencySymbol = r'$';
+
+String _formatCurrency(double value) {
+  final format = NumberFormat.currency(
+    symbol: currencySymbol,
+    decimalDigits: 2,
+    locale: 'en_US', // garante vírgula de milhar e ponto decimal no padrão US
+  );
+  return format.format(value);
+}
+
+class _HomeScreenState extends State<HomeScreen> {
+  final _salaryFormKey = GlobalKey<FormState>();
+  final _expenseFormKey = GlobalKey<FormState>();
+  final _investmentFormKey = GlobalKey<FormState>();
+
+  final _rbcCashController = TextEditingController();
+  final _wealthsimpleCashController = TextEditingController();
+  final _rbcCardController = TextEditingController();
+  final _bmoCardController = TextEditingController();
+
+  final TransactionService _transactionService = TransactionService();
+  double _totalIncome = 0.0;
+  double _totalExpenses = 0.0;
+  double _rbcUnpaidExpenses = 0.0;
+  double _bmoUnpaidExpenses = 0.0;
+
+  List<Map<String, dynamic>> _cashTransactions = [];
+  List<Map<String, dynamic>> _rbcTransactions = [];
+  List<Map<String, dynamic>> _bmoTransactions = [];
+  List<Map<String, dynamic>> _investments = [];
+  Map<String, double> _accountBalances = {};
+
+  bool _isLoading = true;
+  String? _selectedMenu;
+
+  final List<String> _investmentAccountNames = [
+    'TFSA',
+    'RRSP Wealthsimple',
+    'Non-Registered',
+    'Crypto'
+  ];
+
+  @override
+  void initState() {
+    super.initState();
+    // Fetch data after the first frame is built
+    WidgetsBinding.instance.addPostFrameCallback((_) => _fetchData());
+  }
+
+  @override
+  void dispose() {
+    _rbcCashController.dispose();
+    _wealthsimpleCashController.dispose();
+    _rbcCardController.dispose();
+    _bmoCardController.dispose();
+    super.dispose();
+  }
+
+  Future<void> _fetchData() async {
+    if (!mounted) return;
+    final authProvider = Provider.of<AuthProvider>(context, listen: false);
+    final token = authProvider.token;
+
+    setState(() {
+      _isLoading = true;
+    });
+    try {
+      // Fetch all balances, including the definitive cash balance from the backend
+      final cashBalanceFuture =
+          _transactionService.getAccountBalance('CASH', token: token);
+      final investmentBalanceFutures = _investmentAccountNames
+          .map((name) =>
+              _transactionService.getAccountBalance(name, token: token))
+          .toList();
+
+      final otherFutures = <Future<dynamic>>[
+        _transactionService.getSummaryByPaymentMethod(token: token),
+        _transactionService.fetchTransactions(
+            paymentMethod: 'CASH', limit: 10, token: token),
+        _transactionService.fetchTransactions(
+            paymentMethod: 'RBC', limit: 10, token: token),
+        _transactionService.fetchTransactions(
+            paymentMethod: 'BMO', limit: 10, token: token),
+        _transactionService.getInvestments(token: token),
+      ];
+
+      // Await all futures
+      final allInvestmentBalances = await Future.wait(investmentBalanceFutures);
+      final cashBalance = await cashBalanceFuture;
+      final otherResults = await Future.wait(otherFutures);
+
+      // Safely build the account balances map
+      _accountBalances = {'CASH': cashBalance};
+      for (int i = 0; i < _investmentAccountNames.length; i++) {
+        _accountBalances[_investmentAccountNames[i]] = allInvestmentBalances[i];
+      }
+
+      final pmSummary = otherResults[0] as List<Map<String, dynamic>>;
+      _rbcUnpaidExpenses = 0.0;
+      _bmoUnpaidExpenses = 0.0;
+      for (var item in pmSummary) {
+        final paymentMethod =
+            (item['payment_method'] as String?)?.toUpperCase();
+        if (paymentMethod == 'RBC') {
+          _rbcUnpaidExpenses += double.parse(item['unpaid_amount'].toString());
+        } else if (paymentMethod == 'BMO') {
+          _bmoUnpaidExpenses += double.parse(item['unpaid_amount'].toString());
+        }
+      }
+
+      _cashTransactions = otherResults[1] as List<Map<String, dynamic>>;
+      _rbcTransactions = otherResults[2] as List<Map<String, dynamic>>;
+      _bmoTransactions = otherResults[3] as List<Map<String, dynamic>>;
+      _investments = otherResults[4] as List<Map<String, dynamic>>;
+    } catch (e) {
+      print('Error fetching data: $e');
+    } finally {
+      if (mounted) {
+        setState(() {
+          _isLoading = false;
+        });
+      }
+    }
+  }
+
+  Widget _buildMainMenu(BuildContext context) {
+    return ListView(
+      padding: EdgeInsets.zero,
+      children: <Widget>[
+        const DrawerHeader(
+          decoration: BoxDecoration(
+            color: Colors.blue,
+          ),
+          child: Text(
+            'Menu',
+            style: TextStyle(
+              color: Colors.white,
+              fontSize: 24,
+            ),
+          ),
+        ),
+        ListTile(
+          leading: const Icon(Icons.assessment),
+          title: const Text('Investments'),
+          onTap: () {
+            setState(() {
+              _selectedMenu = 'investments';
+            });
+          },
+        ),
+        ListTile(
+          leading: const Icon(Icons.description),
+          title: const Text('Reports'),
+          onTap: () {
+            setState(() {
+              _selectedMenu = 'reports';
+            });
+          },
+        ),
+        ListTile(
+          leading: const Icon(Icons.bar_chart),
+          title: const Text('Charts'),
+          onTap: () {
+            setState(() {
+              _selectedMenu = 'charts';
+            });
+          },
+        ),
+        ListTile(
+          leading: const Icon(Icons.settings),
+          title: const Text('Management'),
+          onTap: () {
+            setState(() {
+              _selectedMenu = 'management';
+            });
+          },
+        ),
+      ],
+    );
+  }
+
+  Widget _buildSubMenu(BuildContext context) {
+    List<Widget> items;
+    String title;
+
+    switch (_selectedMenu) {
+      case 'investments':
+        title = 'Investments';
+        items = [
+          ..._investmentAccountNames.map((accountName) {
+            final balance = _accountBalances[accountName] ?? 0.0;
+            final formattedBalance = _formatCurrency(balance);
+            return ListTile(
+              title: Text('  $accountName - $formattedBalance'),
+              onTap: () {
+                Navigator.pop(context); // Close drawer
+                if (accountName == 'Crypto') {
+                  Navigator.push(
+                    context,
+                    MaterialPageRoute(
+                      builder: (context) =>
+                          CryptoAccountScreen(accountName: accountName),
+                    ),
+                  );
+                } else {
+                  Navigator.push(
+                    context,
+                    MaterialPageRoute(
+                      builder: (context) => InvestmentAccountScreen(
+                        accountName: accountName,
+                        showDividends: accountName != 'Crypto',
+                      ),
+                    ),
+                  );
+                }
+              },
+            );
+          }).toList(),
+          ListTile(
+            title: const Text('  RRSP Sun Life'),
+            onTap: () {
+              Navigator.pop(context); // Close drawer
+              Navigator.push(
+                context,
+                MaterialPageRoute(
+                    builder: (context) => const RrspSunLifeScreen()),
+              );
+            },
+          ),
+        ];
+        break;
+      case 'reports':
+        title = 'Reports';
+        items = [
+          ListTile(
+            title: const Text('  Salary Report'),
+            onTap: () {
+              Navigator.pop(context);
+              Navigator.push(
+                context,
+                MaterialPageRoute(
+                    builder: (context) => const SalaryReportScreen()),
+              );
+            },
+          ),
+          ListTile(
+            title: const Text('  Expense Report'),
+            onTap: () {
+              Navigator.pop(context);
+              Navigator.push(
+                context,
+                MaterialPageRoute(
+                    builder: (context) => const ExpenseReportScreen()),
+              );
+            },
+          ),
+          ListTile(
+            title: const Text('  Summary Report'),
+            onTap: () {
+              Navigator.pop(context);
+              Navigator.push(
+                context,
+                MaterialPageRoute(
+                    builder: (context) => const SummaryReportScreen()),
+              );
+            },
+          ),
+          ListTile(
+            title: const Text('  Move Money Report'),
+            onTap: () {
+              Navigator.pop(context);
+              Navigator.push(
+                  context,
+                  MaterialPageRoute(
+                      builder: (context) => const MovemoneyReportScreen()));
+            },
+          ),
+        ];
+        break;
+      case 'charts':
+        title = 'Charts';
+        items = [
+          ListTile(
+            title: const Text('  Salary Chart'),
+            onTap: () {
+              Navigator.pop(context);
+              Navigator.push(
+                context,
+                MaterialPageRoute(
+                    builder: (context) => const SalaryChartScreen()),
+              );
+            },
+          ),
+          ListTile(
+            title: const Text('  Expense Chart'),
+            onTap: () {
+              Navigator.pop(context);
+              Navigator.push(
+                context,
+                MaterialPageRoute(
+                    builder: (context) => const ExpenseChartScreen()),
+              );
+            },
+          ),
+        ];
+        break;
+      case 'management':
+        title = 'Management';
+        items = [
+          ListTile(
+            title: const Text('  Manage Transactions'),
+            onTap: () {
+              Navigator.pop(context);
+              Navigator.push(
+                context,
+                MaterialPageRoute(
+                    builder: (context) => const ManageTransactionsScreen()),
+              ).then((_) => _fetchData());
+            },
+          ),
+          ListTile(
+            title: const Text('  Reconciliation'),
+            onTap: () {
+              Navigator.pop(context);
+              Navigator.push(
+                context,
+                MaterialPageRoute(
+                    builder: (context) => const ReconciliationScreen(
+                        paymentMethod: '')), // Pass empty string for now
+              );
+            },
+          ),
+        ];
+        break;
+      default:
+        items = [];
+        title = 'Menu';
+    }
+
+    return ListView(
+      padding: EdgeInsets.zero,
+      children: <Widget>[
+        AppBar(
+          title: Text(title),
+          backgroundColor: Theme.of(context).primaryColor,
+          leading: IconButton(
+            icon: const Icon(Icons.arrow_back),
+            onPressed: () {
+              setState(() {
+                _selectedMenu = null;
+              });
+            },
+          ),
+          automaticallyImplyLeading: false,
+        ),
+        ...items,
+      ],
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final double totalUserCash =
+        CurrencyInputFormatter.unformat(_rbcCashController.text) +
+            CurrencyInputFormatter.unformat(_wealthsimpleCashController.text);
+
+    final double appCalculatedCash = _accountBalances['CASH'] ?? 0.0;
+    final token = Provider.of<AuthProvider>(context, listen: false).token;
+
+    return Scaffold(
+      appBar: AppBar(
+        title: const Text('Personal Finance Dashboard'),
+        actions: [
+          const UserProfileAvatar(),
+          Consumer<ThemeNotifier>(
+            builder: (context, themeNotifier, child) {
+              return IconButton(
+                icon: Icon(themeNotifier.themeMode == ThemeMode.dark
+                    ? Icons.dark_mode
+                    : Icons.light_mode),
+                onPressed: () {
+                  themeNotifier.setThemeMode(
+                      themeNotifier.themeMode == ThemeMode.dark
+                          ? ThemeMode.light
+                          : ThemeMode.dark);
+                },
+              );
+            },
+          ),
+          IconButton(
+            icon: const Icon(Icons.logout),
+            onPressed: () {
+              Provider.of<AuthProvider>(context, listen: false).logout();
+            },
+          ),
+        ],
+      ),
+      drawer: Drawer(
+        child: _selectedMenu == null
+            ? _buildMainMenu(context)
+            : _buildSubMenu(context),
+      ),
+      body: _isLoading
+          ? const Center(child: CircularProgressIndicator())
+          : SingleChildScrollView(
+              padding: const EdgeInsets.all(16.0),
+              child: Column(
+                crossAxisAlignment: CrossAxisAlignment.start,
+                children: [
+                  Row(
+                    crossAxisAlignment: CrossAxisAlignment.start,
+                    children: [
+                      Expanded(
+                          child: _buildCashBalanceCard(
+                              totalUserCash, appCalculatedCash)),
+                      const SizedBox(width: 16),
+                      Expanded(
+                          child: _buildCreditCardBalanceCard('RBC Balance',
+                              _rbcCardController, _rbcUnpaidExpenses)),
+                      const SizedBox(width: 16),
+                      Expanded(
+                          child: _buildCreditCardBalanceCard('BMO Balance',
+                              _bmoCardController, _bmoUnpaidExpenses)),
+                    ],
+                  ),
+                  const SizedBox(height: 16),
+                  Row(
+                    crossAxisAlignment: CrossAxisAlignment.start,
+                    children: [
+                      Expanded(
+                          child: _buildRecentTransactionsList(
+                              'Cash Transactions', _cashTransactions)),
+                      const SizedBox(width: 16),
+                      Expanded(
+                          child: _buildRecentTransactionsList(
+                              'RBC Transactions', _rbcTransactions)),
+                      const SizedBox(width: 16),
+                      Expanded(
+                          child: _buildRecentTransactionsList(
+                              'BMO Transactions', _bmoTransactions)),
+                      const SizedBox(width: 16),
+                      Expanded(
+                          child: ExpenseForm(
+                        formKey: _expenseFormKey,
+                        onTransactionSuccess: _fetchData,
+                        token: token,
+                      )),
+                    ],
+                  ),
+                  const SizedBox(height: 16),
+                  Row(
+                    crossAxisAlignment: CrossAxisAlignment.start,
+                    children: [
+                      Expanded(
+                          child: InvestmentForm(
+                        formKey: _investmentFormKey,
+                        accountBalances: _accountBalances,
+                        cashBalance: appCalculatedCash,
+                        onTransactionSuccess: _fetchData,
+                        token: token,
+                      )),
+                      const SizedBox(width: 16),
+                      Expanded(
+                          child: SalaryForm(
+                        formKey: _salaryFormKey,
+                        onTransactionSuccess: _fetchData,
+                        token: token,
+                      )),
+                    ],
+                  ),
+                ],
+              ),
+            ),
+      floatingActionButton: FloatingActionButton(
+        onPressed: _fetchData,
+        tooltip: 'Refresh Data',
+        child: const Icon(Icons.refresh),
+      ),
+    );
+  }
+
+  Widget _buildCashBalanceCard(double totalUserCash, double appCalculatedCash) {
+    final double difference = totalUserCash - appCalculatedCash;
+
+    String differenceLabel = 'Balance is correct';
+    Color differenceColor = Theme.of(context).colorScheme.secondary;
+    String differenceText = _formatCurrency(difference);
+
+    if (difference > 0.01) {
+      differenceLabel = 'Missing Income:';
+      differenceColor = Colors.green;
+      differenceText = '+${_formatCurrency(difference)}';
+    } else if (difference < -0.01) {
+      differenceLabel = 'Missing Expenses:';
+      differenceColor = Colors.red;
+    }
+
+    return AppFormCard(
+      title: 'Cash Balance',
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          _buildBalanceTextField(_rbcCashController, 'RBC Bank Balance'),
+          const SizedBox(height: 12),
+          _buildBalanceTextField(
+              _wealthsimpleCashController, 'Wealthsimple Balance'),
+          const SizedBox(height: 16),
+          const Divider(),
+          const SizedBox(height: 10),
+          _buildResultRow(
+              'Manual Entry Balance:', '${_formatCurrency(totalUserCash)}'),
+          _buildResultRow(
+              'Calculated Balance:', '${_formatCurrency(appCalculatedCash)}'),
+          const SizedBox(height: 10),
+          _buildResultRow(differenceLabel, differenceText,
+              isHighlighted: true, color: differenceColor),
+        ],
+      ),
+    );
+  }
+
+  Widget _buildCreditCardBalanceCard(
+      String title, TextEditingController controller, double appExpenses) {
+    final double userBalance = CurrencyInputFormatter.unformat(controller.text);
+    final double difference = appExpenses - userBalance;
+
+    String differenceLabel = 'Balance is correct';
+    Color differenceColor = Theme.of(context).colorScheme.secondary;
+    String differenceText = '${_formatCurrency(difference)}';
+
+    if (difference > 0.01) {
+      differenceLabel = 'Missing Expenses:';
+      differenceColor = Colors.red;
+      differenceText = '+${_formatCurrency(difference)}';
+    } else if (difference < -0.01) {
+      differenceLabel = 'Missing Refund:';
+      differenceColor = Colors.green;
+    }
+
+    return AppFormCard(
+      title: title,
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          _buildBalanceTextField(controller, 'Statement Balance:'),
+          const SizedBox(height: 16),
+          const Divider(),
+          const SizedBox(height: 10),
+          _buildResultRow(
+              'Manual Entry Balance:', '${_formatCurrency(userBalance)}'),
+          _buildResultRow(
+              'Calculated Balance:', '${_formatCurrency(appExpenses)}'),
+          const SizedBox(height: 10),
+          _buildResultRow(differenceLabel, differenceText,
+              isHighlighted: true, color: differenceColor),
+          const SizedBox(height: 16),
+          Align(
+            alignment: Alignment.centerRight,
+            child: TextButton(
+              onPressed: () {
+                String paymentMethod = 'unknown';
+                if (title.toLowerCase().contains('rbc')) {
+                  paymentMethod = 'rbc';
+                } else if (title.toLowerCase().contains('bmo')) {
+                  paymentMethod = 'bmo';
+                }
+                Navigator.push(
+                  context,
+                  MaterialPageRoute(
+                    builder: (context) =>
+                        ReconciliationScreen(paymentMethod: paymentMethod),
+                  ),
+                ).then((_) => _fetchData()); // Refresh data when returning
+              },
+              child: const Text('Reconcile'),
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+
+  Widget _buildBalanceTextField(
+      TextEditingController controller, String label) {
+    return TextFormField(
+      controller: controller,
+      decoration: InputDecoration(
+        labelText: label,
+        border: OutlineInputBorder(
+          borderRadius: BorderRadius.circular(16.0),
+        ),
+      ),
+      keyboardType: const TextInputType.numberWithOptions(decimal: true),
+      inputFormatters: [CurrencyInputFormatter()],
+      onChanged: (value) => setState(() {}),
+    );
+  }
+
+  Widget _buildResultRow(String label, String value,
+      {bool isHighlighted = false, Color color = Colors.black}) {
+    return Row(
+      mainAxisAlignment: MainAxisAlignment.spaceBetween,
+      children: [
+        Text(label, style: const TextStyle(fontSize: 16)),
+        Text(
+          value,
+          style: TextStyle(
+            fontSize: 16,
+            fontWeight: isHighlighted ? FontWeight.bold : FontWeight.normal,
+            color: isHighlighted ? color : null,
+          ),
+        ),
+      ],
+    );
+  }
+
+  Widget _buildRecentTransactionsList(
+      String title, List<Map<String, dynamic>> transactions) {
+    return AppFormCard(
+      title: title,
+      child: transactions.isEmpty
+          ? const Text('No recent transactions.')
+          : Column(
+              children: transactions.map((transaction) {
+                final date = DateFormat('MM/dd')
+                    .format(DateTime.parse(transaction['date']));
+                final amount = double.parse(transaction['amount'].toString())
+                    .toStringAsFixed(2);
+                final subcategory =
+                    transaction['subcategory'] ?? 'No subcategory';
+                final type = transaction['type'] == 'debit' ? '-' : '+';
+                final color =
+                    transaction['type'] == 'debit' ? Colors.red : Colors.green;
+
+                return Padding(
+                  padding: const EdgeInsets.symmetric(vertical: 4.0),
+                  child: Row(
+                    mainAxisAlignment: MainAxisAlignment.spaceBetween,
+                    children: [
+                      Expanded(
+                        child: Text(
+                          '$date - $subcategory',
+                          overflow: TextOverflow.ellipsis,
+                        ),
+                      ),
+                      Text(
+                        '$type\u0024$amount',
+                        style: TextStyle(
+                            color: color, fontWeight: FontWeight.bold),
+                      ),
+                    ],
+                  ),
+                );
+              }).toList(),
+            ),
+    );
+  }
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+    "name": "@marcos_feitoza/personal-finance-frontend-feature-dashboard",
+    "version": "1.0.0",
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "release": "semantic-release"
+    },
+    "devDependencies": {
+        "semantic-release": "^18.0.0",
+        "@semantic-release/changelog": "^6.0.0",
+        "@semantic-release/git": "^10.0.0",
+        "@semantic-release/github": "^8.0.0"
+    },
+    "release": {
+        "branches": [
+            "main"
+        ],
+        "plugins": [
+            "@semantic-release/commit-analyzer",
+            "@semantic-release/release-notes-generator",
+            "@semantic-release/changelog",
+            "@semantic-release/npm",
+            "@semantic-release/github",
+            "@semantic-release/git"
+        ]
+    }
+}

package/pubspec.yaml

@@ -0,0 +1,67 @@
+name: personal_finance_frontend_feature_dashboard
+description: "A new Flutter package project."
+version: 0.0.1
+homepage:
+
+environment:
+  sdk: '>=2.19.0 <3.0.0'
+
+dependencies:
+  flutter:
+    sdk: flutter
+  intl: ^0.17.0
+  provider: ^6.0.0
+  personal_finance_frontend_core_services:
+    path: ../personal-finance-frontend-core-services
+  personal_finance_frontend_core_ui:
+    path: ../personal-finance-frontend-core-ui
+  personal_finance_frontend_feature_reports:
+    path: ../personal-finance-frontend-feature-reports
+  personal_finance_frontend_feature_charts:
+    path: ../personal-finance-frontend-feature-charts
+  personal_finance_frontend_feature_investments:
+    path: ../personal-finance-frontend-feature-investments
+  personal_finance_frontend_feature_management:
+    path: ../personal-finance-frontend-feature-management
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_lints: ^5.0.0
+
+# For information on the generic Dart part of this file, see the
+# following page: https://dart.dev/tools/pub/pubspec
+
+# The following section is specific to Flutter packages.
+flutter:
+
+  # To add assets to your package, add an assets section, like this:
+  # assets:
+  #   - images/a_dot_burr.jpeg
+  #   - images/a_dot_ham.jpeg
+  #
+  # For details regarding assets in packages, see
+  # https://flutter.dev/to/asset-from-package
+  #
+  # An image asset can refer to one or more resolution-specific "variants", see
+  # https://flutter.dev/to/resolution-aware-images
+
+  # To add custom fonts to your package, add a fonts section here,
+  # in this "flutter" section. Each entry in this list should have a
+  # "family" key with the font family name, and a "fonts" key with a
+  # list giving the asset and other descriptors for the font. For
+  # example:
+  # fonts:
+  #   - family: Schyler
+  #     fonts:
+  #       - asset: fonts/Schyler-Regular.ttf
+  #       - asset: fonts/Schyler-Italic.ttf
+  #         style: italic
+  #   - family: Trajan Pro
+  #     fonts:
+  #       - asset: fonts/TrajanPro.ttf
+  #       - asset: fonts/TrajanPro_Bold.ttf
+  #         weight: 700
+  #
+  # For details regarding fonts in packages, see
+  # https://flutter.dev/to/font-from-package

package/test/personal_finance_frontend_feature_dashboard_test.dart

@@ -0,0 +1,12 @@
+import 'package:flutter_test/flutter_test.dart';
+
+import 'package:personal_finance_frontend_feature_dashboard/personal_finance_frontend_feature_dashboard.dart';
+
+void main() {
+  test('adds one to input values', () {
+    final calculator = Calculator();
+    expect(calculator.addOne(2), 3);
+    expect(calculator.addOne(-7), -6);
+    expect(calculator.addOne(0), 1);
+  });
+}