Skip to content
@aegisx-platform

Aegisx Platform

AegisX Platform

Enterprise Healthcare Information System Platform

Building modern, scalable HIS applications with AI-powered development tools


What is AegisX Platform?

AegisX Platform is a comprehensive enterprise platform designed specifically for Hospital Information Systems (HIS) and healthcare management applications. It provides the infrastructure, tools, and components needed to rapidly build and deploy production-ready healthcare solutions.

Vision

Transform healthcare IT development by providing:

  • Rapid Development: Build complete modules in 10-15 minutes instead of 4-6 hours
  • Consistent Quality: Automated validation, quality gates, and proven patterns
  • Solo-Friendly: Designed for solo developers with Claude AI as primary coding assistant
  • Enterprise-Grade: Multi-domain support, schema isolation, scalable architecture

Open Source Strategy

AegisX Platform embraces open source to empower the healthcare community while maintaining sustainability.

What's Open Source?

Component License Repository NPM Package
@aegisx/ui MIT aegisx-ui ✅ Public
@aegisx/crud-generator MIT crud-generator ✅ Public
@aegisx/mcp MIT aegisx-mcp ✅ Public
Platform Template MIT aegisx-starter-1 -
Documentation MIT Included in all repos -
Development Tools MIT Quality gates, validators -

What's Proprietary?

Domain-specific implementations can be kept proprietary based on your business needs:

  • Hospital-specific workflows and business logic
  • Custom integrations with legacy systems
  • Proprietary algorithms and calculations
  • Specialized reporting and analytics
  • Custom domain modules (optional)

Community vs Enterprise

Feature Community Edition Enterprise Edition
Core Libraries ✅ Free (MIT) ✅ Free (MIT)
Platform Template ✅ Free (MIT) ✅ Free (MIT)
Documentation ✅ Free ✅ Free + Training
Community Support ✅ GitHub/Discord ✅ GitHub/Discord
Updates ✅ Regular ✅ Priority
Professional Support ✅ SLA-backed
Custom Development ✅ Available
Training & Workshops ✅ Included
Enterprise Modules ✅ Exclusive

Why Open Source?

  1. Community-Driven Innovation: Healthcare IT benefits from shared knowledge
  2. Transparency: Open source builds trust in healthcare systems
  3. Quality: Community reviews improve code quality
  4. Sustainability: Open core model supports long-term development
  5. Ecosystem: Enable third-party integrations and extensions

How to Contribute

We welcome contributions to all open source components! See CONTRIBUTING.md for:

  • Code of Conduct
  • Development setup
  • Pull request process
  • Coding standards
  • Testing requirements

Core Libraries

AegisX Platform started with three foundational open source libraries:

Enterprise Angular UI Component Library

  • 40+ production-ready components (forms, data display, navigation, feedback)
  • Built on Angular 17+ with Signals and Material Design
  • Thai language support out-of-the-box
  • Fully typed with TypeScript
  • Accessible (WCAG 2.1 AA compliant)
npm install @aegisx/ui

AI-Powered CRUD Generation CLI

  • Generate full-stack CRUD modules in 10-15 minutes
  • Backend: Fastify routes, TypeBox schemas, repositories, services
  • Frontend: Angular components, services, types, forms
  • Advanced features: Excel import, WebSocket events, bulk operations
  • 3 package tiers: Standard, Enterprise, Full
npm install -g @aegisx/crud-generator
aegisx-cli generate patients --package enterprise --force

Model Context Protocol Server for AI Development

  • Component discovery and documentation lookup
  • Development pattern suggestions
  • API contract validation
  • Real-time code examples
  • Integrates with Claude Code and MCP-compatible AI tools
npm install @aegisx/mcp

Technology Stack

Backend

Component Technology Purpose
Runtime Node.js 22+ JavaScript runtime
Framework Fastify 5.x High-performance web framework
Database PostgreSQL 15+ Multi-schema relational DB
Query Builder Knex.js Migrations and queries
Validation TypeBox JSON Schema validation
Auth JWT + Better Auth Authentication & authorization
WebSockets Fastify WS Real-time features

Frontend

Component Technology Purpose
Framework Angular 20+ Enterprise frontend framework
State Angular Signals Reactive state management
UI Components @aegisx/ui + Material Component library
Styling TailwindCSS Utility-first CSS (layout)
Forms Reactive Forms Type-safe forms
HTTP HttpClient API communication

Development Tools

Tool Purpose Time Savings
@aegisx/crud-generator CRUD generation 4-6h → 10-15min
@aegisx/mcp AI development assistant 50% faster development
Spec Validator 95%+ compliance checking Automated QA
Quality Gates 10-point quality checklist Consistent quality

Architecture

Multi-Domain Strategy

AegisX Platform supports multiple healthcare domains in a single codebase:

Platform (Shared Infrastructure)
├── Authentication & Authorization
├── Database Management (Multi-Schema)
├── UI Component Library
├── API Framework
└── Development Tools

Healthcare Domains (Business Logic)
├── Inventory Management (Pharmacy, Warehouse)
├── Human Resources (Staff, Payroll, Scheduling)
├── Finance (Accounting, Billing, Budget)
├── Patient Management (Records, Appointments)
├── Laboratory (Results, Orders, Quality Control)
└── ... unlimited domains

Schema Isolation

Each domain has its own PostgreSQL schema for data isolation:

-- Platform (shared)
CREATE SCHEMA public;
  -- users, roles, permissions

-- Domain-specific
CREATE SCHEMA inventory;  -- drugs, stock, budgets
CREATE SCHEMA hr;         -- employees, payroll
CREATE SCHEMA finance;    -- accounts, transactions
CREATE SCHEMA patients;   -- records, appointments
CREATE SCHEMA lab;        -- results, orders

Benefits

  • Isolation: Domain data never cross-contaminates
  • Security: Schema-level permissions
  • Performance: Domain-specific indexes and optimization
  • Scalability: Easy to split into microservices later
  • Maintenance: Independent migrations per domain

Quick Start

Prerequisites

  • Node.js 22+
  • PostgreSQL 15+
  • pnpm 10+

Clone and Setup

# Clone the starter template
git clone https://github.com/aegisx-platform/aegisx-starter-1.git
cd aegisx-starter-1

# Install dependencies
pnpm install

# Setup environment
pnpm run setup:env

# Start database (Docker)
pnpm run docker:up

# Run migrations
pnpm run db:migrate
pnpm run db:seed

# Start development servers
pnpm run dev  # API + Web app

Generate Your First Module

# Create migration for new table
npx knex migrate:make create_patients

# Generate full CRUD module (backend + frontend)
./bin/cli.js generate patients --domain patients --schema patients --package enterprise --force

# Start testing
pnpm run dev:api  # http://localhost:3000
pnpm run dev:web  # http://localhost:4200

Project Structure

aegisx-starter-1/
├── apps/
│   ├── api/                    # Fastify backend
│   │   └── src/
│   │       ├── core/           # Platform: auth, database, errors
│   │       ├── layers/
│   │       │   ├── platform/   # Shared across domains
│   │       │   └── domains/    # Healthcare domains
│   │       │       ├── inventory/
│   │       │       ├── hr/
│   │       │       ├── finance/
│   │       │       └── patients/
│   │       └── services/       # Shared services (PDF, email, etc.)
│   │
│   └── web/                    # Angular frontend
│       └── src/app/
│           ├── core/           # Platform: auth, http, guards
│           ├── shared/         # Shared components & services
│           └── features/       # Domain-specific features
│               ├── inventory/
│               ├── hr/
│               ├── finance/
│               └── patients/
│
├── libs/
│   ├── aegisx-ui/              # UI component library
│   ├── aegisx-cli/             # CRUD generator
│   └── aegisx-mcp/             # MCP server
│
├── docs/                       # Complete documentation
│   ├── platform/               # Platform architecture
│   ├── guides/                 # How-to guides
│   ├── reference/              # API reference
│   └── architecture/           # System design
│
└── tools/                      # Development tools
    ├── database/               # Backup, visualization
    └── quality/                # Pre-flight checks

Key Features

1. Rapid CRUD Generation

Generate complete modules in 10-15 minutes:

  • Backend: Routes, schemas, repositories, services
  • Frontend: Components, forms, tables, dialogs
  • Advanced: Excel import, real-time updates, bulk operations

2. Multi-Domain Support

Build multiple healthcare applications in one platform:

  • Inventory management (pharmacy, warehouse)
  • Human resources (staff, payroll)
  • Finance (accounting, billing)
  • Patient management
  • Laboratory information system
  • ... and more

3. AI-Powered Development

Integrated AI tools for faster development:

  • Component discovery (MCP)
  • Pattern suggestions
  • API contract validation
  • Code generation
  • Quality assurance

4. Enterprise-Grade Quality

Automated quality assurance:

  • 95%+ spec compliance validation
  • 10-point quality gates
  • TypeScript strict mode
  • API contract validation
  • Automated testing

5. Thai Language Support

Built-in Thai language support:

  • UI components with Thai fonts (Sarabun)
  • PDF generation with Thai text
  • Thai date/time formatting
  • Bilingual documentation

Documentation

Quick Links

Documentation Site

# View documentation locally
pnpm run docs:dev
# Open http://localhost:5173

Repositories

Repository Description NPM Package
aegisx-starter-1 Main platform template -
aegisx-ui UI component library @aegisx/ui
crud-generator CRUD generation CLI @aegisx/crud-generator
aegisx-mcp MCP development server @aegisx/mcp

License

Open Source Components

All core components are licensed under MIT License:

  • ✅ Free for personal and commercial use
  • ✅ Modify and distribute
  • ✅ No warranty or liability
  • ✅ Attribution required

See LICENSE file for complete details.

Domain-Specific Code

Your custom domain implementations and business logic:

  • 🔒 You retain full ownership
  • 🔒 Choose your own licensing model
  • 🔒 Keep proprietary if needed
  • 🔒 Share with community if desired

Contributing

We welcome contributions to all open source components!

Quick Start

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/your-feature
  3. Make your changes with tests
  4. Run quality checks: pnpm run build && pnpm run test
  5. Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

Areas We Need Help

  • 🐛 Bug fixes and improvements
  • 📚 Documentation and examples
  • 🌐 Internationalization (more languages)
  • 🧪 Test coverage
  • 🎨 UI/UX improvements
  • 🔌 Integrations (HL7, FHIR, DICOM)
  • 📱 Mobile components

Support


Roadmap

Current (v1.x)

  • ✅ Core platform infrastructure
  • ✅ Multi-domain support (Inventory, HR, Finance)
  • ✅ CRUD generator (Standard, Enterprise, Full packages)
  • ✅ UI component library (40+ components)
  • ✅ MCP development tools
  • ✅ Quality automation (validators, gates)

Next (v2.x)

  • 🔲 Patient management domain
  • 🔲 Laboratory information system
  • 🔲 Radiology integration (DICOM)
  • 🔲 HL7/FHIR support
  • 🔲 Mobile applications (iOS/Android)
  • 🔲 Advanced analytics and reporting

Built with ❤️ for the Healthcare Community

AegisX Platform - One Platform, Unlimited Healthcare Apps

Pinned Loading

  1. aegisx-ui aegisx-ui Public

    A comprehensive Design System for Angular with Material Design 3, 120+ design tokens, and 50+ production-ready components. Built for enterprise applications.

    TypeScript

  2. aegisx-mcp aegisx-mcp Public

    MCP (Model Context Protocol) server for the AegisX platform. Provides AI assistants with access to AegisX UI components, CRUD generator commands, development patterns, and API contract discovery.

    TypeScript 1

  3. aegisx-cli aegisx-cli Public

    Handlebars

Repositories

Showing 10 of 11 repositories

Top languages

Loading…

Most used topics

Loading…