# Αρχιτεκτονική εφαρμογών υγείας

> Διαγράμματα και ροές δεδομένων: ασθενής προς εφαρμογή προς Anpheros API προς το FHIR record και εξωτερικές υπηρεσίες, και AI agent προς το context API προς εξουσιοδοτημένα δεδομένα.

Source: https://developers.anpheros.com/el/guides/architecture

Το Anpheros είναι το επίπεδο ιατρικών δεδομένων μεταξύ της εφαρμογής σας (ή του AI agent) και του ιατρικού φακέλου του ασθενούς. Η εφαρμογή σας διατηρεί το δικό της user interface και business logic. Ο ιατρικός φάκελος, η συναίνεση, η προέλευση και ο έλεγχος (audit) βρίσκονται στο Anpheros και προσπελαύνονται μέσω ενός API.

```
  Your application, backend or AI agent
  (mobile app, web app, clinic system, lab system, LLM-based assistant)
                        │  HTTPS · API key (sk_test_ / sk_live_) or OAuth token (at_…)
                        ▼
  Anpheros Platform API
  ├─ /v1        simplified REST: patients, observations, conditions, medications,
  │             documents, timeline, provenance, context, labs, webhooks
  ├─ /fhir/R4   strict FHIR R4: 26 resource types, search, history, transactions,
  │             $everything, $summary (IPS), $validate
  └─ /oauth     OAuth 2.1 + PKCE, SMART on FHIR, OpenID Connect
                        │  every request: project isolation · scopes · rate limits
                        ▼
  One FHIR R4 record per patient
  ├─ versions of every resource (history)   ├─ Provenance for every write
  ├─ Consent resources for every grant      └─ access log visible to the patient
                        │
                        ▼
  Events out: signed webhooks to your server (ids only, never clinical content)
```

## Η οπτική του ασθενούς: από το άτομο σε εξωτερικές υπηρεσίες

```
Patient
   ↓   uses an app, chooses what to share, sees every access
Healthcare application          Anpheros Daily, or your own app
   ↓   REST v1 / FHIR R4 over HTTPS, API key or OAuth token
Anpheros API
   ↓   isolation, scopes, idempotency, provenance
FHIR medical data               the patient's record: 26 resource types, every version kept
   ↓   only what the patient allowed, only for as long as allowed
External healthcare services    laboratories (lab import), clinics (directory, acting-as),
                                other apps (OAuth / SMART), your backend (webhooks)
```

## Η οπτική της Τεχνητής Νοημοσύνης: από τον πράκτορα στα εξουσιοδοτημένα δεδομένα

```
AI agent or LLM application     runs the model you choose — hosted or local
   ↓   POST /v1/context  {patient, task, question, budget_tokens}
Medical context API             plans which parts of the record matter, fits them into the budget,
   ↓                            labels every item with author type and source, records a manifest
Authorised medical data         only records the project created or the patient granted;
                                the read appears in the patient's access log
```

Το μοντέλο δεν λαμβάνει ποτέ διαπιστευτήρια και δεν καλεί ποτέ το Anpheros μόνο του· η εφαρμογή σας ζητά το πλαίσιο και αποφασίζει τι θα στείλει στο μοντέλο. Δύο πλήρη παραδείγματα με κλήσεις API: μια εφαρμογή τεχνητής νοημοσύνης στην υγειονομική περίθαλψη στις [Εφαρμογές Τεχνητής Νοημοσύνης στην Υγειονομική Περίθαλψη](https://developers.anpheros.com/el/guides/ai-healthcare) και ένας εξουσιοδοτημένος πράκτορας στις [Πράκτορες Τεχνητής Νοημοσύνης και Ιατρικά Δεδομένα](https://developers.anpheros.com/el/guides/ai-agents-medical-data). Λεπτομέρειες: [Πράκτορες Τεχνητής Νοημοσύνης και Ιατρικά Δεδομένα](https://developers.anpheros.com/el/guides/ai-agents-medical-data), [Εφαρμογές LLM και Δεδομένα Υγειονομικής Περίθαλψης](https://developers.anpheros.com/el/guides/llm-healthcare-data).

## Ο φάκελος

Κάθε ασθενής έχει έναν φάκελο που αποτελείται από πόρους FHIR R4: `Observation` για ζωτικά σημεία, εργαστηριακά αποτελέσματα, συμπτώματα και περιλήψεις καθημερινής δραστηριότητας, `Condition` και `EpisodeOfCare`, `MedicationStatement` και `MedicationAdministration`, `DocumentReference`, `Immunization`, `AllergyIntolerance` και άλλα — συνολικά 26 τύποι, που αναφέρονται ζωντανά στο CapabilityStatement (`GET /fhir/R4/metadata`). Δεν υπάρχει ιδιόκτητο σχήμα για να μάθετε: το REST API είναι μια απλούστερη προβολή των ίδιων πόρων, με τα ίδια αναγνωριστικά.

Τίποτα δεν αντικαθίσταται σιωπηλά. Κάθε ενημέρωση δημιουργεί μια νέα έκδοση (`/fhir/R4/{type}/{id}/_history`), και κάθε έκδοση καταγράφει το έργο που την έγραψε και τον οργανισμό για λογαριασμό του οποίου γράφτηκε.

## Δύο τρόποι πρόσβασης

| | Κλειδί API | Διακριτικό πρόσβασης OAuth |
|---|---|---|
| Μοιάζει με | `sk_test_…` / `sk_live_…` | `at_…` |
| Χρησιμοποιείται από | τον διακομιστή σας | μια εφαρμογή που ενεργεί για έναν ασθενή |
| Βλέπει | τους ασθενείς που δημιούργησε το έργο σας | ακριβώς έναν ασθενή, εντός των πεδίων εμβέλειας που παραχώρησε ο ασθενής |
| Τυπική χρήση | το backend της δικής σας εφαρμογής, ένα σύστημα εργαστηρίου, μια ενσωμάτωση κλινικής | μια εφαρμογή τρίτου κατασκευαστή ή ένας βοηθός AI που αποκτά πρόσβαση σε ένα αρχείο που έχει ήδη ο ασθενής |

Ένα έργο δεν βλέπει ποτέ τους ασθενείς ενός άλλου έργου, εκτός εάν ο ασθενής παραχωρήσει πρόσβαση. Κάθε έργο λαμβάνει το δικό του αναγνωριστικό για το ίδιο άτομο (pairwise ids), επομένως τα αναγνωριστικά δεν μπορούν να συσχετιστούν μεταξύ εφαρμογών, και ένα αρχείο εκτός της εμβέλειάς σας απαντά `404`, ποτέ `403`.

## Δύο περιβάλλοντα

Το sandbox και το production είναι ξεχωριστές βάσεις δεδομένων. Ένα κλειδί sandbox (`sk_test_`) φυσικά δεν μπορεί να προσεγγίσει πραγματικούς ασθενείς· κάθε έργο sandbox λαμβάνει το δικό του αντίγραφο 30 συνθετικών ασθενών, τους οποίους μπορεί να αλλάξει ελεύθερα και να επαναφέρει. Τα κλειδιά production (`sk_live_`) εκδίδονται σε επαληθευμένους οργανισμούς.

## Ροές Δεδομένων

**Η εφαρμογή σας γράφει.** `POST /v1/patients/{id}/observations` με ένα `Idempotency-Key`. Η πλατφόρμα αποθηκεύει ένα FHIR `Observation`, γράφει ένα `Provenance` (τύπος συγγραφέα: patient, practitioner, device, import ή ai), καταγράφει την πρόσβαση και στέλνει ένα webhook `resource.created` σε εγγεγραμμένα endpoints.

**Μια άλλη εφαρμογή διαβάζει με συναίνεση.** Ο ασθενής την εγκρίνει στη φιλοξενούμενη σελίδα συναίνεσης (`/oauth/authorize`), επιλέγοντας το αρχείο και τη διάρκεια (30–365 ημέρες). Η εφαρμογή ανταλλάσσει τον κωδικό για tokens και διαβάζει μόνο ό,τι επιτρέπουν τα scopes. Ο ασθενής βλέπει την εφαρμογή, τα scopes της και κάθε ανάγνωση στο αρχείο καταγραφής πρόσβασής του, και μπορεί να την ανακαλέσει ανά πάσα στιγμή.

**Ένα εργαστήριο παραδίδει αποτελέσματα.** `POST /v1/patients/{id}/labs/import` με μια αναφορά CSV, HL7 v2 ORU^R01 ή JSON· κάθε αποτέλεσμα γίνεται ένα εργαστηριακό `Observation` με κωδικούς LOINC όπου είναι γνωστοί, και η επανυποβολή της ίδιας αναφοράς είναι ασφαλής.

**Ένα μοντέλο AI χρειάζεται πλαίσιο.** `POST /v1/context` επιστρέφει τα μέρη του αρχείου που σχετίζονται με μια εργασία, εντός ενός ορίου token, κάθε στοιχείο επισημαίνεται με την πηγή του· η κλήση καταγράφεται με ένα manifest id. Το ίδιο το μοντέλο εκτελείται όπου επιλέξετε.

## Πού εντάσσεται το Anpheros σε σύγκριση με την αυτοδημιουργία

| Ζήτημα | Αυτοδημιουργία | Με το Anpheros |
|---|---|---|
| Μοντέλο ιατρικών δεδομένων | σχεδιασμός πινάκων για κάθε είδος εγγραφής | Πόροι FHIR R4, 26 τύποι |
| Διαλειτουργικότητα | προσαρμοσμένες μορφές εξαγωγής | FHIR R4, International Patient Summary, SMART on FHIR |
| Συγκατάθεση | δημιουργία λογικής χορήγησης, πεδίου εφαρμογής, λήξης και ανάκλησης | Χορηγίες OAuth 2.1 αντικατοπτρίζονται ως FHIR `Consent` |
| Έλεγχος | δημιουργία καταγραφής και τρόπου εμφάνισής της στους ασθενείς | κάθε ανάγνωση και εγγραφή καταγράφεται και είναι ορατή στον ασθενή |
| Ενσωμάτωση εργαστηρίου | ανάλυση της μορφής κάθε εργαστηρίου | Εισαγωγή CSV, HL7 v2 ORU και JSON |
| Πλαίσιο AI | συγγραφή κώδικα ανάκτησης και σύνοψης | API πλαισίου με προϋπολογισμό token και ετικέτες προέλευσης |

## Σχετικά

- [Τι είναι το Anpheros;](https://developers.anpheros.com/el/guides/what-is-anpheros)
- [Ανάπτυξη λογισμικού υγείας](https://developers.anpheros.com/el/guides/healthcare-software)
- [Backend και βάση δεδομένων εφαρμογών υγείας](https://developers.anpheros.com/el/guides/medical-app-backend)
- [Δημιουργία εφαρμογής υγείας](https://developers.anpheros.com/el/guides/build-a-healthcare-app)
- [Μοντέλο συναίνεσης και πρόσβασης](https://developers.anpheros.com/el/guides/consent)
- [Ασφάλεια, ιδιωτικότητα και τοποθεσία δεδομένων](https://developers.anpheros.com/el/guides/security)