의료 기기 페이지 프로젝트 가이드라인

Medinor.org는 생의학 커뮤니티의 방대한 파일 캐시를 정리하기 위해 설정한 서버입니다. 이곳에는 온갖 종류의 의료 기기 수리 매뉴얼이 포함되어 있어 우리에게 유용하지만, 필요 없는 다른 자료도 많이 들어 있습니다. 또한 매우 정리되지 않은 상태입니다. 내부에 있는 모든 자료는 널리 공유된 것이지만, 불필요한 파일을 분류하고 삭제하는 동안에는 민감한 자료로 다루어 주세요.

여러분의 역할은 이러한 파일의 이름을 변경하고 적절한 카테고리 및 폴더로 정리하는 것입니다. 더 자세한 지침은 아래에서 확인할 수 있습니다.

이 엄청난 작업에 참여하고 싶다면 biomed@ifixit.com으로 이메일을 보내주세요. 이름, 이메일 주소, 위치(시간대), 그리고 본인이 하는 일과 자원봉사에 관심이 있는 이유에 대한 짧은 소개를 포함해 주세요. Medinor.org에 접속할 수 있도록 계정을 설정해 드리고, Medinor.org 로그인 자격 증명이 담긴 이메일을 보내드리겠습니다. 아직 로그인 자격 증명을 받지 못했더라도 걱정하지 마세요. 너무 많은 사람이 동시에 웹사이트를 사용하는 것을 원치 않으니, 조금만 기다려 주시면 결국 자격 증명을 받게 될 것입니다.

PDF를 열고 읽는 작업은 어떤 이유에서인지 Google Chrome보다 FireFox에서 훨씬 빠르게 진행됩니다. Google Chrome만 사용할 수 있다면 괜찮습니다. 다만, 일부 경우에는 문서 전체를 보기 위해 Medinor.org에서 PDF를 직접 다운로드해야 할 수도 있다는 점을 알아두세요. 최신 버전의 FireFox는 여기에서 다운로드할 수 있습니다.

주로 Medinor.org의 두 폴더인 'PDFs'와 'Medical Devices'에서 작업하게 됩니다. 이 프로젝트를 위해 최소 세 개의 별도 탭이나 창을 사용하는 것을 권장합니다.

1. 한 탭/창은 스프레드시트용으로 사용합니다.
2. 한 탭/창은 Medinor.org의 'PDFs' 폴더를 표시하는 데 사용합니다.
3. 한 탭/창은 Medinor.org의 'Medical Devices' 폴더를 표시하는 데 사용합니다.

구성 가이드: medinor.org의 "My Files" 루트 폴더 안에는 다음이 있습니다:

• All Literature—원래 파일 캐시가 포함되어 있습니다. 무시해도 됩니다.
• PDFs—분류할 파일이 포함된 우리의 "받은 편지함"입니다. PDF가 아닌 파일과 20 KB 미만의 파일을 제외한 All Literature의 모든 항목이 포함되어 있습니다. 프로젝트의 목표는 여기에서 보관할 가치가 있는 모든 것을 식별하고, 정리하여 다음 폴더로 이동하는 것입니다...
• Medical Device—우리가 보관할 PDF를 위한 "보낸 편지함"이자 최종 결과물입니다. 이곳의 폴더는 ifixit.com/Device/Medical_Device의 콘텐츠 구조를 반영하도록 이름을 올바르게 지정하고 정리해야 합니다. 작업이 모두 완료되면 스크립트를 실행하여 내부의 모든 파일을 iFixit으로 자동 가져오고 적절한 기기/카테고리 페이지를 생성할 것입니다.
• Archive, Backup, Future Work, etc.—이 폴더들은 무시해도 안전합니다.

'폴더 할당(Folder Assignments)' 스프레드시트에서 폴더(또는 폴더 세트)를 스스로에게 배정하세요. 모두가 같은 내용을 파악할 수 있도록 'Reserved By' 열에 이름을 입력하세요. (이 목록의 폴더들은 "PDFs" 상위 디렉터리 안에 위치해 있음을 기억하세요.)

아래 설명에 따라 폴더 작업을 마쳤다면 스프레드시트의 D열에 'Complete!'라고 표시해 주세요. 섹션을 시작했으나 계속할 수 없는 경우에는 해당 폴더를 'Started but didn’t finish'로 표시하고 E열에 중단한 부분을 메모로 남겨 주세요.

배정된 각 폴더와 하위 폴더에서 어떤 콘텐츠가 있는지 확인하고 각 파일을 보관할지 삭제할지 결정하세요.

• 서비스 매뉴얼은 소유자/운영자 매뉴얼과 마찬가지로 우선순위가 높습니다. 보관하세요!
• 부품 목록 - 내용을 확인하고 유용해 보이면 보관하세요. 하지만 가격이나 가격표가 보이면 삭제하세요. 해당 가격은 (대부분) 오래되었으며 고객별로 다를 수 있습니다. 서비스 매뉴얼에는 보통 부품 목록이 포함되어 있으므로 종종 중복됩니다.
• 관련 없는 파일. 병원이나 물류와 관련된 특정 파일이나 기기 수리에 폭넓게 유용하지 않은 파일은 삭제하세요.
• 기타/예외 케이스: 배정된 카테고리를 완료하기 위해 최선을 다하되, 까다로운 파일 때문에 도저히 알 수 없는 경우에는 "NEEDS REVIEW"로 표시하고 Medinor Curation 스프레드시트에 메모를 남겨 주세요.

사람이 쉽게 읽고 식별할 수 있도록 파일 이름을 변경하세요. 문서의 제목에 제조업체 이름, 모델 이름, PDF가 다루는 매뉴얼 유형을 모두 포함하세요. (원래 파일명에 있던 정보는 보존하지 않아도 됩니다.)

• 예시: Welch Allyn 300 Series Service Manual.pdf

의료 기기와 문서의 이름을 올바르게 지정하는 방법에 대한 자세한 내용은 기기 명명 규칙(Device Nomenclature) 페이지를 방문하세요.

문서에 두 가지 이상의 언어가 포함된 경우: 영어가 포함되어 있다면 더 이상 할 일이 없습니다. 작업 완료입니다! 하지만 영어가 포함되어 있지 않다면, 첫 번째(또는 주) 언어의 두 글자 코드를 접미사로 추가하세요. (ISO 두 글자 언어 코드에 대한 자세한 정보는 이 웹사이트를 방문하세요.)

• 영어만 포함하거나 영어를 포함한 여러 언어가 있는 파일의 예시 이름: Welch Allyn 300 Series Service Manual.pdf (위와 동일)
• 독일어만 포함하고 영어는 없는 파일의 예시 이름: Welch Allyn 300 Series Service Manual_DE.pdf

생의학 커뮤니티와 협의한 결과, 모든 문서는 주로 사용되는 환경(임상, 실험실 등)을 기준으로 정리하기로 했습니다. 이 폴더들은 이미 생성되어 있습니다. 각 폴더 안에 필요에 따라 파일을 정리할 추가 폴더를 만드세요:

1. 기기 유형당 하나의 하위 폴더 (예: Ventilator) (주의: 단수).
2. 해당 기기 유형의 각 제조업체별 하위-하위 폴더 (예: ACME Ventilator).
   • 참고: ACME라고만 하지 말고 기기 유형을 포함하세요(이것이 중요합니다).
   • 가능하면 기기/장비에 있는 가장 최신 제조업체 또는 가장 눈에 띄는 제조업체 로고를 사용하세요.
3. 각 특정 기기별 하위-하위-하위 폴더 (예: ACME Super Pro 9000).
   • 여기에는 기기 유형을 포함할 필요가 없습니다. 제조업체는 꼭 포함하되 짧게 유지하세요.

참고: 모든 폴더는 전역적으로 고유한 이름을 가져야 합니다. 'Testing Fixture'는 고유하지 않지만, Drager 1840 Testing Fixture는 괜찮습니다.

스스로 배정받은 각 폴더가 비어 있으면 삭제하고 스프레드시트에 complete라고 표시하세요. 이 과정을 반복하세요!

파일이 관련이 있는지 확신할 수 없다면 "NEEDS REVIEW"로 표시하고 Medinor Curation 스프레드시트에 메모를 남겨 주세요.

중복 파일: 하나를 삭제하세요. 같은 매뉴얼의 개정판이 두 개 있다면 가장 최신 버전만 보관하고 나머지는 삭제하세요.

팀원들이 만든 변경 사항이 백그라운드에서 동기화되기는 하지만, 페이지를 새로고침해야만 표시됩니다. (브라우저 새로고침 버튼이 가장 효과적이며, UI의 새로고침 버튼은 오류가 발생할 수 있습니다.)

되돌리기 기능이 없으므로 주의해서 작업하세요. 백업본은 있지만, 사용하지 않는 편이 좋습니다.

PDF 파일을 열거나 볼 때: 스크롤을 내려 파일을 볼 수 있는 경우도 있지만, 표시되지 않거나 첫 페이지만 보이는 경우도 있습니다. 그럴 때는 파일을 다운로드하여 확인하세요. (다운로드 후에도 Reader에서 볼 수 없다면 쓸모없는 파일입니다. 삭제하세요!)

빠르게 움직이고 불필요한 것은 삭제하는 방향으로 결정하세요. 너무 고민하지 마세요. 이는 거대한 프로젝트이므로 빠르게 진행해야 합니다. 결정 앞에서 주저하며 시간을 낭비하지 마세요. 이 프로젝트는 세상에 초안을 내놓는 것이 목적입니다. 만약 의욕이 떨어지고 중요한 일을 하고 있지 않다는 느낌이 든다면 "NEEDS REVIEW"로 표시하고 넘어가세요. 추진력을 유지하세요.

가장 중요한 장비는 인공호흡기, 마취기, 호흡기, BiPAP, CPAP 및 기타 호흡 보조 장치입니다. 그 다음으로는 전 세계 병원에서 흔히 사용하는 모든 장비를 다루고자 합니다. 목표는 생의학 엔지니어와 기타 의료 전문가를 위한 단일 포괄적 자원을 구축하는 것입니다.

이 스프레드시트에는 Medinor의 모든 폴더 목록이 포함되어 있습니다. 모든 폴더를 게시할 수 있도록 각 폴더를 꼼꼼히 검토하고 올바른지 확인하세요!

먼저, 스프레드시트에서 폴더 옆에 본인의 이름을 추가하여 폴더를 배정받으세요. 그 다음 Medinor에서 해당 폴더를 우클릭하고 Review In Progress(검토 진행 중)로 라벨을 지정하세요.

다음으로, (a) 위 지침에 따라 폴더 이름이 올바르게 지정되었는지, (b) 내부의 추가 파일이나 폴더도 이름이 올바르게 지정되고 분류되었는지 확인하세요.

수정이 필요할 수 있는 일반적인 문제는 다음과 같습니다:

• 030139381.pdf와 같이 설명이 부족한 이름을 가진 PDF 문서. 사람이 파일만 보고도 무엇인지 알 수 있도록 하세요. 필요한 경우 문서를 열어 실제 내용을 확인하고 적절하게 이름을 변경하세요. 예: Maquet Servo-i Ventilator - Service Manual.pdf.
• 기기 유형을 포함하지 않고 제조업체 이름만 있는 폴더와 같이 비특이적인 폴더 이름. 예를 들어, Ventilator 폴더 내에서 단순히 “Maquet”으로만 이름 지어진 하위 폴더는 부족합니다. 하위 폴더 이름을 “Maquet Ventilator”로 변경하세요.
• 언어 코드나 “manuals”와 같이 비특이적인 이름 등 다른 문제가 있는 폴더 이름. 모든 폴더는 기기 유형(“Ventilator”), 제조업체 + 기기 유형(“Maquet Ventilator”) 또는 특정 기기 모델(“Maquet Servo-i”)의 이름을 따서 명명되어야 합니다. 특정 기기 모델 폴더에는 “service bulletins”와 같은 항목에 대한 하위 폴더를 두지 마세요. 해당 파일들을 상위 기기 폴더로 이동하고 “service bulletins” 폴더는 삭제하세요.

필요한 변경 사항을 적용하고, 질문이 있으면 이메일을 보내주세요.

• 폴더에 문제가 너무 많아 수정에 도움이 필요하다면, (Medinor와 아래 목록의 "Folder Status" 열 모두에서) NEEDS WORK로 라벨을 변경하세요.

마지막으로, 모든 사항이 확인되면 폴더 라벨을 Reviewed(검토 완료)로 변경하세요. 끝입니다! 다른 폴더를 배정받아 과정을 반복하세요.

이것은 프로젝트의 첫 번째 단계로, 문서를 선별하고 관리 가능한 목록으로 줄이는 과정입니다. 다음 단계에서는 각 기기에 대한 메타데이터, 사진, 추가적인 맥락 정보를 추가하고 누락된 정보를 식별할 예정입니다.