diff --git a/README.md b/README.md index c65af9a..4936178 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# MONOREPO STARTER TEMPLATE +# MONOREPO AI MEDICAL ## ภาพรวม โปรเจกต์นี้เป็น Monorepo แบบ Full-Stack ที่มีโครงสร้างพร้อมใช้งานสำหรับการพัฒนาและทดสอบ: @@ -9,58 +9,52 @@ 4. **Automation:** Docker Compose พร้อมตั้งค่า Database อัตโนมัติเมื่อเริ่มต้น 5. **Caching/Broker:** Redis สำหรับการเก็บ Session/Cache และใช้เป็น Message Broker ให้ Celery 6. **Async Processing:** Celery Worker สำหรับจัดการ Asynchronous Tasks (งานเบื้องหลัง เช่น การส่งอีเมล, การสร้างรายงาน) +7. **Model Serving: **FastAPI / MONAI / PyTorch** สำหรับการโหลดและทำ **Inference** โมเดล AI (เช่น `spleen_ct_spleen_model.ts`) โดยดึงโมเดลจาก MinIO ## การเริ่มต้นใช้งาน (Run Local) -1. **Clone the Repository:** - ```bash - git clone https://gitea.softwarecraft.tech/gitea/monorepo-starter-template.git - cd monorepo-starter-template - # ลบ History ของ Template เก่าทิ้งไป รองรับการเชื่อมต่อไปยัง Repository ใหม่ - rm -rf .git - ``` +### 1. การเตรียม Repository และ Environment -2. **รัน Infrastructure & Backend:** - ไปที่โฟลเดอร์ infra และสตาร์ทบริการทั้งหมด คำสั่งนี้จะ build backend และตั้งค่า CockroachDB Cluster อัตโนมัติ - ```bash - cd infra - docker compose up --build -d - ``` -3. **เข้าถึง Admin UI:** - ตรวจสอบว่า Backend และฐานข้อมูลพร้อมใช้งาน -- Django Admin: http://localhost:8000/admin/ -- CockroachDB Status: http://localhost:8080/ +1. **Clone และเตรียมโค้ด** + ```bash + git clone https://gitea.softwarecraft.tech/gitea/monorepo-starter-template.git + cd monorepo-ai-medical - Username: admin - - Password: Str0ngp@ssword123- + # ล้าง History ของ Template เก่า และเริ่มต้นใหม่ + Remove-Item -Path .git -Recurse -Force # สำหรับ PowerShell + # หรือใช้คำสั่ง Linux/Mac + rm -rf .git -- การเข้าถึงและตรวจสอบ API Endpoints อื่น ๆ: + git init + git add . + git commit -m "Initialize MLOps AI Medical Project Base" + ``` -http://localhost:8000/api/v1/auth/jwt/create/ +2. **เตรียม AI Environment (สำคัญ)** + เข้าโฟลเดอร์ `ai-medical/` และสร้าง Virtual Environment เพื่อติดตั้ง MONAI/FastAPI -http://localhost:8000/api/v1/auth/users/ + ```bash + cd ai-medical + python -m venv venv + .\venv\Scripts\Activate.ps1 # Windows + # หรือ source venv/bin/activate (Linux/Mac) -http://localhost:8000/api/v1/auth/users/reset_password/ + # ติดตั้ง Dependencies + pip install -r requirements.ai.txt + cd .. + ``` -http://localhost:8000/api/v1/auth/users/me/ +--- +### 2. การรัน Infrastructure (DB, Cache, Storage) -4. **รัน Frontend (Web):** - ```bash - cd ../web - npm install - npm run dev - ``` +รัน Services พื้นฐานทั้งหมดใน Docker (ยกเว้น Backend/AI Service ที่จะรันใน Local CLI) -5. **รัน Frontend (Mobile):** -- ติดตั้ง Expo Go บนมือถือ -- สแกน QR Code โดยมือถือและเครื่อง Notebook ต้องอยู่ใน Lan วงเดียวกัน - - ```bash - cd ../mobile - npm expo start - ``` +```bash +cd infra +# รัน DB, Redis, MinIO (ต้องมี MinIO Service ใน docker-compose.yml แล้ว) +docker compose up -d cockroach-1 cockroach-2 cockroach-3 init-cluster redis minio +``` ## การหยุดชั่วคราวและรันต่อ ถ้าต้องการหยุดพัฒนาโดยไม่ลบฐานข้อมูล สามารถรัน: