TB Plus

A modern desktop application built with Tauri (Rust) and Vue (TypeScript) for managing tuberculosis (TB) clinic operations at Sabot Hospital. This system bridges HOSxP's MySQL database (read-only) with a local SQLite database for clinic-specific tracking data.

Features

• Drug Screening: Query HOSxP patients who have received TB drugs to identify new patients.
• Active Patients Dashboard: Overview of currently active TB patients with treatment progress and an alert engine tracking patient adherence.
• Patient Details: Full clinical timeline, drug dispensing history, monthly follow-up records, and side-effect tracking.
• Reports: Summary statistics and exportable CSV reports for TB clinic audits (HA Standard).
• Settings: Complete control to configure database connections, update TB drug codes, and export local SQLite backups.

Architecture

• Frontend: Vue 3.5 (Composition API, <script setup>), TypeScript 5, Pinia, Vue Router 4, and lucide-vue-next for iconography.
• Backend / Desktop: Tauri 2.5, Rust (stable), and sqlx driving database interactions.
• Databases:
  • MySQL (HOSxP): Read-only access to query patient demographics and their drug dispensing records.
  • SQLite: Local, read-write database holding clinic metrics, treatment plans, follow-ups, and statuses.

Getting Started

Prerequisites

• Node.js (Version 18+)
• Rust
• Platform Prerequisites for Tauri 2

Setup

1. Clone the repository (and switch into the project directory):

   git clone https://github.com/suradet-ps/tb-plus.git
   cd tb-plus

2. Install frontend dependencies:

   npm install

3. Run the development server:

   npm run tauri dev

4. Build for release (generates OS specific execution binary):

   npm run tauri build

License

This project is licensed under the MIT License.