Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions app/api/Data/ProductModels.cs
Original file line number Diff line number Diff line change
Expand Up @@ -115,6 +115,35 @@ public sealed class RequirementEvidence
public DateTime RefreshedAt { get; set; }
}

// A comment on a requirement, or a reply to one (ADR-059). Comments are discussion: they never
// change the requirement, its version, its evidence, or its review status. ParentId is null for a
// top-level comment; a reply's parent is always top-level. Deleting keeps the row, so replies stay
// in place, but clears Body: removed text is not kept.
public sealed class RequirementComment
{
public Guid Id { get; set; }
public Guid RequirementId { get; set; }
public Guid? ParentId { get; set; }
public required string AuthorId { get; set; }
public required string Body { get; set; }
public DateTime CreatedAt { get; set; }
public DateTime? EditedAt { get; set; }
public DateTime? DeletedAt { get; set; }
public string? DeletedBy { get; set; }
}

// Who created, edited, or deleted a comment, and when (ADR-059). Action is "created", "edited",
// or "deleted". Earlier text is not recorded. Rows are only ever added.
public sealed class RequirementCommentEvent
{
public Guid Id { get; set; }
public Guid RequirementId { get; set; }
public Guid CommentId { get; set; }
public required string Action { get; set; }
public required string Actor { get; set; }
public DateTime OccurredAt { get; set; }
}

// One requirement marked as a follow-up of another in the same project (ADR-052). Linking does
// not change either requirement's version.
public sealed class RequirementFollowUp
Expand Down
42 changes: 42 additions & 0 deletions app/api/Data/SpecThreadDbContext.cs
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ public sealed class SpecThreadDbContext(DbContextOptions<SpecThreadDbContext> op
public DbSet<RequirementDocument> RequirementDocuments => Set<RequirementDocument>();
public DbSet<RequirementFollowUp> RequirementFollowUps => Set<RequirementFollowUp>();
public DbSet<RequirementFollowUpEvent> RequirementFollowUpEvents => Set<RequirementFollowUpEvent>();
public DbSet<RequirementComment> RequirementComments => Set<RequirementComment>();
public DbSet<RequirementCommentEvent> RequirementCommentEvents => Set<RequirementCommentEvent>();

protected override void OnModelCreating(ModelBuilder model)
{
Expand Down Expand Up @@ -413,5 +415,45 @@ protected override void OnModelCreating(ModelBuilder model)
followUpEvent.HasOne<Requirement>().WithMany().HasForeignKey(x => x.RequirementId).OnDelete(DeleteBehavior.Restrict);
followUpEvent.HasOne<Requirement>().WithMany().HasForeignKey(x => x.OriginalRequirementId).OnDelete(DeleteBehavior.Restrict);
followUpEvent.HasOne<AuthUser>().WithMany().HasForeignKey(x => x.Actor).OnDelete(DeleteBehavior.Restrict);

var comment = model.Entity<RequirementComment>();
comment.ToTable("requirement_comments", table =>
{
table.HasCheckConstraint("ck_requirement_comments_body", "char_length(body) <= 5000");
table.HasCheckConstraint("ck_requirement_comments_deleted", "(deleted_at IS NULL) = (deleted_by IS NULL) AND (deleted_at IS NULL OR body = '')");
table.HasCheckConstraint("ck_requirement_comments_parent", "parent_id IS NULL OR parent_id <> id");
});
comment.HasKey(x => x.Id);
comment.Property(x => x.Id).HasColumnName("id").HasDefaultValueSql("gen_random_uuid()");
comment.Property(x => x.RequirementId).HasColumnName("requirement_id");
comment.Property(x => x.ParentId).HasColumnName("parent_id");
comment.Property(x => x.AuthorId).HasColumnName("author_id");
comment.Property(x => x.Body).HasColumnName("body");
comment.Property(x => x.CreatedAt).HasColumnName("created_at").HasDefaultValueSql("now()");
comment.Property(x => x.EditedAt).HasColumnName("edited_at");
comment.Property(x => x.DeletedAt).HasColumnName("deleted_at");
comment.Property(x => x.DeletedBy).HasColumnName("deleted_by");
comment.HasIndex(x => new { x.RequirementId, x.CreatedAt });
comment.HasIndex(x => x.ParentId);
comment.HasOne<Requirement>().WithMany().HasForeignKey(x => x.RequirementId).OnDelete(DeleteBehavior.Restrict);
comment.HasOne<RequirementComment>().WithMany().HasForeignKey(x => x.ParentId).OnDelete(DeleteBehavior.Restrict);
comment.HasOne<AuthUser>().WithMany().HasForeignKey(x => x.AuthorId).OnDelete(DeleteBehavior.Restrict);
comment.HasOne<AuthUser>().WithMany().HasForeignKey(x => x.DeletedBy).OnDelete(DeleteBehavior.Restrict);

var commentEvent = model.Entity<RequirementCommentEvent>();
commentEvent.ToTable("requirement_comment_events", table =>
table.HasCheckConstraint("ck_requirement_comment_events_action", "action IN ('created', 'edited', 'deleted')"));
commentEvent.HasKey(x => x.Id);
commentEvent.Property(x => x.Id).HasColumnName("id").HasDefaultValueSql("gen_random_uuid()");
commentEvent.Property(x => x.RequirementId).HasColumnName("requirement_id");
commentEvent.Property(x => x.CommentId).HasColumnName("comment_id");
commentEvent.Property(x => x.Action).HasColumnName("action");
commentEvent.Property(x => x.Actor).HasColumnName("actor");
commentEvent.Property(x => x.OccurredAt).HasColumnName("occurred_at").HasDefaultValueSql("now()");
commentEvent.HasIndex(x => x.RequirementId);
commentEvent.HasIndex(x => x.CommentId);
commentEvent.HasOne<Requirement>().WithMany().HasForeignKey(x => x.RequirementId).OnDelete(DeleteBehavior.Restrict);
commentEvent.HasOne<RequirementComment>().WithMany().HasForeignKey(x => x.CommentId).OnDelete(DeleteBehavior.Restrict);
commentEvent.HasOne<AuthUser>().WithMany().HasForeignKey(x => x.Actor).OnDelete(DeleteBehavior.Restrict);
}
}
Loading
Loading