How dklasens/vodalens-au works
VodaLens is an Android companion for viewing Vodafone AU usage, service-level daily history, billing-cycle pace, historical cycles, and bills. The main workflow is sign in to Vodafone, retain the connection and cached account data securely on-device, then refresh and present account information. The repository also includes a separate optional desktop research backend and earlier browser-extension research; neither is required by Android. Android source references and README statements support the main links; backend links are limited to shown imports and wiring.
Main entry points: oauth.cjs OAuth auth · server.cjs Backend startup · VodafoneApi.kt Vodafone API · app.cjs HTTP API routes
Components 26
Android companion
- App screens
apps/android/app/src/main/java/au/com/vodalens/MainActivity.kt - Account state
apps/android/app/src/main/java/au/com/vodalens/LensViewModel.kt - Account models
apps/android/app/src/main/java/au/com/vodalens/Models.kt - Cache codec
apps/android/app/src/main/java/au/com/vodalens/JsonCodec.kt - Encrypted storage
apps/android/app/src/main/java/au/com/vodalens/SecureStore.kt - Connection removal
apps/android/app/src/main/java/au/com/vodalens/ConnectionRemoval.kt - Service accents
apps/android/app/src/main/java/au/com/vodalens/AccentColors.kt
Vodafone access
- Sign-in flow
apps/android/app/src/main/java/au/com/vodalens/VodafoneLogin.kt - Login safeguards
apps/android/app/src/main/java/au/com/vodalens/LoginSecurity.kt - Vodafone API
apps/android/app/src/main/java/au/com/vodalens/VodafoneApi.kt - Session renewal
apps/android/app/src/main/java/au/com/vodalens/SessionRenewal.kt - Concurrent reads
apps/android/app/src/main/java/au/com/vodalens/ConcurrentReads.kt
Desktop research backend
- Backend startup
services/api/src/server.cjs - HTTP API routes
services/api/src/app.cjs - Auth selection
services/api/src/auth.cjs - Browser session auth
services/api/src/session.cjs - OAuth auth
services/api/src/oauth.cjs - Backend vault
services/api/src/store.cjs - Backend config
services/api/src/config.cjs - Renewal experiment
services/api/src/renewal-research.cjs - Account checks
services/api/src/account.cjs
Backend packages
- Usage domain
packages/domain/src/index.cjs - Provider adapter
packages/vodafone-client/src/index.cjs - Backend client
packages/backend-client/src/index.cjs
Other components
- Phone user
- Vodafone AU
Connections 27
- Phone user → App screens: uses
README.md - App screens → Account state: drives
apps/android/app/src/main/java/au/com/vodalens/MainActivity.kt - Account state → Encrypted storage: reads and writes
apps/android/app/src/main/java/au/com/vodalens/LensViewModel.kt - Account state → Vodafone API: requests account data
apps/android/app/src/main/java/au/com/vodalens/LensViewModel.kt - Sign-in flow → Encrypted storage: saves credentials
apps/android/app/src/main/java/au/com/vodalens/VodafoneLogin.kt - Sign-in flow → Vodafone AU: authenticates
README.md - Vodafone API → Vodafone AU: fetches account data
README.md - Vodafone API → Encrypted storage: loads credentials
apps/android/app/src/main/java/au/com/vodalens/VodafoneApi.kt - Vodafone API → Session renewal: renews session
apps/android/app/src/main/java/au/com/vodalens/VodafoneApi.kt - App screens → Service accents: styles services
- Backend startup → Backend config: loads
services/api/src/server.cjs - Backend startup → Backend vault: creates
services/api/src/server.cjs - Backend startup → Auth selection: creates
services/api/src/server.cjs - Backend startup → HTTP API routes: creates
services/api/src/server.cjs - Backend startup → Renewal experiment: creates
services/api/src/server.cjs - Auth selection → Browser session auth: selects
services/api/src/auth.cjs - Auth selection → OAuth auth: selects
services/api/src/auth.cjs - HTTP API routes → Usage domain: uses
services/api/src/app.cjs - HTTP API routes → Provider adapter: requests provider data
services/api/src/app.cjs - HTTP API routes → OAuth auth: uses auth errors
services/api/src/app.cjs - Browser session auth → Provider adapter: verifies account access
services/api/src/session.cjs - Browser session auth → OAuth auth: uses auth errors
services/api/src/session.cjs - OAuth auth → Provider adapter: verifies API access
services/api/src/oauth.cjs - OAuth auth → Account checks: checks account data
services/api/src/oauth.cjs - Renewal experiment → Provider adapter: uses provider adapter
services/api/src/renewal-research.cjs - Renewal experiment → Account checks: checks account data
services/api/src/renewal-research.cjs - Renewal experiment → OAuth auth: uses auth errors
services/api/src/renewal-research.cjs