https://github.com/nwalazaro/payroll-module
Backend payroll calculation module built in .NET Core. Calculates net salary from base salary, bonus, and tax rate. Simulated project based on real-world enterprise development.
https://github.com/nwalazaro/payroll-module
api api-restful backend clean-architecture csharp dotnet financial-systems payroll
Last synced: about 1 month ago
JSON representation
Backend payroll calculation module built in .NET Core. Calculates net salary from base salary, bonus, and tax rate. Simulated project based on real-world enterprise development.
- Host: GitHub
- URL: https://github.com/nwalazaro/payroll-module
- Owner: nwAlazaro
- Created: 2025-06-18T00:20:32.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-18T00:23:18.000Z (12 months ago)
- Last Synced: 2025-06-18T01:29:18.971Z (12 months ago)
- Topics: api, api-restful, backend, clean-architecture, csharp, dotnet, financial-systems, payroll
- Language: C#
- Homepage:
- Size: 2.93 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Payroll Module (Simulated Project)
This is a backend module for calculating employee payroll in a simulated HR or financial system.
It was built using ASP.NET Core and follows clean code and SOLID principles.
## 📌 Features
- Calculates net payroll based on base salary, bonus, and tax rate.
- Exposes a REST API endpoint for payroll calculation.
- Organized into Models, Controllers, and Services using dependency injection.
- Easy to extend and integrate into larger systems.
## 🛠️ Technologies Used
- .NET Core
- C#
- ASP.NET Web API
- Dependency Injection
- Entity Framework Core (placeholder for DB)
- Swagger (suggested for API testing)
## 📁 Project Structure
```
PayrollModule/
├── Controllers/
│ └── PayrollController.cs
├── Models/
│ └── Employee.cs
├── Services/
│ └── PayrollService.cs
```
## 🚀 How to Run (Conceptual Example)
1. Clone the repository
2. Add to a new ASP.NET Core Web API project
3. Register `IPayrollService` and `PayrollService` in `Startup.cs`
4. Use Swagger or Postman to test the endpoint:
```
POST /api/payroll/calculate
{
"name": "Alice",
"baseSalary": 3000,
"bonus": 500,
"taxRate": 0.15
}
```
## 📄 Note
This is a simulated project created for portfolio demonstration purposes. It does not contain business-sensitive or proprietary code.
---
Created by Anderson Enrique Lázaro Moreno
Barcelona, Spain