namespace ZB.MOM.WW.ScadaBridge.Commons.Entities.Schemas;

/// <summary>
/// A reusable, named JSON-Schema library entry (template-level JSON-Schema library).
/// Schemas are referenced from inbound-API / template schema definitions via a
/// <c>{"$ref":"lib:Name"}</c> pointer resolved against this library. One row per
/// named schema in the central <c>SharedSchemas</c> MS SQL table.
/// </summary>
/// <remarks>
/// Persistence-ignorant POCO; the EF Core mapping lives in the Configuration Database
/// component (<c>SharedSchemaConfiguration</c>). Mirrors the single-table
/// <see cref="ZB.MOM.WW.ScadaBridge.Commons.Entities.Scripts.SharedScript"/> entity/config/
/// repository shape — surrogate <c>Id</c>, a unique <see cref="Name"/>, and an unbounded
/// text body.
/// </remarks>
public class SharedSchema
{
    /// <summary>Primary key.</summary>
    public int Id { get; set; }

    /// <summary>Unique schema name used to reference this entry (e.g. <c>lib:Name</c>).</summary>
    public required string Name { get; set; }

    /// <summary>
    /// Optional scope discriminator for future namespacing/visibility partitioning;
    /// <c>null</c> means an unscoped (global) library entry.
    /// </summary>
    public string? Scope { get; set; }

    /// <summary>The JSON Schema document text.</summary>
    public required string SchemaJson { get; set; }
}