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#
- Architecture Overview
- Backend Microservices
- Frontend Applications
- Shared Libraries
- Service Dependencies
- Technology Stack Summary
- 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:
┌─────────────────────────────────────────────────────────────────────────────┐
│ 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#
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 |
| 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 |