How littlenet655-sketch/littlemuse works
LittleNet is a child-safe social and learning platform. A child signs in through the mobile app, explores age- and relationship-filtered content, and can post only through parent controls and server-side safety checks; media stays private until processing and moderation allow publication. Parent workflows manage account approval, relationships, screen time, and review, while learning breaks gate feed use. The map reflects the documented architecture and sampled route behavior; internal wiring for unsampled subsystems is shown only where the README supports it.
Main entry points: connection.py PostgreSQL · mobile Mobile APIs · media_processor.py Media processing · routes.py Post and story upload
Components 22
Mobile experience
- Expo mobile app
mobile_app/App.tsx - Mobile APIs
mobile
Identity and oversight
- Authentication
auth/routes.py - Parent controls
parent/routes.py - Admin review
admin/routes.py
Social and learning
- Feed and discovery
child/routes.py - Content search
child/search_routes.py - Approved messaging
childMessage/routes.py - Learning breaks
quiz/routes.py - Post and story upload
uploadPost/routes.py
Safety and media
- Safety moderation
safety - Media processing
services/media_processor.py - Publication lifecycle
services/publication_lifecycle.py - Durable media outbox
services/media_outbox.py
Platform services
- PostgreSQL
database/connection.py - Private media storage
services/object_storage.py
Other components
- Child
- Parent
- Admin moderator
- Modal AI
- Cloudflare R2
- Email delivery
Connections 30
- Child → Expo mobile app: uses
- Parent → Expo mobile app: uses
- Expo mobile app → Mobile APIs: HTTPS requests
- Mobile APIs → Authentication: authenticates
- Authentication → PostgreSQL: reads and writes
- Authentication → Email delivery: sends verification
- Mobile APIs → Feed and discovery: serves social APIs
- Mobile APIs → Post and story upload: serves upload APIs
- Feed and discovery → PostgreSQL: reads and writes
- Feed and discovery → Content search: searches content
- Content search → PostgreSQL: queries visible content
- Mobile APIs → Approved messaging: serves chat APIs
- Approved messaging → PostgreSQL: reads and writes
- Mobile APIs → Learning breaks: serves quiz APIs
- Learning breaks → PostgreSQL: reads and writes
- Parent → Parent controls: manages child
- Parent controls → PostgreSQL: reads and writes controls
- Post and story upload → Safety moderation: evaluates content
- Post and story upload → PostgreSQL: records post state
- Post and story upload → Durable media outbox: queues media work
- Durable media outbox → Media processing: dispatches work
- Media processing → Modal AI: requests AI analysis
- Media processing → Safety moderation: moderates media
- Media processing → Private media storage: persists accepted media
- Private media storage → Cloudflare R2: stores objects
- Media processing → PostgreSQL: updates processing state
- Publication lifecycle → PostgreSQL: updates publication state
- Publication lifecycle → Private media storage: publishes approved media
- Admin moderator → Admin review: reviews safety items
- Admin review → PostgreSQL: resolves review state