feat(P2+P3): IHF Phase 2 complete; register Phase 3 workplan

Phase 2 — Structured Feedback and Triage (IHUB-WP-0002):
- Schema: annotation_threads, requirement_candidates, triage_states,
  reviewer_assignments; annotations extended with severity + thread_id
- AnnotationThreadsController: create threads, assign annotations
- RequirementCandidatesController: CRUD, escalation, triage lifecycle,
  reviewer assignment, my-queue
- Annotation severity (low/medium/high/critical) with Tailwind color cues
- TriageDashboardAction on HubsController with autoRefresh
- Integration tests (T01–T09), SCOPE.md updated, docs/phase2-summary.md

Phase 3 — Governance and Decision Linkage (IHUB-WP-0003):
- Workplan registered: 9 tasks, State Hub workstream 5f201ee3

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-28 23:37:34 +00:00
parent cfcf4c81f7
commit 840b0e5c7b
25 changed files with 2136 additions and 29 deletions

View File

@@ -0,0 +1,92 @@
module Web.View.AnnotationThreads.Index where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data IndexView = IndexView
{ widget :: !Widget
, threads :: ![AnnotationThread]
, allAnnotations :: ![Annotation]
}
instance View IndexView where
html IndexView { .. } = [hsx|
<div class="mb-6 flex items-center gap-2 text-sm text-gray-500">
<a href={WidgetsAction} class="hover:text-gray-700">Widgets</a>
<span>/</span>
<a href={ShowWidgetAction { widgetId = widget.id }} class="hover:text-gray-700">{widget.name}</a>
<span>/</span>
<span>Threads</span>
</div>
<div class="flex items-center justify-between mb-4">
<h1 class="text-2xl font-semibold">Annotation Threads</h1>
<a href={NewAnnotationThreadAction { widgetId = widget.id }}
class="bg-indigo-600 text-white text-sm font-medium px-4 py-2 rounded hover:bg-indigo-700">
New Thread
</a>
</div>
{if null threads
then [hsx|<p class="text-sm text-gray-500">No threads yet.</p>|]
else [hsx|
<div class="space-y-3">
{forEach threads (renderThreadRow allAnnotations)}
</div>
|]}
|]
renderThreadRow :: [Annotation] -> AnnotationThread -> Html
renderThreadRow allAnnotations t =
let members = filter (\a -> a.threadId == Just t.id) allAnnotations
count = length members
severityBreakdown = buildSeverityBreakdown members
in [hsx|
<div class="bg-white rounded-lg border border-gray-200 px-5 py-4">
<div class="flex items-start justify-between">
<div>
<a href={ShowAnnotationThreadAction { annotationThreadId = t.id }}
class="font-medium text-indigo-600 hover:text-indigo-800">
{t.title}
</a>
{maybe mempty (\d -> [hsx|<p class="text-sm text-gray-500 mt-1">{d}</p>|]) t.description}
</div>
<span class="text-xs text-gray-400 ml-4 whitespace-nowrap">{show t.createdAt}</span>
</div>
<div class="mt-3 flex items-center gap-3 text-xs text-gray-500">
<span>{show count} annotation(s)</span>
{renderSeverityBreakdown severityBreakdown}
</div>
</div>
|]
buildSeverityBreakdown :: [Annotation] -> [(Text, Int)]
buildSeverityBreakdown annotations =
[ ("low", length $ filter (\a -> a.severity == "low") annotations)
, ("medium", length $ filter (\a -> a.severity == "medium") annotations)
, ("high", length $ filter (\a -> a.severity == "high") annotations)
, ("critical", length $ filter (\a -> a.severity == "critical") annotations)
]
renderSeverityBreakdown :: [(Text, Int)] -> Html
renderSeverityBreakdown pairs = [hsx|
<span class="flex items-center gap-1">
{forEach (filter (\(_, n) -> n > 0) pairs) renderSeverityPip}
</span>
|]
renderSeverityPip :: (Text, Int) -> Html
renderSeverityPip (sev, n) = [hsx|
<span class={severityClass sev <> " text-xs px-1.5 py-0.5 rounded"}>
{sev}: {show n}
</span>
|]
severityClass :: Text -> Text
severityClass "low" = "bg-gray-100 text-gray-500"
severityClass "medium" = "bg-blue-100 text-blue-700"
severityClass "high" = "bg-yellow-100 text-yellow-800"
severityClass "critical" = "bg-red-100 text-red-800 font-semibold"
severityClass _ = "bg-gray-100 text-gray-500"

View File

@@ -0,0 +1,33 @@
module Web.View.AnnotationThreads.New where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data NewView = NewView
{ widget :: !Widget
, thread :: !AnnotationThread
}
instance View NewView where
html NewView { .. } = [hsx|
<div class="mb-6 flex items-center gap-2 text-sm text-gray-500">
<a href={ShowWidgetAction { widgetId = widget.id }} class="hover:text-gray-700">{widget.name}</a>
<span>/</span>
<a href={WidgetAnnotationThreadsAction { widgetId = widget.id }} class="hover:text-gray-700">Threads</a>
<span>/</span>
<span>New</span>
</div>
<div class="max-w-lg">
<h1 class="text-2xl font-semibold mb-6">New Annotation Thread</h1>
{renderForm thread widget.id}
</div>
|]
renderForm :: AnnotationThread -> Id Widget -> Html
renderForm thread widgetId = formFor thread [hsx|
{(textField #title) { fieldLabel = "Title" }}
{(textareaField #description) { fieldLabel = "Description (optional)" }}
{submitButton}
|]

View File

@@ -0,0 +1,96 @@
module Web.View.AnnotationThreads.Show where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data ShowView = ShowView
{ widget :: !Widget
, thread :: !AnnotationThread
, annotations :: ![Annotation]
}
instance View ShowView where
html ShowView { .. } = [hsx|
<div class="mb-6 flex items-center gap-2 text-sm text-gray-500">
<a href={ShowWidgetAction { widgetId = widget.id }} class="hover:text-gray-700">{widget.name}</a>
<span>/</span>
<a href={WidgetAnnotationThreadsAction { widgetId = widget.id }} class="hover:text-gray-700">Threads</a>
<span>/</span>
<span>{thread.title}</span>
</div>
<div class="max-w-2xl">
<div class="mb-6">
<h1 class="text-2xl font-semibold">{thread.title}</h1>
{maybe mempty (\d -> [hsx|<p class="text-sm text-gray-500 mt-1">{d}</p>|]) thread.description}
</div>
<div class="mb-4 flex items-center gap-3">
{renderSeverityBar annotations}
<span class="text-xs text-gray-500">{dominantCategoryBadge annotations}</span>
</div>
<div class="space-y-3">
{forEach annotations renderAnnotationCard}
</div>
</div>
|]
renderAnnotationCard :: Annotation -> Html
renderAnnotationCard a = [hsx|
<div class="bg-white rounded-lg border border-gray-200 px-4 py-3">
<div class="flex items-center gap-2 mb-2">
<span class="text-xs bg-gray-100 text-gray-600 px-2 py-0.5 rounded">{a.category}</span>
<span class={severityClass a.severity <> " text-xs px-2 py-0.5 rounded"}>
{a.severity}
</span>
</div>
<p class="text-sm text-gray-700">{a.body}</p>
</div>
|]
renderSeverityBar :: [Annotation] -> Html
renderSeverityBar annotations =
let total = length annotations
counts = map (\s -> (s, length $ filter (\a -> a.severity == s) annotations))
["critical", "high", "medium", "low"]
nonZero = filter (\(_, n) -> n > 0) counts
in if total == 0
then mempty
else [hsx|
<div class="flex items-center gap-1">
{forEach nonZero (\(s, n) -> renderBarSegment s n total)}
</div>
|]
renderBarSegment :: Text -> Int -> Int -> Html
renderBarSegment sev n total =
let pct = (n * 100) `div` total
in [hsx|
<div class={barColor sev <> " h-2 rounded"} style={"width: " <> show pct <> "px"} title={sev <> ": " <> show n}>
</div>
|]
barColor :: Text -> Text
barColor "low" = "bg-gray-300"
barColor "medium" = "bg-blue-400"
barColor "high" = "bg-yellow-400"
barColor "critical" = "bg-red-500"
barColor _ = "bg-gray-300"
dominantCategoryBadge :: [Annotation] -> Text
dominantCategoryBadge [] = ""
dominantCategoryBadge annotations =
let cats = map (.category) annotations
tally = map (\c -> (c, length $ filter (== c) cats)) (nub cats)
best = foldl1 (\(c1, n1) (c2, n2) -> if n2 > n1 then (c2, n2) else (c1, n1)) tally
in fst best
severityClass :: Text -> Text
severityClass "low" = "bg-gray-100 text-gray-500"
severityClass "medium" = "bg-blue-100 text-blue-700"
severityClass "high" = "bg-yellow-100 text-yellow-800"
severityClass "critical" = "bg-red-100 text-red-800 font-semibold"
severityClass _ = "bg-gray-100 text-gray-500"