🚀 Pluct Mobile App - Advanced TikTok Transcription Platform
📱 Overview
Pluct is a cutting-edge mobile application that provides instant AI-powered transcription services for TikTok videos. Built with modern Android architecture and comprehensive API integration, Pluct delivers seamless video-to-text conversion with real-time processing and intelligent content analysis.
Current SSOT Status - 2026-05-22
- Business Engine production Worker
be924cdc-4c3d-41d7-90bb-e06282f0ff5c is the current deployed control plane for app policy, wallet quote/fulfill, service health, and Android update routing.
GET /v1/public/client-policy is the single app policy source for Android hard/soft update state, APK or fallback URL, version codes, feature gates, wallet fulfillment, free tier, and legacy vend-token compatibility.GET /downloads/android/latest.apk currently redirects to https://apknow.one/rSqOHsZVNusERyU with short public cache headers. MOBILE_PLAY_STORE_URL intentionally stays blank until an official listing exists; set Business Engine MOBILE_APK_URL when a signed APK artifact should be delivered directly.- New paid work follows quote -> fulfill -> job status.
/v1/vend-token remains compatibility authorization plumbing for older app paths.
- Automated validation starts with latest touched surfaces, then recent failures, then high-priority journeys. The validated path for this update was
Journey-APIConnectivity, Journey-UX-31DirectValue-FatigueGuard-01Validation, Business Engine wallet/API coverage, direct-to-value readiness, visual parity, intent guard, and onboarding parity.
- Android journey automation is Node + ADB/UIAutomator. Playwright MCP is only for Business Engine web/admin surfaces.
- Home now uses the senior-friendly phrase
uses left, removes duplicate section-level View all actions, protects the bottom row from nav-bar clipping, and keeps the primary paste-to-value card visible without extra navigation.
✨ Key Features
🎯 Core Functionality
- ⚡ Quick Scan: Instant transcription with free tier processing
- 🤖 AI Analysis: Premium deep insights with key takeaways
- 📊 Real-time Credit Management: Live balance tracking and usage monitoring
- 🔄 Background Processing: WorkManager-powered transcription pipeline
- 📱 Modern UI: Jetpack Compose with Material 3 design
🌐 API Integration
- Business Engine: Complete integration with Pluct Business Engine API
- TTTranscribe: Advanced transcription service with status polling
- JWT Authentication: Secure token-based authentication system
- Health Monitoring: Real-time system health checks
- Error Handling: Comprehensive retry logic and fallback mechanisms
🧪 Testing & Quality
- Automated Testing: Node.js-based test orchestration
- UI Validation: Comprehensive UI component testing
- API Testing: End-to-end API integration validation
- Logcat Monitoring: Real-time log analysis and debugging
- Artifact Capture: Screenshot and XML dump collection
🏗️ Architecture
Modern Android Architecture
📱 Presentation Layer (Jetpack Compose)
├── 🎨 UI Components (Material 3)
├── 🔄 ViewModels (MVVM Pattern)
└── 🧭 Navigation (Compose Navigation)
📊 Business Logic Layer
├── 🔧 Use Cases & Interactors
├── 🏪 Repository Pattern
└── 🔄 State Management (StateFlow)
🌐 Data Layer
├── 🗄️ Local Database (Room)
├── 🌍 Remote APIs (OkHttp + Retrofit)
└── 💾 Data Sources (Repository)
🔧 Infrastructure
├── 🏗️ Dependency Injection (Hilt)
├── ⚙️ Background Processing (WorkManager)
└── 🧪 Testing Framework (JUnit + Espresso)
API Integration Flow
1. Health Check -> Business Engine Status
2. Client Policy -> update gate, APK URL, feature gates
3. Balance Check -> available and reserved wallet units
4. Quote -> price shown before work starts
5. Fulfill -> reserve only when the engine accepts work
6. Status Polling -> completed, charged, refunded, or ready/no charge
7. Result Processing -> transcript delivery and compact history row
🚀 Getting Started
Prerequisites
- Android Studio Arctic Fox or later
- JDK 17+
- Android SDK 26+ (API Level 26)
- ADB (Android Debug Bridge)
- Node.js 16+ (for testing)
Quick Start
-
Clone the Repository
git clone https://github.com/iamalbertly/PluctMobileApp.git
cd PluctMobileApp
-
Build the Application
./gradlew assembleDebug
