Control-Vaccination-Services

Bug Report ⚠️ Request Feature 👩‍💻

Ứng dụng quản lý tiêm chủng, phát triển trên nền tảng Budibase để tối ưu quy trình và giảm thao tác thủ công.

Mục tiêu phát triển ứng dụng quản lý tiêm chủng, phát triển trên nền tảng LCDP Budibase kết hợp với AI, tự động hóa quy trình để giảm thao tác thủ công và nâng cao hiệu quả quản lý.

Dự án được thực hiện trong cuộc thi Phần Mềm Nguồn Mở-Olympic Tin học Sinh viên Việt Nam 2024. Được open source theo giấy phép Apache License, Version 2.0 bởi đội tác giả HaUI-AnodisO.

Để biết thêm chi tiết về cuộc thi, bạn có thể xem tại đây.

Link thuyết trình Canva tại cuộc thi link

Slide bài thuyết trình tại cuộc thi dưới dạng PDF có thể được truy cập tại đây: Slide

---

🔎 Danh Mục

1. Giới Thiệu, Demo sản phẩm
2. Chức Năng Chính
3. Tổng Quan Hệ Thống
4. Cấu Trúc Thư Mục
5. Thiết kế Database
6. Hướng Dẫn Cài Đặt
   • 📋 Yêu Cầu - Prerequisites
   • 🔨 Cài Đặt
7. CI/CD
8. 🙌 Đóng Góp
9. 📝 License

---

Giới Thiệu

• Công nghệ LCDP cho phép các công cụ cấu hình dễ dàng và triển khai nhanh chóng mà không cần phải lập trình nhiều.
• BudibaseBudibase là nền tảng phát triển ứng dụng Low-Code, cho phép tạo nhanh các ứng dụng nội bộ với giao diện trực quan, tích hợp linh hoạt và khả năng triển khai dễ dàng.

Demo sản phẩm

---

Chức Năng

Dự án tập trung vào các chức năng chính sau:

• Đăng ký lịch tiêm chủng
• Thông báo lịch tiêm tự động
• Chatbot hỗ trợ thông minh
• Cấp giấy xác nhận tiêm chủng
• Xử lý phản hồi đăng ký nhanh chóng

Link đặc tả usecase link

---

👩‍💻 Tổng Quan Hệ Thống

Mô hình hệ thống bao gồm các công nghệ:

• Docker: Containerize các service.
• Nginx: Reverse proxy server, load balancer, và web server cho các dịch vụ.
• Budibase: Nền tảng low-code để xây dựng và triển khai ứng dụng nhanh chóng.
• FastAPI: Framework web để xây dựng API nhanh chóng và hiệu quả với Python.
• GeminiAI: tạo API hỗ trợ các mô hình trí tuệ nhân tạo và học máy

CI/CD

Project CI/CD sử dụng Github và Github Actions để tự động hóa quá trình build và deploy. Quy trình như hình vẽ sau:

• commitlint.yml: Lint các commit message của các nhánh

Cấu trúc thư mục

• src: Các tệp export của budibase
• Docs: Tài liệu về hệ thống, cuộc thi, sử dụng.
• AI: Tài liệu về module ocr và OpenAPI AI Key

Thiết kế Database

---

Hướng Dẫn Cài Đặt

Yêu Cầu 📋

Trước khi cài đặt, bạn cần cài đặt các công cụ sau:

• Docker
• Docker Compose

🔨 Cài Đặt

---

Cài đặt budibase

Đầu tiên, ta cần cài đặt ứng dụng budibase về self-host, hoặc có thể sử dụng luôn chính website trang chủ budibase chính thức tại đây

Để cài đặt budibase selfhost, ta thực hiện các bước như sau:

Bước 1. clone dự án budibase về máy của bạn:

git clone https://github.com/Budibase/budibase.git

Bước 2. cd vào thư mục hosting

cd budibase/hosting/

Bước 3: Tạo tài khoản admin

• Bạn vào file .env, tìm đến và điền thông tin của mình ở phần này

# An admin user can be automatically created initially if these are set
BB_ADMIN_USER_EMAIL=
BB_ADMIN_USER_PASSWORD=

Bước 4: chạy lệnh docker-compose

docker-compose --env-file hosting.properties up

Ứng dụng budibase của bạn sẽ chạy trên địa chỉ http://localhost:10000

---

Cài đặt AI

Trước hết, hãy cd vào thư mục AI

cd AI/

Sau đó, thực hiện các bước theo hướng dẫn này

---

Import dự án của chúng tôi

Trước hết, hãy clone dự án về máy tính của bạn:

git clone https://github.com/HaUI-AnodisO/Control-Vaccination-Services.git

cd vào thư mục Control-Vaccination-Services/src:

cd Control-Vaccination-Services/src

Bạn sẽ thấy các file đã được giải nén ra. Việc cần làm là nén chúng lại giống như hướng dẫn để tạo file nén.

---

Bây giờ, bạn hãy import thư mục nén này vào app budibase như sau họăc dựa theo hướng dẫn này:

Hướng dẫn Cài đặt và Sử dụng

Bước 1: Tải tệp nén

• Nếu bạn đã có tệp nén sau bước nén trên thì sẽ không cần thực hiện bước ày nữa, ta sẽ sử dụng luôn file nén đó.

Truy cập vào phần Release trên GitHub, tìm tệp nén có tên Vaccine.Control.Center-export-###.tar.gz, đây là phần Export app của chúng tôi. Hãy tải tệp đó về máy.

Bước 2: Đăng nhập vào ứng dụng

Mở ứng dụng và đăng nhập vào tài khoản của bạn.

Bước 3: Tạo ứng dụng mới

Chọn Create new app để tạo một ứng dụng mới, sau đó chọn ứng dụng mới vừa tạo.

Bước 4: Nhập ứng dụng

Vào phần Settings, chọn Export/Import, sau đó nhấn Import app

Bước 5: Hoàn tất

Chọn tệp Vaccine.Control.Center-export-###.tar.gz mà bạn đã tải về, rồi nhấn Update. Vậy là bạn đã có thể sử dụng dịch vụ của chúng tôi ngay bây giờ!

---

🙌 Đóng góp cho dự án

Bug Report ⚠️

Feature Request 👩‍💻

Nếu bạn muốn đóng góp cho dự án, hãy đọc CONTRIBUTING.md để biết thêm chi tiết.

Mọi đóng góp của các bạn đều được trân trọng, đừng ngần ngại gửi pull request cho dự án.

Liên hệ

• Phạm Đăng Đông: dong10082003@gmail.com
• Nguyễn Thị Trang: nguyenthitrang.ttd@gmail.com
• Đỗ Trung Hòa: trunghoa2k4@gmail.com

📝 License

This project is licensed under the terms of the APACHE V2 license.