NetSchema 3.0.1

NetSchema - N-Tier Architecture Generator

NetSchema, .NET 8 proyektl?ri ���n avtomatik N-Tier arxitektura yaradan bir NuGet tool package-dir.

?? X�susiyy?tl?r

• ? App.Core - Domain entities, interfaces v? base class-lar
• ? App.DAL - Data Access Layer, DbContext, Repository Pattern
• ? App.Business - Services, DTOs, Validators, AutoMapper
• ? App.API - Controllers, Swagger, appsettings
• ? App.Shared - Shared utilities v? interfaces
• ? Automatic Code Generation - Modell?rinizd?n tam CRUD generate edir
• ? Generic Repository implementasiyas? (CRUD + Soft Delete)
• ? Entity-specific repository-l?r ���n haz?r struktur
• ? Soft delete d?st?yi (IsDeleted flag)
• ? Audit fields (CreatedDate, UpdatedDate, IsDeleted)
• ? AutoMapper konfiqurasiyas?
• ? FluentValidation inteqrasiyas?
• ? Sample Controller v? DTO-lar

?? Qura?d?rma

Global Tool olaraq

dotnet tool install --global NetSchema

Local Tool olaraq (proyekt ���n)

dotnet new tool-manifest # ?g?r yoxdursa
dotnet tool install NetSchema

?? ?stifad?

Option 1: ?lkin Struktur Yaratmaq (First Time Setup)

Solution directory-nizd? (.sln fayl?n?n oldu?u qovluqda) a?a??dak? ?mri i?l?din:

dotnet netschema generate

Bu ?mr avtomatik olaraq tam N-Tier strukturu yaradacaq (App.Core, App.DAL, App.Business, App.API, App.Shared).

Option 2: M�vcud Modell?r ���n Kod Generate Etm?k ? NEW!

?g?r art?q strukturunuz varsa v? yeni entity-l?r ���n kod generate etm?k ist?yirsinizs?:

1. Entity-l?rinizi yarad?n

// App.Core/Entities/User.cs
public class User : BaseEntity, IAuditedEntity
{
    public string FullName { get; set; } = string.Empty;
    public string Email { get; set; } = string.Empty;
    public DateTime DateOfBirth { get; set; }
    public bool IsActive { get; set; }
    public DateTime CreatedDate { get; set; }
    public DateTime? UpdatedDate { get; set; }
    public bool IsDeleted { get; set; }
}

// App.Core/Entities/Product.cs
public class Product : BaseEntity, IAuditedEntity
{
    public string Name { get; set; } = string.Empty;
    public string? Description { get; set; }
    public decimal Price { get; set; }
    public int StockQuantity { get; set; }
    public DateTime CreatedDate { get; set; }
    public DateTime? UpdatedDate { get; set; }
    public bool IsDeleted { get; set; }
}

2. Code Generator Console App yarad?n

dotnet new console -n MyApp.CodeGen
cd MyApp.CodeGen
dotnet add reference ../MyApp.Core/MyApp.Core.csproj
dotnet add package NetSchema

3. NetSchema il? kod generate edin

// MyApp.CodeGen/Program.cs
using NetSchema.Core;
using MyApp.Core.Entities;

// Fluent API (T�vsiy? olunur)
NetSchema.Configure()
    .AddEntity<User>()
    .AddEntity<Product>()
    .AddEntity<Order>()
    .GenerateAll();

// v? ya Sad? API
// NetSchema.Generate(typeof(User), typeof(Product), typeof(Order));

4. Generate edin!

dotnet run

?? N? Generate Olur?

? Her bir entity ���n avtomatik yarad?r:

?? DTOs (3x)
   � UserDto.cs
   � CreateUserDto.cs
   � UpdateUserDto.cs

? Validators (2x)
   � CreateUserValidator.cs
   � UpdateUserValidator.cs

??? Repositories (2x)
   � IUserRepository.cs
   � UserRepository.cs

?? Services (2x)
   � IUserService.cs
   � UserService.cs

?? Controllers (1x)
   � UserController.cs (Full CRUD REST API)

?? Plus:
   � DbContext-? DbSet ?lav? edir
   � AutoMapper mapping-l?r
   � DI registration-lar

?? Advanced Options

Skip specific generators

NetSchema.Configure()
    .AddEntity<User>()
    .AddEntity<Product>()
    .SkipControllers()  // Controller-l?ri yaratma
    .SkipServices()     // Service-l?ri yaratma
    .GenerateAll();

Custom output path

NetSchema.Configure()
    .AddEntity<User>()
    .WithOutputPath("./CustomOutput")
    .GenerateAll();

Custom namespace

NetSchema.Configure()
    .AddEntity<User>()
    .WithNamespace("MyCompany.MyApp")
    .GenerateAll();

?? Generated API Examples

Generate olunduqdan sonra tam funksional REST API endpoint-l?riniz olacaq:

# Get all users
GET /api/user

# Get user by id
GET /api/user/1

# Create new user
POST /api/user
{
  "fullName": "John Doe",
  "email": "john@example.com",
  "dateOfBirth": "1990-01-01",
  "isActive": true
}

# Update user
PUT /api/user/1
{
  "id": 1,
  "fullName": "John Updated",
  "email": "john.updated@example.com",
  "dateOfBirth": "1990-01-01",
  "isActive": true
}

# Delete user (soft delete)
DELETE /api/user/1

?? Connection String

App.API/appsettings.json fayl?nda database connection string-ini d�z?ldin:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=YourDb;User Id=sa;Password=yourpassword;TrustServerCertificate=True"
  }
}

??? Migration

cd App.API
dotnet ef migrations add InitialCreate
dotnet ef database update

?? API-ni i?? sal?n

dotnet run

Swagger UI: https://localhost:5001/swagger

?? N�mun?l?r

USAGE.md fayl?nda tam n�mun?l?r v? daha �ox detallar.

?? T�hf? verm?k

Pull request-l?r xo? qar??lan?r! B�y�k d?yi?iklikl?r ���n ?vv?lc? issue a�?n.

?? Lisenziya

MIT

?? M�?llif

Emil - GitHub

?? Problem bildirm?k

GitHub Issues

?? N�vb?ti Versiyalarda

• Fluent API for code generation ? v3.0.0
• JWT Authentication
• Redis Caching
• Logging (Serilog)
• Unit Test layer
• Docker support
• GraphQL support