SparkyFitness là một ứng dụng quản lý và theo dõi sức khỏe toàn diện giúp người dùng giám sát chế độ dinh dưỡng, tập luyện và chỉ số cơ thể. Ứng dụng cung cấp các công cụ theo dõi tiến trình hàng ngày, đặt mục tiêu và báo cáo chi tiết để hỗ trợ lối sống lành mạnh.

Tài liệu: https://codewithcj.github.io/SparkyFitness

✨ Tính năng

🍎 Theo dõi dinh dưỡng

Ghi lại bữa ăn hàng ngày của bạn
Tạo và quản lý thực phẩm tùy chỉnh và các danh mục
Xem tóm tắt và phân tích xu hướng với biểu đồ tương tác

💪 Ghi chú tập luyện

Ghi lại các buổi tập luyện của bạn
Duyệt và tìm kiếm cơ sở dữ liệu bài tập toàn diện
Theo dõi tiến trình thể chất theo thời gian

💧 Theo dõi lượng nước uống

Theo dõi mục tiêu uống nước hàng ngày
Ghi nhận lượng nước dễ dàng, nhanh chóng

📏 Đo lường cơ thể

Ghi lại số liệu cơ thể (ví dụ: cân nặng, vòng eo, vòng tay)
Thêm các loại đo lường tùy chỉnh
Hình dung tiến trình qua biểu đồ

🎯 Đặt mục tiêu

Thiết lập và quản lý mục tiêu dinh dưỡng và thể hình
Theo dõi tiến trình theo thời gian

🗓️ Kiểm tra hàng ngày

Theo dõi hoạt động hàng ngày
Duy trì sự nhất quán với việc theo dõi thói quen

🤖 Huấn luyện viên dinh dưỡng AI (SparkyAI)

Ghi nhận thực phẩm, tập luyện, số liệu cơ thể và bước chân qua trò chuyện
Tải lên hình ảnh thực phẩm để tự động ghi nhận bữa ăn
Bao gồm lịch sử trò chuyện và hướng dẫn cá nhân hóa

🔒 Xác thực người dùng & Hồ sơ

Hệ thống đăng nhập an toàn
Chuyển đổi giữa các hồ sơ người dùng
Hỗ trợ truy cập và quản lý cho gia đình

📊 Báo cáo toàn diện

Tạo báo cáo tổng hợp về dinh dưỡng và các chỉ số cơ thể
Theo dõi xu hướng dài hạn theo tuần hoặc tháng

🎨 Chủ đề tùy chỉnh

Chuyển đổi giữa chế độ sáng và tối
Thiết kế giao diện tối giản, không gây phân tâm

Cần hỗ trợ?

Tham gia discord

https://discord.gg/vcnMT5cPEA

Đăng bài trong thảo luận

� Khởi động nhanh

Khởi chạy SparkyFitness chỉ trong vài phút:

# Clone the repository
git clone https://github.com/CodeWithCJ/SparkyFitness.git
cd SparkyFitness
Copy environment template and edit as needed
cp docker/.env.example .env
Start development environment (with live reloading)
./docker/docker-helper.sh dev upAccess application at http://localhost:8080

📖 Tài liệu

Để xem hướng dẫn cài đặt đầy đủ, thiết lập môi trường phát triển và hướng dẫn sử dụng, hãy truy cập tài liệu chi tiết của chúng tôi:

👉 Trang Tài liệu SparkyFitness

Liên kết nhanh

🚀 Bắt đầu - Hướng dẫn thiết lập đầy đủ cho phát triển và triển khai
🐳 Hướng dẫn Docker - Triển khai và cấu hình Docker
🔧 Quy trình phát triển - Hướng dẫn cho nhà phát triển và quy trình đóng góp
📊 Tổng quan tính năng - Tài liệu đầy đủ về các tính năng
🏗️ Kiến trúc hệ thống - Kiến trúc kỹ thuật và thiết kế
Tham khảo Wiki để thiết lập môi trường mẫu và cấu hình Ứng dụng Di động.

🐳 Triển khai Docker

Sản xuất (khuyến nghị):

cp docker/.env.example .env  # Edit as needed
./docker/docker-helper.sh prod up
Access at http://localhost:3004

Phát triển:

cp docker/.env.example .env  # Edit as needed  
./docker/docker-helper.sh dev up
Access at http://localhost:8080 (live reloading)

Để biết hướng dẫn cài đặt chi tiết, cấu hình môi trường và xử lý sự cố, hãy xem tài liệu đầy đủ.

⚠️ Các vấn đề đã biết / Tính năng Beta ⚠️

Các tính năng sau hiện đang ở chế độ beta và có thể chưa được kiểm thử kỹ lưỡng. Có thể gặp lỗi hoặc chức năng chưa hoàn chỉnh:

Chatbot AI
Hỗ trợ nhiều người dùng
Quyền truy cập Gia đình & Bạn bè
Tích hợp dữ liệu Apple Health

Ứng dụng này đang được phát triển mạnh mẽ. Một số chức năng có thể không hoạt động như mong đợi do quá trình chuyển đổi từ Supabase sang PostgreSQL. Thay đổi lớn (BREAKING CHANGES) có thể được áp dụng cho đến khi ứng dụng ổn định. Bạn có thể cần thay đổi biến Docker/môi trường cho các bản phát hành mới. Do đó, không nên sử dụng tự động nâng cấp bằng Watchtower hoặc các ứng dụng tương tự. Hãy đọc ghi chú phát hành cho bất kỳ THAY ĐỔI LỚN nào.

--- Tranlated By Open Ai Tx | Last indexed: 2025-10-04 ---

SparkyFitness

SparkyFitness - Giải pháp tự lưu trữ thay thế MyFitnessPal