MedKnowledge AI — Backend (CKIP)

Enterprise AI Clinical Knowledge Governance Platform — backend Laravel 13 + FastAPI AI Service. Lihat SCOPE.md untuk scope pengerjaan lengkap dan DATABASE_SCHEMA.md untuk skema database.

Quick Start

Seluruh service (Laravel, FastAPI AI Service, LiteLLM, PostgreSQL, Redis, MinIO, Mailpit, nginx) hidup di repo ini — tidak perlu clone repo lain untuk menjalankan backend.

git clone <repo-url> medknowledge-ai-be
cd medknowledge-ai-be
cp .env.example .env
cp docker/litellm/.env.example docker/litellm/.env   # isi OPENAI_API_KEY
docker compose up -d
docker compose exec laravel-app php artisan migrate --force
docker compose exec laravel-app php artisan db:seed --force

Akses aplikasi lewat http://localhost:8080 (nginx, BFF pattern: /api/* → Laravel, sisanya → Next.js).

Untuk full stack (termasuk frontend), clone medknowledge-ai-fe sebagai folder sibling dari medknowledge-ai-be sebelum docker compose up -d — service nextjs di-build dari ../medknowledge-ai-fe:

workspace/
├── medknowledge-ai-be/   ← docker compose up -d dijalankan dari sini
└── medknowledge-ai-fe/   ← sibling, clone terpisah

Struktur Folder

medknowledge-ai-be/
├── app/, bootstrap/, config/, database/, public/, resources/, routes/, storage/, tests/  (Laravel)
├── ai-service/           FastAPI AI Service — satu-satunya jalur akses model AI (SCOPE.md §0)
├── docker/               konfigurasi infra: nginx/, litellm/
├── docker-compose.yml    orkestrasi seluruh service
├── Dockerfile            image PHP-FPM untuk laravel-app/queue-worker/scheduler
└── composer.json

Arsitektur

• Laravel 13 — BFF & business logic, satu-satunya API yang diakses frontend.
• FastAPI AI Service (ai-service/) — Hybrid AI: OpenAI GPT (reasoning, draft generation) + Hugging Face models open source (biomedical NER, terminology mapping, embedding). Diakses lewat LiteLLM sebagai abstraction layer provider-agnostic. Laravel tidak pernah memanggil model AI secara langsung.
• PostgreSQL + TimescaleDB — database utama; audit trail (audit_logs) adalah hypertable append-only.
• MinIO — object storage dokumen sumber (S3-compatible).
• Redis — cache, session, queue.

Detail lengkap: SCOPE.md (keputusan arsitektur, roadmap 3 fase, 50 modul) dan DATABASE_SCHEMA.md.

Development Tanpa Docker (opsional)

composer install
php artisan key:generate
php artisan migrate
composer dev   # jalankan server + queue + logs + vite sekaligus

Catatan: perlu PostgreSQL, Redis, dan MinIO/S3-compatible storage terpasang lokal — Docker Compose tetap cara yang direkomendasikan.

---

Dibangun di atas Laravel — lihat dokumentasi Laravel untuk referensi framework.