Pular para o conteúdo

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.

day.status@v1day.status@v2relatórios antigosregra atual

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

1

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.

2

Narrativa por IA, se você quiser

O modelo recebe só os fatos e escreve com marcadores no lugar de qualquer número.

3

Validação

Dígito solto, número por extenso, marcador inexistente ou termo proibido: o texto é recusado. Até duas tentativas; depois, só números.

4

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@v1

    Nú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@v3

    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. 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@v2

      Dia 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@v1

      Dia 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@v2

    Dias 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@v1

      Dias 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@v4

    Dores 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@v3

      Crises. 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@v2

      Crises. Registros de dor que a própria pessoa marcou como crise, iniciados dentro do período. Nada é deduzido do remédio tomado.

    • pain.crises@v1

      Crises (regra antiga: todo registro de dor). Registros de dor iniciados dentro do período, todos contados como crise.

  • Dores

    pain.episodes@v3

    Dores 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@v2

      Registros 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@v1

      Registros 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@v1

    Dias 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@v1

    Dias 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@v1

    Dias 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@v1

    Mé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@v1

    Maior intensidade registrada no período.

  • Dias por faixa de intensidade

    pain.bands@v2

    Dias 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@v1

      Dias 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@v1

    Maior 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@v2

    Mé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@v1

      Duraçã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@v1

    Mé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@v1

    Resposta 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@v3

    Nú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@v2

      Local da dor. Número de registros de dor iniciados no período em que o local foi marcado.

    • pain.locations@v1

      Local da dor. Número de registros de dor iniciados no período em que o local foi marcado.

  • Sintomas

    pain.symptoms@v2

    Nú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@v1

      Sintomas. Número de registros de dor iniciados no período em que o sintoma foi marcado.

  • Trajetória da dor

    pain.trajectory@v2

    As 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@v1

      Trajetó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@v3

    Cada 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@v2

      Dentro 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@v1

      Dentro 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@v3

    Depois 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@v2

      Dentro 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@v1

      Dentro 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@v2

    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 crise, dias com registro e intensidade média.

    Versão anterior, que os relatórios antigos ainda citam
    • phases.blocks@v1

      Fases 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@v2

    Dias 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@v1

      Dias 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@v2

    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). 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@v1

      Doses. 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@v1

    Dias 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@v1

    Dias 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@v1

    Dias com ao menos uma dose de preventivo divididos pelos dias do período.

  • Combinações no mesmo dia

    meds.combinations@v2

    Dias 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@v1

      Combinaçõ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@v2

    Depois 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@v1

      Eficá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@v1

    Dias 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@v1

    Entre 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@v1

    Entre 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@v1

    Porcentagem 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@v1

    O "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@v2

    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 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@v1

      Sinais 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@v1

    Pró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@v3

    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 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@v2

      Exercí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@v1

      Exercí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@v2

    Porcentagem 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@v1

      Exercí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@v2

    Para 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@v1

      Exercí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@v2

    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 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@v1

      Sono 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@v1

    Horas 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@v1

    Média da nota de 1 (péssimo) a 5 (ótimo) dada no check-in da manhã.

  • Saturação de oxigênio

    spo2.daily@v1

    SpO2 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@v1

    SpO2 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@v1

    Dias 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@v2

    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 5 dias com registro, e com menos fica como dados insuficientes.

    Versão anterior, que os relatórios antigos ainda citam
    • cycle.perimenstrual_window@v1

      Ciclo 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@v1

    Mé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@v2

    Pressã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@v1

      Queda 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@v2

    Temperatura 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@v1

      Temperatura. 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@v1

    Só 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@v1

    Calculada 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@v1

    Valores fixos usados nas regras acima, expostos como fatos para que o texto nunca precise digitar números.

  • Texto automático

    narrative.fixed@v1

    Quando 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@v1

    Geradas 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ê.