Góc nhìn kỹ thuật

Gymios,
bên trong.

Một cái nhìn chính xác về kiến trúc, các lựa chọn về dữ liệu và tích hợp Apple. Các trạng thái phân biệt những gì đã được tích hợp trong mã với những gì còn cần kiểm chứng trên phần cứng thật.

Gymios cho iPhone và Apple Watch đã có trên App Store. Phiên bản Mac sẽ ra mắt sau.

Chính sách dữ liệu Gymios
  1. 01
    Ứng dụng Sức khỏeNguồn chính cho các trường tương thích
  2. 02
    Nguồn đã xác minhThiết bị hoặc dữ liệu nhập đã xác nhận
  3. 03
    Bổ sung từ GymiosChỉ khi thiếu thông tin
Giữ nguồn gốc · không bịa giá trị
Quy tắc ưu tiên

Ứng dụng Sức khỏe không bị ghi đè.

Với những thông tin mà ứng dụng Sức khỏe cung cấp, Gymios coi nguồn này là tham chiếu. Dữ liệu Gymios có thể bổ sung một trường còn trống, nhưng không âm thầm thay thế một giá trị đã có trong Sức khỏe.

  1. 01
    Ưu tiên đọc từ ứng dụng Sức khỏe

    Cân nặng, chiều cao, giấc ngủ, nhịp tim, trạng thái tâm lý hay bài tập chỉ được lấy sau khi được cho phép, kèm ngày và nguồn.

  2. 02
    Kiểm tra các nguồn khác

    Dữ liệu Bluetooth, tài liệu được nhận diện hay dữ liệu nhập đều giữ nguồn gốc. Các giá trị nhạy cảm chưa được xác minh vẫn cần xác nhận.

  3. 03
    Bổ sung phần còn thiếu

    Hồ sơ và bảng hỏi của Gymios chỉ hỏi những thông tin còn thiếu. Từ chối hoặc bỏ qua một dữ liệu không làm cản trở việc phân tích các thông tin khác.

  4. 04
    Chỉ ghi khi được đồng ý

    Một hoạt động ngoài trời, số đo tương thích hay cảm nhận chỉ được thêm vào ứng dụng Sức khỏe sau khi có quyền tương ứng. Nhập bản sao lưu Gymios không sửa đổi hay xóa dữ liệu Sức khỏe.

Cách hoạt động của các nguồn chính
NguồnVai tròKiểm soátGhi đè ứng dụng Sức khỏe?
Ứng dụng Sức khỏeTham chiếu cho các trường tương thíchQuyền Apple theo từng danh mụcKhông áp dụng
Thiết bị hoặc dữ liệu nhậpSố đo bổ sung có thể truy nguyênKiểm chứng kỹ thuật và bởi con ngườiKhông
Nhập liệu trong GymiosBổ sung thông tin còn thiếuThao tác rõ ràng của người dùngKhông
Phân tích của GymiosNhận xét được suy ra và có thể giải thíchKhoảng thời gian, nguồn và mức độ bao phủ hiển thị rõKhông
Kiến trúc Apple gốc

Mỗi framework có một phạm vi rõ ràng.

Gymios được phát triển như một ứng dụng SwiftUI gốc. Các tích hợp hệ thống được tách biệt để việc từ chối một quyền không vô hiệu hóa những mô-đun không phụ thuộc vào quyền đó.

UI

SwiftUI

Giao diện iPhone, Apple Watch và Mac phù hợp với từng màn hình, thành phần hỗ trợ trợ năng và điều hướng gốc.

Đã tích hợp
DB

SwiftData

Buổi tập, dinh dưỡng, số đo đã xác nhận, mục tiêu và tùy chọn luôn có sẵn trên máy.

Đã tích hợp
HK

HealthKit

Đọc và ghi theo danh mục, quyền truy cập tập trung, nguồn gốc dữ liệu và không sao lưu toàn bộ vào CloudKit.

Kiểm chứng trên thiết bị
WC

WatchConnectivity

Liên tục giữa các buổi tập, lộ trình đã lên kế hoạch và hàng đợi chuyển dữ liệu có thể chờ kết nối trở lại.

Kiểm chứng với cặp thiết bị thật
MK

MapKit + Core Location

Đường đi GPS, tốc độ, chặng, lộ trình theo đường, nhập/xuất GPX và thư viện hoạt động ngoài trời.

Kiểm chứng thời gian dài
CK

CloudKit riêng tư

Đồng bộ không bắt buộc các danh mục được cho phép rõ ràng trong cơ sở dữ liệu riêng tư của Apple ID.

Tắt theo mặc định
BT

Core Bluetooth + FTMS

Phát hiện máy chạy bộ, xe đạp và máy chèo thuyền theo tiêu chuẩn, không hứa hẹn tương thích trước khi thử mẫu máy đó.

Kiểm chứng phần cứng
VI

Vision + OCR

Nhận diện trên máy nhãn sản phẩm, thực phẩm và giá trị đề xuất, luôn được hiển thị trước khi xác nhận.

Đã tích hợp
Danh mục chi tiết

Các chức năng nâng cao, theo từng lĩnh vực.

Trạng thái “đã tích hợp” mô tả mã hiện có. Nó không thay thế việc thử nghiệm trên thiết bị, thỏa thuận với nhà sản xuất hay các kiểm chứng chuyên môn được nêu.

⌁

Tập luyện

Đã tích hợp
  • Thư viện buổi tập có sẵn, mục yêu thích và buổi tập tùy chỉnh
  • Gợi ý theo mục tiêu, trình độ, thời lượng, dụng cụ và sở thích
  • Đồng hồ gắng sức/nghỉ, tiếp tục buổi tập và chuyển sang Watch
  • Hướng dẫn, nhóm cơ và minh họa động tác
  • Mục tiêu bao gồm tăng cường cơ bắp và hoạt động ngoài trời
↗

Hoạt động ngoài trời và lộ trình

Kiểm chứng ngoài thực địa
  • Đi bộ, chạy và đạp xe với ghi GPS do bạn bắt đầu
  • Quãng đường, thời gian, vận tốc, tốc độ, quãng nghỉ, độ cao tăng và các chặng
  • Lịch sử có thể đổi tên, mục yêu thích, điểm từ 1 đến 5 và sắp xếp
  • Tạo lộ trình theo đường trên Mac và chuyển sang iPhone/Watch
  • Nhập và xuất GPX/TCX, cảnh báo lệch hướng và tiếp tục an toàn
♥

Sức khỏe và cảm nhận

Cần HealthKit thật
  • Trung tâm duy nhất cho quyền truy cập ứng dụng Sức khỏe
  • Cân nặng, chiều cao, giấc ngủ, tim mạch, phục hồi và nguồn hiển thị rõ
  • Bảng hỏi không bắt buộc để bổ sung thông tin còn thiếu
  • Trạng thái tâm lý từ ứng dụng Sức khỏe được ưu tiên khi có
  • Nhận xét thích ứng, không bịa dữ liệu và không chẩn đoán
◒

Dinh dưỡng

Cần xác nhận
  • Nhật ký bữa ăn, khẩu phần, lượng nước và xu hướng
  • Thư viện dựa trên dữ liệu dinh dưỡng có nguồn
  • Mã vạch Open Food Facts mà không gửi dữ liệu Sức khỏe
  • OCR nhãn sản phẩm và nhận diện ảnh trên máy
  • Giá trị thiếu được hiển thị là không có, không bao giờ bịa ra
◉

Thiết bị kết nối

Theo từng mẫu
  • FTMS cho máy chạy bộ, xe đạp và máy chèo thuyền tương thích
  • Cân thông qua ứng dụng Sức khỏe
  • Dữ liệu đường huyết nhập vào có giới hạn, được cách ly rồi mới xác nhận
  • Hỗ trợ ghép nối theo thương hiệu mà không hứa hẹn sai về khả năng hỗ trợ
  • Ưu tiên chế độ chỉ đọc để tránh mọi lệnh điều khiển ngoài ý muốn
◎

Cộng đồng và sự đồng ý

Nền móng đã tích hợp
  • Mô-đun tắt theo mặc định và có thể thu hồi bất cứ lúc nào
  • Biệt danh không bắt buộc, hồ sơ riêng tư và chế độ hiển thị tự chọn
  • Đồng bộ iCloud giới hạn ở các tùy chọn phi y tế
  • Không tự động nhập danh bạ
  • Mã riêng tư, lời mời, chặn và báo cáo đã được tích hợp; quy trình kiểm duyệt cần được kiểm chứng trước khi mở cửa
★

Mục tiêu và cúp

Chia sẻ tự nguyện
  • Mục tiêu cá nhân, chuỗi ngày và hiệu ứng chúc mừng
  • Tủ trưng bày dạng dọc với ba cúp mỗi kệ trên iPhone và Mac
  • Chia sẻ qua hệ thống một bản tóm tắt do người dùng chọn
  • Game Center không bắt buộc, chỉ giới hạn ở mã định danh và tiến độ thành tích
  • Đăng lên vòng tròn hoặc cộng đồng, kết nối với dịch vụ HTTPS của Gymios, cần đăng nhập bằng Apple
✓

Vai trò huấn luyện viên

Đang cấu hình và thử nghiệm
  • Vai trò do người đó tự khai: Gymios không xác minh bằng cấp và không yêu cầu giấy tờ chứng minh
  • Dành cho một huấn luyện viên bạn đã biết, chẳng hạn ở phòng tập, người mời bạn bằng mã của họ
  • Đăng nhập bằng Apple được xác minh phía máy chủ; mã làm mới được lưu mã hóa để thu hồi kết nối khi xóa tài khoản
  • Không chia sẻ dữ liệu nào khi chưa có sự đồng ý của bạn, theo từng danh mục, kèm ngày kết thúc
✦

Phân tích trên máy

Phòng thí nghiệm
  • Chỉ đối chiếu các danh mục thực sự có sẵn
  • Khoảng thời gian, mức độ bao phủ và nguồn gốc đi kèm các nhận xét
  • Apple Intelligence không bắt buộc để sắp xếp lại các nhận định đã được tính toán
  • Mô hình không truy cập trực tiếp vào ứng dụng Sức khỏe
  • Không gửi tài liệu y tế thô, ghi chú tự do hay đường đi GPS chi tiết
☁

Liên tục với Apple

Chữ ký cần kiểm chứng
  • Tiện ích, complication, Smart Stack và Live Activity
  • App Intents, phím tắt Siri và liên kết sâu
  • Tùy chỉnh riêng biệt các không gian trên iPhone và Mac
  • Màn hình chính trên Watch với các lối tắt thiết yếu
  • Phương án dự phòng truyền thống khi tính năng mới của hệ thống không khả dụng
Cộng đồng và vòng tròn huấn luyện viên

Chia sẻ ít hơn,
nhưng chia sẻ rõ ràng.

Cộng đồng công khai và việc theo dõi riêng tư bởi huấn luyện viên là hai không gian tách biệt. Bật một không gian không bao giờ tự động cấp quyền truy cập vào không gian kia.

01 Bật một cách rõ ràng

Mô-đun ban đầu ở chế độ riêng tư và bị tắt. Sau đó người dùng tự chọn biệt danh, chế độ hiển thị và từng mối quan hệ.

Cài đặt đã tích hợp
02 Đăng tự nguyện

Cúp chỉ được đăng sau khi được cho phép. Hồ sơ cho huấn luyện viên chỉ gồm các danh mục đã đánh dấu và tách riêng những dữ liệu rất nhạy cảm.

Đã triển khai mã, dịch vụ chờ đưa vào hoạt động
03 Huấn luyện viên tự khai

Vai trò huấn luyện viên chỉ là tự khai. Gymios không xác minh bằng cấp: bạn chỉ chia sẻ với người bạn quen biết.

Đã triển khai
04 Sự đồng ý chi tiết

Người nhận, mục đích, danh mục, khoảng thời gian và ngày hết hạn được xác định trước khi truy cập. Việc thu hồi trên máy chủ có hiệu lực ngay và cắt quyền xem hồ sơ đã chia sẻ.

Chính sách và dịch vụ đã tích hợp
Luôn bị loại khỏi phần chia sẻ với huấn luyện viên
Đường huyếtSức khỏe sinh sảnTài liệu y tếỨng dụng Sức khỏe trong iCloud

Huấn luyện viên không bao giờ xem trực tiếp ứng dụng Sức khỏe. Hồ sơ được chuẩn bị trên máy từ một danh sách đóng gồm các danh mục được cho phép, rồi được mã hóa trên một dịch vụ tách biệt với iCloud.

Ranh giới dữ liệu

Những gì rời khỏi ứng dụng — và những gì không.

Mỗi kênh có danh sách cho phép riêng. Bật một loại đồng bộ không tự động cấp quyền truy cập vào các danh mục khác.

Lưu trữ trên máy

Buổi tập, dinh dưỡng, số đo đã xác nhận, mục tiêu và dữ liệu làm việc luôn ở trên thiết bị.

Mặc định
Ứng dụng Sức khỏe

Chỉ đọc hoặc ghi các danh mục được chọn trong giao diện bảo mật của Apple.

Theo danh mục
iCloud riêng tư

Thói quen và kế hoạch; lộ trình đã chuẩn bị và lịch sử GPS do Gymios ghi chỉ khi có hai sự đồng ý riêng biệt. Hoạt động ngoài trời nhập từ Sức khỏe, số đo và vùng nhịp tim, đường huyết và dinh dưỡng đều bị loại trừ.

Không bắt buộc
Game Center

Mã định danh của thành tích và phần trăm tiến độ, không kèm số đo Sức khỏe hay lộ trình chi tiết.

Không bắt buộc
Open Food Facts

Chỉ mã vạch được gửi qua HTTPS để tìm thông tin sản phẩm.

Dịch vụ bên thứ ba
Cộng đồng

Tùy chọn phi y tế trong iCloud; danh tính, mối quan hệ, cúp và hồ sơ huấn luyện viên nằm trên một dịch vụ riêng, với nội dung nhạy cảm được mã hóa khi lưu trữ. API HTTPS đã được triển khai; việc mở cửa đang chờ cấu hình production của Apple và kiểm chứng quy trình kiểm duyệt.

API đã triển khai
Cấp độ bằng chứng

Biên dịch được không có nghĩa là đã kiểm chứng.

Tài liệu kỹ thuật phân biệt bốn cấp độ bằng chứng. Các bước dưới đây mô tả những kiểm tra cần thực hiện; việc kiểm chứng trên phần cứng và khi phát hành vẫn đang diễn ra.

1Mã đã tích hợp

Biên dịch chức năng và kiểm thử các quy tắc có thể tự động hóa.

2Trình mô phỏng

Kiểm tra trên máy giao diện và các tình huống không cần cảm biến.

3Phần cứng thật

Thử nghiệm GPS, Watch, HealthKit, Bluetooth, thời lượng pin và gián đoạn trên thiết bị.

4Phát hành

Kiểm tra chữ ký, quyền riêng tư, trợ năng và các yêu cầu của Apple cho phiên bản phát hành.

Phạm vi sức khỏe

Gymios cung cấp nhật ký, xu hướng và nhận xét cá nhân. Ứng dụng không phải là thiết bị y tế, không phải chẩn đoán hay điều trị, và không thay thế bất kỳ chuyên gia y tế, thể thao hay dinh dưỡng nào.

Theo dõi tình trạng thực tế của các chức năng

Lộ trình phát triển phân biệt những phần đã tích hợp, những phần đang kiểm chứng và các hướng đi trong tương lai.

Mở lộ trình phát triển