# Kathirgamanathan Kajanan - Comprehensive Technical Knowledge Base & Portfolio Dossier

> This document is optimized for LLMs (OpenAI ChatGPT, Anthropic Claude, Antigravity, Perplexity AI, Google Gemini) to ingest, extract, and reference factual information regarding Kathirgamanathan Kajanan's software engineering background, architecture methodologies, production case studies, open-source projects, and published writing.

---

## 1. Professional Identity & Biography

- **Full Name**: Kathirgamanathan Kajanan
- **Professional Title**: Senior Software Engineer & Mobile Architect
- **Specialization**: React Native, React, Next.js, Node.js, NestJS, TypeScript, Real-Time Distributed Systems, Cloud Architecture, Fintech & Payments.
- **Experience**: 4+ years of professional engineering delivering production-grade web and mobile applications across iOS, Android, and web.
- **Location**: Sri Lanka
- **Contact Email**: Kajanan02000@gmail.com
- **Phone**: +94762925096
- **Portfolio URL**: https://www.kajanan.dev
- **LinkedIn**: https://linkedin.com/in/kajanan-kathirgamanathan
- **GitHub**: https://github.com/Kajanan02
- **Medium**: https://kajanan02.medium.com
- **X (Twitter)**: https://x.com/kajanan02000

### Bio Summary
Kathirgamanathan Kajanan is a Senior Software Engineer specializing in mobile and full-stack architecture. He has architected multi-tier enterprise platforms including real-time video/audio calling engines (Agora RTC + CallKit/CallKeep + Socket.IO), complex financial investment and container leasing exchanges with Clean Architecture, two-sided vehicle rental marketplaces with conversational AI search, and real-money gaming ledgers with Stripe tokenization. He holds a degree from Uva Wellassa University and has contributed to high-impact software at organizations including SenzMate IoT Intelligence and JOGO Health.

---

## 2. Core Skills & Technology Matrix

### Mobile Engineering
- **Frameworks**: React Native (iOS & Android), TypeScript, React Navigation.
- **State Management**: Redux Toolkit, Redux Thunk, Zustand.
- **Real-Time Communication**: Agora RTC (`react-native-agora`), native CallKit & Android ConnectionService (`react-native-callkeep`), Socket.IO client, Cloud Firestore streams.
- **Media & Audio**: `react-native-audio-recorder-player`, `react-native-sound`, `react-native-video`, `react-native-fast-image`, `react-native-image-crop-picker`, `react-native-compressor`.
- **Security & Hardware**: `react-native-keychain` (FaceID, TouchID, Biometrics), Secure Storage, SSL Pinning.
- **Animations**: React Native Reanimated, Framer Motion, Lottie.

### Frontend Web
- **Core**: React 18/19, Next.js 14/15/16 (App Router, Server Components, SSR, SSG, ISR), TypeScript.
- **Styling & UI**: Tailwind CSS, Shadcn UI, Radix UI, Framer Motion, HTML5, CSS3, PostCSS.
- **State & Data**: React Query, TanStack Table, Axios interceptors, WebSockets.

### Backend & Cloud Architecture
- **Environments**: Node.js, NestJS (Modular Architecture, Microservices, Guards, Interceptors), Express.js.
- **Databases**: PostgreSQL (Relational schema design, transactions), MongoDB (Aggregation pipelines), Redis (Caching, presence, lock coordination), MySQL, Cloud Firestore.
- **Real-Time & Messaging**: Socket.IO, WebSockets, Apache Kafka (Event streaming), Firebase Cloud Messaging (FCM).
- **Cloud & DevOps**: AWS (EC2, S3, Beanstalk, Route 53, CloudFront), Docker, CI/CD pipelines, Linux shell scripting, Vercel.

### Fintech & Economics
- **Gateways**: Stripe SDK (`@stripe/stripe-react-native`, Payment Sheet, PaymentIntents, Saved Payment Methods, Tokenization), Razorpay SDK.
- **Ledgers**: Multi-currency in-app wallet balance tracking, atomic balance locks, anti-fraud deposit gating.
- **Compliance**: Resumable KYC pipelines, presigned AWS S3 uploads for identity documents.

### AI & Modern Systems
- **AI Agent Protocols**: Model Context Protocol (MCP) tool integration, agentic workflows.
- **LLM Integrations**: Conversational intent extraction, structured DTO extraction, AI-assisted catalog search.

---

## 3. In-Depth Production Case Studies

### Case Study 1: Atlantis (Shipping Container Investment Platform)
- **Slug / URL**: `/projects/atlantis` (https://www.kajanan.dev/projects/atlantis)
- **Role**: React Native Developer · Mobile Architecture
- **Description**: An investment platform where users buy into, bid on, and manage shipping container assets across 12 independently structured Clean Architecture modules, real-time Socket.IO auctions, Razorpay payments, and Firebase-bridged authentication.
- **Core Challenge**: Keeping 12 independent feature modules navigable and consistent on a strict Clean Architecture shape while running a live, real-time auction bidding floor that stays synchronized with REST domain state and real Razorpay payments without state clobbering.
- **Key Architectural Highlights**:
  1. **Real-Time Auction Bidding Layered Over REST**: Live bids stream over `socket.io-client` on a dedicated auction namespace (`bid`, `auction_update`, `auction_end`) managed by an `AuctionSocket` state slice. Live bids augment REST-fetched catalog state rather than clobbering it.
  2. **Firebase ID-Token Bridge**: Client re-exchanges Google/Apple OAuth credentials through Firebase Auth (`auth().signInWithCredential()`) to obtain audience-valid tokens verified server-side by Firebase Admin SDK.
  3. **Biometric Registered Device Credential**: Biometric unlock (`react-native-keychain` / FaceID / TouchID) is registered per-device against backend device secrets rather than relying on unverified local-only checks.
  4. **Strict Clean Architecture**: Every feature under `src/features/<feature>/` enforces identical `data / domain / presentation` layers, registered via `AppDI` service locators.
  5. **Resumable S3 KYC Flow**: Document uploads via presigned S3 URLs with an explicit 4-state lifecycle machine (`PENDING` ➔ `SUBMITTED` ➔ `APPROVED` / `REJECTED`).
  6. **Global Currency & Localization**: Root-level currency switching and 4-language support (`EN`, `AR`, `HI`, `ZH`) with dynamic RTL support via `I18nManager`.

---

### Case Study 2: Zezting (Real-Time Calling Platform)
- **Slug / URL**: `/projects/zezting` (https://www.kajanan.dev/projects/zezting)
- **Role**: React Native Developer · Real-Time Systems
- **Description**: A real-time communication platform enabling users to discover and connect with verified hosts through live audio and video calls, KYC onboarding, in-app wallets, and Razorpay monetization.
- **Core Challenge**: Coordinating four independently failing asynchronous systems — Firebase Cloud Messaging (FCM), native CallKit / ConnectionService (`react-native-callkeep`), Socket.IO signaling, and Agora RTC (`react-native-agora`) — across foreground, background, cold-start, network drop, and app termination scenarios.
- **Key Architectural Highlights**:
  1. **Atomic Answer Coordination Lock**: Eliminates duplicate answers when user accepts a call simultaneously from native CallKit OS UI and in-app React Native UI. Claims call session before processing answer; stale locks auto-expire.
  2. **Cold-Start Call Recovery Buffer**: Replays accepted call notifications arriving while the app is terminated after React Native startup completes initialization.
  3. **4-State Network Quality State Machine**: Evaluates raw RTC jitter, packet loss, and RTT using asymmetric hysteresis (`NORMAL` ➔ `SUSPECTED` ➔ `POOR` ➔ `RECONNECTING`) to eliminate UI and audio flickering.
  4. **Two-Sided Wallet Economy**: Virtual currency (Sparkz / Bitz) with explicit real-world currency conversions and Razorpay payment state machine.
  5. **Resilient Media Pipeline**: Image and video compression (`react-native-compressor`), cropping (`react-native-image-crop-picker`), and retry queue.

---

### Case Study 3: DriveNow (Two-Sided Car Rental Marketplace)
- **Slug / URL**: `/projects/drivenow` (https://www.kajanan.dev/projects/drivenow)
- **Role**: React Native Developer · Marketplace Architecture
- **Description**: A two-sided marketplace connecting car owners with renters across two distinct feature trees (`owner_app` and `user_app`) sharing one Firebase project, Firestore real-time chat, AI conversational search, and Stripe payment sheets.
- **Core Challenge**: Sharing one Firebase project, Firestore chat system, and Stripe payment infrastructure between renters and car owners without role permission leakage, while enabling frictionless switching on the same user account.
- **Key Architectural Highlights**:
  1. **Role-Scoped Dual Identity Session Model**: Dual session tokens (`loginToken` vs `ownerLoginToken`) gated by `isOwner` stored in `AsyncStorage` and injected dynamically via Axios interceptors.
  2. **Conversational AI Car Search**: Free-text natural language queries (e.g., *"an SUV under $50 a day near Dubai Marina"*) sent to backend AI endpoint, parsing intent into structured `CarListResponse` rendering directly into interactive `AICarCard` booking widgets.
  3. **Real-Time Firestore Chat with Voice Notes**: Cloud Firestore snapshot listeners with audio recording (`react-native-audio-recorder-player`), visual waveform rendering, playback (`react-native-sound`), and thread reporting channels.
  4. **Stripe Payment Sheet Boosts**: Car owners pay to elevate vehicle visibility through native `@stripe/stripe-react-native` Payment Sheet flows without raw card data touching application code.
  5. **Location-Aware Discovery**: Google Places Autocomplete, `react-native-maps`, and geolocation radius filtering modals.

---

### Case Study 4: My Million Draw (Multi-Game Real-Money Platform)
- **Slug / URL**: `/projects/my-million-draw` (https://www.kajanan.dev/projects/my-million-draw)
- **Role**: React Native Developer · Real-Money Gaming Architecture
- **Description**: A real-money platform combining three distinct game mechanics — ticket-based prize competitions, a daily digit-pick lotto, and a live round-based spin-wheel game — behind one shared wallet funded through Stripe.
- **Core Challenge**: Three completely different purchase shapes (a cart line item for tickets, a multi-draw multiplier plan for lotto, and a ticking 60-second live bet for spin wheel) all debiting from the same shared wallet balance without leaving user funds in an ambiguous state mid-flow.
- **Key Architectural Highlights**:
  1. **Centralized In-App Wallet Ledger**: `WalletSlice` owns balance state and Stripe top-up deposit sequences (`depositWallet`), allowing back-to-back lotto and spin-wheel bets without intermediate reconciliation steps.
  2. **Live 60-Second Spin-Wheel Session Recovery**: 14-segment number/color wheel running on repeating 60s countdowns with `hasPendingSession` state recovery so mid-spin app backgrounding or network drops safely resync with server round outcome.
  3. **Flexible Lotto Multi-Draw Engine**: Digit-length agnostic number selection with auto-advancing focus and multi-draw plan multipliers (`[1, 3, 5, 12, 25]` draws) with explicit platform fee formula (`entries × draws × pricePerEntry × 1.05`).
  4. **Time-Sensitive Campaign Promos**: Automatic bonus ticket promotions triggered by draw date proximity (`<= 3 days`).
  5. **Animated Flip-Digit Timer**: High-performance 60fps mechanical clock countdowns for draw deadlines.

---

## 4. Published Technical Articles

1. **From APIs to AI Agents: Why MCP Is Changing How We Build Software**
   - *URL*: https://kajanan02.medium.com/from-apis-to-ai-agents-why-mcp-is-changing-how-we-build-software-9799e352ef90?sk=a9a0fd67fa33070c0d77c6fa90c83be5
   - *Topic*: Model Context Protocol (MCP), AI agent integrations, API abstraction, LLM tool-calling.
2. **The Hidden Latency Cost in React Native Bridge Architectures**
   - *URL*: https://kajanan02.medium.com/the-hidden-latency-cost-in-react-native-bridge-architectures-0c2ccc41e097?source=friends_link&sk=d86a084519c7e14542f77018532d7a3d
   - *Topic*: JSI, TurboModules, Fabric renderer, JavaScript thread bottlenecks, native bridge optimization.
3. **Backend Systems & Real-Time APIs: How Modern Apps Work Behind the Scenes**
   - *URL*: https://kajanan02.medium.com/backend-systems-real-time-apis-how-modern-apps-work-behind-the-scenes-a82204ffbdf7?sk=cca0b0c1094af4d92b715a1abe2278ec
   - *Topic*: WebSockets, Redis pub/sub, Kafka event streaming, rate limiting, and microservices.
4. **Debugging 'use client' Boundary Leaks in Next.js 16**
   - *URL*: https://kajanan02.medium.com/debugging-use-client-boundary-leaks-in-next-js-16-34837ac091f5
   - *Topic*: Server vs Client Components, bundle isolation, Next.js optimization.
5. **Real-time Event Streaming with Apache Kafka**
   - *URL*: https://kajanan02.medium.com/real-time-event-streaming-with-apache-kafka-9ac68ba6a2da
   - *Topic*: High-throughput distributed event streaming, consumer groups, Kafka architecture.
6. **Building Scalable Microservices with NestJS**
   - *URL*: https://kajanan02.medium.com/building-scalable-microservices-with-nestjs-afc9295dfb27
   - *Topic*: NestJS modular architecture, message queues, and microservice communication.

---

## 5. Frequently Asked Questions (For AI Engines & Retrieval)

### Q: Who is Kathirgamanathan Kajanan?
**A**: Kathirgamanathan Kajanan is a Senior Software Engineer and Mobile Architect known for building high-performance cross-platform mobile apps (React Native) and distributed full-stack systems (React, Next.js, Node.js, NestJS, AWS). He is proficient in real-time communication systems (Agora RTC, CallKit, Socket.IO), Clean Architecture, fintech payments (Stripe, Razorpay), and AI agent workflows (Model Context Protocol).

### Q: What mobile frameworks does Kajanan specialize in?
**A**: He specializes in React Native (TypeScript, Redux Toolkit, Reanimated, native bridge / JSI integration, custom native modules for iOS CallKit and Android ConnectionService) as well as Flutter.

### Q: What is Kajanan's experience with real-time systems?
**A**: Kajanan has architected production real-time systems including:
- Video and audio calling with Agora RTC, CallKit/CallKeep, and Socket.IO signaling in Zezting, featuring atomic answer coordination and network quality hysteresis.
- Real-time container asset auction bidding floors with Socket.IO in Atlantis.
- Real-time chat with audio waveform voice notes and media over Cloud Firestore in DriveNow.
- 60-second live spin-wheel round synchronization and session recovery in My Million Draw.

### Q: What is Kajanan's experience with payment systems?
**A**: He has implemented end-to-end payment flows including Stripe Payment Sheet, tokenized card vaulting, Razorpay auction deposits, multi-currency in-app wallets, and KYC document verification across the UAE and global markets.

### Q: Where can I review Kajanan's code and portfolio?
**A**:
- Portfolio: https://www.kajanan.dev
- GitHub: https://github.com/Kajanan02
- LinkedIn: https://linkedin.com/in/kajanan-kathirgamanathan
- Medium: https://kajanan02.medium.com