यह पृष्ठ AI द्वारा लिखा गया अनुवाद का पहला मसौदा है। धाराप्रवाह हिन्दी बोलने वाले किसी व्यक्ति ने अभी इसकी समीक्षा नहीं की है।

ट्यूटोरियल

यह ट्यूटोरियल बताता है कि प्रणाली को स्थानीय कंप्यूटर पर कैसे चलाएँ। इसके लिए टर्मिनल चाहिए, लेकिन Rust या Svelte का ज्ञान ज़रूरी नहीं है।

यह सेटअप केवल मूल्यांकन के लिए है। वास्तविक रोगी डेटा का उपयोग न करें। इसमें सार्वजनिक रूप से ज्ञात परीक्षण पासवर्ड इस्तेमाल होते हैं।

चरण 1: उपकरण इंस्टॉल करें

ये उपकरण आवश्यक हैं:

चरण 2: कोड प्राप्त करें

टर्मिनल खोलें, परियोजना डाउनलोड करें और उसके फ़ोल्डर में जाएँ:

git clone https://github.com/patient-administration-system/patient-administration-system.git
cd patient-administration-system

चरण 3: डेटाबेस और साइन-इन सेवा शुरू करें

podman compose -f podman/compose.yml up -d

यदि कोई पोर्ट पहले से उपयोग में है, तो नीचे दिखाए अनुसार दूसरे पोर्ट चुनें, और आगे के चरणों में संबंधित पोर्ट नंबर बदलें:

PAS_PG_PORT=5442 PAS_KEYCLOAK_PORT=8190 podman compose -f podman/compose.yml up -d

चरण 4: डेटाबेस तैयार करें

इससे तालिकाएँ बनती हैं और एक डेमो सुविधा, एक वार्ड, एक कमरा और तीन बिस्तर जुड़ते हैं। पहली बार चलाने पर निर्भरताएँ डाउनलोड और कंपाइल होती हैं, जिसमें कुछ समय लग सकता है।

export DATABASE_URL=postgres://pas:pas_dev_password@localhost:5432/pas
cargo run -p patient-administration-system-migrations --bin pas-migrate -- up
cargo run -p patient-administration-system --bin pas-seed

चरण 5: टोकन सेवा शुरू करें

उसी फ़ोल्डर में दूसरा टर्मिनल खोलें और यह कमांड चलती रहने दें:

sh scripts/dev-auth.sh

चरण 6: API शुरू करें

पहले टर्मिनल में चलाएँ:

PAS_PASETO_KEYS_URL=http://127.0.0.1:8195/keys.json PAS_REQUIRE_AUTH=true \
  cargo run -p patient-administration-system --bin patient-administration-system

शुरू होने के बाद, यह पुष्टि करने के लिए ब्राउज़र में http://localhost:8080/api/health खोलें कि यह चल रहा है। इस मोड में /swagger-ui/ पर Swagger UI को टोकन चाहिए, इसलिए यह 401 लौटाता है।

चरण 7: वेब इंटरफ़ेस शुरू करें

परियोजना के फ़ोल्डर में तीसरा टर्मिनल खोलें:

cd patient-administration-system-ui-with-svelte
cp .env.example .env
pnpm install && pnpm run dev

यदि आपने चरण 3 में कोई दूसरा Keycloak पोर्ट चुना है, तो उसे .env में OIDC_ISSUER में भी बदलें।

चरण 8: साइन इन करें

http://localhost:5173 खोलें और किसी परीक्षण उपयोगकर्ता के रूप में साइन इन करें:

उपयोगकर्ता नाम पासवर्ड उद्देश्य
admin admin कर्मचारी दृश्य: समय-सारिणी, अपॉइंटमेंट और प्रतीक्षा सूचियाँ
patient patient रोगी दृश्य: अपॉइंटमेंट और संदेश

कर्मचारियों की तरह admin उपयोगकर्ता से एक बार उपयोग होने वाला कोड भी माँगा जाता है। विकास कुंजी JBSWY3DPEHPK3PXP को किसी ऑथेंटिकेटर ऐप में जोड़ें, और उसमें दिखने वाला कोड दर्ज करें।

सूचियाँ खाली होंगी। डेमो डेटा में कोई व्यक्ति नहीं है, क्योंकि रोगी और कर्मचारी person-service और worker-service में रखे जाते हैं, जो अलग परियोजनाएँ हैं।

चरण 9: बंद करें

प्रोग्राम रोकने के लिए हर टर्मिनल में Ctrl और C दबाएँ, फिर सहायक सेवाएँ रोकें:

podman compose -f podman/compose.yml down

अगले कदम