FinanceTracker

FinanceTracker is a personal finance management platform designed to help users manage their income and expenses efficiently. The application allows users to track financial transactions, categorize expenses, generate financial reports, and communicate with financial advisors. The platform provides real-time notifications and a user-friendly interface for an enhanced experience.

Features

1. User Registration and Login:

   • Secure user authentication using ASP.NET Core Identity.
   • User profile management.

2. Income and Expense Management:

   • Add, edit, and delete income and expense records.
   • Categorize transactions (e.g., food, transportation, entertainment).
   • Display financial summaries, including current balance, total income, and expenses.

3. Graphical and Report Visualization:

   • Generate monthly and yearly financial reports.
   • Display interactive charts using libraries like Chart.js or ngx-charts.
   • Export reports to PDF or Excel.

4. Alerts and Notifications:

   • Real-time notifications using SignalR for pending transactions, payment deadlines, and financial goals.
   • Customizable alerts for users.

5. Transaction Search and Filters:

   • Advanced search functionality to find specific transactions.
   • Filters by category, date, and amount.

6. Receipt and Proof Upload:

   • Upload photos of receipts and payment proofs.
   • Display a gallery of images associated with transactions.

7. Private Messaging System:

   • Real-time chat with financial advisors using SignalR.
   • Message history and management.

8. Deployment:

   • Application deployment on Heroku utilizing free services.

Technologies Used

• Backend:

  • ASP.NET Core Web API
  • Entity Framework Core
  • AutoMapper
  • SignalR

• Frontend:

  • Angular
  • Angular Material or ngx-bootstrap for UI components
  • Reactive Forms and Template Forms for form handling
  • Chart.js or ngx-charts for data visualization
  • Bootstrap for responsive and attractive UI

• Database:

  • SQL Server or PostgreSQL

• Deployment:

  • Heroku for application hosting

Development Steps

1. Setting Up the Developer Environment:

   • Install and configure the .NET SDK and CLI.
   • Install and configure Node.js and Angular CLI.
   • Create ASP.NET Core Web API and Angular projects using CLI.

2. Backend Implementation:

   • Create data models and configure Entity Framework Core.
   • Implement API endpoints for managing income, expenses, categories, and reports.
   • Configure authentication and authorization with ASP.NET Core Identity.
   • Integrate AutoMapper for DTO and domain model mapping.
   • Configure SignalR for real-time notifications.

3. Frontend Implementation:

   • Set up the Angular project and install necessary dependencies.
   • Create components for main functionalities (registration, login, income, expenses, reports, etc.).
   • Implement Reactive Forms and Template Forms for transaction forms.
   • Integrate chart libraries for financial data visualization.
   • Add UI components from Angular Material or ngx-bootstrap.
   • Configure routing and route guards for secured routes.

4. Integration and Testing:

   • Test integration between frontend and backend.
   • Perform usability testing and bug fixing.
   • Test functionality on various devices to ensure responsiveness.

5. Deployment:

   • Configure project for deployment on Heroku.
   • Deploy the application and test in a production environment.

Getting Started

Follow these steps to get started with FinanceTracker:

1. Clone the repository:

    git clone https://github.com/yourusername/FinanceTracker.git
    cd FinanceTracker

2. Clone the repository:

   • Navigate to the FinanceTracker.Api folder.
   • Restore dependencies and run the project:

       dotnet restore
       dotnet run

3. Frontend Setup:

   • Navigate to the FinanceTracker.Client folder.
   • Install dependencies and run the Angular app:

       npm install
       ng serve

4. Open the Application:

   • Open your browser and navigate to http://localhost:4200.

Folder Structure

- `FinanceTracker.Api` - ASP.NET Core Web API project
- `FinanceTracker.Client` - Angular project

Contributing

- Contributions are welcome! Please read the CONTRIBUTING.md for details on the code of   conduct and the process for submitting pull requests.

License

- This project is licensed under the MIT License - see the LICENSE file for details.