Files
Meister-Eder/openspec/changes/define-project-scope/content/channel-config.md
T
gurixandClaude Opus 4.5 145947c520 Add project scope documentation for AI playgroup registration system
Define complete non-technical scope for replacing Google Forms registration
with an AI-powered conversational agent. Includes:

- Registration data requirements (13 fields with validation rules)
- Knowledge base content (fees, regulations, schedule, FAQ from official PDFs)
- Conversation flow design with bilingual support (German/English)
- Agent personality guidelines (warm & friendly tone)
- Admin notification routing by playgroup type
- Email reminder system for incomplete registrations
- Data export formats (CSV/JSON)
- Channel configuration (email + chat)
- Release priorities (MVP scope defined)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-20 17:52:13 +01:00

4.0 KiB

Channel Configuration

Email Channel

Registration Email Address

Address: [To be determined]

Suggested options:

  • anmeldung@familienvereinfaellanden.ch (German: "registration")
  • spielgruppen@familien-verein.ch (existing admin address - Markus Graf)
  • registration@familienvereinfaellanden.ch

Note: The existing admin email spielgruppen@familien-verein.ch could be used, or a new dedicated address could be created.

Requirements for Email Address

  • Should be memorable and clear in purpose
  • Associated with the organization's domain (preferred)
  • Or a dedicated Gmail/other address if domain email not available

Email Processing

  • All emails to this address are processed by the AI agent
  • Agent responds from the same address
  • Thread tracking via email headers (In-Reply-To, References)

Chat Interface

Access URL

URL: [To be determined]

Suggested options:

  • https://familienvereinfaellanden.ch/anmeldung
  • https://register.familienvereinfaellanden.ch
  • Embedded widget on existing website

Branding Requirements

Style: Simple and neutral

Element Specification
Color scheme Clean, neutral colors (white background, subtle accent)
Logo Optional - can include Familienverein logo if available
Typography System fonts, readable and accessible
Layout Mobile-first, clean chat bubble design

Welcome Message

German (default):

Willkommen bei der Spielgruppe Pumuckl! Ich kann dir bei der Anmeldung deines Kindes helfen oder Fragen beantworten. Was möchtest du tun?

English:

Welcome to Spielgruppe Pumuckl! I can help you register your child or answer questions. What would you like to do?

Chat Interface Elements

  • Chat message bubbles (agent vs parent visually distinct)
  • Text input field
  • Send button
  • Typing indicator when agent is responding
  • Minimal header with playgroup name

Channel Selection Notes

Both channels lead to the same AI agent and registration system. The choice of channel is purely based on parent preference:

Channel Best for
Email Parents who prefer asynchronous communication
Chat Parents who want immediate, real-time interaction

Registrations from both channels are stored in the same system and appear identical to the admin.


Channel-Specific Behavior Differences

While both channels use the same AI agent and conversation logic, there are some inherent differences:

Response Timing

Aspect Email Chat
Response time Near-instant (automated) Real-time
Parent expectation Can be async Expects immediate reply
Session concept Thread-based Session-based

Conversation Flow

Aspect Email Chat
Multiple questions One per email preferred Multiple turns easy
Length Can be longer Shorter, conversational
Formatting Rich text, headers Simple text, emojis OK

State Management

Aspect Email Chat
Session timeout No timeout (thread-based) Session-based (browser)
Resumption Automatic via thread Same session required
Data retention 1 month Browser session duration
Reminders Yes (Day 3, 10, 25) No (session-based)

Error Handling

Aspect Email Chat
Invalid input Ask in next reply Immediate correction
Dropped session Follow-up email Timeout message
Technical error Error response email Error message in chat

Unique Capabilities

Email Only:

  • Can handle overnight/delayed responses naturally
  • Parent can attach documents if needed
  • Formal record via email threads

Chat Only:

  • Typing indicators
  • Immediate validation feedback
  • More natural conversation flow
  • Session can redirect to email if preferred

Consistent Across Both

  • Same AI agent personality
  • Same registration data collected
  • Same validation rules
  • Same knowledge base access
  • Same notification to admin
  • Same data storage format