📊 FinOps Core - Financial Management and Reconciliation System

Corporate application developed to demonstrate advanced architectural patterns, financial data integrity, and high-performance read operations using CQRS.

---

🏛️ Architecture

The solution follows Clean Architecture and Domain-Driven Design (DDD), keeping business rules completely isolated from infrastructure and frameworks.

To support scalability and high throughput, the application adopts CQRS (Command Query Responsibility Segregation).

✍️ Command Side (Write)

• Entity Framework Core
• Unit of Work
• Rich Domain Model
• Optimistic Concurrency
• ACID Transactions
• FluentValidation
• MediatR

Business operations pass through the domain layer, ensuring consistency and protecting financial transactions.

---

📖 Query Side (Read)

• Dapper
• Native SQL
• Lightweight DTOs
• Optimized Queries

Read operations bypass ORM tracking, delivering significantly faster dashboard and reporting performance.

---

🧩 Design Patterns

Pattern	Purpose
✅ Clean Architecture	Separation of concerns
✅ Domain-Driven Design	Rich business domain
✅ CQRS	Read/Write segregation
✅ Unit of Work	Transaction management
✅ Repository Pattern	Persistence abstraction
✅ MediatR	Decoupled application layer
✅ Result Pattern	Business validation without exceptions
✅ Dependency Injection	Loose coupling
✅ Idempotency	Prevent duplicate financial requests

---

🚀 Tech Stack

Backend

Technology	Description
.NET 8	Backend
C#	Programming Language
Entity Framework Core	Commands
Dapper	High-performance Queries
MediatR	CQRS
FluentValidation	Validation
LINQ	Data Manipulation
xUnit	Unit Tests
Moq	Mocking

---

Frontend

Technology	Description
Angular	SPA
TypeScript	Language
SCSS	Styling
RxJS	Reactive Programming
HTTP Interceptors	Authentication & Error Handling

---

Infrastructure

Technology	Description
Oracle Database	Relational Database
Docker	Containers
Docker Compose	Local Environment
Kubernetes	Deployment
GitHub Actions	CI/CD

---

📂 Project Structure

src
├── FinancialSystem.Domain
│   ├── Entities
│   ├── ValueObjects
│   ├── Enums
│   ├── Events
│   └── Interfaces
│
├── FinancialSystem.Application
│   ├── Commands
│   ├── Queries
│   ├── DTOs
│   ├── Validators
│   └── Behaviors
│
├── FinancialSystem.Infrastructure
│   ├── Persistence
│   ├── Dapper
│   ├── Repositories
│   └── Services
│
└── FinancialSystem.API
    ├── Controllers
    ├── Middleware
    ├── Filters
    └── Configuration

frontend
└── financial-app

k8s
└── deployment

---

⚡ Running Locally

Requirements

• Docker Desktop
• .NET SDK 8
• Node.js
• Angular CLI

---

Clone Repository

git clone https://github.com/your-user/finops-core.git

cd finops-core

---

Start Oracle

docker compose up -d db

---

Apply Migrations

cd src/FinancialSystem.API

dotnet ef database update

dotnet run

Swagger

https://localhost:5001/swagger

---

Angular

cd frontend/financial-app

npm install

ng serve

http://localhost:4200

---

🧪 Tests

cd src

dotnet test

---

📈 Main Features

• Financial Reconciliation
• Cash Flow Management
• CQRS Architecture
• Dashboard Queries
• High Performance Reads
• Rich Domain Validation
• Transaction Management
• Optimistic Concurrency
• Idempotent Requests
• Unit Testing

---

👨‍💻 Author

Gabriel Campos

---

📄 License

Licensed under the MIT License.