TÂM AN Plus

TÂM AN Plus là một nền tảng web mã nguồn mở (React + FastAPI + MySQL) phục vụ việc thu thập, lưu trữ và phân tích các chỉ số sức khỏe định kỳ cho người cao tuổi. Mục tiêu là hỗ trợ sàng lọc sớm, cảnh báo rủi ro và cung cấp giao diện thân thiện cho người lớn tuổi, đồng thời hỗ trợ bác sĩ và người thân theo dõi.

Phiên bản này là mô hình thử nghiệm cho cuộc thi Giải Pháp Phần Mềm 2025 - Trường Đại học Mở TP.HCM.

Mục lục

• Tổng quan
• Tính năng chính
• Yêu cầu hệ thống
• Cài đặt nhanh (Quick Start)
• Cấu trúc repo
• Phát triển & Kiểm thử
• Đóng góp
• Giấy phép

Tổng quan

Hệ thống hỗ trợ:

• Thu thập chỉ số sức khỏe (năm sinh, giới tính, cân nặng, chiều cao, huyết áp, nhịp tim, đường huyết)
• Lưu trữ lịch sử (EMR nhẹ)
• Phân tích/rà soát bằng AI (tích hợp Gemini API) để sàng lọc và cảnh báo
• Chatbot hỗ trợ trao đổi giữa người dùng và bác sĩ
• Giao diện thân thiện cho người lớn tuổi và thông báo giọng nói (Speech Synthesis)

Tính năng chính

• Dashboard lịch sử chỉ số
• Cảnh báo thời gian thực khi có dấu hiệu bất thường
• Chat AI (GPT-like) và ghi nhận phản hồi bác sĩ
• Hỗ trợ nhập bằng smartwatch (Đang phát triển) / thủ công / giọng nói
• Quản lý người thân & phân quyền (user / carer / doctor / admin) (Đang phát triển)

Yêu cầu hệ thống

• Python 3.10+
• Node.js 16+
• MySQL 8+

Cài đặt nhanh (Quick Start)

1. Backend

cd backend
python -m venv .venv
.venv\Scripts\activate   # Windows
pip install -r ../requirements.txt
uvicorn main:app --reload --host 0.0.0.0 --port 8000

2. Frontend

cd frontend
npm install
npm start

Sau khi chạy cả hai phần, frontend mặc định sẽ kết nối tới backend ở http://localhost:8000 (nếu cần thay đổi, cập nhật file cấu hình tương ứng trong frontend/src hoặc .env).

Cấu trúc repo (tóm tắt)

• backend/ — FastAPI app, model, schema, database connector
• frontend/ — React app
• database/ — scripts SQL mẫu và ERD
• docs/ — tài liệu, hướng dẫn

Phát triển & Kiểm thử

• Viết unit-test cho backend bằng pytest là khuyến khích.
• Mở rộng quy mô xử lý của phần mềm
• Cấu hình CI (GitHub Actions) có thể đặt trong .github/workflows/ để chạy lint/test/build tự động.

Đóng góp

Chúng tôi hoan nghênh mọi đóng góp (issue, PR). Vui lòng:

1. Mở issue mô tả ý tưởng/bug trước khi gửi PR nếu thay đổi lớn.
2. Fork repo, tạo branch feature/fix, gửi PR vào branch main.
3. Tuân thủ coding style: Python (black/flake8), JS (prettier/eslint).

Bạn có thể thêm mục kiểm tra tự động (CI) để validate PR trước khi merge.

Người đóng góp chính ✨

Marcoh05P 💻 🛠️

nguyenminhtuuuu 💻 📊

Teaching2504 💡 📚

Giấy phép

Dự án sử dụng giấy phép MIT — xem file LICENSE để biết chi tiết.

---

© THE THREE - Software Solution Contest 2025 - Ho Chi Minh City Open University