[WIP] Tech Overview

[!note] Current Focus: Demo UI MVP Development (Frontend-only with mock data)

Backend Status: Paused - All backend implementation deferred Priority: UI-based demo to showcase product vision and user experience

This directory contains all technical documentation, architecture decisions, and development resources for AarogyaDost.

🚨 Current Status & Critical Issues

Production System Status

  • ✅ Web App: Live at https://m.arogyadost.in (React + TypeScript)

  • ✅ Backend API: Live at https://api.arogyadost.in (FastAPI + Python)

  • ✅ Mobile App: In development (React Native + Expo)

  • ✅ Infrastructure: AWS (Amplify + Elastic Beanstalk)

Critical Divergence Issues

  • 🔴 Platform Mismatch: Product requires desktop-first, tech built web-first

  • 🔴 Core Features Missing: OCR + biomarker tracking not implemented

  • 🔴 Data Storage: Product requires local-first, tech uses cloud APIs

  • 🔴 Target Users: Product targets longevity enthusiasts, tech built for general health

→ See [[PRODUCT_TECH_DIVERGENCE_ANALYSIS|Complete Divergence Analysis]]

📁 Directory Structure

/mvp/ - MVP Implementation

Current production system and technical documentation.

  • Status: 🟢 Production Ready (Web + API)

  • Gap: Missing core product requirements (OCR, biomarker tracking)

  • See: [[mvp/README|MVP Documentation]]

/research/ - Technical Research

Research on longevity science, biomarkers, and health technology.

  • Status: 🟢 Comprehensive research available

  • Alignment: ✅ Matches product vision

  • See: [[research/longevity-science-overview|Longevity Science]]

/architecture/ - System Architecture

High-level system design and architectural decisions.

  • Status: 🟡 Documented but misaligned with product

  • Gap: Web architecture vs desktop requirements

  • See: [[architecture/]]

/development/ - Development Resources

Development guides, setup instructions, and best practices.

  • Status: 🟢 Available for current tech stack

  • Gap: No desktop development guides

  • See: [[development/]]

/infrastructure/ - Infrastructure & DevOps

AWS infrastructure, deployment, and operational documentation.

  • Status: ✅ Complete and production ready

  • Documentation: AWS setup, deployment processes, cost tracking

  • See: [[infrastructure/README|Infrastructure Docs]] | [[infrastructure/aws-setup|AWS Setup]] | [[infrastructure/deployment-processes|Deployment]]

/architecture/ - System Architecture

High-level system architecture and design documentation.

  • Status: ✅ Complete

  • Documentation: System architecture, design principles, ADRs

  • See: [[architecture/README|Architecture Docs]] | [[architecture/system-architecture|System Architecture]]

/deployment/ - Deployment Documentation

Deployment status and configuration.

  • Status: ✅ Complete

  • See: [[deployment/deployment-status|Deployment Status]]

/docs/ - Additional Documentation

Supplementary technical documentation and references.

📋 Task Management

todo.md - Current Tasks

  • Status: 🟢 Recently updated (Dec 30, 2025)

  • Purpose: Centralized task tracking for tech team

  • Categories: Critical, High Priority, Backend, Frontend, Research, Infrastructure

  • Progress: 15+ documentation tasks completed

  • See: [[todo.md|Current Tasks]] | [[task-status-index.md|Task Status Index]]

📚 Development Resources

Setup & Configuration

  • [[DEVELOPMENT_SETUP.md|Development Setup]] - Complete environment setup guide

  • [[SUBMODULE_WORKFLOW.md|Submodule Workflow]] - Git submodule management

  • [[API_SPECIFICATION.md|API Specification]] - Complete API contracts and schemas

  • [[BIOMARKER_PATTERNS.md|Biomarker Patterns]] - OCR extraction patterns for Indian labs

Documentation Status

  • ✅ Development Environment: Complete setup guide available

  • ✅ API Documentation: Full specification with all endpoints

  • ✅ Biomarker Extraction: Regex patterns for Indian lab reports

  • ✅ Repository Management: Submodule workflow documented

  • 🔄 Implementation: Backend/frontend tasks in progress

🎯 What Was Built vs What Was Planned

Actually Built (Production Ready)

Originally Planned (Product Requirements)

🚀 Quick Start

For Current System (Production)

  1. Web App: Visit https://m.arogyadost.in

  2. API Docs: Check https://api.arogyadost.in/docs

  3. Development: See [[mvp/README|MVP Documentation]]

For Understanding Gaps

  1. Divergence Analysis: Read [[PRODUCT_TECH_DIVERGENCE_ANALYSIS|Critical Analysis]]

  2. Product Requirements: Review [[../product/mvp/mvp-prd|MVP PRD]]

  3. Technical Architecture: Compare [[mvp/ARCHITECTURE|Current]] vs [[../product/mvp/mvp-technical-requirements|Required]]

🔗 Key Documents

Current Implementation

  • [[mvp/README|MVP Technical Overview]] - Current production system

  • [[mvp/ARCHITECTURE|System Architecture]] - Technical architecture

  • [[deployment/deployment-status|Deployment Status]] - Current deployment status

  • [[mvp/aws-infrastructure-report|AWS Infrastructure]] - Infrastructure details

Development & Setup

  • [[DEVELOPMENT_SETUP.md|🚀 Development Setup]] - Complete environment setup guide

  • [[SUBMODULE_WORKFLOW.md|Git Submodule Workflow]] - Repository management

  • [[API_SPECIFICATION.md|📋 API Specification]] - Complete API contracts

  • [[BIOMARKER_PATTERNS.md|🔬 Biomarker Patterns]] - OCR extraction algorithms

Task Management

  • [[todo.md|📝 Current Tasks]] - Active development tasks

  • [[task-status-index.md|📊 Task Status Index]] - Progress tracking

  • [[MVP_UI_CHANGES_DEMO_REQUIREMENTS|🎯 UI Changes Required]] - Demo app requirements

  • [[MVP_IMPLEMENTATION_SPRINT_PLAN|Sprint Plan]] - Implementation roadmap

Gap Analysis

  • [[PRODUCT_TECH_DIVERGENCE_ANALYSIS|🚨 Divergence Analysis]] - Critical review required

  • [[../product/mvp/mvp-prd|MVP PRD]] - Original product requirements

  • [[../product/mvp/mvp-technical-requirements|Technical Requirements]] - What should be built

Research & Context

  • [[research/longevity-science-overview|Longevity Science]] - Domain research

  • [[../competitors/strategic-insights|Strategic Insights]] - Market positioning

  • [[../strategy/product-vision-memo|Product Vision]] - Strategic context

📊 Current Development Focus

Demo UI MVP (Current Priority) 🎯

Documentation Complete ✅

Backend Development (Paused) ⏸️

Note: Backend implementation is paused. Focus is on demo UI MVP with mock data.

  • ⏸️ OCR Service: AWS Textract integration (deferred)

  • ⏸️ Database Migration: PostgreSQL setup (deferred)

  • ⏸️ Authentication: JWT implementation (deferred)

  • ⏸️ File Upload: S3 integration (deferred)

Strategic Alignment (Ongoing)

🎯 Strategic Options

Option A: Align Tech to Product (Recommended)

  • Implement OCR + biomarker tracking

  • Build desktop version (Electron)

  • Add local storage + encryption

  • Target longevity market

Option B: Align Product to Tech

  • Update positioning to "AI health platform"

  • Target general health users

  • Emphasize AI chat + provider network

  • Web-first strategy

Option C: Hybrid Approach

  • Launch current web app as "Lite"

  • Build desktop app as "Pro"

  • Dual market positioning

→ Full analysis in [[PRODUCT_TECH_DIVERGENCE_ANALYSIS|Divergence Analysis]]

📞 Getting Help

  • Development Setup: See [[DEVELOPMENT_SETUP.md|Development Setup Guide]]

  • API Integration: Check [[API_SPECIFICATION.md|API Specification]]

  • Biomarker Extraction: Review [[BIOMARKER_PATTERNS.md|Biomarker Patterns]]

  • Repository Management: See [[SUBMODULE_WORKFLOW.md|Submodule Workflow]]

  • Task Status: Check [[task-status-index.md|Task Status Index]]

  • Current System Issues: See [[mvp/README|MVP Documentation]]

  • Product Alignment: Review [[PRODUCT_TECH_DIVERGENCE_ANALYSIS|Divergence Analysis]]

Last Updated: 2025-12-30 Status: 🎯 Demo UI MVP Development (Frontend Focus) Next Action: Build UI-based demo with mock data

[[../README|← Back to Main]] | [[DEVELOPMENT_SETUP.md|🚀 Setup Guide →]] | [[MVP_UI_CHANGES_DEMO_REQUIREMENTS|🎯 Demo UI Requirements →]]

Previous[WIP] MVP ArchitectureNext[WIP] Infrastructure

Last updated