opengis/README.md
Flook 58ea6c08a4
All checks were successful
continuous-integration/drone/push Build is passing
ปรับปรุง README
2025-04-15 15:51:27 +07:00

80 lines
3.3 KiB
Markdown

# 🌐 OpenGIS
[![Deploy Status](https://img.shields.io/badge/deploy-success-brightgreen?style=flat-square&logo=vercel)](https://opengis.softwarecraft.tech/)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](#license)
> Frontend สำหรับระบบ OpenGIS และแสดงผลแบบ Responsive ด้วย React + TailwindCSS ✨
> ระบบนี้จะถูก Deploy ไปที่: 🌍 **[https://opengis.softwarecraft.tech/](https://opengis.softwarecraft.tech/)**
---
## 🚀 Features
- ✅ จัดการข้อมูลที่ต้องการได้ (CRUD)
- 🌞🌙 ปุ่มสลับธีม Light/Dark พร้อม Animationร
- 📋 ตารางข้อมูลพร้อมปุ่ม Update และ Delete
- 🔒 Modal ยืนยันการลบข้อมูล
- 💅 ใช้ TailwindCSS และ DaisyUI สำหรับ UI ที่ดูดี
- ⚠️ หมายเหตุ: อยู่ระหว่างการพัฒนา โค้ดปัจจุบันยังไม่ใช่รูปแบบการทำงานจริงทั้งหมด
---
## 🧪 Tech Stack
| Technology | Description |
|--------------|------------------------------------|
| ⚛️ React | Frontend JavaScript Framework |
| 💨 TailwindCSS | Utility-first CSS Framework |
| 🖌️ DaisyUI | Component UI บนพื้นฐาน Tailwind |
| 🧠 Gitea | Git Self-hosted Repository |
| 🚀 Drone CI | การทำ Continuous Integration และ Continuous Delivery (CI/CD) |
| 🚀 SonarQube | การวิเคราะห์คุณภาพโค้ด (Code Quality) |
---
## 🔗 Deployment
ระบบนี้จะถูก Deploy ไปยัง:
👉 **[https://opengis.softwarecraft.tech/](https://opengis.softwarecraft.tech/)**
⚠️ หมายเหตุ: ระบบยังอยู่ในระหว่างการพัฒนา อาจมีการเปลี่ยนแปลงในอนาคต
---
## 🛠️ Development
### 1. ขั้นตอนสำหรับ Frontend
``` bash
cd frontend
npm install
npm run dev
```
หากต้องการรันเฉพาะ frontend แบบ local dev ไม่ต้องใช้ Docker ก็สามารถทำได้ตามขั้นตอนข้างบน
### 2. ขั้นตอนสำหรับ Employee Service (Backend)
ต้องติดตั้ง JDK 21+ และ Maven
``` bash
cd employee-service
./mvnw spring-boot:run
```
แนะนำให้ใช้ IDE เช่น IntelliJ IDEA หรือ VS Code ในการพัฒนา
### 3. การทดสอบระบบแบบรวม (Frontend + Backend)
ใช้คำสั่งเดียวเพื่อรันทั้งระบบผ่าน Docker Compose
``` bash
docker compose up -d
```
จากนั้นสามารถเข้าใช้งานที่
- Frontend: http://localhost
- Backend (Employee Service): http://localhost/api/employees
---
## 🤝 Contributing
Pull requests welcome! หากมีคำแนะนำหรือข้อเสนอแนะ ยินดีรับฟังเสมอ 🙌