descrybe/docs/support-auto/06-admin-kb-settings-ui.md

06 — Admin KB + auto-reply settings UI

Agent: 6/10 (support-auto)
Date: 2026-08-05
Status: Implemented (frontend + AI config columns)

---

PROBLEM

Full platform admins need a clean place to manage support knowledge articles/templates, toggle FAQ auto-match + AI fallback (enable, thresholds, draft vs auto-send), and see which admin AI role powers fallback — without giving support_staff settings mutation.

---

Routes & auth

Surface	Path	Gate
UI	/admin/support/knowledge	requirePlatformAdmin()
Nav	Admin shell Manage → Support KB	fullAdminOnly
Inbox shortcut	Support Center actions (full admin)	fullAdmin
API articles	/api/admin/support/kb/articles*	RequirePlatformAdmin
API templates	/api/admin/support/templates*	RequirePlatformAdmin
API settings	/api/admin/support/auto-config	RequirePlatformAdmin

ASSUMPTION: Contract lists KB CRUD as platform-admin only; staff do not get a read-only KB UI in this pass (inbox remains their surface).

---

Files

File	Intent
apps/web/src/lib/support/admin-kb-api.ts	Typed client for articles, templates, auto-config
apps/web/src/routes/admin/support/knowledge/+page.svelte	Tabs: Articles · Templates · Auto-reply
apps/web/src/lib/components/AdminNav.svelte	Support KB nav + active-state split from ticket inbox
apps/web/src/routes/admin/support/+page.svelte	Link to knowledge page for full admins
apps/api/sql/schema/033_support_auto_ai_config.sql	AI columns on support_auto_config
apps/api/internal/support/kb_types.go	Extended AutoConfig / AutoConfigInput
apps/api/internal/support/match_auto_reply.go	Get/UpdateAutoConfig read/write AI fields
apps/api/internal/support/errors.go	ErrInvalidAIThreshold, ErrInvalidAIDelivery

Backend CRUD handlers already from agent 3: support_kb_handlers.go + mounts in server.go.

---

UX

1. Articles — list, create/edit dialog (slug, markdown body, keywords, intents, categories, publish, weight), delete.
2. Templates — same pattern; placeholders {{subject}} / {{category}}.
3. Auto-reply — two cards:
   • FAQ: master enable, faq_enabled, match threshold, retry-on-first-reply
   • AI: ai_enabled, delivery (draft | auto_send), AI threshold, use global support role, optional overrides
4. Support AI role card — loads ai_roles.support from GET /api/admin/settings; links to /admin/settings AI roles tab. Key always from that role; overrides only provider/model/base URL.

Matches admin shell: PageShell, dark .dark tokens, TableShell / Tabs / Dialog / Card.

---

Settings contract mapping

UI control	AutoConfig JSON field	Default
Enable automatic first responses	enabled	false
FAQ / template matching	faq_enabled	true
Match confidence	match_confidence_threshold	0.78
Retry on first customer reply	retry_on_first_customer_reply	false
Enable AI fallback	ai_enabled	false
Delivery mode	ai_delivery	draft
AI confidence	ai_confidence_threshold	0.65
Use platform support role	ai_use_global_support_role	true
Overrides	ai_*_override	empty

Rate-limit fields from contract §8 are not in this UI yet (table has no columns); agent 4/9 can add later.

---

Verification

cd apps\web
npm run check

Manual:

1. Full admin → Manage → Support KB → create published article with keywords → save auto settings (FAQ on, AI draft).
2. Confirm Platform settings → AI roles → Support shows as the fallback provider card.
3. support_staff → Support KB nav hidden; deep link /admin/support/knowledge → forbidden empty state.
4. After migrate 032+033, settings persist via PUT /api/admin/support/auto-config.

---

Notes for integrator (agent 10)

• Migration order: 032_support_kb_auto_reply.sql then 033_support_auto_ai_config.sql.
• GetAutoConfig falls back to FAQ-only SELECT if AI columns are missing (pre-033).
• No git commit from this agent.