Software Specification: MMT Screening Support Platform

Executive Summary

The MMT Screening Support Platform is a comprehensive web application designed to scale Modern Monetary Theory education through 'Finding the Money' documentary screenings. The platform serves as a central hub where organizers can access curated discussion materials, facilitators can prepare for Q&A sessions with AI-powered tools, and audiences can engage with follow-up resources and surveys. The system maintains MMT content integrity through built-in guardrails while allowing customization for local contexts. By integrating event management, resource distribution, and community knowledge sharing into a single platform, it transforms individual screening efforts into a coordinated educational movement with measurable impact tracking and continuous improvement capabilities.

Tool Overview

Type: web application with API

Description: A multi-user platform that provides MMT screening organizers with curated educational resources, AI-powered Q&A preparation tools, integrated event management, and audience engagement features including pre/post screening surveys and social media promotion tools.

Primary Users: MMT screening organizers, discussion facilitators, and documentary audiences seeking deeper MMT understanding

Problem Solved: Eliminates manual distribution of screening materials and provides consistent, high-quality MMT education support while building institutional knowledge from screening experiences

Key Features

[MVP] Multi-Role Resource Library

Organized repository of MMT educational materials categorized by audience type and screening context with downloadable PDFs, videos, and interactive content

User Story: As a screening organizer, I want to access materials appropriate for my audience type so that I can provide relevant MMT education

Complexity: medium

[MVP] AI-Powered Q&A Database

Searchable database of MMT questions and multiple approved answers with automatic tagging and suggested response priorities

User Story: As a facilitator, I want to search for how similar questions have been answered before so that I can provide varied, accurate responses while keeping discussions fresh

Complexity: complex

[POST-MVP] Content Customization with Guardrails

AI-powered system allowing material customization while preventing modifications that contradict core MMT principles

User Story: As an organizer, I want to adapt materials for my specific audience while ensuring I maintain MMT accuracy

Complexity: complex

[POST-MVP] Integrated Event Management

Complete screening event creation, registration, and management system replacing current Vimeo limitations

User Story: As an organizer, I want to manage my entire screening event through one platform so that I can capture MMT-specific data and provide better support

Complexity: medium

[MVP] Pre/Post Screening Surveys

AI-powered survey system similar to harmonica.chat measuring economic understanding and sentiment changes

User Story: As an organizer, I want to measure the impact of my screening on audience understanding so that I can improve future events and demonstrate MMT education effectiveness

Complexity: medium

[POST-MVP] Community Q&A Contribution

System for organizers to submit new questions and responses from their screenings to build collective knowledge

User Story: As a facilitator, I want to share unique questions from my screening so that other facilitators can benefit from our collective experience

Complexity: simple

[POST-MVP] Social Media Integration

Automated generation of social media posts for screening promotion and MMT advocate notification system

User Story: As an organizer, I want to easily promote my screening and connect with local MMT advocates so that I can increase attendance and get expert support

Complexity: medium

[FUTURE] Analytics Dashboard

Comprehensive analytics showing material usage effectiveness, screening outcomes, and knowledge building trends

User Story: As an MML administrator, I want to see which materials and approaches are most effective so that I can optimize the platform and MMT education strategy

Complexity: medium

User Workflows

Organizer Screening Setup Flow

Steps:

1. Step 1: Organizer registers and selects audience type/context
2. Step 2: System recommends appropriate resource bundles
3. Step 3: Organizer downloads/customizes materials within guardrails
4. Step 4: Organizer creates screening event and generates promotion materials
5. Step 5: System notifies relevant local MMT advocates

Screens: Registration, Resource Library, Customization Tool, Event Creator, Promotion Generator

Facilitator Q&A Preparation Flow

Steps:

1. Step 1: Facilitator searches Q&A database by topic/audience type
2. Step 2: System displays multiple answer variations with suggested priorities
3. Step 3: Facilitator reviews and bookmarks preferred responses
4. Step 4: System provides practice mode for common question scenarios

Screens: Q&A Search, Response Library, Preparation Dashboard

Audience Engagement Flow

Steps:

1. Step 1: Audience member takes pre-screening survey via QR code
2. Step 2: System stores anonymous response linked to event
3. Step 3: Post-screening, audience takes follow-up survey
4. Step 4: System provides personalized next-step recommendations
5. Step 5: Audience can access additional resources based on interests

Screens: Survey Interface, Results Dashboard, Resource Recommendations

Data Requirements

User

Fields: user_id, role, email, organization, location, expertise_level, created_at

Relationships: One-to-many with Events, many-to-many with Resources accessed

Storage Notes: Role-based access control required

Resource

Fields: resource_id, title, type, audience_category, content_url, description, tags, approval_status, version

Relationships: Belongs to ResourceCategory, has many AccessLogs

Storage Notes: Version control for content updates, approval workflow needed

Question

Fields: question_id, question_text, category_tags, difficulty_level, frequency_score, audience_type, created_by

Relationships: One-to-many with Answers, belongs to Events (where originated)

Storage Notes: Full-text search indexing required

Answer

Fields: answer_id, question_id, answer_text, effectiveness_rating, approved_by, context_notes

Relationships: Belongs to Question, versioned for updates

Storage Notes: Multiple approved answers per question allowed

Event

Fields: event_id, organizer_id, title, date, location, audience_type, expected_attendance, actual_attendance

Relationships: Belongs to User (organizer), has many SurveyResponses

Storage Notes: Integration with calendar systems needed

SurveyResponse

Fields: response_id, event_id, pre_post_indicator, understanding_score, sentiment_data, next_action_interest, timestamp

Relationships: Belongs to Event, anonymous but linked pairs

Storage Notes: Anonymous data with secure pairing mechanism for pre/post comparison

Integrations with MMT Ecosystem

MMT Educational Resources (existing websites)

Type: API

Light integration for advanced learners who want deeper content without overwhelming casual movie-goers

Data Exchanged: Resource recommendations based on survey responses and demonstrated interest level

harmonica.chat

Type: API

Leverage existing AI survey technology for pre/post screening assessments

Data Exchanged: Survey templates, response processing, and sentiment analysis capabilities

Social Media MMT Networks

Type: webhook

Automated posting to MMT Facebook groups, Twitter accounts for screening promotion

Data Exchanged: Event details, generated promotional content, advocate notification triggers

Technical Considerations

Suggested Stack: Next.js/React frontend, Node.js/Express backend, PostgreSQL database, Redis for caching, OpenAI API for content guardrails and tagging

Hosting: Cloud platform (AWS/Vercel) with CDN for resource delivery

Authentication: Role-based auth with organizer verification process, social login options for ease of use

Key Challenges:

• AI content guardrail accuracy for MMT principles
• Scalable video/resource hosting
• Anonymous survey pairing system
• Real-time Q&A search during events

MVP Scope

Included in MVP:

• Multi-Role Resource Library
• Basic Q&A Database with search
• Pre/Post Screening Surveys
• User registration and role management

Excluded from MVP (Future):

• AI-powered customization
• Full event management
• Social media integration
• Advanced analytics

Success Criteria: 10 successful screening events using the platform with measurable pre/post survey improvements and positive organizer feedback on resource accessibility

Development Phases

Phase 1: Core Resource Platform

Deliverables:

• User authentication system
• Resource library with categorization
• Basic Q&A search functionality
• Survey integration

Phase 2: Community & Customization

Deliverables:

• Q&A contribution system
• Content customization with guardrails
• Event management integration

Phase 3: Promotion & Analytics

Deliverables:

• Social media automation
• Advanced analytics dashboard
• Ecosystem advocate notifications

Next Steps

1. Create detailed database schema and API endpoint specifications
2. Set up development environment and establish content approval workflow with Modern Money Lab team
3. Design and prototype the resource categorization system and user interface mockups
4. Research and test AI models for content guardrails to ensure MMT accuracy in customizations