Visão técnica

Gymios,
por dentro.

Uma leitura precisa da arquitetura, das escolhas sobre os dados e das integrações Apple. Os status separam o que está integrado ao 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
    App SaúdeFonte principal para os campos compatíveis
  2. 02
    Fonte verificadaAparelho ou importação confirmada
  3. 03
    Complemento GymiosSó quando a informação falta
Origem preservada · nenhum valor inventado
Regra de prioridade

O app Saúde não é sobrescrito.

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

  1. 01
    Ler o app Saúde primeiro

    Peso, altura, sono, frequência cardíaca, estado mental ou treinos são usados somente após autorização, com a data e a fonte.

  2. 02
    Verificar as outras fontes

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

  3. 03
    Completar o que falta

    O perfil e os questionários do Gymios pedem apenas as informações ausentes. Recusar ou omitir um dado não impede a análise dos outros.

  4. 04
    Gravar só com permissão

    Uma atividade ao ar livre, uma medição compatível ou um registro de bem-estar só é adicionado ao app Saúde após a autorização correspondente. Importar um backup do Gymios não altera nem apaga nada no Saúde.

Comportamento das principais fontes
FonteFunçãoControleSobrescreve o app Saúde?
App SaúdeReferência dos campos compatíveisAutorizações Apple por categoriaNão se aplica
Aparelho ou importaçãoMedição complementar rastreávelValidação técnica e humanaNão
Registro no GymiosCompleta uma informação ausenteAção explícita do usuárioNão
Análise do GymiosObservação derivada e explicávelPeríodo, fontes e cobertura visíveisNão
Arquitetura Apple nativa

Cada framework tem um escopo claro.

O Gymios é desenvolvido como um app SwiftUI nativo. As integrações com o sistema sã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 tela, componentes acessíveis e navegação nativa.

Integrado
DB

SwiftData

Treinos, nutrição, medições confirmadas, metas e preferências continuam disponíveis localmente.

Integrado
HK

HealthKit

Leitura e gravação por categoria, autorizações centralizadas, origem e nenhum backup geral no CloudKit.

Validação em aparelho
WC

WatchConnectivity

Continuidade dos treinos, percursos planejados e filas de transferência capazes de esperar a conexão voltar.

Validação com par real
MK

MapKit + Core Location

Traçado GPS, ritmo, etapas, rotas que seguem as estradas, importação/exportação GPX e biblioteca de atividades ao ar livre.

Validação de longa duração
CK

CloudKit privado

Sincronização opcional de categorias explicitamente autorizadas no banco de dados privado da Conta Apple.

Desativado por padrão
BT

Core Bluetooth + FTMS

Detecção de esteiras, bicicletas e remos padronizados, 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

Os recursos avançados, área por área.

O status “integrado” descreve o código disponível. Ele não substitui os testes em aparelhos, os acordos com fabricantes nem as validações profissionais indicadas.

⌁

Treinamento

Integrado
  • Biblioteca de treinos prontos, favoritos e treinos personalizados
  • Recomendação conforme objetivo, nível, duração, equipamento e preferências
  • Cronômetros de esforço/descanso, retomada do treino e transferência para o Watch
  • Instruções, grupos musculares e demonstrações de movimentos
  • Metas que incluem fortalecimento e atividades ao ar livre
↗

Atividades ao ar livre e percursos

Validação em campo
  • Caminhada, corrida e bicicleta com gravação GPS iniciada por você
  • Distância, tempo, velocidade, ritmo, pausas, desnível e etapas
  • Histórico renomeável, favoritos, notas de 1 a 5 e ordenação
  • Criação de rotas por estradas no Mac e transferência para iPhone/Watch
  • Importação e exportação GPX/TCX, alerta de desvio e retomada protegida
♥

Saúde e bem-estar

Requer HealthKit real
  • Central única de autorizações do app Saúde
  • Peso, altura, sono, coração, recuperação e fontes visíveis
  • Questionário opcional que completa as informações ausentes
  • Estado mental do app Saúde com prioridade quando existe
  • Observações adaptativas sem dados inventados nem diagnóstico
◒

Nutrição

Confirmação necessária
  • Diário de 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 foto
  • Valores ausentes exibidos como indisponíveis, nunca inventados
◉

Aparelhos conectados

Modelo por modelo
  • FTMS para esteiras, bicicletas e remos compatíveis
  • Balanças pelo app Saúde
  • Importações de glicemia limitadas, postas em quarentena e depois confirmadas
  • Ajuda no pareamento por marca sem falsa promessa de compatibilidade
  • Somente leitura sempre que possível, para evitar qualquer comando involuntário
◎

Comunidade e consentimento

Fundações integradas
  • Módulo desativado por padrã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 contatos
  • Códigos privados, convites, bloqueio e denúncia integrados; procedimento de moderação a validar antes da abertura
★

Metas e troféus

Compartilhamento voluntário
  • Metas pessoais, sequências de dias e comemoração visual
  • Vitrine vertical com três troféus por prateleira no iPhone e no Mac
  • Compartilhamento pelo sistema de um resumo escolhido pelo usuário
  • Game Center opcional limitado ao identificador e ao progresso 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 andamento
  • Função declarada pela própria pessoa: o Gymios não verifica diplomas nem pede comprovantes
  • Pensado para um treinador que você já conhece, por exemplo da academia, e que convida você com o código dele
  • Início de sessão Apple verificado no servidor; token de renovação guardado criptografado para revogar a conexão ao apagar a conta
  • Nenhum dado compartilhado sem sua permissão, categoria por categoria, com data de término
✦

Análise local

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

Continuidade Apple

Assinatura a validar
  • Widgets, complicação, Smart Stack e Live Activity
  • App Intents, atalhos da Siri e links diretos
  • Personalização separada dos espaços no iPhone e no Mac
  • Tela 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

Compartilhar menos,
mas com clareza.

A comunidade pública e o acompanhamento privado por 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 continua privado e desativado no início. Depois, o usuário escolhe seu pseudônimo, sua visibilidade e cada relação.

Ajustes integrados
02 Publicação voluntária

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

Implementado, serviço a implantar
03 Treinador declarado

A função de treinador é uma simples declaração. O Gymios não verifica diplomas: você compartilha apenas com uma pessoa que conhece.

Implementado
04 Consentimento detalhado

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 compartilhada.

Política e serviço integrados
Sempre excluídos do compartilhamento com o treinador
GlicemiaSaúde reprodutivaDocumentos médicosApp Saúde no iCloud

O treinador nunca consulta diretamente o app Saúde. As fichas são preparadas localmente a partir de uma lista fechada de categorias autorizadas e depois criptografadas em um serviço separado do iCloud.

Limites dos dados

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

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

Armazenamento local

Treinos, nutrição, medições confirmadas, metas e dados de trabalho ficam no aparelho.

Por padrão
App Saúde

Leitura ou gravação apenas para as categorias escolhidas na interface segura da Apple.

Por categoria
iCloud privado

Rotinas e planejamento; percursos preparados e histórico GPS gravado pelo Gymios somente com duas permissões separadas. As atividades ao ar livre importadas do Saúde, as medições e zonas cardíacas, a glicemia e a nutrição ficam de fora.

Opcional
Game Center

Identificador da conquista e porcentagem de progresso, sem medições de saúde nem percurso detalhado.

Opcional
Open Food Facts

Somente o código de barras é enviado por HTTPS para buscar 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 em um serviço separado, com criptografia dos conteúdos sensíveis no armazenamento. A API HTTPS está implantada; a abertura aguarda a configuração de produção da Apple e a validação da moderação.

API implantada
Nível de prova

Compilar não é validar.

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

1Código integrado

Compilar o recurso e testar suas regras automatizáveis.

2Simulador

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

3Hardware real

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

4Distribuição

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

Escopo de saúde

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

Acompanhar o estado real dos recursos

A roadmap separa os itens integrados, os que estão em validação e as ideias futuras.

Abrir a roadmap