Guias de Implementação (IGs) em desenvolvimento
Os guias de implementação são desenvolvidos pelas equipas de trabalho com recurso ao site github. É este o local onde as equipas trabalham em conjunto e onde as questões e dúvidas são respondidas. Com o sistema de deploy, a cada nova modificação de conteúdo, um exemplo do site do IG é criado para validação da alteração e como montra do atual estado do IG. Os IGs podem então ser visto no Github do HL7 Portugal em https://github.com/hl7-pt
A lista pode ser vista aqui:
| Título | Repositório | Página web | Descrição |
|---|---|---|---|
| Reacções adversas e alergias | https://github.com/hl7-pt/adr-ig | https://hl7-pt.github.io/adr-ig/ | Especificação para notificar alergias/intolerâncias e potenciais reacções adversas a medicamentos |
| Noticia Nascimento | https://github.com/hl7-pt/obs-neonat-ig | https://hl7-pt.github.io/obs-neonat-ig/ | Notificação de uma noticia de nascimento |
| Saúde Comunitária [P5] | https://github.com/hl7-pt/community-health-ig | https://hl7-pt.github.io/community-health-ig/ | |
| Gestão de doenças respiratórias [FMUP] | https://github.com/hl7-pt/resp-ig | https://hl7-pt.github.io/resp-ig/ | |
| Portuguese core | https://github.com/hl7-pt/core | https://hl7-pt.github.io/core/ | |
| ET RSE em formato IG | https://github.com/hl7-pt/draft-et-rse | ||
| PEM-H em formato IG | https://github.com/hl7-pt/pem-h | https://hl7-pt.github.io/pem-h/ | |
| Reabilitação Pulmonar [FMUP] | https://github.com/hl7-pt/pulmonar-rehab | https://hl7-pt.github.io/pulmonar-rehab/ |
Procedimento para publicação de especificações técnicas
O HL7 Portugal tem de momento dois âmbitos na criação de especificações: de projecto e nacionais.
1.Âmbito de Projeto: Especificações técnicas criadas num contexto específico, geralmente preconizadas por uma entidade terceira. O HL7 Portugal assume aqui um vínculo que pode ser uma simples revisão da especificação de modo geral, ou apenas colocar no site a especificação de forma a aumentar a sua propagação.
2. Âmbito Nacional: Especificações criadas dentro do HL7 Portugal e promovidas pela associação. Estas especificações têm como objectivo atender às necessidades nacionais, para ser usada a nível nacional e não apenas com um foco local como o âmbito de projecto.
Embora haja essa distinção, uma especificação de projeto pode, eventualmente, evoluir para uma especificação de âmbito nacional, seja através de uma expansão ou atualização, ou mesmo pela criação de uma nova especificação baseada na anterior.
Ciclo de Vida de uma Especificação
- Proposta e Aprovação do Projeto:
-
- Qualquer membro da HL7 Portugal pode propor um projeto para desenvolver uma especificação.
- A proposta é submetida ao Comité Técnico da HL7 Portugal, que pode aprová-la, rejeitá-la ou solicitar informações adicionais. O resultado é registado na ata da reunião.
- Se aprovada:
- O projeto é criado e documentado no GitHub da HL7 Portugal;
- Uma equipa de projeto é formada, com facilitador(es) nomeado(s) para coordenar o processo.
- Desenvolvimento:
- O desenvolvimento da especificação ocorre num ambiente colaborativo, de momento, utilizando o GitHub para gestão e acompanhamento.
- A equipa do projeto é responsável por garantir que o processo de desenvolvimento siga os princípios de abertura e consenso.
- O progresso do projeto é regularmente relatado ao Comité Técnico ou direção.
- Votação e Apreciação Pública:
- Quando o projeto estiver suficientemente maduro, os facilitadores solicitam a abertura de uma votação pública para recolha de comentários, sendo estes comentários públicos.
- O comité técnico irá avaliar o estado e maturidade do projeto antes de abrir a votação.
- A votação tem um prazo mínimo de 15 dias, durante o qual qualquer pessoa pode comentar a especificação, utilizando o sistema GitHub Issues ou enviando comentários por email, que são posteriormente copiados para o GitHub.
- Ao fim da votação, os membros da HL7 Portugal podem votar a favor, contra (justificando com comentários) ou abster-se.
- A especificação é aprovada se houver pelo menos 10 votos e uma maioria de 2/3 dos votos não abstencionistas for alcançada.
- Em caso de voto negativo, a responsabilidade de avaliação retorna ao comité técnico, que informa a equipa do projeto para atualizar o standard.
Em caso de voto positivo, o processo continua da seguinte forma: o comité técnico informa a equipa do projeto, que processará os comentários.
- Reconciliação dos Comentários:
- Após o período de apreciação pública, a equipa de projeto trabalha na reconciliação dos comentários recebidos, incorporando as sugestões e corrigindo eventuais problemas.
- Os facilitadores acompanham esse processo, assegurando que as alterações estejam ligadas aos comentários para facilitar a sua rastreabilidade.
- Publicação:
- Após a fase de reconciliação, o Comité Técnico avalia a qualidade final da especificação e decide se ela está pronta para ser publicada.
- Se aprovada, a especificação é oficialmente publicada no repositório de publicações da HL7 Portugal, atualmente site hl7.pt.
- O Comité Técnico é responsável por gerir o processo de publicação.