feat(T02-T11): IHF Phase 1 schema, controllers, views, and helpers

- Schema: hubs, widgets, widget_versions, interaction_events (append-only
  trigger), annotations, users — single migration file
- Web layer: Types, Routes, FrontController with auth + AutoRefresh layout
- Controllers: Hubs (CRUD), Widgets (CRUD + versioning), InteractionEvents
  (JSON capture, canonical event_type validation), Annotations (threaded,
  append-only)
- Sessions controller for IHP auth
- Views: Hubs (index/show/new/edit), Widgets (index/show/new/edit),
  Annotations (index/new), Sessions (login)
- widgetEnvelope helper with full data-* governance attributes
- Integration tests: Hub CRUD, Widget versioning, event capture, append-only
  guard, annotation threading, validation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-27 01:42:43 +00:00
parent ff11913d5c
commit c560e541c7
26 changed files with 1591 additions and 12 deletions

31
Web/View/Hubs/Edit.hs Normal file
View File

@@ -0,0 +1,31 @@
module Web.View.Hubs.Edit where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data EditView = EditView { hub :: !Hub }
instance View EditView where
html EditView { .. } = [hsx|
<div class="max-w-lg">
<div class="flex items-center gap-2 text-sm text-gray-500 mb-4">
<a href={HubsAction} class="hover:text-gray-700">Hubs</a>
<span>/</span>
<a href={ShowHubAction { hubId = hub.id }} class="hover:text-gray-700">{hub.name}</a>
<span>/</span>
<span>Edit</span>
</div>
<h1 class="text-2xl font-semibold mb-6">Edit Hub</h1>
{renderForm hub}
</div>
|]
renderForm :: Hub -> Html
renderForm hub = formFor hub [hsx|
{textField #name}
{(textField #slug) { helpText = "Lowercase, URL-safe identifier" }}
{textField #domain}
{submitButton}
|]

56
Web/View/Hubs/Index.hs Normal file
View File

@@ -0,0 +1,56 @@
module Web.View.Hubs.Index where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data IndexView = IndexView { hubs :: ![Hub] }
instance View IndexView where
html IndexView { .. } = [hsx|
<div class="flex items-center justify-between mb-6">
<h1 class="text-2xl font-semibold">Hubs</h1>
<a href={NewHubAction}
class="bg-indigo-600 text-white text-sm font-medium px-4 py-2 rounded
hover:bg-indigo-700">
New Hub
</a>
</div>
<div class="bg-white rounded-lg border border-gray-200 overflow-hidden">
<table class="w-full text-sm">
<thead class="bg-gray-50 border-b border-gray-200">
<tr>
<th class="text-left px-4 py-3 font-medium text-gray-700">Name</th>
<th class="text-left px-4 py-3 font-medium text-gray-700">Slug</th>
<th class="text-left px-4 py-3 font-medium text-gray-700">Domain</th>
<th class="px-4 py-3"></th>
</tr>
</thead>
<tbody>
{forEach hubs renderHub}
</tbody>
</table>
</div>
|]
renderHub :: Hub -> Html
renderHub hub = [hsx|
<tr class="border-b border-gray-100 hover:bg-gray-50">
<td class="px-4 py-3">
<a href={ShowHubAction { hubId = hub.id }}
class="font-medium text-indigo-600 hover:text-indigo-800">
{hub.name}
</a>
</td>
<td class="px-4 py-3 text-gray-500 font-mono text-xs">{hub.slug}</td>
<td class="px-4 py-3 text-gray-500">{hub.domain}</td>
<td class="px-4 py-3 text-right">
<a href={EditHubAction { hubId = hub.id }}
class="text-gray-500 hover:text-gray-700 text-xs mr-3">Edit</a>
<a href={DeleteHubAction { hubId = hub.id }}
class="text-red-500 hover:text-red-700 text-xs"
data-confirm="Delete this hub?">Delete</a>
</td>
</tr>
|]

24
Web/View/Hubs/New.hs Normal file
View File

@@ -0,0 +1,24 @@
module Web.View.Hubs.New where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data NewView = NewView { hub :: !Hub }
instance View NewView where
html NewView { .. } = [hsx|
<div class="max-w-lg">
<h1 class="text-2xl font-semibold mb-6">New Hub</h1>
{renderForm hub}
</div>
|]
renderForm :: Hub -> Html
renderForm hub = formFor hub [hsx|
{textField #name}
{(textField #slug) { helpText = "Lowercase, URL-safe identifier" }}
{textField #domain}
{submitButton}
|]

141
Web/View/Hubs/Show.hs Normal file
View File

@@ -0,0 +1,141 @@
module Web.View.Hubs.Show where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
data ShowView = ShowView
{ hub :: !Hub
, widgets :: ![Widget]
, recentEvents :: ![InteractionEvent]
, recentAnnotations :: ![Annotation]
}
instance View ShowView where
html ShowView { .. } = [hsx|
<div class="mb-6">
<div class="flex items-center gap-2 text-sm text-gray-500 mb-2">
<a href={HubsAction} class="hover:text-gray-700">Hubs</a>
<span>/</span>
<span>{hub.name}</span>
</div>
<div class="flex items-center justify-between">
<div>
<h1 class="text-2xl font-semibold">{hub.name}</h1>
<p class="text-sm text-gray-500 mt-1">
<span class="font-mono bg-gray-100 px-1 rounded">{hub.slug}</span>
<span class="ml-2">{hub.domain}</span>
</p>
</div>
<div class="flex gap-2">
<a href={EditHubAction { hubId = hub.id }}
class="text-sm border border-gray-300 px-3 py-1.5 rounded hover:bg-gray-50">
Edit
</a>
<a href={NewWidgetAction}
class="text-sm bg-indigo-600 text-white px-3 py-1.5 rounded hover:bg-indigo-700">
New Widget
</a>
</div>
</div>
</div>
<div class="grid grid-cols-3 gap-4 mb-8">
<div class="bg-white rounded-lg border border-gray-200 p-4">
<p class="text-xs text-gray-500 uppercase tracking-wide">Widgets</p>
<p class="text-3xl font-semibold mt-1">{length widgets}</p>
</div>
<div class="bg-white rounded-lg border border-gray-200 p-4">
<p class="text-xs text-gray-500 uppercase tracking-wide">Recent Events</p>
<p class="text-3xl font-semibold mt-1">{length recentEvents}</p>
</div>
<div class="bg-white rounded-lg border border-gray-200 p-4">
<p class="text-xs text-gray-500 uppercase tracking-wide">Recent Annotations</p>
<p class="text-3xl font-semibold mt-1">{length recentAnnotations}</p>
</div>
</div>
<section class="mb-8">
<h2 class="text-lg font-medium mb-3">Widgets</h2>
<div class="bg-white rounded-lg border border-gray-200 overflow-hidden">
<table class="w-full text-sm">
<thead class="bg-gray-50 border-b border-gray-200">
<tr>
<th class="text-left px-4 py-3 font-medium text-gray-700">Name</th>
<th class="text-left px-4 py-3 font-medium text-gray-700">Type</th>
<th class="text-left px-4 py-3 font-medium text-gray-700">Status</th>
<th class="text-left px-4 py-3 font-medium text-gray-700">Version</th>
</tr>
</thead>
<tbody>
{forEach widgets renderWidgetRow}
</tbody>
</table>
</div>
</section>
<section class="mb-8">
<h2 class="text-lg font-medium mb-3">Recent Interaction Events</h2>
<div class="bg-white rounded-lg border border-gray-200 overflow-hidden">
<table class="w-full text-sm">
<thead class="bg-gray-50 border-b border-gray-200">
<tr>
<th class="text-left px-4 py-3 font-medium text-gray-700">Event</th>
<th class="text-left px-4 py-3 font-medium text-gray-700">Actor</th>
<th class="text-left px-4 py-3 font-medium text-gray-700">Occurred</th>
</tr>
</thead>
<tbody>
{forEach recentEvents renderEventRow}
</tbody>
</table>
</div>
</section>
<section>
<h2 class="text-lg font-medium mb-3">Recent Annotations</h2>
<div class="space-y-2">
{forEach recentAnnotations renderAnnotationCard}
</div>
</section>
|]
renderWidgetRow :: Widget -> Html
renderWidgetRow w = [hsx|
<tr class="border-b border-gray-100 hover:bg-gray-50">
<td class="px-4 py-3">
<a href={ShowWidgetAction { widgetId = w.id }}
class="font-medium text-indigo-600 hover:text-indigo-800">
{w.name}
</a>
</td>
<td class="px-4 py-3 text-gray-500">{w.widgetType}</td>
<td class="px-4 py-3">
<span class="inline-block px-2 py-0.5 rounded text-xs bg-green-100 text-green-800">
{w.status}
</span>
</td>
<td class="px-4 py-3 text-gray-500">v{show w.version}</td>
</tr>
|]
renderEventRow :: InteractionEvent -> Html
renderEventRow e = [hsx|
<tr class="border-b border-gray-100">
<td class="px-4 py-3 font-mono text-xs">{e.eventType}</td>
<td class="px-4 py-3 text-gray-500 text-xs">{e.actorType}</td>
<td class="px-4 py-3 text-gray-400 text-xs">{show e.occurredAt}</td>
</tr>
|]
renderAnnotationCard :: Annotation -> Html
renderAnnotationCard a = [hsx|
<div class="bg-white rounded border border-gray-200 px-4 py-3">
<div class="flex items-center gap-2 mb-1">
<span class="text-xs bg-gray-100 text-gray-600 px-2 py-0.5 rounded">{a.category}</span>
<span class="text-xs text-gray-400">{a.actorType}</span>
</div>
<p class="text-sm text-gray-700">{a.body}</p>
</div>
|]