How anhquocs/akaalert works
AkaAlert is a React Native operations app for monitoring and administering Facebook and TikTok advertising infrastructure. Users sign in, view real-time summaries and job status, then manage ad accounts, recovery, spend-cap records, TikTok apps and advertisers, alerts, and system access. Feature screens and hooks drive domain use cases; repositories implement data access through the shared API client. The README documents SSE job updates and Firebase push/Firestore notifications. Most feature wiring was not sampled, so those links reflect documented capabilities and avoid uncertain call chains.
Main entry points: App.tsx App Entry And Navigation · FacebookNavigator.tsx Facebook Workspace · OverviewScreen.tsx Overview Dashboard · useAuth.ts Authentication Hook
Components 26
App Shell
- App Entry And Navigation
App.tsx - Sign In
src/features/auth/presentation/ui/LoginScreen.tsx - Authentication Hook
src/features/auth/presentation/viewmodel/useAuth.ts - Authentication Repository
src/features/auth/data/repository/AuthRepositoryImpl.ts - Token Storage
src/features/auth/data/local/storage.ts - API Client
src/core/data/remote/apiClient.ts - Network Status
src/core/hooks/useNetworkStatus.ts
Monitoring
- Overview Dashboard
src/features/overview/presentation/ui/OverviewScreen.tsx - Summary Retrieval
src/features/overview/domain/usecases/GetSummaryUseCase.ts - Live Job Stream
src/features/overview/presentation/viewmodels/useJobStream.ts - Job Stream Repository
src/features/overview/data/repositories/JobStreamRepositoryImpl.ts
- Facebook Workspace
src/features/facebook/presentation/navigation/FacebookNavigator.tsx - Ad Accounts And Checks
src/features/facebook/domain/usecase/ad-accounts/index.ts - Business Managers
src/features/facebook/business-managers/presentation/ui/BusinessManagersScreen.tsx - Spend Cap Resets
src/features/facebook/domain/usecase/spend-cap/index.ts - Account Recovery
src/features/facebook/domain/usecase/account-recovery/index.ts
TikTok
- TikTok Workspace
src/features/tiktok/presentation/navigation/TikTokNavigator.tsx - Apps And OAuth
src/features/tiktok/domain/usecase/apps-oauth/index.ts - Advertisers
src/features/tiktok/domain/usecase/advertisers/index.ts
Alerts And Admin
- Alerts And Delivery Logs
src/features/alerts/presentation/ui/AlertsScreen.tsx - Push And Firestore Notifications
src/features/notifications/presentation/react/FCMService.ts - System Administration
src/features/system/presentation/ui/SystemScreen.tsx
Other components
- Operator
- API Gateway
- SSE Service
- Firebase Services
Connections 27
- Operator → App Entry And Navigation: opens
- App Entry And Navigation → Sign In: routes
- Sign In → Authentication Hook: submits credentials
- Authentication Hook → Authentication Repository: executes login
- Authentication Repository → API Client: posts login
- API Client → API Gateway: sends requests
- Authentication Hook → Token Storage: stores tokens
- API Client → Token Storage: reads and refreshes tokens
- App Entry And Navigation → Overview Dashboard: navigates
- Overview Dashboard → Summary Retrieval: loads summary
- Overview Dashboard → Live Job Stream: observes jobs
- Live Job Stream → Job Stream Repository: observes stream
- Job Stream Repository → SSE Service: connects SSE
- Overview Dashboard → API Gateway: controls jobs
- App Entry And Navigation → Facebook Workspace: opens workspace
- Facebook Workspace → Ad Accounts And Checks: manages accounts
- Facebook Workspace → Business Managers: manages business managers
- Facebook Workspace → Spend Cap Resets: reviews spend resets
- Facebook Workspace → Account Recovery: manages recovery
- App Entry And Navigation → TikTok Workspace: opens workspace
- TikTok Workspace → Apps And OAuth: manages apps and OAuth
- TikTok Workspace → Advertisers: views advertisers
- App Entry And Navigation → Alerts And Delivery Logs: opens alerts
- App Entry And Navigation → Push And Firestore Notifications: initializes notifications
- Push And Firestore Notifications → Firebase Services: receives and syncs
- App Entry And Navigation → System Administration: opens administration
- App Entry And Navigation → Network Status: shows connectivity