ZarishSphere Platform¶

Welcome to ZarishSphere¶

A comprehensive ERP/EHR integrated platform combining enterprise resource planning with electronic health records, built on FHIR standards.

🎯 Overview¶

ZarishSphere Platform is a modern, microservices-based healthcare and business management system that seamlessly integrates:

ERP Capabilities: Financial management, HR, logistics
EHR Capabilities: Patient records, clinical data, FHIR compliance
Platform Services: Authentication, forms, analytics, knowledge base

🏗️ Architecture¶

graph TB subgraph "Frontend Layer" DP[Doctor Portal] PP[Patient Portal] LP[Lab Portal] PHP[Pharmacy Portal] AD[Admin Dashboard] end subgraph "API Gateway" GW[zarish-connect
Port 8080] end subgraph "ERP Services" FIN[zarish-fin
Financial
Port 8081] HRA[zarish-hra
HR
Port 8082] LOG[zarish-log
Logistics
Port 8093] end subgraph "EHR Services" HIS[zarish-his
Hospital
Port 8083] SPH[zarish-sphere
FHIR Core
Port 8084] end subgraph "Platform Services" ACC[zarish-access
Auth
Port 8085] TRM[zarish-terms
Terminology
Port 8086] FRM[zarish-forms
Forms
Port 8087] GEO[zarish-geo
Geography
Port 8088] SUP[zarish-support
Support
Port 8089] MGT[zarish-management
Projects
Port 8090] WKI[zarish-wiki
Knowledge
Port 8091] INS[zarish-insight
Analytics
Port 8092] end subgraph "Data Layer" DB[(PostgreSQL
Database)] end DP --> GW PP --> GW LP --> GW PHP --> GW AD --> GW GW --> FIN GW --> HRA GW --> HIS GW --> SPH GW --> ACC GW --> TRM GW --> FRM GW --> GEO GW --> SUP GW --> MGT GW --> WKI GW --> INS GW --> LOG FIN --> DB HRA --> DB HIS --> DB SPH --> DB ACC --> DB TRM --> DB FRM --> DB GEO --> DB SUP --> DB MGT --> DB WKI --> DB INS --> DB LOG --> DB style GW fill:#4F46E5,stroke:#312E81,stroke-width:3px,color:#fff style FIN fill:#10B981,stroke:#065F46,stroke-width:2px,color:#fff style HRA fill:#10B981,stroke:#065F46,stroke-width:2px,color:#fff style LOG fill:#10B981,stroke:#065F46,stroke-width:2px,color:#fff style HIS fill:#F59E0B,stroke:#92400E,stroke-width:2px,color:#fff style SPH fill:#F59E0B,stroke:#92400E,stroke-width:2px,color:#fff style DB fill:#EF4444,stroke:#991B1B,stroke-width:2px,color:#fff

✨ Key Features¶

ERP Modules¶

Financial Management (zarish-fin): Complete accounting, journal entries, chart of accounts
Human Resources (zarish-hra): Employee management, departments, payroll
Logistics (zarish-log): Inventory, shipment tracking, supply chain

EHR Modules¶

Hospital Information System (zarish-his): Patient records, encounters, FHIR-compliant
FHIR Core (zarish-sphere): Practitioners, organizations, locations

Platform Services¶

Authentication (zarish-access): User management, roles, permissions
Terminology (zarish-terms): SNOMED CT, ICD-11, LOINC
Forms (zarish-forms): Dynamic form builder with JSON schema
Geography (zarish-geo): Administrative divisions, districts
Support (zarish-support): Ticket management system
Project Management (zarish-management): Tasks, projects, collaboration
Knowledge Base (zarish-wiki): Documentation, articles
Analytics (zarish-insight): Dashboards, reports, metrics

🚀 Quick Start¶

Using Docker Compose¶

# Clone the repository
git clone https://github.com/ZarishSphere-Platform/zarish-sphere-frontend.git

# Start all services
docker-compose up -d

# Access the API Gateway
curl http://localhost:8080/health

Manual Setup¶

# Start individual services
cd zarish-fin && go run cmd/server/main.go  # Port 8081
cd zarish-hra && go run cmd/server/main.go  # Port 8082
cd zarish-his && go run cmd/server/main.go  # Port 8083
cd zarish-connect && go run cmd/server/main.go  # Port 8080

📊 Technology Stack¶

Layer	Technology
Backend	Go 1.21+, Gin, GORM
Database	PostgreSQL 15
Frontend	React, TypeScript, Vite
API	REST, FHIR R4
DevOps	Docker, Kubernetes, GitHub Actions