https://github.com/nikanats/blogify
A modern .NET Web API for a blog platform
https://github.com/nikanats/blogify
bloging clean-architecture cqrs csharp ddd docker-compose dotnet keycloak redis seq
Last synced: 5 months ago
JSON representation
A modern .NET Web API for a blog platform
- Host: GitHub
- URL: https://github.com/nikanats/blogify
- Owner: NikaNats
- License: mit
- Created: 2024-12-31T18:25:17.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-08-09T21:04:11.000Z (6 months ago)
- Last Synced: 2025-08-09T21:14:52.399Z (6 months ago)
- Topics: bloging, clean-architecture, cqrs, csharp, ddd, docker-compose, dotnet, keycloak, redis, seq
- Language: C#
- Homepage:
- Size: 399 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Blogify API
A modern, robust, and scalable backend API for a blogging platform. Built with **.NET 9**, following **Clean
Architecture** principles, **Domain-Driven Design (DDD)**, and the **CQRS** pattern.
---
## 🚀 Table of Contents
- [Features](#features)
- [Technology Stack](#technology-stack)
- [Architecture Overview](#architecture-overview)
---
## ✨ Features
- **User Management:** Secure user registration and login via Keycloak
- **Content Management:** Full CRUD for Posts, Categories, and Tags
- **Interactive Content:** Comment support on posts
- **API Versioning:** Endpoints versioned (e.g., `/api/v1/...`)
- **Health Checks:** Database, cache, and authentication provider monitoring
- **Asynchronous Processing:** Outbox Pattern with Quartz.NET for reliable background domain event processing
- **Robust Architecture:** Layered design for maintainability, scalability, and testability
---
## 🛠️ Technology Stack
| Area | Technology / Library |
|-------------------|----------------------------------------------|
| Backend Framework | .NET 9 & ASP.NET Core |
| Architecture | Clean Architecture, DDD, CQRS |
| Database | PostgreSQL |
| ORM / Data Access | Entity Framework Core 9, Dapper |
| Authentication | Keycloak (OAuth 2.0 / OIDC) |
| Caching | Redis (via IDistributedCache) |
| Testing | xUnit, NSubstitute, Shouldly, Testcontainers |
| Logging | Serilog, Seq |
| API & Docs | REST, OpenAPI (Swagger), Asp.Versioning.Mvc |
| Validation | FluentValidation |
| Scheduling | Quartz.NET |
---
## 🏛️ Architecture Overview
Blogify implements **Clean Architecture** to ensure loose coupling, testability, and scalability. The major layers are:
- **Domain:** Core business models and rules (no dependencies)
- **Application:** Business logic using CQRS (only depends on Domain)
- **Infrastructure:** Database, authentication, caching, and other service implementations
- **API (Presentation):** Exposes functionality via RESTful endpoints
```mermaid
graph TD
subgraph "Presentation Layer"
API[Blogify API]
end
subgraph "Application Layer"
APP[Business Logic]
end
subgraph "Infrastructure Services"
KEYCLOAK[Keycloak]
DB[(Database)]
REDIS[Redis]
SEQ[Seq]
QUARTZ[Scheduler]
end
USER[User] -->|HTTPS| API
API -->|Authentication| KEYCLOAK
API -->|Commands/Queries| APP
APP -->|Data| DB
APP -->|Cache| REDIS
QUARTZ -->|Polls| DB
DB -->|Events| QUARTZ
QUARTZ -->|Publishes| APP
API -->|Logs| SEQ
APP -->|Logs| SEQ
classDef service fill:#e6f3ff,stroke:#0066cc,stroke-width:2px;
classDef infra fill:#fff5e6,stroke:#ff9900,stroke-width:2px;
classDef db fill:#d9f2d9,stroke:#009900,stroke-width:2px;
class API,APP service;
class KEYCLOAK,REDIS,SEQ,QUARTZ infra;
class DB db;
```