KOI Platform Technical Reference

1. Executive Summary

KOI is a collaborative community coordination platform designed to manage group activities, location voting, event scheduling, communication, financial contributions, lending records, and notifications through a centralized web application. The platform provides secure authentication, real-time collaboration, democratic location voting, and financial transparency.

The application is built using a modern full-stack architecture leveraging React, Node.js, Supabase, and PostgreSQL.

2. System Architecture

The high-level architecture utilizes a separation of concerns between the client and backend, supported by managed authentication and real-time infrastructure.

Request Flow

Frontend (React): Handles the user interface, state management, and animations.
REST API (Express): Manages business logic and processes client requests.
Authentication Layer (Supabase Auth): Secures routes and validates sessions via middleware.
Database Layer (Supabase PostgreSQL): Provides robust, relational data storage queried via Drizzle ORM.
Realtime Layer (WebSocket Server): Broadcasts live updates for chat and dynamic voting.

3. Technology Stack

Frontend

Framework & Build: React + Vite
Styling: Tailwind CSS
Data Fetching: React Query
Animations: Framer Motion
Routing: Wouter
Auth Client: Supabase JS

Backend & Infrastructure

Runtime: Node.js
API Framework: Express
Database Access: Drizzle ORM
Database: PostgreSQL (Supabase)
Realtime Updates: WebSockets
Hosting: Render (API) + Supabase (Database/Auth)

4. Core Modules

Dashboard Module: High-level community activity overview.
Voting Module: Real-time democratic polling for location selection.
Schedule Module: Event and participation management for administrators and members.
Chat Module: WebSocket-driven real-time communication between members.
Contributions & Lending: Transparency tools for financial tracking and lending records.
Notifications: System-wide broadcast alerts.