Sync release-3.8.0 with main (fast-forward, 263 commits)

CLAUDE.md

@@ -0,0 +1,92 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+AMRIT MMU (Mobile Medical Unit) UI — an Angular 16 healthcare application for the PSMRI AMRIT platform. Supports nurse, doctor, lab technician, pharmacist, radiologist, and oncologist workflows including patient registration, vitals capture, clinical examination, diagnosis, prescriptions, lab tests, drug dispensing, and offline data sync for van operations.
+
+## Build & Development Commands
+
+| Command | Purpose |
+|---------|---------|
+| `npm start` | Dev server on **port 4202** (`ng serve`) |
+| `npm run build` | Production build |
+| `npm run build-dev` | AOT dev build (increased heap) |
+| `npm run build-prod` | AOT production build (increased heap) |
+| `npm run build-ci` | CI build (generates `environment.ci.ts` from template + env vars) |
+| `npm test` | Run tests (Karma + Jasmine) |
+| `npm run lint` | ESLint |
+| `npm run lint:fix` | ESLint with auto-fix |
+| `npm run commit` | Commitizen conventional commit prompt |
+
+## Git Submodule: Common-UI
+
+`Common-UI/` is a git submodule from `https://github.com/PSMRI/Common-UI`. It provides:
+- `registrar` module (patient registration + `SessionStorageService`)
+- `feedback` module
+- `tracking` module (Matomo analytics)
+
+Initialize with:
+```bash
+cd Common-UI && git submodule update --init --recursive && git checkout develop
+```
+
+Import paths use `Common-UI/src/...` (e.g., `Common-UI/src/registrar/registration.module`).
+
+## Architecture
+
+### Module Structure
+- **AppModule** — root module with hash-based routing (`useHash: true`)
+- **CoreModule** — singleton services, guards, shared components, directives. Uses `CoreModule.forRoot()` pattern
+- **Feature modules** (lazy-loaded): `nurse-doctor`, `lab`, `pharmacist`, `data-sync`, `registrar` (from Common-UI), `feedback` (from Common-UI)
+- **MaterialModule** — re-exports all Angular Material modules
+
+### State Management
+No NgRx — uses Angular services with `BehaviorSubject`/`Subject` for reactive state. Key examples:
+- `NurseService` — cross-component clinical state (RBS, NCD, IDRS, assessment)
+- `HttpServiceService` — language/i18n state via `currentLangugae$` BehaviorSubject
+- `SessionStorageService` (Common-UI) — encrypted sessionStorage via `ng-cryptostore`, key from `environment.encKey`
+
+### HTTP / Auth
+- `HttpInterceptorService` — attaches auth tokens (`Authorization`, `ServerAuthorization`), manages spinner, handles 27-minute session timeout with warning dialog, auto-logout on 401/5002
+- Auth tokens stored in sessionStorage as `authenticationToken` and `isAuthenticated`
+- `AuthGuard` protects clinical routes; `CanDeactivateGuardService` prevents navigation with unsaved changes
+
+### Key Services (core)
+- `ConfirmationService` — alert/confirm/remarks dialogs via `CommonDialogComponent` + `MatDialog`
+- `IotService` — Bluetooth device integration at `http://localhost:8085/ezdx-hub-connect-srv`
+- `SpinnerService` — global loading indicator
+
+### Routing
+Root routes: `login`, `service`, `servicePoint`, `registrar`, `nurse-doctor`, `lab`, `pharmacist`, `datasync`
+Nurse-doctor sub-routes: role-specific worklists, patient workarea (`attendant/:attendant/patient/:beneficiaryRegID`), case sheet print, reports
+
+## Code Conventions
+
+- **License header**: All source files begin with the AMRIT GPL-3.0 license block
+- **Component prefix**: `app` (kebab-case for components, camelCase for directives)
+- **Commit convention**: Conventional Commits enforced via commitlint. Types: `feat`, `fix`, `build`, `chore`, `ci`, `docs`, `perf`, `refactor`, `revert`, `style`, `test`
+- **Pre-commit hook**: `lint-staged` runs ESLint `--fix` on `src/**/*.ts`
+- **Formatting**: Prettier — 2-space tabs, single quotes, semicolons, 80 char width, ES5 trailing commas
+- **TypeScript**: strict mode, ES5 target, strict templates enabled
+
+## Environment Configuration
+
+Environment files in `src/environments/`. CI build uses EJS template (`environment.ci.ts.template`) with env vars for API endpoints, encryption keys, captcha config, and tracking config. Key environment properties:
+- API base URLs: `commonAPI`, `mmuAPI`, `tmAPI`, `schedulerAPI`, etc.
+- `encKey` — sessionStorage encryption key
+- `siteKey` / `captchaChallengeUrl` — captcha configuration
+- `tracking` — Matomo analytics config (siteId, trackerUrl, enabled)
+- `isMMUOfflineSync` — enables offline data sync feature
+
+## Key Dependencies
+
+- Angular 16.2 + Angular Material 16.2
+- Bootstrap 5.3 (layout) + Font Awesome 4.7 (icons)
+- RxJS 7.8, Moment.js 2.30
+- `ng-cryptostore` — encrypted sessionStorage
+- `exceljs` + `file-saver` — Excel report generation
+- `ngx-webcam` — webcam capture
+- `ng2-charts` / `chart.js` — charts
+- `recordrtc` — audio recording

CONTRIBUTING.md

@@ -0,0 +1,96 @@
+# Contributing to MMU-UI
+
+## Prerequisites
+
+- **Node.js**: v18.10.0 or higher
+- **Angular CLI**: v16.2.x (`npm install -g @angular/cli`)
+- **Git**: v2.x or higher
+
+## Local Setup
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/PSMRI/MMU-UI.git
+   cd MMU-UI
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Initialize Common-UI submodule:
+   ```bash
+   cd Common-UI && git submodule update --init --recursive && git checkout develop
+   ```
+
+4. Start the dev server:
+   ```bash
+   npm start
+   ```
+   Access at `http://localhost:4202/#/login`
+
+## Branch Naming
+
+Use prefixes for clarity:
+- `feat/` — New features
+- `fix/` — Bug fixes
+- `chore/` — Dependencies, build, tooling
+- `docs/` — Documentation updates
+- `refactor/` — Code improvements
+
+Example: `feat/patient-registration-flow`
+
+## Commits
+
+Conventional Commits are **enforced** by Husky + commitlint:
+
+```
+type(scope): description
+
+Valid types: feat, fix, build, chore, ci, docs, perf, refactor, revert, style, test
+Example: feat(vitals): add blood pressure validation
+```
+
+Use `npm run commit` for an interactive prompt.
+
+## PR Checklist
+
+Before submitting a PR:
+
+- [ ] `npm run lint:fix` — ESLint passes
+- [ ] No `console.log()` in production code (only `console.warn/error` allowed)
+- [ ] `npm test` — Tests pass
+- [ ] Branch follows naming convention
+- [ ] Commit messages follow Conventional Commits
+- [ ] Code uses Angular services for state (BehaviorSubject pattern)
+
+## Code Standards
+
+### State Management
+- Use `BehaviorSubject` in services for reactive state
+- No NgRx — services manage component communication
+- Example: `NurseService`, `HttpServiceService`
+
+### No Console Output
+- Remove all `console.log()` from production code
+- Only `console.warn()` and `console.error()` are allowed
+- ESLint enforces this via `no-console` rule
+
+### TypeScript & Templates
+- Strict mode enabled (`strict: true`)
+- Strict templates enabled (`strictTemplates: true`)
+- Use `any` only when unavoidable (rule disabled, but discouraged)
+
+## Running Tests
+
+```bash
+npm test
+```
+
+Tests run in watch mode. Files are re-tested on change.
+
+## Questions?
+
+See [CLAUDE.md](CLAUDE.md) for detailed architecture notes.
+File issues in the [main AMRIT repo](https://github.com/PSMRI/AMRIT/issues).

README.md

@@ -1,6 +1,7 @@
 # AMRIT - Mobile Medical Unit (MMU) Service
 
-[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) ![branch parameter](https://github.com/PSMRI/MMU-UI/actions/workflows/sast.yml/badge.svg)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![DeepWiki](https://img.shields.io/badge/DeepWiki-PSMRI%2FMMU--UI-blue)](https://deepwiki.com/PSMRI/MMU-UI)
+
 
 The AMRIT Mobile Medical Unit (MMU) service provides essential medical assistance to individuals without requiring them to be admitted to a hospital. This service operates through a mobile unit equipped with a laboratory for conducting medical tests and the capability to dispense medicines. The MMU employs an internet-connected device to collect and transmit medical data to the AMRIT application. It supports various medical standards and incorporates a feature that allows data capture and synchronization even when an internet connection is unavailable.
 
@@ -32,20 +33,37 @@ Ensure that the following prerequisites are met before building the MMU service:
 
 * JDK 17
 * Maven 
-* Nodejs v18.10.0
+* Node.js v18.10.0 (use `nvm` to manage versions: `nvm install` picks up the version from `.nvmrc`)
 * MySQL
 
 ### Installation
 
 To install the MMU module, please follow these steps:
 
-1. Clone the repository to your local machine.
-2. Install the dependencies and build the module:
-   - Run the command `npm install`.
-   - Run the command `npm run build`.
-   - Run the command `mvn clean install`.
-   - Run the command `npm start`.
-3. Open your browser and access `http://localhost:4200/#/login` to view the login page of module.
+1. Clone the repository with submodules:
+   ```bash
+   git clone --recurse-submodules https://github.com/PSMRI/MMU-UI.git
+   cd MMU-UI
+   ```
+   If you already cloned without `--recurse-submodules`, run:
+   ```bash
+   git submodule update --init --recursive
+   ```
+
+2. Use the correct Node.js version:
+   ```bash
+   nvm install
+   nvm use
+   ```
+
+3. Install dependencies and build the module:
+   ```bash
+   npm install
+   npm run build       # or npm run build-dev for an AOT dev build
+   npm start           # serves at http://localhost:4202
+   ```
+
+4. Open your browser and access `http://localhost:4202/#/login` to view the login page of the module.
 
 ### Building from source
 
@@ -55,7 +73,7 @@ mvn -B package --file pom.xml -P <profile_name>
 ```
 
 The available profiles include dev, local, test, and ci.
-Refer to `src/environments/environment.ci.template` file and ensure that the right environment variables are set for the build.
+Refer to `src/environments/environment.ci.ts.template` file and ensure that the right environment variables are set for the build.
 
 Packing with `ci` profile calls `build-ci` script in `package.json`.
 It creates a `environment.ci.ts` file with all environment variables used in the generated build.
@@ -68,29 +86,19 @@ The MMU module offers comprehensive management capabilities for your application
 
 ### Initializing Submodule `Common-UI`
 
-To initialize the `Common-UI` submodule, follow these steps:
+The `Common-UI` submodule provides shared UI modules (registrar, feedback, tracking).
 
-1. Clone the `mmu-ui` project:
-   ```bash
-   git clone https://github.com/PSMRI/MMU-UI
-
-2. Navigate to the project directory and pull the latest changes from the develop branch
-   cd mmu-ui
-   git checkout develop
-   git pull origin develop
-
-3. Open the integrated terminal for the common-ui submodule and initialize it
-
-   cd Common-UI
-   git init
-   git remote add origin https://github.com/PSMRI/Common-UI
-   git submodule update --init --recursive
+To initialize it:
 
-4. Check the available branches and switch to the develop branch
+```bash
+# From the repo root, run:
+git submodule update --init --recursive
+cd Common-UI
+git checkout develop
+git pull origin develop
+```
 
-   git branch
-   git checkout develop
-   git pull origin develop
+If you cloned with `--recurse-submodules`, the submodule is already initialized.
 
 ## Filing Issues
 
@@ -100,4 +108,3 @@ If you encounter any issues, bugs, or have feature requests, please file them in
 
 We’d love to have you join our community discussions and get real-time support!  
 Join our [Discord server](https://discord.gg/FVQWsf5ENS) to connect with contributors, ask questions, and stay updated.  
-

angular.json

@@ -35,7 +35,10 @@
               "node_modules/bootstrap/dist/css/bootstrap.min.css",
               "node_modules/font-awesome/css/font-awesome.min.css"
             ],
-            "scripts": []
+            "scripts": [],
+            "allowedCommonJsDependencies": [
+              "qrcode"
+            ]
           },
           "configurations": {
             "production": {
@@ -119,7 +122,8 @@
           },
           "defaultConfiguration": "development",
           "options": {
-            "port": 4202
+            "port": 4202,
+            "host": "0.0.0.0"
           }
         },
         "extract-i18n": {