Financial Calculator Project

🚀 About the Project

The Financial Calculator Project is a robust application designed to assist users with various financial calculations, simulations, and analyses. The project is currently in progress and aims to provide a comprehensive set of tools for personal and professional financial planning.

This project uses Docker to ensure a portable and consistent development environment. Future plans include adding database integration to store user profiles, calculation history, and more.

---

✨ Features

The following features are planned for the project. Implemented features are marked as (Implemented):

1. Loan Installment Calculation (Price Table and SAC) (Implemented)

   • Calculate monthly installments using:
     • Price Table (Fixed Installments).
     • SAC (Constant Amortization System).

2. Interest Rate Conversion (Implemented)

   • Convert interest rates between different periods:
     • Monthly to annual.
     • Annual to daily.

3. Investment Simulator (Implemented)

   • Simulate capital growth over time with:
     • Initial value.
     • Monthly deposits.
     • Interest rate.
     • Time period.

4. Reports and Export (Implemented)

   • Generate detailed calculation reports in .txt or .csv formats.
   • Save reports locally using the System.IO library.

5. Profitability Analysis

   • Compare different investment options:
     • Savings yield.
     • Direct Treasury yield.
     • Stock fund yield.

6. Inflation Calculation

   • Calculate the impact of inflation on future income or costs.

7. Integration with Financial Market APIs

   • Obtain real-time financial data such as:
     • SELIC rates.
     • Currency exchange rates (dollar, euro).
     • Market indexes.

8. Graphical Interface Support

   • Add a user-friendly graphical interface using Windows Forms or WPF.

9. User Profile Customization

   • Save user preferences such as:
     • Default rates.
     • Currencies.
     • Calculation history.

10. Graphical Visualization of Results

    • Visualize financial data and growth using libraries like LiveCharts or ScottPlot.

11. Retirement Planning

    • Calculate:
      • Monthly savings needed to reach a goal.
      • Time required to accumulate a target amount.

12. Advanced Mathematical Functions

    • Perform complex financial calculations:
      • Net Present Value (NPV).
      • Internal Rate of Return (IRR).

13. Multilingual Support

    • Add support for multiple languages (e.g., Portuguese, English, Spanish).

14. Logging and Error Handling

    • Implement robust logging using ILogger or NLog.

15. Docker with Database

    • Use Docker to add database integration (PostgreSQL or SQL Server) for storing:
      • User profiles.
      • Calculation history.

---

🛠️ Technologies Used

• C# (Core development language)
• .NET Framework
• System.IO (File handling)
• Docker (Environment setup)
• Planned Database Integration: PostgreSQL or SQL Server

---

📄 Usage Instructions

1. Clone the repository:

   git clone /~https://github.com/your-username/financial-calculator.git
   cd financial-calculator

2. Run the application:

   dotnet run

3. Use Docker for containerized setup (coming soon).

---

🌟 Contributing

Contributions are welcome! Please submit issues or pull requests to enhance the project.

---

📌 Status

This project is in progress. Current focus areas include:

• Refining implemented features.
• Planning database integration and Docker configurations.

---

📞 Contact

For questions or feedback, contact Carlos Eduardo.