Oter — Internal docs

Internal documentation for the Oter platform — architecture, feature guides, ops runbooks, and domain references. Rendered by docs-site/ at the internal docs URL (IAP-protected).

Oter is a comprehensive life-management platform built with Kotlin Multiplatform. It runs on Android, iOS, Desktop, Web, and a Ktor server, and features a sophisticated balance-prediction engine for finance forecasting.

How this folder is organized

• overview/ — Product, architecture, domain models, prediction, UI/UX, integrations, testing, roadmap. Start here.
• features/ — Per-feature deep dives (finance, tasks, habits, journal, calendar, study, nutrition, timers, workout, work, books, notifications, dashboard, onboarding).
• architecture/ — Cross-cutting decisions: navigation, design-system conventions, offline/sync, plan patterns.
• design-system/ — Token reconciliation and prototype implementation status.
• integrations/ — External-service wiring (auth refresh tokens, FCM, WebSocket).
• infra/ — GCP / Cloud Run / Cloud SQL / CI runbooks.
• tech-debt/ — Live technical-debt and improvements register.
• agents/ — AI / dashboard agent prompts and reference.
• public/ — Source for the public-facing docs site (oterapp.com/docs/). Internal readers don’t need this; it’s served by the same docs-site/ app via DOCS_VARIANT=public.

Build modules

Note (2026-06): the app was consolidated onto a single shared UI. The old per-feature Android modules (*_domain/*_data/*_presentation) and the core-data / core-ui / navigation / test-core libraries were removed — that feature code now lives in shared/.

• shared — Shared code (UI, view models, services) across all platforms
• composeApp — Compose Multiplatform application (Desktop, iOS, Android)
• androidApp — Android entry point (hosts the shared UI)
• server — Backend server implementation (Ktor)
• core — Core Android functionality

Quick links

• Architecture overview
• Domain models
• Prediction engine — and the finance prediction deep-dives
• Testing & QA
• Roadmap

All pages

Overview

• Global Architecture
• Domain & Models
• Prediction Engine
• UI & UX
• Integrations
• Testing & QA
• Roadmap

Features

• Finance Feature Guide
  • Finance Accounts
  • Bills reader (receipt scan)
  • Finance Debts
  • Bank statement reconciliation and follow-up
  • Balance prediction
    • Balance Prediction Algorithm Analysis
    • Balance Prediction Scenario Lab
• Products & price tracking
• Tasks Feature Guide
  • Task Filtering and Date Logic
• Projects Feature Guide
• Habits Feature Guide
• Journal Feature Guide
• Calendar Feature Guide
• Study
  • Study Feature Guide
  • Study System Documentation
  • Plan: Scheduled (recurring) Study Sessions on the Calendar
• Nutrition Feature Guide
• Timers
  • Timer System Documentation
  • Timers Feature Guide
• Workout Feature Guide
• Work tracking
  • Work Feature Guide
• Books
  • Books Feature Guide
  • Books Module - Desktop Implementation
  • Books Module Integration Guide
• Notifications Feature Guide
• Dashboard Feature Guide
  • Mobile Dashboard Integration
  • Oter Today Widget Implementation
• Onboarding journey
• In-App Guidance (Tours + Info Popovers)

Architecture

• Auth subsystem
  • Auth: refresh tokens & key rotation
• App navigation structure
• Build flavors
• Design System Conventions
• Offline data loading and sync
• Shared Sync Algorithm Design
• Plan — Architecture patterns and tradeoffs documentation
• Web search provider — cost analysis & recommendation

Design system

• Oter — Design System Tokens
• Prototype Implementation Status

Integrations docs

• FCM Token Retrieval Troubleshooting Guide
• WebSocket 400 Error Debugging Guide

Infrastructure docs

• Local database (Cloud SQL proxy + migrations)
• GCP server deploy (Artifact Registry and Cloud Run)
• GCP web deploy (Artifact Registry and Cloud Run)
• GCP docs sites (public bucket + internal Cloud Run + IAP)
• GCP billing — baseline, improvements, forecast
• GCP cost cuts (Oter + Negodex)
• Automation tooling options for Oter
• Release Checklist
• Git Strategy
• CI Gradle tuning
• WASM Web Client
• Web Frontend: Compose Multiplatform WASM
• DigitalOcean Container Registry (DOCR) Setup Guide
• DigitalOcean Container Registry Quota Fix Guide

Technical Debt & Improvements Register

• Tech Debt — In-flight Migrations
• Tech Debt — Architecture & Code
• Tech Debt — Testing & QA
• Tech Debt — Design System
• Tech Debt — Dependencies, Build & Infra

Dashboard Expert AI Agent Documentation

• Dashboard Expert AI Agent - System Prompt
• Dashboard Architecture Deep-Dive
• Dashboard API Reference
• Dashboard Common Tasks Guide
• Dashboard Troubleshooting Guide