Eve library

Aphrodite Domain - Service Inventory

Guide

Revision 1

On this page

Migration Status: Eve → Aphrodite (Oshun Domain)

This document provides a comprehensive inventory of all Eve microservices, their responsibilities, dependencies, and migration targets for the Aphrodite domain within the Oshun monorepo.


Table of Contents#

  1. Architecture Overview
  2. Backend Microservices
  3. Frontend Applications
  4. Shared Libraries
  5. Service Dependencies
  6. Technology Stack Summary
  7. Migration Targets

Architecture Overview#

The Eve platform is a comprehensive adult entertainment streaming platform built as a microservices architecture with the following high-level components:

text
┌─────────────────────────────────────────────────────────────────────────────┐
│                            CLIENT APPLICATIONS                               │
├──────────────────┬──────────────────┬──────────────────────────────────────┤
│   Web (Next.js)  │ Mobile (RN)      │ Admin Dashboard (RN Web)             │
└────────┬─────────┴────────┬─────────┴──────────────────┬───────────────────┘
         │                  │                            │
         ▼                  ▼                            ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                           API GATEWAY / SERVICES                             │
├─────────┬─────────┬─────────┬─────────┬─────────┬─────────┬────────────────┤
│  User   │  Chat   │ Payment │ Stream  │ Content │ Notif.  │ Analytics      │
│ Service │ Service │ Service │ Service │ Service │ Service │ Service        │
│ :3000   │ :5000   │ :4000   │ :50051  │ :7001   │ :7003   │ :7000          │
└────┬────┴────┬────┴────┬────┴────┬────┴────┬────┴────┬────┴────┬───────────┘
     │         │         │         │         │         │         │
     ▼         ▼         ▼         ▼         ▼         ▼         ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                              DATA LAYER                                      │
├───────────────────┬───────────────────┬─────────────────────────────────────┤
│  PostgreSQL       │  MongoDB          │  ClickHouse                         │
│  (Users, Payments,│  (Chat, Notif.)   │  (Analytics)                        │
│   Streams)        │                   │                                     │
└───────────────────┴───────────────────┴─────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│                           INFRASTRUCTURE                                     │
├───────────────────┬───────────────────┬─────────────────────────────────────┤
│  Redis            │  Kafka            │  AWS S3 / CloudFront                │
│  (Cache, Sessions,│  (Event Bus)      │  (Media Storage / CDN)              │
│   Socket.io)      │                   │                                     │
└───────────────────┴───────────────────┴─────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│                         EXTERNAL INTEGRATIONS                                │
├───────────────────┬───────────────────┬─────────────────────────────────────┤
│  Payment Gateways │  Push Services    │  Device Protocols                   │
│  (CCBill, Segpay, │  (Firebase FCM,   │  (Lovense, Buttplug, Kiiroo,        │
│   Epoch)          │   SendGrid)       │   Handy, OhMiBod)                   │
└───────────────────┴───────────────────┴─────────────────────────────────────┘

Backend Microservices#

1. User Service#

Property Value
Source Location eve/apps/user-service/
Migration Target apps/aphrodite/user/
Framework Fastify 4.27.0
Port 3000 (USER_SERVICE_PORT)
Health Endpoint GET /healthz

Purpose#

User identity, authentication, and profile management service. Serves as the primary entry point for user-facing API orchestration.

Key Responsibilities#

  • Authentication

    • User registration with email verification
    • Login/logout with session management
    • Token refresh and password reset
    • Two-factor authentication (TOTP-based)
    • OAuth integration (Google, Facebook, etc.)
  • Profile Management

    • User profile CRUD operations
    • Creator profile management
    • User preferences and settings
  • Social Features

    • Follow/unfollow functionality
    • Friend management
    • Fan club management and subscription tiers

API Routes#

Route Method Description
/healthz GET Health check
/register POST User registration
/login POST User login
/refresh-token POST Token refresh
/profile GET/PUT Profile management
/creator GET/PUT Creator profile
/settings GET/PUT User settings
/follow POST/DELETE Social graph
/fan-club GET/POST Fan club management

Dependencies#

  • Internal: PostgreSQL, Redis
  • External: OAuth providers
  • Packages: @eve/database, @eve/utilities, @eve/common

2. Chat Service#

Property Value
Source Location eve/apps/chat-service/
Migration Target apps/aphrodite/chat/
Framework Node.js HTTP + Socket.io 4.8.1
Port 5000 (CHAT_SERVICE_PORT)
Health Endpoint GET /healthz

Purpose#

Real-time messaging service for direct messages and stream chat, implementing horizontal scaling via Redis adapter and event fan-out via Kafka.

Key Responsibilities#

  • Real-time Messaging

    • WebSocket connections via Socket.io
    • Direct message (DM) handling
    • Stream chat support
    • Message persistence to MongoDB
  • Moderation

    • Content filtering
    • Moderation commands
    • Message flagging
  • State Management

    • Presence management
    • Room management
    • Typing indicators

Core Modules#

Module Purpose
dm-service.ts Direct message orchestration
dm-handlers.ts Socket.io event handlers
dm-repository.ts MongoDB persistence layer
content-filter.ts Message content filtering
moderation-service.ts Moderation integration
socket.ts Socket.io server creation
rooms.ts Room state management
presence.ts User presence tracking

Dependencies#

  • Internal: MongoDB, Redis (Socket.io adapter), Kafka
  • Packages: @eve/utilities

3. Analytics Service#

Property Value
Source Location eve/apps/analytics-service/
Migration Target apps/aphrodite/analytics/
Framework Fastify 4.28.1
Port 7000 (ANALYTICS_SERVICE_PORT)
Health Endpoint GET /healthz

Purpose#

Analytics pipeline and event ingestion service providing creator dashboard aggregations and real-time event processing with ClickHouse backend.

Key Responsibilities#

  • Event Processing

    • Analytics event ingestion
    • Real-time event pipeline
    • Event aggregation and rollups
  • Creator Dashboard

    • Earnings metrics
    • Viewer analytics
    • Performance aggregation
    • Peak hours analysis
    • Geographic distribution
  • System Analytics

    • Custom event tracking
    • Retention analysis
    • Funnel metrics

Core Modules#

Module Purpose
analytics-pipeline.ts Event processing pipeline
creator-dashboard-api.ts Creator metrics API
clickhouse-client.ts ClickHouse integration
creator-dashboard/earnings.ts Earnings calculations
creator-dashboard/viewers.ts Viewer statistics
creator-dashboard/tips.ts Tip analytics
analytics/realtime.ts Real-time processing
analytics/retention.ts Retention metrics

Dependencies#

  • Internal: ClickHouse
  • Packages: @eve/common

4. Content Service#

Property Value
Source Location eve/apps/content-service/
Migration Target apps/aphrodite/content/
Framework Express 4.21.2
Port 7001 (CONTENT_SERVICE_PORT)
Health Endpoint GET /healthz

Purpose#

Content management and media processing service handling photos, videos, VOD, and all media storage operations.

Key Responsibilities#

  • Content Management

    • Content store/inventory
    • Photo set management
    • VOD (Video On Demand) service
  • Media Processing

    • Image processing and optimization (Sharp)
    • Video transcoding
    • Thumbnail generation
  • Storage

    • AWS S3 integration
    • Presigned URL generation
    • CDN integration

Core Modules#

Module Purpose
content-store-service.ts Core content management
media-upload-service.ts File upload handling
image-processing-service.ts Image optimization
video-processing-service.ts Video transcoding
vod-service.ts VOD management
photoset-helper-service.ts Photo set utilities
content-store/licenses.ts Content licensing
content-store/purchases.ts Purchase tracking

Dependencies#

  • Internal: AWS S3, PostgreSQL
  • External: CloudFront CDN
  • Packages: @eve/common, Sharp 0.33.5

5. Moderation Service#

Property Value
Source Location eve/apps/moderation-service/
Migration Target apps/aphrodite/moderation/
Framework Fastify 4.28.1
Port 7002 (MODERATION_SERVICE_PORT)
Health Endpoint GET /healthz

Purpose#

Content moderation service providing AI-powered detection, human moderation workflows, compliance tracking, and user reporting systems.

Key Responsibilities#

  • AI Moderation

    • ML-based content detection
    • Automated flagging
    • Category classification
  • Human Review

    • Moderation queue management
    • Review workflows
    • Escalation handling
  • Compliance

    • Rule enforcement
    • Policy violation tracking
    • Compliance reporting
  • Reporting

    • User report handling
    • Appeal management

Core Modules#

Module Purpose
ai-moderation-service.ts ML-based detection
human-moderation-service.ts Manual review workflows
compliance-service.ts Compliance enforcement
reporting-service.ts User reporting system
runtime.ts Moderation orchestration

Dependencies#

  • Internal: PostgreSQL, Redis
  • Packages: @eve/common

6. Notification Service#

Property Value
Source Location eve/apps/notification-service/
Migration Target apps/aphrodite/notifications/
Framework Fastify 4.28.1
Port 7003 (NOTIFICATION_SERVICE_PORT)
Health Endpoint GET /healthz

Purpose#

Multi-channel notification delivery system handling email, push notifications, and in-app notifications with preference management.

Key Responsibilities#

  • Email Notifications

    • SendGrid integration
    • Template management
    • Delivery tracking
  • Push Notifications

    • Firebase Cloud Messaging
    • iOS/Android support
    • Topic management
  • In-App Notifications

    • Real-time delivery (Socket.io)
    • Queue management
    • History tracking
  • Preferences

    • User notification settings
    • Channel preferences
    • Frequency controls

Core Modules#

Module Purpose
notification-service.ts Main orchestration
email-notification-service.ts SendGrid integration
push-notification-service.ts Firebase FCM
notification-repository.ts MongoDB persistence
notification-handlers.ts Event handlers

Dependencies#

  • Internal: MongoDB, Redis, Socket.io
  • External: SendGrid, Firebase Admin SDK
  • Packages: @eve/common

7. Payment Service#

Property Value
Source Location eve/apps/payment-service/
Migration Target apps/aphrodite/payment/
Framework Fastify 4.28.1
Port 4000 (PAYMENT_SERVICE_PORT)
Health Endpoint GET /healthz

Purpose#

Complete payment orchestration service handling purchases, tips, earnings, payouts, and financial reporting with multiple payment gateway integrations.

Key Responsibilities#

  • Transaction Processing

    • Purchase processing
    • Tip transactions (viewer → creator)
    • Token/credit system
    • Refund processing
  • Creator Finance

    • Earnings calculation
    • Payout management
    • Payout scheduling
    • Payment method management
  • Compliance

    • Tax document handling
    • Tax reporting
    • Identity verification
    • Fraud detection
  • Interactive Features

    • Tip menus and goals
    • Leaderboards
    • Transfer management

API Routes#

Route Category Endpoints
Purchase Initiation, confirmation, callbacks
Tips Processing, menus, leaderboards, goals
Earnings Creator earnings queries
Payouts Management, scheduling, methods
Tax Documents, reporting
Webhooks Payment gateway callbacks

Payment Processors#

Processor Purpose
CCBill Primary credit card processor
Segpay Alternative payment processor
Epoch Token-based processor
King Premium payment system

Security Features#

  • CORS configuration
  • Helmet.js security headers
  • Rate limiting (120 req/min)
  • Input validation (Zod)
  • Idempotency support for transactions

Dependencies#

  • Internal: PostgreSQL, Redis
  • External: CCBill, Segpay, Epoch APIs
  • Packages: @eve/database, @eve/utilities

8. Recommendation Service#

Property Value
Source Location eve/apps/recommendation-service/
Migration Target apps/aphrodite/recommendations/
Framework Express 4.21.2
Port 7004 (RECOMMENDATION_SERVICE_PORT)
Health Endpoint GET /healthz

Purpose#

Personalization and recommendation engine providing hybrid recommendation strategies using feature store, collaborative filtering, and ML predictions.

Key Responsibilities#

  • Feature Management

    • User feature store
    • Item feature store
    • Feature engineering
  • ML Models

    • Model training orchestration
    • Model serving
    • Performance tracking
  • Recommendations

    • Hybrid recommendation algorithms
    • Collaborative filtering
    • Content-based filtering
  • Experimentation

    • A/B testing support
    • Experiment management
    • Performance analysis

Core Modules#

Module Purpose
recommendation-engine.ts Core algorithm
feature-store.ts Feature management
model-service.ts Model lifecycle
training-service.ts Training orchestration
monitoring-service.ts Performance metrics
ab-testing-service.ts Experiment management
personalization-api.ts Public API

Dependencies#

  • Internal: PostgreSQL, Redis
  • Packages: @eve/common

9. Stream Service#

Property Value
Source Location eve/apps/stream-service/
Migration Target apps/aphrodite/streaming/
Framework gRPC + Fastify (health)
Port 50051 gRPC (STREAM_SERVICE_PORT)
Health Port 3001 HTTP (STREAM_SERVICE_HEALTH_PORT)
Health Endpoint GET /healthz

Purpose#

Core streaming orchestration service managing live streams, interactive features, show types (group, private, ticket), and device integrations.

Key Responsibilities#

  • Stream Management

    • Stream creation and lifecycle
    • WebRTC signaling
    • MediaSoup SFU integration
    • Quality adaptation (ABR)
  • Show Types

    • Public streams
    • Group shows
    • Private shows (1-on-1)
    • Ticket shows (paid exclusive)
  • Interactive Features

    • Goal-based tipping
    • Viewer presence
    • Interactive device control
  • Media Delivery

    • HLS / LL-HLS streaming
    • DVR support
    • Stream recording
    • Bandwidth management
  • VR Support

    • VR capture
    • VR playback
    • Stereoscopic streaming

Device Integrations#

Device Protocol Description
Lovense Proprietary Interactive vibrators
OhMiBod Proprietary Interactive vibrators
Buttplug Open standard Universal device protocol
Kiiroo Proprietary Synchronized devices
Handy Proprietary Stroker devices
Tcode Protocol Haptic scripting

Core Modules#

Module Purpose
stream-discovery-service.ts Stream discovery
goal-service.ts Goal-based interactions
private-show-service.ts 1-on-1 streams
group-show-service.ts Group streaming
ticket-show-handlers.ts Paid shows
toy-device-abstraction.ts Device protocol layer
vibration-handler.ts Device control
funscript-service.ts Interactive scripts
mediasoup.ts SFU integration
signaling.ts WebRTC signaling
hls.ts / ll-hls.ts HLS streaming
vr-capture/ VR capture system
vr-playback/ VR playback system
dvr.ts Recording support
quality.ts Quality settings
bandwidth.ts Bandwidth optimization
latency.ts Latency management

Dependencies#

  • Internal: PostgreSQL, Redis, Kafka, MediaSoup
  • External: Device APIs
  • Packages: @eve/database, @eve/common, @eve/proto

Frontend Applications#

10. Web Application#

Property Value
Source Location eve/apps/web/
Migration Target apps/aphrodite/web/
Framework Next.js 14.2.15
Language TypeScript

Purpose#

Main browser-based web application providing the primary user interface for streaming, chat, tipping, and content consumption.

Technology Stack#

  • Framework: Next.js 14
  • UI Library: React 18.3.1
  • State Management: Zustand 4.5.5
  • Data Fetching: @tanstack/react-query 5.59.16
  • Styling: Tailwind CSS

Key Features#

  • Creator dashboard
  • Stream viewer interface
  • Real-time chat UI
  • Analytics dashboard
  • Content management
  • Profile management
  • Payment/tipping interface
  • Recommendation display

11. Mobile Application#

Property Value
Source Location eve/apps/mobile/
Migration Target apps/aphrodite/mobile/
Framework React Native 0.73.2
Language TypeScript

Purpose#

Native mobile application for iOS and Android providing an optimized mobile experience for streaming, chat, payments, and content consumption.

Technology Stack#

  • Navigation: @react-navigation
  • State: Zustand 4.4.7
  • HTTP: Axios 1.6.5
  • Video: react-native-video 5.2.1
  • WebRTC: react-native-webrtc 118.0.3
  • Push: @react-native-firebase/messaging
  • Biometrics: react-native-biometrics
  • Storage: react-native-mmkv
  • IAP: react-native-iap 12.10.0

Key Features#

  • Live streaming viewer
  • Real-time chat
  • In-app purchases
  • Video playback (HLS)
  • WebRTC for group shows
  • Biometric authentication
  • Push notifications
  • Age gating
  • Parental controls

Component Areas#

Area Purpose
AgeGate Age verification
Chat Messaging interface
CoStreaming Co-streaming UI
ContentWarning Content warnings
Payment Payment UI
Profile User profiles
Settings App settings
Stream Stream viewer
VideoPlayer Video playback

12. Admin Dashboard#

Property Value
Source Location eve/apps/admin/
Migration Target apps/aphrodite/admin/
Framework React Native (Web)
Language TypeScript

Purpose#

Administrative dashboard for platform management including user management, content moderation, and system monitoring.

Key Features#

  • User Management

    • Paginated user list with search/filter
    • User detail views
    • Admin actions (warn, suspend, ban, password reset)
  • Content Moderation

    • Moderation queue with priority filtering
    • Content review interface
    • Appeal management
  • Performance Monitoring

    • Real-time system metrics
    • Endpoint statistics
    • Database performance

Shared Libraries#

Core Packages#

Package Location Purpose
@eve/database packages/database/ Prisma ORM, schema, migrations
@eve/utilities packages/utilities/ Logging, crypto, IDs, helpers
@eve/common packages/common/ Achievements, leaderboards, loyalty
@eve/api-middleware packages/api-middleware/ API middleware, validation
@eve/config packages/config/ Centralized configuration
@eve/security packages/security/ Encryption, data classification
@eve/proto packages/proto/ Protocol buffer definitions
@eve/cache packages/cache/ Redis utilities
@eve/ui packages/ui/ Shared React components
@eve/gamification packages/gamification/ Gamification features

Shared Services#

Location Purpose
services/shared/ Cross-service utilities, middleware

Service Dependencies#

Dependency Matrix#

text
                    PostgreSQL  MongoDB  ClickHouse  Redis  Kafka  S3
User Service           ✓                              ✓
Chat Service                      ✓                   ✓      ✓
Analytics Service                            ✓
Content Service        ✓                              ✓            ✓
Moderation Service     ✓                              ✓
Notification Service              ✓                   ✓
Payment Service        ✓                              ✓
Recommendation Svc     ✓                              ✓
Stream Service         ✓                              ✓      ✓

External Service Dependencies#

Service External Dependency Purpose
User Service OAuth Providers Social login
Payment Service CCBill, Segpay, Epoch Payment processing
Notification Service SendGrid, Firebase Email, push notifications
Content Service CloudFront CDN delivery
Stream Service Lovense, Buttplug, etc. Device control

Technology Stack Summary#

Layer Technology
Frontend Next.js 14 (Web), React Native 0.73 (Mobile/Admin)
API Framework Fastify 4.x, Express 4.x, gRPC
Language TypeScript (100%)
Primary Database PostgreSQL (Prisma)
Document Store MongoDB 7.0
Analytics Database ClickHouse
Cache/Sessions Redis
Message Queue Kafka
Real-time Socket.io, WebRTC (MediaSoup)
Object Storage AWS S3
CDN CloudFront, Cloudflare
Email SendGrid
Push Notifications Firebase Cloud Messaging
Image Processing Sharp
Build System Turborepo, npm workspaces
Containerization Docker

Migration Targets#

Apps (Services)#

Eve Location Aphrodite Target Nx Build Target
eve/apps/user-service/ apps/aphrodite/user/ aphrodite-user
eve/apps/chat-service/ apps/aphrodite/chat/ aphrodite-chat
eve/apps/analytics-service/ apps/aphrodite/analytics/ aphrodite-analytics
eve/apps/content-service/ apps/aphrodite/content/ aphrodite-content
eve/apps/moderation-service/ apps/aphrodite/moderation/ aphrodite-moderation
eve/apps/notification-service/ apps/aphrodite/notifications/ aphrodite-notifications
eve/apps/payment-service/ apps/aphrodite/payment/ aphrodite-payment
eve/apps/recommendation-service/ apps/aphrodite/recommendations/ aphrodite-recommendations
eve/apps/stream-service/ apps/aphrodite/streaming/ aphrodite-streaming
eve/apps/web/ apps/aphrodite/web/ aphrodite-web
eve/apps/mobile/ apps/aphrodite/mobile/ aphrodite-mobile
eve/apps/admin/ apps/aphrodite/admin/ aphrodite-admin

Libraries#

Eve Location Aphrodite Target Package Name
eve/packages/database/ libs/aphrodite/database/ @aphrodite/database
eve/packages/utilities/ libs/aphrodite/utilities/ @aphrodite/utilities
eve/packages/common/ libs/aphrodite/common/ @aphrodite/common
eve/packages/api-middleware/ libs/aphrodite/api-middleware/ @aphrodite/api-middleware
eve/packages/config/ libs/aphrodite/config/ @aphrodite/config
eve/packages/security/ libs/aphrodite/security/ @aphrodite/security
eve/packages/proto/ libs/aphrodite/proto/ @aphrodite/proto
eve/packages/cache/ libs/aphrodite/cache/ @aphrodite/cache
eve/packages/ui/ libs/aphrodite/ui/ @aphrodite/ui
eve/packages/gamification/ libs/aphrodite/gamification/ @aphrodite/gamification

Document History#

Date Version Author Changes
2026-01-16 1.0.0 Claude Initial service inventory