ИДЕС СПЕЦИФИКАЦИЯ

[StructLayout(LayoutKind.Explicit, Size = 16)]
public readonly partial struct Ides : IEquatable<Ides>, IComparable<Ides>
{
    [FieldOffset(0)] readonly byte b0;
    [FieldOffset(1)] readonly byte b1;
    // ... поля b2-b14 ...
    [FieldOffset(15)] readonly byte b15;
}

// Генерация Ides в формате ULID
Ides id = Ides.NewIdes();
// Результат: 26 символов Base32 на кириллице
Console.WriteLine(id.ToString());
// Вывод: "07ЗЖ4РСТ01АБВГДЕЖЗИКЛМНПРСТУ"
// Получение времени создания
DateTimeOffset? created = id.Time;
Console.WriteLine($"Создан: {created:yyyy-MM-dd HH:mm:ss}");

// Генерация Ides в формате UUID v4
Ides id = Ides.NewIdesV4();
// Результат: 26 символов Base32 на кириллице
Console.WriteLine(id.ToString());
// Вывод: "АБВГДЕЖЗИКЛМНПРСТУФХЦЧ01АБВГ"
// Время создания будет случайным (не имеет смысла для UUID v4)
DateTimeOffset? time = id.Time; // Случайное значение

// Генерация нового ULID
Ides ulid = Ides.NewIdes();
// Генерация нового UUID v4
Ides uuid = Ides.NewIdesV4();
// Создание из байтового массива
byte[] bytes = new byte[16] { 0x01, 0x23, 0x45, /* ... */ };
Ides fromBytes = new Ides(bytes);
// Парсинг из строки
Ides parsed = Ides.Parse("07ЗЖ4РСТ01АБВГДЕЖЗИКЛМНПРСТУ");
// Безопасный парсинг
if (Ides.TryParse("07ЗЖ4РСТ01АБВГДЕЖЗИКЛМНПРСТУ", out Ides safe))
{
    Console.WriteLine($"Успешно: {safe}");
}

Ides id = Ides.NewIdes();
// В строку (Base32 кириллица)
string base32 = id.ToString();
// В байтовый массив
byte[] bytes = id.ToByteArray();
// В Base64
string base64 = id.ToBase64();
// Неявное преобразование
string str = id;          // Ides -> string
Ides fromStr = "07ЗЖ..."; // string -> Ides
byte[] arr = id;          // Ides -> byte[]

Ides id1 = Ides.NewIdes();
await Task.Delay(10); // Ждем 10мс
Ides id2 = Ides.NewIdes();
// Сравнение
bool equal = id1 == id2;           // false
bool notEqual = id1 != id2;        // true
int cmp = id1.CompareTo(id2);      // -1 (id1 < id2)
// Сортировка списка (ULID сортируются по времени)
List<Ides> list = new() { id2, id1, Ides.NewIdes() };
list.Sort(); // Автоматическая сортировка
// Хеш-код для словарей
int hash = id1.GetHashCode();
Dictionary<Ides, string> dict = new();
dict[id1] = "Значение";

public class MyDbContext : DbContext
{
    public DbSet<User> Users { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // Автоматическая настройка всех свойств типа Ides
        modelBuilder.UseIdes();
        
        // Для ASP.NET Core Identity
        modelBuilder.UseIdesForIdentity<ApplicationUser>();
        
        base.OnModelCreating(modelBuilder);
    }
}
public class User
{
    public Ides Id { get; set; } = Ides.NewIdes();
    public Ides? ParentId { get; set; }
    public string Name { get; set; }
}

// Создание таблицы с Ides
migrationBuilder.CreateTable(
    name: "Users",
    columns: table => new
    {
        Id = table.Column<byte[]>(type: "binary(16)", nullable: false),
        ParentId = table.Column<byte[]>(type: "binary(16)", nullable: true),
        Name = table.Column<string>(nullable: false)
    },
    constraints: table =>
    {
        table.PrimaryKey("PK_Users", x => x.Id);
    });

// Регистрация конвертера
var options = new JsonSerializerOptions
{
    Converters = { new IdesJsonConverter() }
};
// Сериализация
Ides id = Ides.NewIdes();
string json = JsonSerializer.Serialize(id, options);
// Результат: "07ЗЖ4РСТ01АБВГДЕЖЗИКЛМНПРСТУ"
// Десериализация
Ides parsed = JsonSerializer.Deserialize<Ides>(json, options);
// В составе объекта
var user = new { Id = Ides.NewIdes(), Name = "Иван" };
string userJson = JsonSerializer.Serialize(user, options);
// {"Id":"07ЗЖ4РСТ01АБВГДЕЖЗИКЛМНПРСТУ","Name":"Иван"}

public class Article
{
    public Ides Id { get; set; } = Ides.NewIdes();
    public string Title { get; set; }
    public string Content { get; set; }
    public DateTimeOffset CreatedAt { get; set; } = DateTimeOffset.UtcNow;
}
// Использование в репозитории
public class ArticleRepository
{
    public async Task<Article> CreateAsync(string title, string content)
    {
        var article = new Article
        {
            Id = Ides.NewIdes(), // Автоматическая генерация
            Title = title,
            Content = content
        };
        
        _context.Articles.Add(article);
        await _context.SaveChangesAsync();
        return article;
    }
}

[ApiController]
[Route("api/[controller]")]
public class UsersController : ControllerBase
{
    [HttpGet("{id}")]
    public async Task<ActionResult<UserDto>> GetUser(Ides id)
    {
        // Ides автоматически парсится из URL
        var user = await _userService.GetByIdAsync(id);
        if (user == null) return NotFound();
        
        return Ok(new UserDto
        {
            Id = user.Id, // Сериализуется как Base32 кириллица
            Name = user.Name
        });
    }
    
    [HttpPost]
    public async Task<ActionResult<UserDto>> CreateUser(CreateUserRequest request)
    {
        var user = new User
        {
            Id = Ides.NewIdes(), // Генерация на сервере
            Name = request.Name,
            Email = request.Email
        };
        
        await _userService.CreateAsync(user);
        return CreatedAtAction(nameof(GetUser), new { id = user.Id }, user);
    }
}