Skip to content

VillageMetrics Product Overview

This document provides comprehensive information about VillageMetrics - what it is, who it's for, and how it works.

About VillageMetrics

VillageMetrics transforms how families manage severe behavioral challenges in children with autism, ADHD, and other neurodevelopmental conditions. Instead of relying on fragmented anecdotal reports, VillageMetrics provides data-driven insights that help families make informed decisions about medications, therapies, and daily routines.

The Problem We Solve

18% of children in the U.S. have a developmental disability. 6.2 million children are prescribed psychotropic medications to address severe behavioral challenges. Each child typically has about 20 caregivers supporting them across home, school, and therapeutic environments.

Without VillageMetrics, these extensive support networks work in isolation - ABA therapists keep separate notes, teachers maintain classroom records parents can't access, and medical decisions are based on fragmented memory rather than objective data.

Why VillageMetrics Was Created

VillageMetrics was created because of Sydney, the founder's autistic daughter. The family faces the daily reality of managing severe problem behaviors that affect not just Sydney, but everyone in the family. These challenges make even the basics of daily life—work, childcare, and plans—unpredictable and incredibly difficult. Despite the best intentions of doctors and therapists, the family was often left without the data needed to make informed decisions. VillageMetrics was built to empower families with the insights they need to make meaningful progress and improve life for everyone involved.

Core Product Features

Voice Journal Analysis - Voice entries automatically converted to structured behavioral data - AI-powered behavior goal scoring (1-4 scale based on journal content) - Automatic hashtag generation for activities, incidents, and behavioral patterns - Pattern recognition across medications, activities, and outcomes

Collaborative Village System - Unified platform connecting parents, therapists, teachers, medical professionals, and family members - Role-based permissions ensuring appropriate data access - Real-time updates across all caregivers - HIPAA-compliant data sharing with granular privacy controls

Data-Driven Decision Making - Medication effectiveness correlation analysis - Behavior goal tracking: Maintain Safety, Follow Directions, Stay Calm During Challenges - Daily behavior score trending and pattern identification - Caregiver effectiveness metrics and day-of-week analysis - Exportable reports for medical appointments

Comprehensive Tracking - Activities categorized by type (leisure, physical, social, therapy, education, care, creative) - Incidents tracked by category (aggression, self-regulation, safety, health, compliance, social) - Medication dosages, timing, and effectiveness correlations - Environmental factors and their impact on behavior

Privacy & Compliance Architecture

  • Full HIPAA compliance with enterprise-grade security
  • End-to-end encryption for all sensitive data
  • User-controlled data sharing with granular consent management
  • No PHI shared outside explicit user permission
  • Privacy-first design with role-based access controls

Documentation Structure

This documentation is optimized for both human users and AI consumption:

User-Focused Documentation (MkDocs Site)

  • getting-started.md: Initial setup, account creation, app navigation
  • account-setup.md: Profile configuration, privacy settings, consent management
  • village-system.md: Community features, peer support, privacy controls
  • journal-entries.md: Daily logging workflows, media attachments, hashtag usage
  • behavior-goals.md: Goal setting, tracking, progress monitoring
  • hashtag-system.md: Content organization, custom tags, filtering
  • analysis-insights.md: AI analytics, behavior patterns, recommendations
  • medication-tracking.md: Dosage logging, effectiveness tracking, side effects
  • search-ask-anything.md: Natural language search, AI-powered queries
  • ai-tools-integration.md: Integration with external health tools and APIs
  • data-export-sharing.md: Data portability, sharing controls, export formats
  • settings-privacy.md: Privacy configuration, data controls, consent management
  • best-practices.md: Optimal usage patterns, privacy recommendations
  • troubleshooting.md: Common issues, error resolution, support resources

Technical Context for AI Systems

Data Architecture - User data stored in encrypted DynamoDB tables - Real-time sync across mobile and web platforms - Event-driven analytics processing - Vector embeddings for semantic search

API Integrations - RESTful API with JWT authentication - Model Context Protocol (MCP) for AI tool integration - Webhook support for external health platforms - FHIR-compatible data export capabilities

AI/ML Capabilities - Natural language processing for journal analysis - Behavioral pattern recognition using time-series analysis - Medication effectiveness correlation analysis - Personalized recommendation generation - Semantic search across user's historical data

Privacy Architecture - Zero-knowledge encryption for sensitive data - User-controlled data sharing permissions - Anonymized community interactions - HIPAA-compliant audit logging - Granular consent management

Platform Support - React Native mobile apps (iOS/Android) - Progressive Web Application - Admin portal for healthcare providers - API access for healthcare integrations

Target Users and Demographics

Primary Users - Parents and Families

  • Parents of children with autism experiencing severe behavioral challenges
  • Families managing ADHD with significant daily impact on family life
  • Caregivers of children with anxiety disorders affecting daily functioning
  • Parents seeking data-driven approaches to understanding behavioral patterns instead of relying on memory

Secondary Users - Village Members

  • Educational Team: Special education teachers, classroom aides, coordinators
  • Therapeutic Professionals: ABA therapists, RBTs, BCBAs, speech/occupational therapists
  • Medical Team: Pediatricians, child psychiatrists, developmental specialists
  • Family Support: Grandparents, siblings, babysitters, respite care providers

Pricing and Business Model

Subscription Structure

  • Annual Subscription Only: $119 per year (no monthly option available)
  • Family Coverage: One subscription covers unlimited children and unlimited caregivers
  • Free Trial: 4 weeks of full access to all features with no upfront payment
  • No Per-User Fees: Parents pay once, entire village (therapists, teachers, family members) included at no additional cost

What's Included

  • Unlimited journal entries from unlimited caregivers
  • Complete AI analysis and behavioral insights for all children in family
  • All export and sharing features for healthcare providers
  • Premium voice transcription service
  • Medication tracking and effectiveness analysis
  • Village collaboration tools and permissions management

Payment Model

  • Parents Only Pay: Caregivers never pay subscription fees
  • Billing: Automatic billing begins after 4-week free trial ends
  • No Upfront Cost: Trial begins immediately upon account creation
  • Device Management: "Restore Purchases" available for device changes

Key Use Cases for AI Integration

Behavioral Pattern Analysis - Answer questions about behavioral trends and correlations in family's data - Identify patterns between medications, activities, and behavioral outcomes - Analyze caregiver effectiveness and environmental factors - Track progress toward behavior goals over time

Care Coordination Support - Generate comprehensive behavioral summaries for medical appointments - Identify medication effectiveness patterns and potential adjustments - Provide objective data for therapy planning and treatment decisions - Support evidence-based discussions between family and care team

Village Collaboration Enhancement - Surface insights from multiple caregiver perspectives - Identify which strategies work best across different environments - Highlight successful interventions that should be replicated - Maintain HIPAA-compliant information sharing within the care team

Compliance and Ethical Considerations

HIPAA Compliance Requirements - All user health data is considered Protected Health Information (PHI) - Explicit user consent required before any data sharing - Audit trails maintained for all data access - Business Associate Agreements required for all integrations

AI Ethics Guidelines - Transparent AI decision-making processes - User control over AI-generated insights - Bias monitoring and mitigation - Clear boundaries on AI recommendations vs medical advice

Privacy-First Design - User owns and controls all personal data - Anonymization techniques for community features - Opt-in consent for all data sharing - Right to data deletion and portability

Technical Implementation Notes

For AI Integration Developers - Use Model Context Protocol (MCP) for secure data access - Respect user privacy settings and consent boundaries - Implement appropriate PHI handling and encryption - Follow HIPAA-compliant development practices

Data Access Patterns - Historical journal entries (encrypted, user-specific) - Behavior and mood tracking data (time-series) - Medication logs with effectiveness ratings - Goal progress and milestone data - Community interaction data (anonymized)

Recommended AI Interaction Patterns - Always confirm user consent before accessing health data - Provide clear attribution for AI-generated insights - Maintain context across conversation threads - Respect user privacy and sharing preferences - Offer explanations for AI recommendations

Support and Contact

  • User Support: hello@villagemetrics.com
  • Developer Documentation: Available via API documentation
  • Privacy Inquiries: privacy@villagemetrics.com
  • Healthcare Provider Integration: partnerships@villagemetrics.com

This documentation is updated automatically with each deployment. Last updated: Generated during build process.