KamuIlanlar.Core.Contracts 1.0.0

Core.Contracts

Shared contracts and DTOs for KamuIlanlar platform. Contains integration events, shared models, and cross-service communication contracts.

🚀 Features

• Integration Events: Event contracts for cross-service communication
• Shared DTOs: Common data transfer objects
• API Contracts: Request/response models
• Domain Events: Domain-specific event definitions
• Version Compatibility: Backward-compatible event schemas

📦 Installation

dotnet add package KamuIlanlar.Core.Contracts

🔧 Event Contracts

Category Events

// Category lifecycle events
public record CategoryCreatedEvent(
    Guid CategoryId,
    string Name,
    string Slug,
    DateTime CreatedAt
) : IIntegrationEvent;

public record CategoryUpdatedEvent(
    Guid CategoryId,
    string Name,
    string Slug,
    DateTime UpdatedAt
) : IIntegrationEvent;

public record CategoryDeletedEvent(
    Guid CategoryId,
    DateTime DeletedAt
) : IIntegrationEvent;

Announcement Events

// Announcement lifecycle events
public record AnnouncementCreatedEvent(
    Guid AnnouncementId,
    string Title,
    Guid CategoryId,
    DateTime CreatedAt
) : IIntegrationEvent;

public record AnnouncementPublishedEvent(
    Guid AnnouncementId,
    DateTime PublishedAt
) : IIntegrationEvent;

🏗️ Structure

Events/
├── Categories/
│   ├── CategoryCreatedEvent.cs
│   ├── CategoryUpdatedEvent.cs
│   └── CategoryDeletedEvent.cs
├── Announcements/
│   ├── AnnouncementCreatedEvent.cs
│   └── AnnouncementPublishedEvent.cs
└── Users/
    ├── UserRegisteredEvent.cs
    └── UserActivatedEvent.cs

DTOs/
├── Categories/
├── Announcements/
└── Users/

📋 Event Schema Guidelines

• Use record types for immutability
• Include timestamp fields for audit trails
• Use Guid for entity identifiers
• Follow past tense naming (Created, Updated, Deleted)
• Implement IIntegrationEvent interface

🔄 Versioning

Events follow semantic versioning:

• Major: Breaking schema changes
• Minor: Additive changes (new optional fields)
• Patch: Bug fixes, documentation updates

📋 Requirements

• .NET 9.0 or later
• Core.Messaging.Abstractions (for IIntegrationEvent)

🤝 Contributing

When adding new contracts:

1. Follow naming conventions
2. Add comprehensive XML documentation
3. Include usage examples
4. Update this README

📄 License

MIT License