eCourt-Doc-Edit/backend/WordVersioning.Api/Models/TemplateDtos.cs
Suphonchai Phoonsawat 25c2ce53cd Phase 3
2026-08-19 12:15:20 +07:00

81 lines
2.7 KiB
C#

using System.ComponentModel.DataAnnotations;
namespace WordVersioning.Api.Models;
/// <summary>body ของ POST /api/templates (multipart/form-data)</summary>
public class CreateTemplateRequest
{
[Required]
public string Name { get; set; } = string.Empty;
public string? Description { get; set; }
[Required]
public IFormFile File { get; set; } = null!;
}
/// <summary>body ของ PUT /api/templates/{id} — Fields เป็น optional (ไม่ส่ง = แก้ metadata อย่างเดียว)</summary>
public class UpdateTemplateRequest
{
public string? Name { get; set; }
public string? Description { get; set; }
public bool? IsActive { get; set; }
public List<TemplateFieldDefinition>? Fields { get; set; }
}
/// <summary>นิยาม field หนึ่งตัวที่ admin ตั้ง — Key ต้องตรงกับที่ detect จากไฟล์ (เพิ่ม/ลบ key ต้องผ่าน replace ไฟล์)</summary>
public class TemplateFieldDefinition
{
[Required]
public string Key { get; set; } = string.Empty;
public string Label { get; set; } = string.Empty;
/// <summary>text | number | date</summary>
public string Type { get; set; } = "text";
public bool IsRequired { get; set; }
public int SortOrder { get; set; }
}
/// <summary>body ของ PUT /api/templates/{id}/file (multipart/form-data)</summary>
public class ReplaceTemplateFileRequest
{
[Required]
public IFormFile File { get; set; } = null!;
}
public record TemplateFieldDto(Guid Id, string Key, string Label, string Type, bool IsRequired, int SortOrder);
public record TemplateListItem(
Guid Id,
string Name,
string? Description,
bool IsActive,
int FieldCount,
DateTimeOffset CreatedAt,
DateTimeOffset UpdatedAt);
public record TemplateDetail(
Guid Id,
string Name,
string? Description,
bool IsActive,
DateTimeOffset CreatedAt,
DateTimeOffset UpdatedAt,
IReadOnlyList<TemplateFieldDto> Fields);
/// <summary>response ของ POST /api/templates — fields ที่ detect อัตโนมัติพร้อมค่า default
/// ให้ admin ไปตั้ง label/type/required ต่อผ่าน PUT (FR-9)</summary>
public record CreateTemplateResponse(Guid Id, IReadOnlyList<TemplateFieldDto> Fields);
/// <summary>response ของ PUT /api/templates/{id}/file — เตือน tag ที่หายไป/เพิ่มมาหลัง replace ไฟล์</summary>
public record ReplaceTemplateFileResponse(
Guid Id,
IReadOnlyList<TemplateFieldDto> Fields,
IReadOnlyList<string> AddedTags,
IReadOnlyList<string> RemovedTags);