generated from coulomb/repo-seed
tegwick
1f1da56533
DB migration h5c6d7e8f9a0:
- Extends tdstatus enum: submitted → analyse → plan → implement →
test → review → finished (+ wont_fix remains)
- New td_notes table: td_id FK (CASCADE), step, author, content, created_at
API:
- TDNote model + TDNoteCreate/TDNoteRead schemas
- TDRead includes notes[] (selectin loaded)
- New routes: GET/POST /technical-debt/{id}/notes/
- list_td status filter accepts str (all enum values)
Modal: new submissions use status="submitted" instead of "open"
UI Feedback page revamp:
- Visual step-by-step stepper (submitted→analyse→plan→implement→test→review→finished)
- Per-step notes: view all notes, add note inline
- Action buttons: advance to next step, won't fix
- Review step highlighted as awaiting original suggester confirmation
- Closed items (finished/wont_fix) shown with last 2 notes
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
94 lines
3.5 KiB
Python
94 lines
3.5 KiB
Python
import enum
|
|
import uuid
|
|
|
|
from sqlalchemy import DateTime, Enum, ForeignKey, String, Text
|
|
from sqlalchemy.dialects.postgresql import UUID
|
|
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
|
from sqlalchemy.sql import func
|
|
|
|
from api.models.base import Base, TimestampMixin, new_uuid
|
|
|
|
|
|
class TDStatus(str, enum.Enum):
|
|
# Legacy general statuses
|
|
open = "open"
|
|
in_progress = "in_progress"
|
|
resolved = "resolved"
|
|
deferred = "deferred"
|
|
wont_fix = "wont_fix"
|
|
# Dashboard-improvement workflow steps
|
|
submitted = "submitted"
|
|
analyse = "analyse"
|
|
plan = "plan"
|
|
implement = "implement"
|
|
test = "test"
|
|
review = "review"
|
|
finished = "finished"
|
|
|
|
|
|
# Ordered workflow steps for dashboard-improvement suggestions
|
|
SUGGESTION_STEPS = ["submitted", "analyse", "plan", "implement", "test", "review", "finished"]
|
|
|
|
|
|
class TDNote(Base):
|
|
__tablename__ = "td_notes"
|
|
|
|
id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=new_uuid)
|
|
td_id: Mapped[uuid.UUID] = mapped_column(
|
|
UUID(as_uuid=True), ForeignKey("technical_debt.id", ondelete="CASCADE"),
|
|
nullable=False, index=True,
|
|
)
|
|
step: Mapped[str] = mapped_column(String(30), nullable=False)
|
|
author: Mapped[str | None] = mapped_column(String(100), nullable=True)
|
|
content: Mapped[str] = mapped_column(Text, nullable=False)
|
|
created_at: Mapped[DateTime] = mapped_column(
|
|
DateTime(timezone=True), server_default=func.now(), nullable=False
|
|
)
|
|
|
|
td: Mapped["TechnicalDebt"] = relationship("TechnicalDebt", back_populates="notes")
|
|
|
|
|
|
class TechnicalDebt(Base, TimestampMixin):
|
|
__tablename__ = "technical_debt"
|
|
|
|
id: Mapped[uuid.UUID] = mapped_column(
|
|
UUID(as_uuid=True), primary_key=True, default=new_uuid
|
|
)
|
|
td_id: Mapped[str | None] = mapped_column(
|
|
String(30), nullable=True, unique=True, index=True
|
|
) # human-readable ref, e.g. TD-CUST-001
|
|
domain_id: Mapped[uuid.UUID] = mapped_column(
|
|
UUID(as_uuid=True),
|
|
ForeignKey("domains.id", ondelete="RESTRICT"),
|
|
nullable=False,
|
|
index=True,
|
|
)
|
|
title: Mapped[str] = mapped_column(String(255), nullable=False)
|
|
description: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
location: Mapped[str | None] = mapped_column(String(500), nullable=True)
|
|
debt_type: Mapped[str] = mapped_column(
|
|
String(50), nullable=False, default="other"
|
|
) # design | implementation | test | docs | dependencies | performance | security | other
|
|
severity: Mapped[str] = mapped_column(String(20), nullable=False, default="medium")
|
|
status: Mapped[TDStatus] = mapped_column(
|
|
Enum(TDStatus, name="tdstatus"), nullable=False, default=TDStatus.open
|
|
)
|
|
topic_id: Mapped[uuid.UUID | None] = mapped_column(
|
|
UUID(as_uuid=True), ForeignKey("topics.id", ondelete="SET NULL"), nullable=True
|
|
)
|
|
workstream_id: Mapped[uuid.UUID | None] = mapped_column(
|
|
UUID(as_uuid=True), ForeignKey("workstreams.id", ondelete="SET NULL"), nullable=True
|
|
)
|
|
|
|
domain: Mapped["Domain"] = relationship("Domain", lazy="selectin") # noqa: F821
|
|
topic: Mapped["Topic"] = relationship("Topic", lazy="selectin") # noqa: F821
|
|
workstream: Mapped["Workstream"] = relationship("Workstream", lazy="selectin") # noqa: F821
|
|
notes: Mapped[list["TDNote"]] = relationship(
|
|
"TDNote", back_populates="td", lazy="selectin",
|
|
order_by="TDNote.created_at",
|
|
)
|
|
|
|
@property
|
|
def domain_slug(self) -> str:
|
|
return self.domain.slug if self.domain is not None else ""
|