Skip to content

๐Ÿ› ๏ธ AOS GitHub Config Hub โ€” Centralized repo for contribution guidelines, issue templates, PR workflows, and organization-wide settings for all AOS projects. Streamlining collaboration, automation, and quality ๐Ÿš€

License

Notifications You must be signed in to change notification settings

ajay-o-s/.github

๐Ÿš€ AOS โ€” Ajay O S Platform

AOS Status Architecture Auth IoT License

AOS (Ajay O S) is a startup-driven technology platform built around a core-first architecture, combining centralized system logic with scalable microservices, automation engines, and IoT integrations.

AOS powers all applications and services under ajayos.in, with a strong focus on security, automation, and developer productivity.


๐Ÿงญ Vision

Build a unified system platform that enables secure applications, intelligent automation, and connected devices โ€” all driven by a single, trusted core.

AOS is designed as a long-term startup platform, not a collection of disconnected tools.


๐Ÿง  Architecture Philosophy

AOS follows a hybrid architecture model:

๐Ÿงฉ AOS Core (Central Authority)

The heart of the platform.
Defines rules, security, and consistency.

  • Identity & authentication
  • Authorization & permissions
  • API contracts & validation
  • Shared UI system & theming
  • Configuration & feature control

๐Ÿ”— Microservices for Automation & Scale

Traditional microservices are used where they make sense:

  • Automation engines
  • Bots & workers
  • Webhook processors
  • Integrations
  • Messaging services
  • IoT data handlers
  • Background processing
  • Event-driven workflows

This avoids unnecessary complexity while enabling scale and flexibility. This approach balances consistency with scalability.

๐Ÿ—๏ธ High-Level Architecture


AOS Core (Single Source of Truth)
โ”œโ”€ Authentication & Identity
โ”œโ”€ Security & Permissions
โ”œโ”€ API Gateway & Contracts
โ”œโ”€ UI System & Theme Engine
โ””โ”€ Configuration Management

Microservices Layer
โ”œโ”€ Automation Workers
โ”œโ”€ Email & OTP Services
โ”œโ”€ Webhook Routers
โ”œโ”€ GitHub / Google Integrations
โ”œโ”€ Messaging & Bot Services
โ”œโ”€ Job Queues & Workers
โ””โ”€ IoT Processing Services

๐Ÿ” Authentication & Security

AOS implements a modern, extensible authentication system:

  • ๐Ÿ”‘ JWT (access & refresh tokens)
  • ๐Ÿ” OAuth 2.0 (Google, GitHub, more)
  • ๐Ÿงพ Token-based API access
  • ๐Ÿ”„ Device & session management
  • ๐Ÿ›ก๏ธ Centralized permission enforcement

All security decisions are enforced by AOS Core, ensuring consistent behavior across every application and service.


๐ŸŒ Backend Platform

api.ajayos.in is the central backend gateway.

Responsibilities:

  • Authentication & authorization
  • API routing & validation
  • Automation orchestration
  • Webhook handling
  • Service-to-service communication

Microservices integrate through this gateway using strict contracts.


๐ŸŽจ Unified UI System

All AOS products share a common UI foundation:

  • Reusable React component library
  • Centralized design language
  • Theme & branding consistency
  • Accessibility-first layouts

Apps are deployed independently but feel unified.


๐Ÿค– Automation Platform

Automation is a core pillar of AOS.

Includes services for:

  • GitHub workflow automation
  • Google account integrations
  • Webhook forwarding & transformation
  • Chatbots & messaging systems
  • Scheduled and event-driven jobs

Automation services run as independent microservices.


๐ŸŒ IoT & Edge Computing

AOS supports secure IoT and edge integrations, including:

  • Raspberry Pi
  • ESP32
  • NodeMCU
  • Arduino-based controllers
  • Linux edge devices

Use cases:

  • Device provisioning
  • Secure API communication
  • Automation triggers
  • Data collection & processing

๐Ÿ—บ๏ธ Roadmap & Milestones

โœ… Phase 1 โ€” Foundation

  • AOS Core architecture
  • Central authentication system
  • Shared UI foundation
  • API gateway setup

๐Ÿšง Phase 2 โ€” Automation Expansion

  • Advanced webhook routing
  • GitHub & Google automation services
  • Background workers & schedulers
  • Improved monitoring & logging

๐Ÿ”œ Phase 3 โ€” IoT & Edge Growth

  • Secure device onboarding
  • ESP32 / Pi automation flows
  • Edge-triggered workflows
  • IoT dashboard integration

๐Ÿ”ฎ Phase 4 โ€” Platform Maturity

  • Public SDKs & APIs
  • Plugin system for automations
  • Advanced analytics & observability
  • Selective open-source releases

๐Ÿ” Security & Responsible Disclosure

Security is taken seriously at AOS.

If you discover a vulnerability:

  • โŒ Do not open a public issue
  • โœ… Report responsibly via email

๐Ÿ“ง [email protected]
(or) [email protected]

We commit to:

  • Timely acknowledgment
  • Responsible fixes
  • Coordinated disclosure where applicable

๐Ÿ“ฆ Repository Scope

Public

  • Documentation
  • Developer tools & utilities
  • Templates & starter projects
  • Selected automation tools
  • Open-source components

Private

  • AOS Core implementation
  • Authentication & security logic
  • Production automation services
  • IoT provisioning systems
  • Internal CI/CD & infrastructure

Internal implementation details are intentionally not exposed.


๐Ÿงฐ Technology Stack (Overview)

Layer Technologies
Backend Node.js, Express
Frontend React, Vite, Tailwind CSS, MUI
Auth & Security JWT, OAuth 2.0
Automation Workers, Webhooks, Job Queues
Databases MongoDB, MySQL, Redis
IoT & Edge Raspberry Pi, ESP32, NodeMCU, Arduino
DevOps Docker, NGINX, GitHub Actions

๐Ÿ“š Documentation & Policies


๐Ÿ‘ค Founder & Maintainer

Ajay O S
Founder โ€” AOS Platform

AOS is built as a long-term platform, focused on stability, security, and automation-first development.


๐Ÿ“„ License

Public repositories under AOS are released under the MIT License, unless stated otherwise.
Private repositories remain proprietary.


๐Ÿš€ AOS โ€” Core-First. Automation-Driven. Built to Scale.
๐Ÿ› ๏ธ Designed as a platform, not just a product.

About

๐Ÿ› ๏ธ AOS GitHub Config Hub โ€” Centralized repo for contribution guidelines, issue templates, PR workflows, and organization-wide settings for all AOS projects. Streamlining collaboration, automation, and quality ๐Ÿš€

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks