Drafft cyntaf o'r cyfieithiad yw'r dudalen hon, wedi'i ysgrifennu gan AI. Nid yw siaradwr Cymraeg rhugl wedi'i hadolygu eto.
Tiwtorial
Mae'r tiwtorial hwn yn disgrifio sut i redeg y system ar gyfrifiadur lleol. Mae angen terfynell, ond nid oes angen gwybodaeth am Rust na Svelte.
Ar gyfer gwerthuso yn unig y mae'r gosodiad hwn. Peidiwch â defnyddio data cleifion go iawn. Mae'n defnyddio cyfrineiriau prawf sy'n hysbys i'r cyhoedd.
Cam 1: Gosod yr offer
Mae angen yr offer canlynol:
- Rust, sy'n adeiladu'r API. Mae'r prosiect yn dewis y fersiwn iawn i chi.
- Node 26 gyda pnpm, sy'n rhedeg y rhyngwyneb gwe.
- Podman, sy'n rhedeg y gronfa ddata a'r gwasanaeth mewngofnodi.
Cam 2: Cael y cod
Agorwch derfynell, yna lawrlwythwch y prosiect a mynd i'w ffolder:
git clone https://github.com/patient-administration-system/patient-administration-system.git
cd patient-administration-systemCam 3: Dechrau'r gronfa ddata a'r gwasanaeth mewngofnodi
podman compose -f podman/compose.yml up -dOs yw porth eisoes yn cael ei ddefnyddio, dewiswch byrth eraill fel y dangosir, a newidiwch rifau'r pyrth yn y camau nesaf:
PAS_PG_PORT=5442 PAS_KEYCLOAK_PORT=8190 podman compose -f podman/compose.yml up -dCam 4: Paratoi'r gronfa ddata
Mae hyn yn creu'r tablau, yna'n ychwanegu un cyfleuster enghreifftiol, un ward, un ystafell a thri gwely. Mae'r rhediad cyntaf yn lawrlwytho ac yn crynhoi dibyniaethau, a all gymryd peth amser.
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-seedCam 5: Dechrau'r gwasanaeth tocynnau
Agorwch ail derfynell yn yr un ffolder. Gadewch hwn yn rhedeg:
sh scripts/dev-auth.shCam 6: Dechrau'r API
Ewch yn ôl i'ch terfynell gyntaf a rhedeg:
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-systemPan fydd wedi dechrau, agorwch http://localhost:8080/api/health mewn porwr i gadarnhau ei fod yn rhedeg. Mae Swagger UI yn /swagger-ui/ yn gofyn am docyn yn y modd hwn, felly mae'n dychwelyd 401.
Cam 7: Dechrau'r rhyngwyneb gwe
Agorwch drydedd derfynell yn ffolder y prosiect:
cd patient-administration-system-ui-with-svelte
cp .env.example .env
pnpm install && pnpm run devOs dewisoch borth Keycloak arall yng ngham 3, newidiwch ef yn OIDC_ISSUER yn .env hefyd.
Cam 8: Mewngofnodi
Agorwch http://localhost:5173 a mewngofnodwch gydag un o'r defnyddwyr prawf:
| Enw defnyddiwr | Cyfrinair | Diben |
|---|---|---|
admin |
admin |
Golwg staff: amserlen, apwyntiadau a rhestrau aros |
patient |
patient |
Golwg claf: apwyntiadau a negeseuon |
Gofynnir hefyd i'r defnyddiwr admin am god un-tro, fel pob aelod o staff. Ychwanegwch yr allwedd ddatblygu JBSWY3DPEHPK3PXP at ap dilysu, a rhowch y cod y mae'n ei ddangos.
Bydd y rhestrau'n wag. Nid oes pobl yn y data enghreifftiol, gan y cedwir cleifion a staff yn person-service a worker-service, sy'n brosiectau ar wahân.
Cam 9: Cau i lawr
Pwyswch Ctrl ac C ym mhob terfynell i atal y rhaglenni, yna ataliwch y gwasanaethau ategol:
podman compose -f podman/compose.yml down