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

  3. aegisx-cli aegisx-cli Public

    Handlebars

Repositories

Showing 9 of 9 repositories

Most used topics

Loading…