Visão técnica

Gymios,
por dentro.

Uma leitura precisa da arquitetura, das escolhas sobre os dados e das integrações Apple. Os estados distinguem o que está integrado no código do que ainda precisa de validação em hardware real.

O Gymios para iPhone e Apple Watch está disponível na App Store. A versão para Mac chegará mais tarde.

Política de dados do Gymios
  1. 01
    Apple SaúdeFonte principal para os campos compatíveis
  2. 02
    Fonte verificadaAparelho ou importação confirmada
  3. 03
    Complemento GymiosApenas quando a informação está em falta
Origem preservada · nenhum valor inventado
Regra de prioridade

A Apple Saúde não é substituída.

Para as informações que a Apple Saúde disponibiliza, o Gymios trata essa fonte como referência. Um dado do Gymios pode completar um campo em falta, mas não substitui silenciosamente um valor existente na Saúde.

  1. 01
    Ler primeiro a Apple Saúde

    Peso, altura, sono, frequência cardíaca, estado de espírito ou treinos são utilizados apenas após autorização, com a respetiva data e fonte.

  2. 02
    Verificar as outras fontes

    Um dado Bluetooth, um documento reconhecido ou um registo importado mantém a sua origem. Os valores sensíveis não verificados continuam a aguardar confirmação.

  3. 03
    Completar o que falta

    O perfil e os questionários do Gymios só pedem as informações em falta. Recusar ou omitir um dado não impede a análise dos restantes elementos.

  4. 04
    Escrever apenas com acordo

    Uma saída, uma medição compatível ou um registo de sensações só é adicionado à Apple Saúde após a autorização correspondente. A importação de uma cópia de segurança do Gymios não altera nem elimina nada na Saúde.

Comportamento das principais fontes
FonteFunçãoControloSubstitui a Apple Saúde?
Apple SaúdeReferência dos campos compatíveisAutorizações Apple por categoriaNão aplicável
Aparelho ou importaçãoMedição complementar rastreávelValidação técnica e humanaNão
Registo no GymiosCompleta uma informação em faltaAção explícita do utilizadorNão
Análise do GymiosObservação derivada e explicávelPeríodo, fontes e cobertura visíveisNão
Arquitetura Apple nativa

Cada framework tem um âmbito claro.

O Gymios é desenvolvido como uma aplicação SwiftUI nativa. As integrações com o sistema estão isoladas para que uma autorização recusada não desative os módulos que não dependem dela.

UI

SwiftUI

Interfaces para iPhone, Apple Watch e Mac adaptadas a cada ecrã, componentes acessíveis e navegação nativa.

Integrado
DB

SwiftData

Sessões, nutrição, medições confirmadas, objetivos e preferências permanecem disponíveis localmente.

Integrado
HK

HealthKit

Leitura e escrita por categoria, autorizações centralizadas, origem e nenhuma cópia de segurança geral no CloudKit.

Validação em aparelho
WC

WatchConnectivity

Continuidade das sessões, percursos planeados e filas de transferência capazes de aguardar o regresso da ligação.

Validação com par real
MK

MapKit + Core Location

Traçado GPS, ritmo, etapas, itinerários que seguem as estradas, importação/exportação GPX e biblioteca de saídas.

Validação de longa duração
CK

CloudKit privado

Sincronização opcional de categorias explicitamente autorizadas na base de dados privada da Conta Apple.

Desativado por predefinição
BT

Core Bluetooth + FTMS

Deteção de passadeiras, bicicletas e remos normalizados, sem prometer compatibilidade antes de testar o modelo.

Validação em hardware
VI

Vision + OCR

Reconhecimento local de rótulos, alimentos e valores candidatos, sempre apresentados antes da confirmação.

Integrado
Catálogo detalhado

As funcionalidades avançadas, domínio a domínio.

O estado «integrado» descreve o código disponível. Não substitui os testes em aparelhos, os acordos com fabricantes nem as validações profissionais indicadas.

⌁

Treino

Integrado
  • Biblioteca de sessões prontas, favoritos e sessões personalizadas
  • Recomendação de acordo com objetivo, nível, duração, equipamento e preferências
  • Cronómetros de esforço/repouso, retoma da sessão e transferência para o Watch
  • Instruções, zonas musculares e demonstrações de movimentos
  • Objetivos que incluem reforço e atividades ao ar livre
↗

Saídas e percursos

Validação no terreno
  • Caminhada, corrida e bicicleta com registo GPS iniciado por si
  • Distância, tempo, velocidade, ritmo, pausas, desnível e etapas
  • Histórico com nomes editáveis, favoritos, notas de 1 a 5 e ordenação
  • Criação de itinerários por estrada no Mac e transferência para iPhone/Watch
  • Importação e exportação GPX/TCX, alerta de desvio e retoma protegida
♥

Saúde e sensações

Requer HealthKit real
  • Centro único de autorizações da Apple Saúde
  • Peso, altura, sono, coração, recuperação e fontes visíveis
  • Questionário opcional que completa as informações em falta
  • Estado de espírito da Apple Saúde com prioridade quando existe
  • Observações adaptativas sem dados inventados nem diagnóstico
◒

Nutrição

Confirmação necessária
  • Diário das refeições, porções, hidratação e tendências
  • Biblioteca baseada em dados nutricionais com fontes
  • Código de barras Open Food Facts sem envio de dados de saúde
  • OCR de rótulos e reconhecimento local por fotografia
  • Valores em falta apresentados como indisponíveis, nunca inventados
◉

Aparelhos ligados

Modelo a modelo
  • FTMS para passadeiras, bicicletas e remos compatíveis
  • Balanças através da Apple Saúde
  • Importações de glicemia limitadas, postas em quarentena e depois confirmadas
  • Ajuda ao emparelhamento por marca sem falsas promessas de suporte
  • Leitura apenas, sempre que possível, para evitar qualquer comando involuntário
◎

Comunidade e consentimento

Fundações integradas
  • Módulo desativado por predefinição e revogável a qualquer momento
  • Pseudónimo opcional, perfil privado e visibilidade escolhida
  • Sincronização com o iCloud limitada às preferências não médicas
  • Nenhuma importação automática dos contactos
  • Códigos privados, convites, bloqueio e denúncia integrados; procedimento de moderação a validar antes da abertura
★

Objetivos e troféus

Partilha voluntária
  • Objetivos pessoais, séries de dias e celebração visual
  • Vitrine vertical com três troféus por prateleira no iPhone e no Mac
  • Partilha pelo sistema de um resumo escolhido pelo utilizador
  • Game Center opcional limitado ao identificador e à progressão da conquista
  • Publicação no círculo ou na comunidade ligada ao serviço HTTPS do Gymios, com início de sessão Apple obrigatório
✓

Função de treinador

Configuração e testes em curso
  • Função declarada pela própria pessoa: o Gymios não verifica diplomas nem pede comprovativos
  • Pensado para um treinador que já conhece, por exemplo do ginásio, e que o convida com o código dele
  • Início de sessão Apple verificado no servidor; token de renovação guardado encriptado para revogar a ligação ao eliminar a conta
  • Nenhum dado partilhado sem o seu acordo, categoria a categoria, com data de fim
✦

Análise local

Laboratório
  • Cruzamento apenas das categorias realmente disponíveis
  • Período, cobertura e origem associados às observações
  • Apple Intelligence opcional para reordenar constatações já calculadas
  • Nenhum acesso direto do modelo à Apple Saúde
  • Nenhum documento médico em bruto, nota livre ou traçado GPS detalhado é transmitido
☁

Continuidade Apple

Assinatura a validar
  • Widgets, complicação, Smart Stack e Live Activity
  • App Intents, atalhos da Siri e ligações diretas
  • Personalização separada dos espaços no iPhone e no Mac
  • Ecrã inicial do Watch com atalhos essenciais
  • Alternativa clássica quando uma novidade do sistema não está disponível
Comunidade e círculo do treinador

Partilhar menos,
mas com clareza.

A comunidade pública e o acompanhamento privado de um treinador são dois espaços separados. Ativar um nunca dá acesso automático ao outro.

01 Ativação explícita

O módulo permanece privado e desativado no início. Depois, o utilizador escolhe o seu pseudónimo, a sua visibilidade e cada relação.

Definições integradas
02 Publicação voluntária

Os troféus só são publicados após autorização. As fichas do treinador incluem apenas as categorias assinaladas e distinguem os dados muito sensíveis.

Implementado, serviço a implementar
03 Treinador declarado

A função de treinador é uma simples declaração. O Gymios não verifica diplomas: só partilha com uma pessoa que conhece.

Implementado
04 Consentimento granular

Destinatário, finalidade, categorias, período e expiração são definidos antes do acesso. A revogação no servidor é imediata e corta a ficha partilhada.

Política e serviço integrados
Sempre excluídos da partilha com o treinador
GlicemiaSaúde reprodutivaDocumentos médicosApple Saúde no iCloud

O treinador nunca consulta diretamente a Apple Saúde. As fichas são preparadas localmente a partir de uma lista fechada de categorias autorizadas e depois encriptadas num serviço distinto do iCloud.

Fronteiras dos dados

O que sai da app — e o que não sai.

Cada canal tem a sua própria lista de permissões. Ativar uma sincronização não dá acesso automático às outras categorias.

Armazenamento local

Sessões, nutrição, medições confirmadas, objetivos e dados de trabalho permanecem no aparelho.

Por predefinição
Apple Saúde

Leitura ou escrita apenas para as categorias escolhidas na interface segura da Apple.

Por categoria
iCloud privado

Rotinas e planeamento; percursos preparados e histórico GPS registado pelo Gymios apenas com duas autorizações separadas. As saídas importadas da Saúde, as medições e zonas cardíacas, a glicemia e a nutrição ficam excluídas.

Opcional
Game Center

Identificador da conquista e percentagem de progressão, sem medições de saúde nem percurso detalhado.

Opcional
Open Food Facts

Apenas o código de barras é enviado por HTTPS para procurar a ficha do produto.

Serviço de terceiros
Comunidade

Preferências não médicas no iCloud; identidade, relações, troféus e fichas do treinador num serviço distinto, com encriptação dos conteúdos sensíveis no armazenamento. A API HTTPS está implementada; a abertura aguarda a configuração de produção da Apple e a validação da moderação.

API implementada
Nível de prova

Compilar não é validar.

A documentação técnica distingue quatro níveis de prova. As etapas abaixo descrevem os controlos esperados; as validações em hardware e na distribuição continuam em curso.

1Código integrado

Compilar a funcionalidade e testar as suas regras automatizáveis.

2Simulador

Verificar localmente a interface e os cenários sem sensor.

3Hardware real

Pôr à prova GPS, Watch, HealthKit, Bluetooth, autonomia e interrupções em aparelhos.

4Distribuição

Controlar assinatura, privacidade, acessibilidade e requisitos da Apple para a versão distribuída.

Âmbito de saúde

O Gymios apresenta diários, tendências e observações pessoais. A aplicação não é um dispositivo médico, nem um diagnóstico, nem um tratamento, e não substitui nenhum profissional de saúde, de desporto ou de nutrição.

Acompanhar o estado real das funcionalidades

A roadmap distingue os elementos integrados, os que estão em validação e as pistas futuras.

Abrir a roadmap