Método
Como o app conta, regra por regra
Todo número do painel e do relatório vem de uma regra escrita em código, com teste, nome e versão. Esta página lista as regras atuais, as anteriores e os limites que elas usam. É a mesma lista do apêndice do PDF.
Versões
Mudou a regra? Nasce uma versão nova.
Um relatório guarda os fatos calculados e a versão de cada regra. Quando uma regra muda, os relatórios antigos continuam apontando para a versão com que foram calculados, e o apêndice diz qual é. Nada é recalculado por baixo de você.
Cálculo por código
Funções puras com teste produzem todos os fatos a partir do diário do período: valor, unidade, n e a regra.
Narrativa por IA, se você quiser
O modelo recebe só os fatos e escreve com marcadores no lugar de qualquer número.
Validação
Dígito solto, número por extenso, marcador inexistente ou termo proibido: o texto é recusado. Até duas tentativas; depois, só números.
Render
Tela e PDF trocam os marcadores pelos valores. O modelo nunca digita número, então o texto não discorda da tabela.
Limites
Os números fixos que as regras usam
Cada um está no código, com o nome, e aparece no apêndice quando entra numa conta.
3
amostra mínima
dias ou ocorrências para uma porcentagem; abaixo disso, “dados insuficientes”
5
por grupo comparado
dias em cada grupo de uma comparação (com e sem exercício, noites curtas e as outras, dentro e fora da janela do ciclo)
20 pts
para virar pergunta
diferença mínima, em pontos percentuais, para um cruzamento virar pergunta para o médico
48 h
janela dos sinais
sintoma até este tanto antes do início (pródromo) ou depois do fim (pósdromo) de uma dor
< 6 h
noite curta
sono abaixo disto entra como noite curta na comparação com a dor do dia seguinte
< 90%
saturação baixa
leituras da noite abaixo disto contam como baixas; o PDF cita as noites, não um diagnóstico
5 hPa
queda de pressão
variação negativa desde a véspera a partir da qual o dia entra como dia de queda
8 h
dor longa
a partir disto (ou de um dia para outro), a dor é lida evento a evento no relatório
6 h / 2 h
antes e depois de um evento
janela da última intensidade antes e da primeira depois de um remédio, exercício ou gatilho dentro da dor
O dia e o período
Dias do período
period.days@v1Número de dias entre o início e o fim do relatório, inclusive.
Dia com dor, sem dor, parcial, sem registro e em andamento
day.status@v3Dia com dor: há registro de dor cobrindo o dia, leitura de intensidade acima de zero ou check-in com dor. Dia sem dor: nenhuma evidência de dor e o dia foi fechado sem dor (check-in da noite com zero). Dia parcial: o dia tem algum registro (check-in da manhã, remédio, relato, ciclo), mas não a dor do dia; conta à parte e não vira dia sem dor. Sem registro: nenhum registro no dia. Em andamento: o dia em que o relatório foi gerado, enquanto ainda não tem a dor do dia; ele não acabou, então não conta como sem registro nem como parcial. Nas porcentagens, "dias com registro" são os dias com dor ou sem dor: parciais, sem registro e o dia em andamento ficam fora.
2 versões anteriores, que os relatórios antigos ainda citam
day.status@v2Dia com dor, sem dor, parcial e sem registro. Dia com dor: há registro de dor cobrindo o dia, leitura de intensidade acima de zero ou check-in com dor. Dia sem dor: nenhuma evidência de dor e o dia foi fechado sem dor (check-in da noite com zero). Dia parcial: o dia tem algum registro (check-in da manhã, remédio, relato, ciclo), mas não a dor do dia; conta à parte e não vira dia sem dor. Sem registro: nenhum registro no dia. Nas porcentagens, "dias com registro" são os dias com dor ou sem dor: parciais e sem registro ficam fora.
day.status@v1Dia com dor, sem dor e sem registro. Dia com dor: há registro de dor cobrindo o dia, leitura de intensidade acima de zero ou check-in com dor. Dia sem dor: nenhuma evidência de dor e o dia foi fechado sem dor (check-in da noite com zero). Sem registro: todo o resto. Ausência de registro nunca conta como dia sem dor.
Dias com registro
coverage.pct_recorded@v2Dias com dor somados aos dias sem dor, divididos pelos dias do período já encerrados (o dia em andamento, o da geração do relatório, fica fora). Dias parciais e sem registro contam no denominador.
Versão anterior, que os relatórios antigos ainda citam
coverage.pct_recorded@v1Dias com registro. Dias com dor somados aos dias sem dor, divididos pelos dias do período. Dias parciais e sem registro ficam fora.
A dor
Crises
pain.crises@v4Dores que a própria pessoa marcou como crise e que tocam o período: as que começaram nele e as que começaram antes e terminaram nele (ou seguem em andamento). Registros que se sobrepõem contam como uma crise só, e a dor é crise se algum deles foi marcado. A crise que começou antes do primeiro dia é contada à parte, com a data do início ("3 crises, 1 começou em 30/09"). É a mesma regra do resumo do período no assistente. Nada é deduzido do remédio tomado.
3 versões anteriores, que os relatórios antigos ainda citam
pain.crises@v3Crises. Registros de dor que a própria pessoa marcou como crise, iniciados dentro do período; registros que se sobrepõem contam como um só, e o grupo é crise se algum deles foi marcado. Nada é deduzido do remédio tomado.
pain.crises@v2Crises. Registros de dor que a própria pessoa marcou como crise, iniciados dentro do período. Nada é deduzido do remédio tomado.
pain.crises@v1Crises (regra antiga: todo registro de dor). Registros de dor iniciados dentro do período, todos contados como crise.
Dores
pain.episodes@v3Dores registradas que tocam o período: as que começaram nele e as que começaram antes e terminaram nele (ou seguem em andamento). Registros que se sobrepõem (um dentro do intervalo do outro, ou cruzando o mesmo dia sem horário que os separe) contam como uma dor só. A que começou antes do primeiro dia é contada à parte ("começou antes").
2 versões anteriores, que os relatórios antigos ainda citam
pain.episodes@v2Registros de dor. Vezes em que a pessoa registrou uma dor (com ou sem marcação de crise), iniciadas dentro do período. Registros que se sobrepõem (um dentro do intervalo do outro, ou cruzando o mesmo dia sem horário que os separe) contam como um só.
pain.episodes@v1Registros de dor. Vezes em que a pessoa registrou uma dor (com ou sem marcação de crise), iniciadas dentro do período.
Dias com crise
pain.days_with_crisis@v1Dias cobertos por uma dor marcada como crise, do início ao fim (ou até hoje, se ainda está em andamento).
Dias com crise incapacitante
pain.crisis_disabling@v1Dias com crise em que a resposta mais limitante do dia à pergunta sobre o que a pessoa tinha para fazer foi "Não consegui fazer".
Frequência da dor
pain.pct_recorded@v1Dias com dor divididos pelos dias com registro (com dor ou sem dor). Dias parciais e sem registro ficam fora da conta.
Intensidade média
pain.mean_intensity@v1Média da maior intensidade (0 a 10) de cada dia com dor que teve intensidade registrada. O n é o número de dias usados.
Intensidade máxima
pain.max_intensity@v1Maior intensidade registrada no período.
Dias por faixa de intensidade
pain.bands@v2Dias com dor pela maior intensidade do dia, nas faixas da escala do cartão: dói um pouco (1 e 2), ligeira (3 e 4), moderada (5 e 6), severa (7 e 8) e dói ainda mais (9 e 10; o 10 é só para a dor com vômito). Dias com dor sem intensidade registrada são contados à parte.
Versão anterior, que os relatórios antigos ainda citam
pain.bands@v1Dias por faixa de intensidade (regra antiga). Dias com dor pela maior intensidade do dia: leve de 1 a 3, moderada de 4 a 6, forte de 7 a 10. Dias com dor sem intensidade registrada são contados à parte.
Sequências
pain.streaks@v1Maior sequência de dias seguidos com dor e de dias seguidos sem dor. Um dia parcial ou sem registro interrompe a sequência.
Duração das crises
pain.crisis_duration@v2Média, em horas, das dores marcadas como crise, encerradas e com horário de início e de fim. Exige ao menos duas.
Versão anterior, que os relatórios antigos ainda citam
pain.crisis_duration@v1Duração das crises (regra antiga: todo registro de dor). Média, em horas, dos registros de dor encerrados que têm horário de início e de fim. Exige ao menos dois.
Duração da dor
pain.episode_duration@v1Média, em horas, dos registros de dor encerrados que têm horário de início e de fim. Exige ao menos dois.
Impacto no dia
pain.impact@v1Resposta mais limitante do dia à pergunta sobre o que a pessoa tinha para fazer, vinda do check-in da noite ou de uma dor encerrada no dia.
Local da dor
pain.locations@v3Número de registros de dor iniciados no período em que o local foi marcado em algum momento da dor. A dor pode mudar de lugar e cada lista de locais fica guardada com horário, então contam todos os locais registrados ao longo da dor, não só o último. À parte, em quantos registros o local estava na primeira marcação (o local do começo). Registros antigos, com uma lista só, contam essa lista como todos os locais e como a inicial.
2 versões anteriores, que os relatórios antigos ainda citam
pain.locations@v2Local da dor. Número de registros de dor iniciados no período em que o local foi marcado.
pain.locations@v1Local da dor. Número de registros de dor iniciados no período em que o local foi marcado.
Sintomas
pain.symptoms@v2Número de registros de dor iniciados no período em que o sintoma foi marcado.
Versão anterior, que os relatórios antigos ainda citam
pain.symptoms@v1Sintomas. Número de registros de dor iniciados no período em que o sintoma foi marcado.
Trajetória da dor
pain.trajectory@v2As intensidades de cada dor em ordem de horário: a primeira, a mais forte, a última e o caminho entre elas. Registros que se sobrepõem são uma dor só, com as leituras de todos eles. A forma sai das mudanças entre leituras seguidas: ficou igual, só subiu, só desceu, subiu e depois desceu, ou subiu e desceu mais de uma vez. Exige duas leituras na mesma dor. As horas até o pico contam do início (ou da primeira leitura, se o início não tem horário). A base são as dores iniciadas no período.
Versão anterior, que os relatórios antigos ainda citam
pain.trajectory@v1Trajetória da dor. As intensidades de cada registro de dor em ordem de horário: a primeira, a mais forte, a última e o caminho entre elas. A forma sai das mudanças entre leituras seguidas: ficou igual, só subiu, só desceu, subiu e depois desceu, ou subiu e desceu mais de uma vez. Exige duas leituras na mesma dor. As horas até o pico contam do início (ou da primeira leitura, se o início não tem horário).
Dentro da dor: cada evento
pain.within_events@v3Cada remédio, exercício e gatilho com horário dentro de uma dor (ligado a algum registro dela, ou entre o início e o fim) é lido sozinho, antes de qualquer agrupamento: a última intensidade registrada até 6 horas antes, a última nas 2 horas seguintes e, mais tarde, a maior registrada depois dessas 2 horas até o fim do dia do evento (o check-in da noite ligado à dor entra), para a piora que só aparece no fim do dia. Diz se a de depois, e a de mais tarde, é menor, igual ou maior que a de antes; sem a leitura, fica "sem leitura" e sai das contas. Evento sem horário não entra. Registros que se sobrepõem são uma dor só (a mesma conta das dores do relatório): o evento entra uma vez, com as leituras de todos eles. O exercício leva o tipo de treino e o esforço quando a pessoa informou. As dores lidas evento por evento são as longas (8 horas ou mais, ou de um dia para outro), entre as dores iniciadas no período. É o que as intensidades registradas mostram em volta do evento, não a resposta da pessoa sobre o efeito do remédio, que continua à parte. O relatório mostra e não recomenda: nada aqui sugere fazer, evitar, interromper ou trocar exercício; o que fazer com o que aparece é conversa com o médico.
2 versões anteriores, que os relatórios antigos ainda citam
pain.within_events@v2Dentro da dor: cada evento. Cada remédio, exercício e gatilho com horário dentro de um registro de dor (ligado a ele, ou entre o início e o fim) é lido sozinho, antes de qualquer agrupamento: a última intensidade registrada até 6 horas antes, a última nas 2 horas seguintes e, mais tarde, a maior registrada depois dessas 2 horas até o fim do dia do evento (o check-in da noite ligado à dor entra), para a piora que só aparece no fim do dia. Diz se a de depois, e a de mais tarde, é menor, igual ou maior que a de antes; sem a leitura, fica "sem leitura" e sai das contas. Evento sem horário não entra. O exercício leva o tipo de treino e o esforço (leve, moderado ou intenso) quando a pessoa informou. As dores lidas evento por evento no relatório são as longas (8 horas ou mais, ou de um dia para outro). É o que as intensidades registradas mostram em volta do evento, não a resposta da pessoa sobre o efeito do remédio, que continua à parte. O relatório mostra e não recomenda: nada aqui sugere fazer, evitar, interromper ou trocar exercício; o que fazer com o que aparece é conversa com o médico.
pain.within_events@v1Dentro da dor: cada evento. Cada remédio, exercício e gatilho com horário dentro de um registro de dor (ligado a ele, ou entre o início e o fim) é lido sozinho, antes de qualquer agrupamento: a última intensidade registrada até 6 horas antes e a última nas 2 horas seguintes. Se a de depois é menor, igual ou maior que a de antes. Sem uma das duas, fica "sem leitura" e sai das contas. Evento sem horário não entra. As dores lidas evento por evento no relatório são as longas (8 horas ou mais, ou de um dia para outro). É o que as intensidades registradas mostram em volta do evento, não a resposta da pessoa sobre o efeito do remédio, que continua à parte.
Dentro da dor: panorama por evento
pain.within_groups@v3Depois de ler cada ocorrência, junta as do mesmo remédio, da mesma atividade de exercício (yoga, musculação: o tipo de treino e o esforço aparecem em cada evento, mas não separam o grupo, porque cada fragmento ficava numa dor só) ou do mesmo gatilho (separando o "qual"), sem juntar tipos diferentes: em quantas vezes a intensidade ficou menor, igual ou maior nas 2 horas seguintes e, à parte, mais tarde no mesmo dia. Registros que se sobrepõem são uma dor só, e o evento conta uma vez. As porcentagens exigem 3 ocorrências com a leitura, em duas dores ou mais. O que apareceu numa dor só é mostrado como ocorrência, não como padrão. É associação observada, nunca causa, e não vira recomendação de fazer, evitar ou trocar exercício.
2 versões anteriores, que os relatórios antigos ainda citam
pain.within_groups@v2Dentro da dor: panorama por evento. Depois de ler cada ocorrência, junta as do mesmo remédio, do mesmo exercício (separando o tipo de treino e o esforço) ou do mesmo gatilho, sem juntar tipos diferentes: em quantas vezes a intensidade ficou menor, igual ou maior nas 2 horas seguintes e, à parte, mais tarde no mesmo dia. As porcentagens exigem 3 ocorrências com a leitura, em duas dores ou mais. O que apareceu numa dor só é mostrado como ocorrência, não como padrão. É associação observada, nunca causa, e não vira recomendação de fazer, evitar ou trocar exercício.
pain.within_groups@v1Dentro da dor: panorama por evento. Depois de ler cada ocorrência, junta as do mesmo remédio, do mesmo tipo de exercício (separando o tipo de treino) ou do mesmo gatilho, sem juntar tipos diferentes: em quantas vezes a intensidade ficou menor, igual ou maior nas 2 horas seguintes. A porcentagem exige 3 ocorrências com leitura antes e depois, em duas dores ou mais. O que apareceu numa dor só é mostrado como ocorrência, não como padrão. É associação observada, nunca causa.
Fases do período
Fases do período
phases.blocks@v2Períodos de até 62 dias são divididos em blocos de 7 dias a partir do início; períodos maiores, em meses do calendário. Cada bloco mostra dias com dor, dias com crise, dias com registro e intensidade média.
Versão anterior, que os relatórios antigos ainda citam
phases.blocks@v1Fases do período. Períodos de até 62 dias são divididos em blocos de 7 dias a partir do início; períodos maiores, em meses do calendário. Cada bloco mostra dias com dor, dias com registro e intensidade média.
Remédios
Dias com remédio
meds.days_with_dose@v2Dias com ao menos uma dose registrada. Remédio para a dor (tomado quando a dor vem) e preventivo são contados separadamente. O remédio cadastrado para a dor com a classe "Não é para a dor" (tomado junto, para o estômago, por exemplo) aparece na lista de remédios, mas fica fora dos dias e das doses de remédio para a dor, das combinações e do contador, e é contado à parte.
Versão anterior, que os relatórios antigos ainda citam
meds.days_with_dose@v1Dias com remédio. Dias com ao menos uma dose registrada. Remédio para a dor (tomado quando a dor vem) e preventivo são contados separadamente.
Doses
meds.doses@v2Número de doses registradas no período: por remédio, para a dor, preventivas e no total (cada registro de remédio é uma dose). A dose de cada remédio é a quantidade mais registrada (ex.: 50 mg). As doses de remédio com a classe "Não é para a dor" entram no total e são contadas à parte, fora das doses para a dor.
Versão anterior, que os relatórios antigos ainda citam
meds.doses@v1Doses. Número de doses registradas no período: por remédio, para a dor, preventivas e no total (cada registro de remédio é uma dose). A dose de cada remédio é a quantidade mais registrada (ex.: 50 mg).
Dias com remédio para a dor por classe
meds.days_by_class@v1Dias com ao menos uma dose de remédio para a dor de cada classe informada no cadastro (analgésico ou anti-inflamatório, triptano, combinado, ergótico, opioide, outro). Conta dias, não doses. Remédio sem classe ou com "não sei" entra só no total de dias com remédio para a dor. É só a contagem: o relatório não compara com nenhum limite nem qualifica o número; a referência geral sobre uso de remédio fica no blog e a conversa é com o médico.
Dias com remédio para a dor a cada 30 dias
meds.per_30_days@v1Dias com remédio para a dor divididos pelos dias do período e multiplicados por 30, para comparar períodos de tamanhos diferentes.
Dias com preventivo
meds.pct_days_preventive@v1Dias com ao menos uma dose de preventivo divididos pelos dias do período.
Combinações no mesmo dia
meds.combinations@v2Dias em que dois ou mais remédios para a dor diferentes foram tomados. A lista mostra as 5 combinações mais frequentes e diz quantas ficaram de fora. Desempate: mais dias; depois a combinação com mais remédios; depois a mais recente; por fim, a ordem alfabética.
Versão anterior, que os relatórios antigos ainda citam
meds.combinations@v1Combinações no mesmo dia. Dias em que dois ou mais remédios para a dor diferentes foram tomados.
Efeito do remédio para a dor
meds.efficacy@v2Depois de registrar uma dose de remédio para a dor (no tempo escolhido para cada remédio, ou no fechamento do dia), a própria pessoa responde se o remédio fez efeito: a dor passou, melhorou, não mudou ou piorou. Nada é deduzido das intensidades: dose sem resposta aparece como sem resposta. Alívio soma "a dor passou" e "melhorou".
Versão anterior, que os relatórios antigos ainda citam
meds.efficacy@v1Eficácia do remédio de crise (regra antiga, substituída pela v2). Para cada dose de crise com horário, comparava a última intensidade registrada nas 12 horas anteriores à dose com a primeira intensidade registrada entre 30 minutos e 24 horas depois. Menor: melhorou. Igual: igual. Maior: piorou. Dose sem horário ou sem as duas leituras ficava sem avaliação.
Gatilhos
Dias com o gatilho
triggers.exposure@v1Dias em que o gatilho foi marcado no check-in, num relato avulso ou como suspeito num registro de dor iniciado no dia. Também se informa quantos desses dias vieram só de marcações feitas durante a dor.
Dor no mesmo dia do gatilho
triggers.pain_same_day@v1Entre os dias com o gatilho e com registro, a porcentagem com dor no mesmo dia. Exige 3 dias.
Dor no dia seguinte ao gatilho
triggers.pain_next_day@v1Entre os dias com o gatilho cujo dia seguinte tem registro, a porcentagem com dor no dia seguinte. Exige 3 dias.
Referência geral
triggers.baseline@v1Porcentagem de dias com dor entre todos os dias com registro, e de dias seguintes com dor entre os pares de dias com registro, para comparar com cada gatilho.
Gatilho específico
triggers.specific@v1O "qual" de um gatilho (alimento: chocolate), quando se repete em dois dias ou mais. Para cada um, os dias marcados, quantos só dentro de um registro de dor, a porcentagem de dias com dor em até um dia depois (no mesmo dia ou no seguinte) e no dia seguinte, contra a mesma conta em todos os dias com registro. Exige 3 dias. É associação observada, nunca confirmação de causa: a vontade de comer algo pode ser um sinal de pródromo, não um gatilho.
Sinais antes e depois
Sinais antes e depois da dor
signs.phase@v2A pessoa marca o sintoma (nos check-ins ou em relatos); a fase sai do horário. Pródromo: sintoma até 48 horas antes do início de uma dor. Pósdromo: até 48 horas depois do fim. Sintoma durante a dor é sintoma da dor e não entra. Os horários são os do fuso da pessoa: dor sem horário vai do começo ao fim do dia local (de 00h00 a 23h59), e relato sem horário conta ao meio-dia local. A base são as dores iniciadas no período, com os registros sobrepostos fundidos numa dor só (a mesma conta das dores do relatório); no pósdromo, só as já encerradas. A porcentagem de dores com sinal é sobre essa base; a de cada sintoma é sobre as dores da própria fase, as que tiveram algum sinal antes (ou depois). À parte, os dias com sinal, entre os dias com registro (sem registro não é zero). Co-ocorrência, sem interpretação: nada aqui indica uma condição associada.
Versão anterior, que os relatórios antigos ainda citam
signs.phase@v1Sinais antes e depois da dor. A pessoa marca o sintoma (nos check-ins ou em relatos); a fase sai do horário. Pródromo: sintoma até 48 horas antes do início de um registro de dor. Pósdromo: até 48 horas depois do fim. Sintoma durante a dor é sintoma da dor e não entra. Conta os dias com sinal (entre os dias com registro; sem registro não é zero), os registros de dor que tiveram sinal antes ou depois e, para cada sintoma, em quantos registros ele apareceu. Co-ocorrência, sem interpretação: nada aqui indica uma condição associada.
O que são pródromo, pósdromo e gatilho
terms.phases_and_triggers@v1Pródromo: Sinais que aparecem até dois dias antes da dor, como cansaço, bocejos, pescoço tenso ou vontade de comer algo. São o aviso do corpo: reconhecer os seus ajuda a se preparar. Pósdromo: O que fica depois que a dor passa, por até dois dias: cansaço, dificuldade de concentrar, humor baixo. Também faz parte da crise. Gatilho: Algo que costuma vir antes da dor: um alimento, pouco sono, estresse. Varia de pessoa para pessoa e só se descobre observando. A vontade de comer algo pode ser um sinal de pródromo, não um gatilho.
Exercício
Exercício
exercise.day@v3Dia com exercício: dia com exercício registrado pela pessoa (no check-in da noite ou avulso, com ou sem minutos) ou com minutos de exercício no Apple Saúde. Os minutos vêm do Saúde quando houver; senão, são a soma dos exercícios registrados (a média só usa os dias com minutos). Dia sem exercício: dia com registro (com dor, sem dor ou parcial), com check-in da noite ou dado do Saúde e sem exercício registrado; dia sem registro nunca conta como dia sem exercício, e o dia em que o relatório é gerado só conta depois do check-in da noite.
2 versões anteriores, que os relatórios antigos ainda citam
exercise.day@v2Exercício. Dia com exercício: dia com exercício registrado pela pessoa (no check-in da noite ou avulso, com ou sem minutos) ou com minutos de exercício no Apple Saúde. Os minutos vêm do Saúde quando houver; senão, são a soma dos exercícios registrados (a média só usa os dias com minutos). Dia sem exercício: dia com check-in da noite ou com dado do Saúde e sem exercício registrado.
exercise.day@v1Exercício. Minutos de exercício do dia vindos do Apple Saúde quando houver; senão, a soma do check-in e dos relatos avulsos. Dia sem exercício: dia com check-in da noite ou com dado do Saúde e sem exercício registrado.
Exercício e dor
exercise.pain@v2Porcentagem de dias com dor no mesmo dia e no dia seguinte, para dias com e sem exercício. É uma comparação entre dois grupos de dias: cada grupo exige 5 dias com registro, e com menos fica como dados insuficientes.
Versão anterior, que os relatórios antigos ainda citam
exercise.pain@v1Exercício e dor. Porcentagem de dias com dor no mesmo dia e no dia seguinte, para dias com e sem exercício. Cada grupo exige 3 dias com registro.
Exercício por atividade
exercise.by_type@v2Para cada atividade de exercício (yoga, musculação, caminhada; o tipo de treino e o esforço não separam a atividade, para não fragmentar os dias), os dias em que foi feita e a porcentagem com dor no mesmo dia, no dia seguinte e dois dias depois, e com dor ou com crise marcada em algum dos dois dias seguintes. Cada porcentagem só usa dias com registro: nos dois dias seguintes, conta quando um deles teve dor (ou crise) e conta como "sem" só quando os dois têm registro. Exige 3 dias. A referência é a mesma conta em todos os dias com registro do período.
Versão anterior, que os relatórios antigos ainda citam
exercise.by_type@v1Exercício por tipo. Para cada tipo de exercício (separando o tipo de treino, como superiores ou inferiores na musculação), os dias em que foi feito e a porcentagem com dor no mesmo dia, no dia seguinte e dois dias depois, e com dor ou com crise marcada em algum dos dois dias seguintes. Cada porcentagem só usa dias com registro: nos dois dias seguintes, conta quando um deles teve dor (ou crise) e conta como "sem" só quando os dois têm registro. Exige 3 dias. A referência é a mesma conta em todos os dias com registro do período.
Sono e saturação
Sono e dor
sleep.pain@v2Média de sono das noites antes de dias com dor e antes de dias sem dor, e porcentagem de dias com dor depois de noites com menos de 6 horas e depois das outras noites. São comparações entre dois grupos: cada grupo exige 5 noites, e com menos fica como dados insuficientes.
Versão anterior, que os relatórios antigos ainda citam
sleep.pain@v1Sono e dor. Média de sono das noites antes de dias com dor e antes de dias sem dor, e porcentagem de dias com dor depois de noites com menos de 6 horas. Cada grupo exige 3 noites.
Sono
sleep.night@v1Horas de sono da noite que antecede o dia: medidas pelo relógio ou iPhone quando houver, ou a correção feita pela pessoa no check-in; senão, o informado no check-in da manhã. A noite é a sessão de sono que termina entre 3 h e 12 h do dia; cochilos ficam de fora. Noites medidas e noites informadas não se somam: a noite informada é a que não tem medida, então, com o relógio em todas as noites, nenhuma conta como informada.
Qualidade do sono
sleep.quality@v1Média da nota de 1 (péssimo) a 5 (ótimo) dada no check-in da manhã.
Saturação de oxigênio
spo2.daily@v1SpO2 mínima e média do dia pelo Apple Saúde. Noites com mínima abaixo de 90% são contadas à parte.
Saturação de oxigênio
spo2.night@v1SpO2 medida pelo relógio só durante a noite de sono. A mais baixa de cada noite ignora uma leitura isolada: é o valor abaixo do qual ficam as 10% leituras mais baixas (com menos de 10 leituras, a mínima). Noites em que esse valor ficou abaixo de 90% são contadas à parte.
Ciclo menstrual
Dias com escape
cycle.spotting@v1Dias do período com fluxo "escape" (só manchas) registrado no ciclo. O escape não inicia menstruação, então fica fora da janela em torno dela: a dor nesses dias é comparada com a dos outros dias com registro (com dor ou sem dor), com a mesma amostra mínima das outras comparações. Serve a quem usa um método que muda ou interrompe o sangramento.
Ciclo e dor
cycle.perimenstrual_window@v2Janela perimenstrual: de 2 dias antes a 3 dias depois do início de cada menstruação. Compara a porcentagem de dias com dor dentro e fora da janela. Cada grupo exige 5 dias com registro, e com menos fica como dados insuficientes.
Versão anterior, que os relatórios antigos ainda citam
cycle.perimenstrual_window@v1Ciclo e dor. Janela perimenstrual: de 2 dias antes a 3 dias depois do início de cada menstruação. Compara a porcentagem de dias com dor dentro e fora da janela. Cada grupo exige 3 dias com registro.
Duração do ciclo
cycle.prediction@v1Média dos últimos 6 intervalos entre inícios de menstruação, ignorando intervalos fora de 15 a 60 dias.
Clima
Queda de pressão
weather.pressure_drop@v2Pressão média ao nível do mar das horas do dia, na previsão de curto prazo do MET Norway (instituto meteorológico público da Noruega) para a cidade da pessoa, gravada logo depois da meia-noite; o dia só entra se a previsão cobre ao menos 18 das 24 horas. Dia de queda: 5 hPa ou mais abaixo do dia anterior gravado, da mesma fonte e na mesma cidade. Sem esse dia anterior, a variação fica sem valor e o dia fica fora da comparação: nunca conta como zero. Compara a porcentagem de dias com dor com e sem queda. Cada grupo exige 3 dias com registro. Dias de antes da troca de fonte seguem a v1.
Versão anterior, que os relatórios antigos ainda citam
weather.pressure_drop@v1Queda de pressão. Dia com pressão média 5 hPa ou mais abaixo da do dia anterior. Compara a porcentagem de dias com dor com e sem queda. Cada grupo exige 3 dias com registro.
Temperatura
weather.temperature@v2Temperatura média das horas do dia, na previsão de curto prazo do MET Norway para a cidade da pessoa, gravada logo depois da meia-noite. Dia sem clima gravado fica de fora. Compara dias com dor e sem dor; cada grupo exige 3 dias. Dias de antes da troca de fonte seguem a v1.
Versão anterior, que os relatórios antigos ainda citam
weather.temperature@v1Temperatura. Temperatura média do dia na cidade da pessoa. Compara dias com dor e sem dor; cada grupo exige 3 dias.
Notas
Das suas notas
notes.themes@v1Só com a permissão da pessoa. A IA lê as notas do período (com o número do dia, sem datas e com e-mails, telefones e nomes próprios trocados por marcadores) e só agrupa as notas em temas. Os temas são conferidos por regra (sem nome de pessoa, sem número, sem termo de diagnóstico ou de causa, só dias que têm nota, pelo menos dois dias). Os números de cada tema são calculados pelo app: dias com o tema e a porcentagem com dor no dia, no seguinte e dois dias depois, e com crise marcada em algum dos dois dias seguintes. Cada porcentagem só usa dias com registro e exige 3 dias. A referência é a mesma conta em todos os dias do período.
Pessoa
Faixa etária
person.age_band@v1Calculada pelo ano de nascimento informado em Ajustes; só a faixa entra no relatório, nunca a idade exata. Sem o ano, nada aparece.
Texto e perguntas
Limites usados nas regras
threshold@v1Valores fixos usados nas regras acima, expostos como fatos para que o texto nunca precise digitar números.
Texto automático
narrative.fixed@v1Quando o texto da IA não passa na revisão automática, nem na nova tentativa com o trecho recusado devolvido a ela, ou quando a IA falha ao responder, o resumo é montado pelo app só com os números calculados (dias com dor, crises, intensidade, dias com remédio para a dor), sem interpretação, e as perguntas para o médico saem dos modelos do app como estão. Texto recusado nunca é publicado.
Perguntas para o médico
questions@v1Geradas por regras a partir dos fatos (por exemplo, muitos dias com remédio para a dor, gatilho com dor bem acima da referência, dor concentrada perto da menstruação). A IA só reescreve em linguagem natural.
O texto de IA
O que o modelo nunca pode escrever
O texto do relatório é conferido por regras antes de aparecer. Entre as travas, uma lista de termos proibidos: diagnóstico, afirmação de causa e orientação de tratamento. Alguns deles:
- cronica
- cronico
- diagnostico
- diagnostica
- diagnosticar
- transtorno
- sindrome
- doenca
- patologia
- apneia
- insonia
- depressao
- rebote
- abuso de medicamento
- e mais 70
Nenhum número digitado
O modelo escreve {{pain.days_with_pain}}, nunca “9”. Dígito solto, número por extenso ou “%” fora de marcador recusam o texto. O nome “SpO2” não conta como número, e o “%” repetido logo depois de uma porcentagem é tirado antes de conferir.
Nenhum fato insuficiente
Um marcador de fato com amostra abaixo do mínimo recusa o texto: o modelo não pode comentar o que não há.
Recusado nunca sai
O texto recusado volta ao modelo com o trecho que não passou. Se falhar de novo, o resumo é um texto automático, montado pelo app só com os números.
Gatilhos pelo código
A seção de gatilhos não é da IA: o código a escreve sempre com a referência ao lado, e frase da IA que cite um gatilho fora dela sai antes da validação.
Sem dado pessoal
Nome, e-mail, notas, datas reais e localização nunca vão ao modelo. As notas só vão com permissão, mascaradas, e só para agrupar assuntos.
Limite padrão: 3 textos de IA por pessoa por semana, e só conta o texto entregue: recusado ou falha da IA não gasta. Os números saem sempre. O relatório por dentro.
Veja as regras aplicadas num relatório
Um mês de dados fictícios, com todas as seções, a tabela dia a dia e o apêndice que cita cada regra desta página.
O app não substitui avaliação médica. Ele organiza o que você viveu para você entender melhor a sua dor e, se quiser, conversar melhor com quem cuida de você.