Bahmni AI Migration Reference

A public reference project that demonstrates how AI-assisted development techniques were used to accelerate the migration and enhancement of Bahmni, an open-source hospital management system. This project includes AI-generated code, manual extensions, and associated artifacts of the frontend migration experiment.

Features

• TypeScript - Type-safe JavaScript
• React - UI library for building user interfaces
• Carbon Design System - IBM's open-source design system
• Webpack - Module bundler for modern JavaScript applications
• PWA Support - Progressive Web App capabilities for offline use
• React Router - Declarative routing for React applications

Prerequisites

• Node.js (v18.x or later recommended)
• Yarn (v1.22.x or later recommended)

Getting Started

Installation

# Install dependencies
yarn

Detailed Setup Guide

For a comprehensive setup guide including development environments, Docker configuration, authentication setup, and troubleshooting, please refer to our Setup Guide. Certainly. Here's a more formal and grammatically correct version of the provided project README section:

Development Instructions

To begin local development, follow the steps below:

1. Start the Development Server

   yarn start

   This will launch the development server at http://localhost:3000.

2. Start Bahmni Standard Locally

   In a separate terminal, start the Bahmni standard environment using Docker:

   docker compose up -d

3. Access the New Clinical Dashboard

   Once Bahmni is running:

   • Register a new patient through the Bahmni interface.

   • Copy the patient's UUID from the URL.

   • Navigate to the following URL in your browser, replacing {uuid} with the actual patient UUID:

     http://localhost:3000/clinical/{uuid}
     

   This will load the new clinical dashboard for the selected patient.

Project Structure

bahmni-clinical-frontend/
├── public/                  # Static assets
│   ├── favicon.ico          # Favicon
│   ├── logo192.png          # Logo for PWA (192x192)
│   ├── logo512.png          # Logo for PWA (512x512)
│   ├── manifest.json        # PWA manifest
│   ├── robots.txt           # Robots file
│   └── index.html           # HTML template
├── src/
│   ├── assets/              # Images, fonts, etc.
│   ├── components/          # Reusable UI components
│   │   ├── common/          # Shared components
│   │   └── layout/          # Layout components
│   ├── hooks/               # Custom React hooks
│   ├── pages/               # Page components
│   ├── routes/              # Routing configuration
│   ├── styles/              # Global styles
│   ├── types/               # TypeScript type definitions
│   ├── utils/               # Utility functions
│   ├── App.tsx              # Main App component
│   ├── index.tsx            # Application entry point
│   └── service-worker.ts    # PWA service worker
├── .babelrc                 # Babel configuration
├── .eslintrc.js             # ESLint configuration
├── .gitignore               # Git ignore file
├── package.json             # Project dependencies and scripts
├── README.md                # Project documentation
├── tsconfig.json            # TypeScript configuration
└── webpack.config.js        # Webpack configuration

Scripts

• yarn start - Start the development server
• yarn build - Build the application for production
• yarn lint - Run ESLint to check for code quality issues
• yarn lint:fix - Fix ESLint issues automatically

Technologies

• React - UI library
• TypeScript - Type-safe JavaScript
• Carbon Design System - IBM's design system
• Webpack - Module bundler
• React Router - Routing library
• ESLint - Code quality tool
• Workbox - PWA tooling

License

[Add license information here]