Voter Questions
UC-VQ-1
Submit Question
Voter navigates to Call5 Democracy question submission page, selects a candidate, provides basic information (name, voter ID, address, email), and enters question text. System validates, records submission with timestamp, and triggers AI candidate response. Anonymous submission is supported.
UC-VQ-2
Candidate Response
System retrieves candidate-specific context file and generates AI response based on question. Response is presented via web interface and emailed to voter. If voter is a Civic Group Member, system provides sharing options with pre-populated content for their preferred platforms.
Call Five People - Civic Group Formation
UC-CF-1
Create a Civic Group
Authenticated user navigates to "Create Civic Group" feature, enters group name, personal information, and platform preferences (Nextdoor, Bluesky, Mastodon, email). System validates information, creates new civic group with user as founding member and Group Leader, assigns city name from address, and generates unique invite link.
UC-CF-2
Invite People to Join Civic Group
Member navigates to "Invite Members" page, system displays unique invite link for their civic group. Member copies and shares link via their preferred method (email, direct message, phone/SMS, in-person with QR code). System tracks invitation activity with timestamp.
UC-CF-3
Accept Invitation and Join Civic Group
User clicks invite link, views civic group information, authenticates via Google OAuth, provides personal information and platform preferences. System validates user is not already member of another group, adds user as member, records who invited them (network tracking), and notifies existing members.
UC-CF-4
Prevent Multiple Civic Group Memberships
System checks user's existing civic group membership when attempting to join. If existing membership is detected, system prevents join action and displays message: "You are already a member of [Group Name]. Each person can only be a member of one civic group, though you can lead your own group while being a member of another."
UC-CF-5
Grow Beyond Five Members
When civic group already has five members, system allows group to grow beyond five members as member invites additional person. System records growth milestone for tracking exponential expansion. While five is the recommended "Call 5" size for each member's direct network, groups can grow organically beyond this threshold.
UC-CF-6
Track Who Invited Whom
System records invitation relationship when invitation is accepted: inviting member ID, new member ID, timestamp, and civic group ID. System stores network growth path and enables future analytics on exponential growth patterns, most active recruiters, and network depth and breadth.
UC-CF-7
View Civic Group Membership
Member navigates to "My Civic Group" page. System retrieves and displays active members: group name, city, list of active members (names only for privacy), member count, and Group Leader indicator. System does not display inactive/removed members, member contact information, or platform preferences of other members.
UC-CF-8
Maintain Political Issues List
Group Leader or members propose political issues important to the group. System stores issue list associated with civic group. Members can view, discuss, and update issue priorities. System uses issue list to suggest relevant candidate questions, filter news and updates, and guide group discussion topics.
UC-CF-9
Platform Preference Management
Member navigates to "Sharing Preferences" and views current platform preferences. Member can enable/disable sharing options: Nextdoor, Bluesky, Mastodon, Email (always available), and future platforms. System validates at least one sharing option is enabled, saves updated preferences, and confirms changes. Future "Share to..." buttons display accordingly.
UC-CF-10
Active Members Group List Access
Member accesses group member list and system filters to show only active members. System displays basic status: last activity date and member since date. System respects privacy by not showing contact details, platform preferences, or personal demographic information.
UC-CF-11
Google OAuth Authentication
User selects "Sign in with Google", system redirects to Google OAuth consent screen. User authorizes Call5 Democracy, Google returns authentication token, system validates token and creates/retrieves user session. System verifies user's email address and grants access to authenticated features: email-based responses, civic group creation/membership, sharing preferences, and saved questions/responses.
UC-CF-12
Specify Candidate Relationship
User is prompted to optionally specify relationship to candidate: Supporter, Undecided voter, Opponent, or Not specified. System stores relationship preference and uses it to personalize AI candidate responses (tone, focus), filter relevant campaign promises, and customize notification content.
Hub-and-Spoke Sharing
UC-HS-1
Group Leader Posts Announcement
Group Leader creates announcement in Call5 (text, links, optional attachments) and submits to group. System stores announcement in civic group timeline and generates "Share to..." buttons based on member preferences. Each button pre-populates: brief preview of announcement, link back to Call5 for full details, and call-to-action. Members click preferred button, review pre-populated content, and complete sharing manually. One announcement can be easily shared to multiple platforms; conversation stays coherent in Call5 hub.
UC-HS-2
AI Candidate Response Shared with Group
Civic Group Member submits question to AI candidate and indicates "Share with my civic group" (optional checkbox). System generates AI response and stores question/response. System generates "Share to..." buttons for all group members based on their platform preferences. Pre-populated share content includes: member name and question topic, brief excerpt of AI response, and link to full Q&A in Call5. AI candidate Q&A becomes a group learning experience with convenient sharing options; discussion happens in hub.
UC-HS-3
Call-5 Recruitment with Platform Integration
Member shares Call5 invite link on their preferred platform (e.g., Nextdoor neighborhood group). Post reaches contacts who are active on that platform. New members click invite link, create accounts, and specify their varied platform preferences. System tracks recruitment success. Member can remain in original civic group (single membership rule) while leading their new group (multiple leadership allowed). Both groups can interact, share AI candidate responses with pre-populated content, and coordinate on civic issues. Exponential growth happens naturally through existing social networks while respecting platform diversity and user control.
UC-HS-4
Cross-Platform Discussion Thread
Member submits question to AI candidate through Call5. AI responds with detailed policy position. "Share to..." buttons appear for each member based on platform preferences. Members who want to share click their preferred button, review pre-populated content, and complete sharing. Members and their contacts click through to Call5 to read full AI response. Discussion happens in Call5 (not fragmented across platforms). Easy sharing to multiple platforms attracts new members with diverse preferences. Result: discussion coherence + easy multi-platform sharing + no forced platform adoption + user control.
UC-HS-5
Post-Election Network Persistence
After election ends, campaign AI personalities transition to tracking elected officials' promise fulfillment. Group Leader posts updates about city council decisions on key issues. System provides "Share to..." buttons with pre-populated content for all member preferences. Group discusses implications in Call5. AI candidate provides analysis based on campaign promises vs. actual votes. Network remains active for next election cycle, local initiatives, ongoing civic participation, and community organizing. Easy sharing with pre-populated content maintains engagement through members' preferred platforms. Sharing infrastructure built during campaign continues serving community; post-election silence is broken.
UC-HS-6
Platform Migration Flexibility
Member navigates to "Sharing Preferences" in Call5 and updates their platform selections (e.g., unchecks Bluesky, keeps Nextdoor and Email). System saves updated preferences. Future "Share to..." buttons display updated preferences only. No disruption to group communication occurs. Member maintains full participation regardless of platform shifts. Other members' preferences remain unchanged. Platform preference changes don't break civic engagement continuity; members maintain control and can adapt to evolving social media landscape.
Admin Use Cases
UC-ADM-1
Monitor System Health
Admin accesses monitoring dashboard and system displays: active users count, questions submitted (daily/weekly/monthly), civic groups created, network growth metrics (Call-5 cascade depth), email delivery rates (MailGun), platform sharing success rates, and API usage and performance. Admin reviews for anomalies and takes corrective action if needed.
UC-ADM-2
Review Logs and Analytics
Admin accesses logs and analytics. System provides: error logs, user activity patterns, popular candidate questions, network growth visualizations, platform preference distributions, and sharing analytics. Admin analyzes trends and generates reports for stakeholders to understand system usage patterns.
UC-ADM-3
Manage Feature Flags
Admin accesses feature flag configuration and can enable/disable: Call Five People feature, Hub-and-Spoke sharing (per platform), Campaign promise repository (ENH-002), AI news scanning (ENH-003), and Group chat (if implemented). System applies configuration changes and features become available/unavailable to users accordingly. Supports gradual rollout.
UC-ADM-4
Add/Modify/Delete a Candidate
Admin navigates to "Manage Candidates" and selects action: Add (enter candidate name, upload context file, set active status), Modify (update candidate name or context file), or Delete (remove candidate with system warning if questions exist). System validates input, applies changes to database, and updates candidate selection dropdown for voters.
UC-ADM-5
Add/Manage Campaign Promises
Admin navigates to "Campaign Promises", selects candidate, and adds new promise: promise text, category (housing, transit, education, etc.), date made, and source link. Admin can modify or delete existing promises. System stores promise in repository and makes promise available for: AI candidate responses, post-election tracking, group discussions, and news scanning (ENH-003).