dsh-medrec-qc 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 0.2.4
+
+- Add a demo card to the README: one terminal shot of this plugin's real output
+  over its own test fixture, plus the DSH Market badge.
+
+  The card is generated by running this repository's check core over a committed
+  fixture and rendering the report it returned, so the findings, rule ids, cited
+  documents and "not obtained" notes are the plugin's own output rather than an
+  artist's impression. In a family whose claim is that it never fabricates a
+  citation, a hand-drawn screenshot would undercut the thing being demonstrated.
+
+  Added to all five READMEs together, which `check:readmes` requires.
+
+
+## 0.2.3
+
+- Rework the README first screen. The H1 now names what the plugin checks rather
+  than repeating the package name, and a question-and-answer table and a standards
+  table come before the boundary paragraph.
+
+  The substance is unchanged and the boundary paragraph is verbatim: in a
+  compliance tool that paragraph is what stops a wrong "pass" being read as
+  approval, so it moved rather than shrank. What changed is the order - a reader
+  or an extractor previously met eleven badges, an install command and a
+  disclaimer before learning what the plugin does. The Q&A rows are derived from
+  each plugin's own rules and the standards table from the rule pack's
+  `document`/`number` fields, so no answer and no standard is hand-typed.
+
+  All five languages were restructured together; `check:readmes` holds them to the
+  same section count, install command and configuration keys.
+
 ## 0.2.2
 
 - Ship `CHANGELOG.md` and `SECURITY.md` inside the package. `files` is an

package/README-es.md

@@ -1,4 +1,34 @@
-# dsh-medrec-qc
+# dsh-medrec-qc — Comprobación de forma y avisos de contradicción lógica de la portada del historial clínico de hospitalización
+
+[![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
+
+`dsh-medrec-qc` lee una exportación de la portada del historial clínico de hospitalización (病案首页), una fila por alta, con el juego de columnas de la exportación de evaluación nacional, de la estadística sanitaria o de una exportación local del hospital, y comprueba la completitud formal, la aritmética interna y la forma de codificación de esa misma exportación: que cada columna obligatoria tenga contenido o el marcador `-`, que las horas de ingreso y de alta estén presentes, sean precisas al minuto y no estén invertidas, que la estancia declarada coincida con las dos fechas, que el nombre y el código del diagnóstico principal y los de la operación principal se rellenen juntos, que los códigos tengan la forma escrita que configura el paquete de reglas, que las tres columnas de firma reflejen la responsabilidad médica de tres niveles, que el modo de alta sea uno de los códigos definidos, que la edad y los pesos neonatales usen las formas prescritas, que el número de otros diagnósticos no supere el techo configurado, y que se señalen para revisión humana un diagnóstico incompatible con el sexo registrado o dos horas discordantes en un alta por fallecimiento.
+
+## Cómo se ve la salida
+
+![Terminal demo of dsh-medrec-qc: real output over its MR-009 fixture](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-demo.png)
+
+Salida real de este plugin sobre su propio fixture de prueba `MR-009` — no es un montaje. El paquete de reglas no inventa citas, así que cada hallazgo nombra la cláusula aplicada y advierte que su texto no se obtuvo.
+
+## Qué responde
+
+| Usted pregunta | Qué responde |
+|---|---|
+| Una columna obligatoria está vacía, pero escribí `-` en ella. ¿Se informa de eso? | No. `MR-001` considera un `-` aislado la marca de «no hay nada que registrar» e informa solo de las columnas realmente vacías. Comprueba que la columna obligatoria tenga contenido, no que el contenido sea correcto, y su gravedad queda limitada a `warn` porque el anexo que cita es un PDF que este entorno no puede descodificar. Ese mismo `-` sigue contando como firma ausente en `MR-009`. |
+| La hora de ingreso figura como una fecha sin hora ni minuto, y en una fila la hora de alta es anterior a la de ingreso. | `MR-002` informa de un `入院时间` o `出院时间` que solo se puede leer hasta el día, porque el tiempo registrado debe ser preciso al minuto, y también informa de un valor que no puede analizar como fecha y hora. `MR-003` compara el orden literal de los dos campos e informa de la fila en la que la hora de alta va primero. Ambas trabajan sobre los valores literales y ninguna decide cuál de las dos horas es la verdadera. |
+| La portada dice `5` días, pero las fechas son ingreso el 12 de junio y alta el 15 de junio. | `MR-004` recalcula los días como fecha de alta menos fecha de ingreso e informa de la fila cuando el `实际住院天数` declarado no coincide; el ingreso y el alta el mismo día cuentan como `0` días, y un valor que no sea un número entero de días también se informa. Solo compara esos tres valores guardados y no decide cuál de ellos está mal. |
+| `主要诊断名称` está relleno y `主要诊断编码` vacío, y otra fila trae un código de forma extraña. | `MR-005` exige que ambos se rellenen juntos y nombra el que falta; comprueba únicamente que los dos existan, no que el código corresponda al diagnóstico. `MR-006` contrasta después el código con la forma escrita configurada en el paquete y no verifica que ese código exista en ninguna versión del directorio de clasificación. |
+| Un lote no trae ningún registro de operación. ¿Las reglas de operación pasan en silencio? | No. `MR-007` se declara en `skipped` con el motivo de que el material no contiene registros de operación y la comprobación de pareja no procede, en lugar de pasar en silencio. Cuando una fila sí registra una operación, la regla exige que `主要手术名称` y `主要手术编码` se rellenen juntos, y `MR-008` comprueba solo la forma escrita del código de operación. |
+| El diagnóstico principal de un paciente varón es una afección relacionada con el embarazo. ¿Bloquea la exportación? | `MR-014` lo informa como una diferencia de nivel `warn` para que la confirme una persona, nunca como un bloqueo: los documentos sanitarios no contienen ninguna cláusula que haga incompatible un diagnóstico con el sexo registrado, y el detalle publicado de ese tipo de regla del seguro médico no cubre el capítulo de embarazo, parto y puerperio y admite excepciones de justificación clínica. Confirme con el clínico si el error está en el sexo o en el diagnóstico. |
+
+## Normas que sigue
+
+| Documento | Número | Reglas que lo citan |
+|---|---|---|
+| 《住院病案首页数据质量管理与控制指标（2016版）》 | 国卫办医发〔2016〕24号 | MR-001 |
+| 《住院病案首页数据填写质量规范（暂行）》 | 国卫办医发〔2016〕24号 | MR-002, MR-003, MR-005, MR-006, MR-007, MR-008, MR-013, MR-015 |
+| 《卫生部关于修订住院病案首页的通知》 | 卫医政发〔2011〕84号 | MR-004, MR-009, MR-010, MR-011, MR-012 |
+| 国家医疗保障局"两库"知识点（诊断与患者性别不符） | 国家医疗保障局公告（第二十一批） | MR-014 |
 
 **Boundary:** this plugin checks the **front sheet of the inpatient medical record (病案首页)** — the
 one-page discharge summary coders and the national assessment system read — for form completeness,

package/README-hi.md

@@ -1,4 +1,34 @@
-# dsh-medrec-qc
+# dsh-medrec-qc — भर्ती रोगी के मेडिकल रिकॉर्ड की फ्रंट शीट की रूप-जाँच और तार्किक विरोधाभास की चेतावनी
+
+[![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
+
+`dsh-medrec-qc` भर्ती रोगी के मेडिकल रिकॉर्ड की फ्रंट शीट (病案首页) के एक्सपोर्ट को पढ़ता है, जिसमें प्रत्येक डिस्चार्ज की एक पंक्ति होती है और कॉलम-सेट राष्ट्रीय मूल्यांकन एक्सपोर्ट, स्वास्थ्य सांख्यिकी एक्सपोर्ट या अस्पताल के स्थानीय एक्सपोर्ट का हो सकता है, और उसी एक्सपोर्ट की रूप-पूर्णता, आंतरिक अंकगणित तथा कोडन-रूप की जाँच करता है: हर अनिवार्य कॉलम में सामग्री या `-` चिह्न हो, भर्ती और डिस्चार्ज का समय दर्ज हो, मिनट तक सटीक हो और उलटा न हो, दर्ज ठहराव-अवधि दोनों तारीख़ों से मेल खाए, मुख्य निदान का नाम और कोड तथा मुख्य ऑपरेशन का नाम और कोड साथ-साथ भरे गए हों, कोड उस लिखित रूप में हों जो नियम-पैक कॉन्फ़िगर करता है, तीन हस्ताक्षर कॉलम त्रि-स्तरीय चिकित्सक उत्तरदायित्व दर्शाते हों, डिस्चार्ज मोड निर्धारित कोड में से हो, आयु और नवजात का वज़न निर्धारित रूपों में हों, अन्य निदानों की संख्या कॉन्फ़िगर की गई सीमा के भीतर हो, और दर्ज लिंग से असंगत निदान अथवा मृत्यु-डिस्चार्ज में परस्पर भिन्न दो समय मानवीय समीक्षा के लिए सामने लाए जाएँ।
+
+## आउटपुट कैसा दिखता है
+
+![Terminal demo of dsh-medrec-qc: real output over its MR-009 fixture](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-demo.png)
+
+इस प्लगइन का अपने ही `MR-009` टेस्ट फ़िक्स्चर पर वास्तविक आउटपुट — कोई नकली चित्र नहीं। नियम-पैक उद्धरण नहीं गढ़ता, इसलिए हर निष्कर्ष लागू किए गए खंड का नाम और यह भी बताता है कि उसका मूल पाठ इस बार प्राप्त नहीं हुआ।
+
+## यह किन सवालों का जवाब देता है
+
+| आपका सवाल | इसका जवाब |
+|---|---|
+| कोई अनिवार्य कॉलम खाली छूटा है, पर मैंने उसमें `-` लिखा है। क्या यह दर्ज होगा? | नहीं। `MR-001` अकेले `-` को «यहाँ दर्ज करने योग्य कुछ नहीं» का चिह्न मानता है और केवल सचमुच खाली छूटे कॉलम दर्ज करता है। यह देखता है कि अनिवार्य कॉलम में सामग्री है, यह नहीं कि सामग्री सही है, और इसकी गंभीरता `warn` तक सीमित है क्योंकि यह जिस अनुलग्नक का हवाला देता है वह ऐसा PDF है जिसे यह वातावरण डिकोड नहीं कर सकता। वही `-` `MR-009` में हस्ताक्षर अनुपस्थित ही गिना जाता है। |
+| भर्ती का समय केवल तारीख़ के रूप में लिखा है, घंटा-मिनट नहीं, और एक पंक्ति में डिस्चार्ज का समय भर्ती से पहले है। | `MR-002` ऐसे `入院时间` या `出院时间` को दर्ज करता है जो केवल दिन तक पढ़ा जा सके, क्योंकि दर्ज समय मिनट तक सटीक होना चाहिए, और ऐसा मान भी दर्ज करता है जिसे तारीख़ और समय के रूप में पढ़ा ही न जा सके। `MR-003` दोनों फ़ील्ड के शाब्दिक क्रम की तुलना करके उस पंक्ति को दर्ज करता है जिसमें डिस्चार्ज का समय पहले आता है। दोनों केवल शाब्दिक मानों पर काम करते हैं और कोई यह नहीं तय करता कि सच्चा समय कौन-सा है। |
+| फ्रंट शीट में `5` दिन लिखा है, पर तारीख़ें 12 जून को भर्ती और 15 जून को डिस्चार्ज हैं। | `MR-004` दिनों को «डिस्चार्ज की तारीख़ घटा भर्ती की तारीख़» से दोबारा जोड़ता है और जिस पंक्ति में दर्ज `实际住院天数` मेल न खाए उसे दर्ज करता है; उसी दिन भर्ती और डिस्चार्ज `0` दिन गिना जाता है, और पूर्णांक दिन न होने वाला मान भी दर्ज होता है। यह केवल उन तीन दर्ज मानों की तुलना करता है और यह नहीं तय करता कि उनमें कौन ग़लत है। |
+| `主要诊断名称` भरा है पर `主要诊断编码` खाली है, और किसी अन्य पंक्ति में कोड का रूप विचित्र है। | `MR-005` दोनों को साथ भरे जाने की अपेक्षा करता है और बताता है कि कौन-सा छूटा है; यह केवल यह देखता है कि दोनों मौजूद हैं, यह नहीं कि कोड निदान से मेल खाता है। इसके बाद `MR-006` कोड को नियम-पैक में कॉन्फ़िगर किए गए लिखित रूप से मिलाता है और यह नहीं जाँचता कि वह कोड वर्गीकरण निर्देशिका के किसी संस्करण में मौजूद है या नहीं। |
+| किसी बैच में ऑपरेशन का कोई रिकॉर्ड ही नहीं है। क्या ऑपरेशन के नियम चुपचाप पास हो जाते हैं? | नहीं। `MR-007` चुपचाप पास होने के बजाय `skipped` में यह कारण दर्ज करता है कि सामग्री में ऑपरेशन का कोई रिकॉर्ड नहीं है और जोड़ी-जाँच लागू नहीं होती। जब किसी पंक्ति में ऑपरेशन दर्ज हो, तो नियम `主要手术名称` और `主要手术编码` दोनों को साथ भरे जाने की अपेक्षा करता है, और `MR-008` केवल ऑपरेशन कोड का लिखित रूप देखता है। |
+| एक पुरुष रोगी का मुख्य निदान गर्भावस्था से जुड़ी स्थिति है। क्या इससे एक्सपोर्ट रुक जाएगा? | `MR-014` इसे मानवीय पुष्टि के लिए `warn` स्तर के अंतर के रूप में दर्ज करता है, कभी अवरोध के रूप में नहीं: स्वास्थ्य-पक्ष के दस्तावेज़ों में ऐसा कोई खंड नहीं है जो किसी निदान को दर्ज लिंग से असंगत ठहराए, और चिकित्सा-बीमा के उस नियम-प्रकार का प्रकाशित विवरण गर्भावस्था, प्रसव और प्रसवोत्तर अध्याय को समाहित नहीं करता तथा नैदानिक औचित्य के अपवाद की अनुमति देता है। चिकित्सक से पुष्टि करें कि ग़लती लिंग में है या निदान में। |
+
+## यह किन मानकों पर आधारित है
+
+| दस्तावेज़ | संख्यांक | इन्हें उद्धृत करने वाले नियम |
+|---|---|---|
+| 《住院病案首页数据质量管理与控制指标（2016版）》 | 国卫办医发〔2016〕24号 | MR-001 |
+| 《住院病案首页数据填写质量规范（暂行）》 | 国卫办医发〔2016〕24号 | MR-002, MR-003, MR-005, MR-006, MR-007, MR-008, MR-013, MR-015 |
+| 《卫生部关于修订住院病案首页的通知》 | 卫医政发〔2011〕84号 | MR-004, MR-009, MR-010, MR-011, MR-012 |
+| 国家医疗保障局"两库"知识点（诊断与患者性别不符） | 国家医疗保障局公告（第二十一批） | MR-014 |
 
 **Boundary:** this plugin checks the **front sheet of the inpatient medical record (病案首页)** — the
 one-page discharge summary coders and the national assessment system read — for form completeness,

package/README-pt.md

@@ -1,4 +1,34 @@
-# dsh-medrec-qc
+# dsh-medrec-qc — Verificação de forma e avisos de contradição lógica da folha de rosto do registo clínico de internamento
+
+[![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
+
+`dsh-medrec-qc` lê uma exportação da folha de rosto do registo clínico de internamento (病案首页), uma linha por alta, com o conjunto de colunas da exportação de avaliação nacional, da estatística sanitária ou de uma exportação local do hospital, e verifica a completude formal, a aritmética interna e a forma de codificação dessa mesma exportação: que cada coluna obrigatória tenha conteúdo ou o marcador `-`, que as horas de admissão e de alta estejam preenchidas, sejam precisas ao minuto e não estejam invertidas, que o tempo de internamento declarado coincida com as duas datas, que o nome e o código do diagnóstico principal e os da operação principal sejam preenchidos em conjunto, que os códigos tenham a forma escrita que o pacote de regras configura, que as três colunas de assinatura reflitam a responsabilidade médica de três níveis, que o modo de alta seja um dos códigos definidos, que a idade e os pesos neonatais usem as formas prescritas, que o número de outros diagnósticos não exceda o limite configurado, e que sejam assinalados para revisão humana um diagnóstico incompatível com o sexo registado ou duas horas discordantes numa alta por óbito.
+
+## Como é a saída
+
+![Terminal demo of dsh-medrec-qc: real output over its MR-009 fixture](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-demo.png)
+
+Saída real deste plugin sobre o seu próprio fixture de teste `MR-009` — não é uma simulação. O pacote de regras não inventa citações, por isso cada achado nomeia a cláusula aplicada e avisa que o seu texto não foi obtido.
+
+## O que ele responde
+
+| Você pergunta | O que ele responde |
+|---|---|
+| Uma coluna obrigatória ficou vazia, mas escrevi `-` nela. Isso é reportado? | Não. `MR-001` considera um `-` isolado a marca de «não há nada a registar» e reporta apenas as colunas realmente vazias. Verifica que a coluna obrigatória tem conteúdo, não que o conteúdo está correto, e a sua gravidade fica limitada a `warn` porque o anexo que cita é um PDF que este ambiente não consegue descodificar. Esse mesmo `-` continua a contar como assinatura em falta em `MR-009`. |
+| A hora de admissão está escrita só com a data, sem hora nem minuto, e numa linha a hora de alta é anterior à da admissão. | `MR-002` reporta um `入院时间` ou `出院时间` que só pode ser lido até ao dia, porque o tempo registado deve ser preciso ao minuto, e reporta também um valor que não consegue analisar como data e hora. `MR-003` compara a ordem literal dos dois campos e reporta a linha em que a hora de alta vem primeiro. Ambas trabalham sobre os valores literais e nenhuma decide qual das duas horas é a verdadeira. |
+| A folha de rosto diz `5` dias, mas as datas são admissão a 12 de junho e alta a 15 de junho. | `MR-004` recalcula os dias como data de alta menos data de admissão e reporta a linha quando o `实际住院天数` declarado não coincide; admissão e alta no mesmo dia contam `0` dias, e um valor que não seja um número inteiro de dias também é reportado. Compara apenas esses três valores guardados e não decide qual deles está errado. |
+| `主要诊断名称` está preenchido mas `主要诊断编码` está vazio, e noutra linha o código tem uma forma estranha. | `MR-005` exige que ambos sejam preenchidos em conjunto e indica qual falta; verifica apenas que os dois existam, não que o código corresponda ao diagnóstico. `MR-006` testa depois o código contra a forma escrita configurada no pacote e não verifica se esse código existe em qualquer versão do diretório de classificação. |
+| Um lote não traz qualquer registo de operação. As regras de operação passam em silêncio? | Não. `MR-007` declara-se em `skipped` com o motivo de que o material não contém registos de operação e a verificação de par não se aplica, em vez de passar em silêncio. Quando uma linha regista mesmo uma operação, a regra exige que `主要手术名称` e `主要手术编码` sejam preenchidos em conjunto, e `MR-008` verifica apenas a forma escrita do código de operação. |
+| O diagnóstico principal de um doente do sexo masculino é uma condição relacionada com a gravidez. Isso bloqueia a exportação? | `MR-014` reporta-o como uma diferença de nível `warn` para confirmação humana, nunca como bloqueio: os documentos sanitários não contêm qualquer cláusula que torne um diagnóstico incompatível com o sexo registado, e o detalhe publicado desse tipo de regra do seguro de saúde não abrange o capítulo de gravidez, parto e puerpério e admite exceções de justificação clínica. Confirme com o clínico se o erro está no sexo ou no diagnóstico. |
+
+## Normas que segue
+
+| Documento | Número | Regras que o citam |
+|---|---|---|
+| 《住院病案首页数据质量管理与控制指标（2016版）》 | 国卫办医发〔2016〕24号 | MR-001 |
+| 《住院病案首页数据填写质量规范（暂行）》 | 国卫办医发〔2016〕24号 | MR-002, MR-003, MR-005, MR-006, MR-007, MR-008, MR-013, MR-015 |
+| 《卫生部关于修订住院病案首页的通知》 | 卫医政发〔2011〕84号 | MR-004, MR-009, MR-010, MR-011, MR-012 |
+| 国家医疗保障局"两库"知识点（诊断与患者性别不符） | 国家医疗保障局公告（第二十一批） | MR-014 |
 
 **Boundary:** this plugin checks the **front sheet of the inpatient medical record (病案首页)** — the
 one-page discharge summary coders and the national assessment system read — for form completeness,

package/README-zh.md

@@ -1,4 +1,34 @@
-# dsh-medrec-qc
+# dsh-medrec-qc — 病案首页形式质控与逻辑矛盾提示
+
+[![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
+
+`dsh-medrec-qc` 读取一份住院病案首页导出表，每行一例出院病例，列名可以是国家绩效考核导出、卫生统计导出或医院本地导出的写法，核对这份材料自身的形式齐备、内部算术与编码形式：必填栏目是否有内容或按规范填写 `-`、入院时间与出院时间是否填写且精确到分钟且前后不倒置、填写的实际住院天数是否与两个日期一致、主要诊断的名称与编码以及主要手术的名称与编码是否同时填写、编码是否符合规则库配置的书写形式、三级医师签名栏是否齐全、离院方式是否为规定代码、年龄与新生儿体重是否使用规定形式、其他诊断条数是否在配置上限内，以及诊断与性别不相容、死亡病例两条时间不一致等需人工核实的情形是否被列出。
+
+## 实际输出长什么样
+
+![Terminal demo of dsh-medrec-qc: real output over its MR-009 fixture](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-demo.png)
+
+本插件对自己 `MR-009` 测试夹具的**真实输出**，不是示意图。规则库不伪造引文，因此每条发现都会同时写明所引条款，以及该条款原文本次未取得。
+
+## 它回答什么问题
+
+| 你会问 | 它怎么答 |
+|---|---|
+| 某个必填栏目是空的，但我填了 `-`，会被报出来吗？ | 不会。`MR-001` 把单独一个 `-` 视为「没有可填写内容」的标注，只报真正留空的栏目。它核对的是必填栏目有没有内容，不判断内容填得对不对；由于本条所引附件是 PDF、本环境无法解码，它的严重级封顶为 `warn`。同一个 `-` 在 `MR-009` 里仍然算签名缺失。 |
+| 入院时间只写到日、没有时分，还有一行的出院时间早于入院时间。 | `MR-002` 会报出只能读到日的 `入院时间` 或 `出院时间`（记录时间应当精确到分钟），完全解析不成日期时间的取值也一并报出。`MR-003` 按两个字段本身的字面先后关系，报出出院时间在前的那一行。两条都只看字面取值，不判断哪个时间才是真实时间。 |
+| 首页上写的是 5 天，而入出院日期是 6 月 12 日入院、6 月 15 日出院。 | `MR-004` 按「出院日 − 入院日」重算天数，与填写的 `实际住院天数` 不符即报出该行；同日入出院计 `0` 天，填的不是整数天也会报出。它只比对这三个已填的值，不判断其中哪一个填错了。 |
+| `主要诊断名称` 填了、`主要诊断编码` 空着；另一行的编码写法很怪。 | `MR-005` 要求两者同时填写，并指出缺的是哪一项；它只核对两者是否同时存在，不判断编码与诊断是否对应。`MR-006` 再按规则库中配置的书写形式核对编码，不校验该编码是否存在于某一版本的分类目录中。 |
+| 一批材料里完全没有手术操作记录，手术类规则会静默通过吗？ | 不会。`MR-007` 会在 `skipped` 中报告「材料中没有手术或操作记录、配对检查不适用」，而不是静默通过。某一病例确实记录了手术时，本条要求 `主要手术名称` 与 `主要手术编码` 同时填写，`MR-008` 只核对手术编码的书写形式。 |
+| 男性患者的主要诊断是妊娠相关疾病，会阻断上报吗？ | `MR-014` 只作为 `warn` 级差异提示人工核实，从不作阻断：卫生口径文件中没有「诊断必须与性别相容」的条款，医保侧该规则类型的已公开明细未覆盖妊娠分娩产褥期章节，并允许临床合理性例外。请与临床确认是性别填错还是诊断填错。 |
+
+## 依据的标准
+
+| 文件 | 文号 | 引用它的规则 |
+|---|---|---|
+| 《住院病案首页数据质量管理与控制指标（2016版）》 | 国卫办医发〔2016〕24号 | MR-001 |
+| 《住院病案首页数据填写质量规范（暂行）》 | 国卫办医发〔2016〕24号 | MR-002, MR-003, MR-005, MR-006, MR-007, MR-008, MR-013, MR-015 |
+| 《卫生部关于修订住院病案首页的通知》 | 卫医政发〔2011〕84号 | MR-004, MR-009, MR-010, MR-011, MR-012 |
+| 国家医疗保障局"两库"知识点（诊断与患者性别不符） | 国家医疗保障局公告（第二十一批） | MR-014 |
 
 **Boundary:** this plugin checks the **front sheet of the inpatient medical record (病案首页)** — the
 one-page discharge summary coders and the national assessment system read — for form completeness,

package/README.md

@@ -1,4 +1,34 @@
-# dsh-medrec-qc
+# dsh-medrec-qc — Form check and logic-contradiction prompts for the inpatient medical record front sheet
+
+[![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
+
+`dsh-medrec-qc` reads an export of the inpatient medical record front sheet (病案首页), one row per discharge, in the column set of the national assessment export, the health statistics export or a hospital-local export, and checks that export's own form completeness, internal arithmetic and coding form: that each required column carries content or the `-` marker, that the admission and discharge times are present, precise to the minute and not in the wrong order, that the declared length of stay agrees with the two dates, that the primary diagnosis name and code and the primary operation name and code are filled together, that the codes have the written form the pack configures, that the three signature columns reflect three-level physician responsibility, that the discharge mode is one of the defined codes, that the age and the neonatal weights use the prescribed forms, that the count of other diagnoses stays within the configured ceiling, and that a diagnosis incompatible with the recorded sex or two disagreeing times in a death discharge are surfaced for human review.
+
+## What it looks like
+
+![Terminal demo of dsh-medrec-qc: real output over its MR-009 fixture](https://raw.githubusercontent.com/PerryLink/dsh-medrec-qc/main/docs/assets/dsh-medrec-qc-demo.png)
+
+Real output from this plugin over its own `MR-009` test fixture — not a mock-up. The rule pack ships no invented quotations, so a finding names both the clause it applied and the fact that the clause text was not obtained.
+
+## What it answers
+
+| You ask | What it answers |
+|---|---|
+| A required column is left empty, but I typed `-` in it. Is that reported? | No. `MR-001` treats a lone `-` as the marker for 'nothing to record here' and reports only the columns that are truly blank. It checks that a required column carries content, not that the content is correct, and it is capped at `warn` because the attachment it cites is a PDF this environment cannot decode. The same `-` still counts as a missing signature under `MR-009`. |
+| The admission time is written as a bare date with no hour or minute, and on one row the discharge time is earlier than the admission time. | `MR-002` reports a `入院时间` or `出院时间` value that can be read only to the day, because the recorded time must be precise to the minute, and it also reports a value it cannot parse as a date and time at all. `MR-003` compares the literal order of the two fields and reports the row where the discharge time comes first. Both work on the literal values and neither decides which of the two times is the true one. |
+| The front sheet says `5` days, but the dates are 12 June in and 15 June out. | `MR-004` recounts the days as discharge date minus admission date and reports the row when the declared `实际住院天数` disagrees; admission and discharge on the same day count as `0` days, and a value that is not a whole number of days is reported too. It compares the three stored values only and does not decide which of them is wrong. |
+| `主要诊断名称` is filled in but `主要诊断编码` is blank, and another row carries a code in a strange shape. | `MR-005` requires the two to be filled together and names the one that is missing; it checks only that both exist, not that the code matches the diagnosis. `MR-006` then tests the code against the written form configured in the pack, and it does not verify that the code exists in any version of the classification directory. |
+| A batch contains no operation records at all. Do the operation rules pass in silence? | No. `MR-007` reports itself in `skipped` with the reason that the material holds no operation record, so the pairing check does not apply, instead of passing in silence. When a row does record an operation, the rule requires `主要手术名称` and `主要手术编码` to be filled together, and `MR-008` checks the written form of the operation code only. |
+| A male patient's primary diagnosis is a pregnancy-related condition. Does that block the export? | `MR-014` reports it as a `warn`-level difference for a human to confirm, never as a block: the health-side documents contain no clause making a diagnosis incompatible with the recorded sex, and the published detail of that medical-insurance rule type does not cover the pregnancy, childbirth and puerperium chapter and allows clinical exceptions. Confirm with the clinician whether the sex or the diagnosis is wrong. |
+
+## Standards it follows
+
+| Document | Number | Cited by rules |
+|---|---|---|
+| 《住院病案首页数据质量管理与控制指标（2016版）》 | 国卫办医发〔2016〕24号 | MR-001 |
+| 《住院病案首页数据填写质量规范（暂行）》 | 国卫办医发〔2016〕24号 | MR-002, MR-003, MR-005, MR-006, MR-007, MR-008, MR-013, MR-015 |
+| 《卫生部关于修订住院病案首页的通知》 | 卫医政发〔2011〕84号 | MR-004, MR-009, MR-010, MR-011, MR-012 |
+| 国家医疗保障局"两库"知识点（诊断与患者性别不符） | 国家医疗保障局公告（第二十一批） | MR-014 |
 
 **Boundary:** this plugin checks the **front sheet of the inpatient medical record (病案首页)** — the
 one-page discharge summary coders and the national assessment system read — for form completeness,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-medrec-qc",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "病案首页形式质控与逻辑矛盾提示（依据国卫办医发〔2016〕24号等公开文件，仅提示差异，不作出定性结论）",
   "type": "module",
   "main": "lib/index.mjs",