Verantwortlich (Owner)
{ownerName}
diff --git a/frontend/src/registry/steeringElementRegistry.js b/frontend/src/registry/steeringElementRegistry.js
index 0456557..ef56272 100644
--- a/frontend/src/registry/steeringElementRegistry.js
+++ b/frontend/src/registry/steeringElementRegistry.js
@@ -2,7 +2,7 @@
* AP2.4 — Steuerungselement-Registry (Element → UI-Semantik).
*/
-/** @type {Record
} */
+/** @type {Record} */
export const STEERING_ELEMENT_UI = {
critical_path: {
nextActionTitle: 'Nächster Schritt am kritischen Pfad',
@@ -18,6 +18,40 @@ export const STEERING_ELEMENT_UI = {
},
}
+/** Labels für Steuerungselemente auf Plan-Profil (Anzeige, nicht Verhalten). */
+export const STEERING_ELEMENT_PLAN_LABELS = {
+ work_cycle_scope: 'Sprint-Zeitbox',
+ backlog_epic_hierarchy: 'Epic-Hierarchie im Eingang',
+ gate_fulfillment: 'Gate-Fortschritt',
+ queue_inbox: 'Queue-Eingang',
+ critical_path: 'Kritischer Pfad',
+ recurring_rhythm: 'Rhythmen',
+ maturity_stage: 'Reifegrad-Stufen',
+ chapter_progression: 'Kapitel-Fortschritt',
+ dispute_timeline: 'Verfahren / Fristen',
+ next_action_primary: 'Nächster Schritt',
+}
+
+export const BACKLOG_VOCABULARY_PROFILE_LABELS = {
+ agile_intake: 'Agile Eingang (Epic, Story, Bug, Issue)',
+ continuous_intake: 'Kontinuierlicher Eingang (Idee, Bug, Störung)',
+ standard_intake: 'Standard-Eingang (Story, Bug, Issue)',
+ none: 'Kein Backlog-Eingang',
+}
+
+/** Plan-relevante Elemente zuerst. */
+const PLAN_ELEMENT_ORDER = [
+ 'work_cycle_scope',
+ 'backlog_epic_hierarchy',
+ 'gate_fulfillment',
+ 'queue_inbox',
+ 'critical_path',
+ 'recurring_rhythm',
+ 'maturity_stage',
+ 'chapter_progression',
+ 'dispute_timeline',
+]
+
/**
* @param {string[] | undefined | null} elements
* @param {string} key
@@ -34,3 +68,23 @@ export function steeringElementUi(elements, key) {
if (!hasSteeringElement(elements, key)) return null
return STEERING_ELEMENT_UI[key] || null
}
+
+/**
+ * @param {string[] | undefined | null} elements
+ */
+export function planSteeringElementLabels(elements) {
+ if (!Array.isArray(elements)) return []
+ const order = new Map(PLAN_ELEMENT_ORDER.map((key, index) => [key, index]))
+ return elements
+ .filter((key) => STEERING_ELEMENT_PLAN_LABELS[key])
+ .sort((a, b) => (order.get(a) ?? 99) - (order.get(b) ?? 99))
+ .map((key) => STEERING_ELEMENT_PLAN_LABELS[key])
+}
+
+/**
+ * @param {string | undefined | null} profileKey
+ */
+export function backlogVocabularyProfileLabel(profileKey) {
+ if (!profileKey) return null
+ return BACKLOG_VOCABULARY_PROFILE_LABELS[profileKey] || profileKey
+}
diff --git a/frontend/src/styles/program-chrome.css b/frontend/src/styles/program-chrome.css
index 1d4a0ac..d0aaae7 100644
--- a/frontend/src/styles/program-chrome.css
+++ b/frontend/src/styles/program-chrome.css
@@ -887,3 +887,130 @@
.next-action-reason {
margin-left: 4px;
}
+
+.backlog-intake-guide {
+ margin-bottom: 16px;
+ padding: 12px 14px;
+ border-left: 3px solid var(--jk-primary);
+ background: var(--jk-surface-muted, rgba(0, 0, 0, 0.03));
+ border-radius: 8px;
+}
+
+.backlog-intake-guide--compact {
+ margin-bottom: 12px;
+ padding: 0;
+ border: none;
+ background: transparent;
+ font-size: 14px;
+}
+
+.backlog-intake-guide__title {
+ margin: 0 0 10px;
+}
+
+.backlog-intake-guide__steps {
+ list-style: none;
+ margin: 0;
+ padding: 0;
+ display: flex;
+ flex-direction: column;
+ gap: 10px;
+}
+
+.backlog-intake-guide__step {
+ display: flex;
+ gap: 10px;
+ align-items: flex-start;
+}
+
+.backlog-intake-guide__step-marker {
+ flex-shrink: 0;
+ width: 1.25rem;
+ font-weight: 700;
+ line-height: 1.4;
+}
+
+.backlog-intake-guide__step--current .backlog-intake-guide__step-marker {
+ color: var(--jk-primary);
+}
+
+.backlog-intake-guide__step--done .backlog-intake-guide__step-marker {
+ color: var(--jk-success, #2e7d32);
+}
+
+.backlog-intake-guide__step--pending {
+ opacity: 0.72;
+}
+
+.backlog-intake-guide__step-detail {
+ margin: 4px 0 0;
+ font-size: 13px;
+}
+
+.backlog-intake-guide__step-link {
+ display: inline-block;
+ margin-top: 4px;
+ font-size: 13px;
+}
+
+.plan-steering-summary {
+ margin: 16px 0;
+ padding: 14px 16px;
+ border-radius: 8px;
+ background: var(--jk-surface-muted, rgba(0, 0, 0, 0.03));
+ border: 1px solid var(--jk-border, rgba(0, 0, 0, 0.08));
+}
+
+.plan-steering-summary__title {
+ margin: 0 0 12px;
+ font-size: 1rem;
+}
+
+.plan-steering-summary__list {
+ margin: 0;
+}
+
+.plan-steering-summary__row {
+ display: grid;
+ grid-template-columns: minmax(7rem, 9rem) 1fr;
+ gap: 8px 12px;
+ margin-bottom: 10px;
+}
+
+.plan-steering-summary__row dt {
+ margin: 0;
+}
+
+.plan-steering-summary__row dd {
+ margin: 0;
+}
+
+.plan-steering-summary__pills {
+ list-style: none;
+ margin: 0;
+ padding: 0;
+ display: flex;
+ flex-wrap: wrap;
+ gap: 6px;
+}
+
+.plan-steering-summary__pill {
+ padding: 2px 8px;
+ border-radius: 999px;
+ font-size: 12px;
+ background: var(--jk-surface, #fff);
+ border: 1px solid var(--jk-border, rgba(0, 0, 0, 0.1));
+}
+
+.plan-steering-summary__paths {
+ font-size: 14px;
+}
+
+.plan-steering-summary__footnote {
+ margin: 12px 0 0;
+ font-size: 13px;
+}
+
+.plan-steering-summary__tag {
+ font-size: 13px;
+}
diff --git a/frontend/src/utils/backlogIntakeGuide.js b/frontend/src/utils/backlogIntakeGuide.js
new file mode 100644
index 0000000..e0e301f
--- /dev/null
+++ b/frontend/src/utils/backlogIntakeGuide.js
@@ -0,0 +1,119 @@
+/**
+ * Geführter Eingangs-Flow — Schritte aus Operating Context, keine Archetyp-Ifs.
+ */
+
+/**
+ * @typedef {'pending' | 'current' | 'done'} GuideStepState
+ * @typedef {{
+ * id: string,
+ * title: string,
+ * detail: string,
+ * state: GuideStepState,
+ * to?: string,
+ * linkLabel?: string,
+ * }} BacklogIntakeGuideStep
+ */
+
+/**
+ * @param {{
+ * vocabulary: import('./resolveBacklogVocabulary.js').BacklogVocabulary,
+ * sprintCommitEnabled: boolean,
+ * hasPlanableSprint: boolean,
+ * hasBacklogItems: boolean,
+ * hasCommittableItems: boolean,
+ * hasConvertedItems: boolean,
+ * directWorkEnabled: boolean,
+ * initiativeId: string,
+ * scopedPath: (path: string, opts: { initiativeId: string }) => string,
+ * }} input
+ * @returns {BacklogIntakeGuideStep[]}
+ */
+export function buildBacklogIntakeGuideSteps(input) {
+ const {
+ vocabulary,
+ sprintCommitEnabled,
+ hasPlanableSprint,
+ hasBacklogItems,
+ hasCommittableItems,
+ hasConvertedItems,
+ directWorkEnabled,
+ initiativeId,
+ scopedPath,
+ } = input
+
+ const epicHierarchy = Boolean(
+ vocabulary.capabilities?.epic_hierarchy ?? vocabulary.epic_hierarchy,
+ )
+ const storyLabel = vocabulary.labels?.story || 'Story'
+ const epicLabel = vocabulary.labels?.epic || 'Epic'
+
+ /** @type {BacklogIntakeGuideStep[]} */
+ const steps = []
+
+ if (sprintCommitEnabled) {
+ steps.push({
+ id: 'sprint',
+ title: 'Sprint anlegen',
+ detail: 'Unter Plan → Sprint einen Zeitrahmen anlegen (geplant oder aktiv).',
+ state: hasPlanableSprint ? 'done' : 'current',
+ to: scopedPath('/plan/sprint', { initiativeId }),
+ linkLabel: 'Zu Sprint-Planung',
+ })
+ }
+
+ steps.push({
+ id: 'intake',
+ title: epicHierarchy
+ ? `${epicLabel} oder ${storyLabel} im Eingang`
+ : `${storyLabel} im Eingang erfassen`,
+ detail: epicHierarchy
+ ? `Optional ${epicLabel} als Container, darunter ${storyLabel}/Bug/Issue zum Refinement.`
+ : 'Ideen und Störungen sammeln, bevor sie committet werden.',
+ state: hasBacklogItems
+ ? 'done'
+ : steps.some((step) => step.state === 'current')
+ ? 'pending'
+ : 'current',
+ to: undefined,
+ linkLabel: undefined,
+ })
+
+ steps.push({
+ id: 'commit',
+ title: sprintCommitEnabled ? 'In Sprint committen' : 'In Arbeitspaket umwandeln',
+ detail: sprintCommitEnabled
+ ? 'Item markieren → Ziel-Sprint wählen → committen. Daraus entsteht ein Arbeitspaket im Ist.'
+ : 'Freigegebenes Item committen — es wird ein Arbeitspaket im Ist.',
+ state: hasConvertedItems
+ ? 'done'
+ : hasCommittableItems && (!sprintCommitEnabled || hasPlanableSprint)
+ ? 'current'
+ : 'pending',
+ })
+
+ if (directWorkEnabled) {
+ steps.push({
+ id: 'direct-ap',
+ title: 'Alternativ: Arbeitspaket direkt',
+ detail:
+ 'Ad-hoc-Spike oder Nacharbeit ohne Backlog-Umweg — Plan → Arbeit (Direct Commit, Pfad B).',
+ state: 'pending',
+ to: scopedPath('/plan/work', { initiativeId }),
+ linkLabel: 'Plan → Arbeit',
+ })
+ }
+
+ if (!steps.some((step) => step.state === 'current')) {
+ const firstPending = steps.find((step) => step.state === 'pending')
+ if (firstPending) firstPending.state = 'current'
+ }
+
+ return steps
+}
+
+/**
+ * @param {BacklogIntakeGuideStep[]} steps
+ */
+export function isBacklogIntakeGuideComplete(steps) {
+ return steps.length > 0 && steps.every((step) => step.state === 'done' || step.id === 'direct-ap')
+}
diff --git a/frontend/src/utils/backlogIntakeGuide.test.js b/frontend/src/utils/backlogIntakeGuide.test.js
new file mode 100644
index 0000000..615cdf4
--- /dev/null
+++ b/frontend/src/utils/backlogIntakeGuide.test.js
@@ -0,0 +1,44 @@
+import { describe, expect, it } from 'vitest'
+import { buildBacklogIntakeGuideSteps } from './backlogIntakeGuide.js'
+import { DEFAULT_BACKLOG_VOCABULARY } from './resolveBacklogVocabulary.js'
+
+const scope = (path, { initiativeId }) => `${path}?initiative=${initiativeId}`
+
+describe('buildBacklogIntakeGuideSteps', () => {
+ it('startet mit Sprint-Schritt wenn sprint_commit aktiv', () => {
+ const steps = buildBacklogIntakeGuideSteps({
+ vocabulary: {
+ ...DEFAULT_BACKLOG_VOCABULARY,
+ capabilities: { sprint_commit: true, epic_hierarchy: true },
+ labels: { epic: 'Epic', story: 'Story' },
+ },
+ sprintCommitEnabled: true,
+ hasPlanableSprint: false,
+ hasBacklogItems: false,
+ hasCommittableItems: false,
+ hasConvertedItems: false,
+ directWorkEnabled: true,
+ initiativeId: 'abc',
+ scopedPath: scope,
+ })
+ expect(steps[0].id).toBe('sprint')
+ expect(steps[0].state).toBe('current')
+ expect(steps.some((step) => step.id === 'direct-ap')).toBe(true)
+ })
+
+ it('markiert Eingang als erledigt wenn Items vorhanden', () => {
+ const steps = buildBacklogIntakeGuideSteps({
+ vocabulary: DEFAULT_BACKLOG_VOCABULARY,
+ sprintCommitEnabled: false,
+ hasPlanableSprint: false,
+ hasBacklogItems: true,
+ hasCommittableItems: true,
+ hasConvertedItems: false,
+ directWorkEnabled: false,
+ initiativeId: 'abc',
+ scopedPath: scope,
+ })
+ const intake = steps.find((step) => step.id === 'intake')
+ expect(intake?.state).toBe('done')
+ })
+})