Skip to main content

Overview

What is Chilarai?​

Chilarai is the internal codename for CampusHub, a modern school management platform being developed by Ujan Labs.

The goal of Chilarai is to provide a unified operating system for educational institutions, enabling schools to manage their academic, administrative, financial, and communication processes through a single platform.

The platform is designed to support institutions of varying sizes while maintaining simplicity, scalability, and affordability.


Vision​

To build a modern, extensible, and AI-enabled school operating system that reduces administrative effort and improves operational efficiency for educational institutions.


Problem Statement​

Many schools continue to rely on a mix of spreadsheets, disconnected software products, paper-based workflows, and manual processes.

This creates several challenges:

  • Duplicate data entry
  • Inconsistent records
  • Limited reporting capabilities
  • Difficult communication between stakeholders
  • High administrative effort
  • Poor user experience

Chilarai aims to address these problems through a unified platform.


Core Principles​

Simplicity​

The platform should remain easy to use for administrators, teachers, parents, and students.

Open and Extensible​

The architecture should support future integrations, extensions, and custom workflows without requiring major redesign.

API First​

Business capabilities should be exposed through well-defined APIs to support multiple user experiences and future integrations.

Cloud Native​

The platform should support modern deployment, monitoring, and operational practices.

Security by Design​

Authentication, authorization, auditing, and data protection should be foundational concerns rather than afterthoughts.

AI Ready​

The platform should be designed to accommodate future AI-assisted experiences, automation, reporting, and insight generation.


Initial Functional Areas​

The initial scope includes:

  • User Management
  • School Management
  • Academic Year Management
  • Student Management
  • Admission Management
  • Attendance Management
  • Fee Management
  • Reporting

Additional capabilities will be introduced incrementally as the product matures.


Technology Stack​

Current technology decisions include:

  • Nx Monorepo
  • Next.js
  • NestJS
  • PostgreSQL
  • Drizzle ORM
  • pg PostgreSQL driver
  • Drizzle Kit migrations
  • Zod
  • Keycloak

These decisions are captured in the Architecture Decision Records (ADRs).


Repository Structure​

The Chilarai platform currently consists of:

  • web – Frontend application
  • api – Backend API
  • shared-types – Shared TypeScript contracts
  • shared-validation – Shared validation schemas

Current Status​

Chilarai is currently in the foundation-to-implementation transition.

The product direction, domain model, architecture, and technology choices are defined. The application repositories contain the initial frontend and backend scaffolds, but runtime platform capabilities and business modules are not yet implemented.

Completed:

  • Repository setup
  • Monorepo setup
  • Frontend foundation
  • Backend foundation
  • Shared contract library
  • Shared validation library
  • Documentation platform
  • Domain model
  • Overall system and application architecture
  • Architecture Decision Records and technology stack decisions

In Progress / Next:

  • Database layer and migrations
  • Authentication
  • Multi-tenant implementation and school context
  • School onboarding
  • Core business modules
  • Deployment architecture

Intended Audience​

This documentation is intended for:

  • Founders
  • Developers
  • Architects
  • Contributors
  • Future team members

It serves as the primary source of truth for architectural decisions, domain models, implementation guidance, and operational procedures.