feat(release): front int PK with app-minted GUID EntryKey on the public addressing surface (P11 W5, 11.H)

This commit is contained in:
daniel-c-harvey
2026-06-16 17:11:55 -04:00
parent fe28573b68
commit f07d29cdcf
37 changed files with 627 additions and 160 deletions
+4
View File
@@ -9,6 +9,10 @@ namespace DeepDrftModels.DTOs;
// TrackConverter assigns every field on the round-trip, so an empty default is never observable.
public class ReleaseDto : BaseModel
{
// The release's public handle — the GUID string the public site/API address it by (Phase 11 §3e).
// Mirrors TrackDto's EntryKey. No `required` (BaseModel/Manager<> need new()); TrackConverter
// assigns it on every round-trip, so an empty default is never observable.
public string EntryKey { get; set; } = string.Empty;
public string Title { get; set; } = string.Empty;
public string Artist { get; set; } = string.Empty;
public string? Genre { get; set; }
+6
View File
@@ -12,6 +12,12 @@ namespace DeepDrftModels.Entities;
// explicitly to satisfy the generic constraints on Repository<>/Manager<>/etc.
public class ReleaseEntity : BaseEntity, IEntity
{
// App-minted GUID-string public handle, mirroring TrackEntity.EntryKey exactly: required string,
// entry_key column, unique index, born app-side as Guid.NewGuid().ToString() at release creation
// (the FindOrCreateRelease path). Fronts the int Id (the DB-only PK, unused by the app) so the
// public site/API address releases by an opaque key, never the transparent sequential id
// (Phase 11 §3e). Unlike a track's EntryKey it has no vault job — it is purely an identifier.
public required string EntryKey { get; set; }
public required string Title { get; set; }
public required string Artist { get; set; }
public string? Genre { get; set; }