프로젝트 소개

FED-SPA(Florida Establishment Directory — Spa & Parlor Assurance)는 플로리다 주의 면허 마사지 업소를 위한 정적·자체 호스팅 디렉토리입니다. 이 프로젝트는 세 가지 불가침 원칙을 기반으로 합니다: 백엔드 없음(정적 파일만, 연 1회 갱신), 제3자 의존성 없음(바닐라 JS/CSS, Python 표준 라이브러리, Node 네이티브 암호화, 플랫폼 네이티브 프레임워크만 사용), 연간 갱신 주기. 데이터셋은 두 계층으로 구성됩니다. 면허 목록은 공개 기록으로 일반 텍스트 JSON으로 제공되며, 누구나 감사하고 포크할 수 있습니다. 감시 목록 계층은 플로리다 DOH 의료 품질 보증(MQA) 포털에서 문서화된 검색 결과 면허가 일치하지 않는 업소를 포함하며, PBKDF2-SHA256 및 AES-256-GCM으로 암호화되어 구독자가 공유 코드를 입력한 후에만 앱 내에서 복호화됩니다. 각 감시 목록 항목에는 정확한 검색어와 날짜가 status_note에 포함되어 있어, "면허 없음"이 판결이 아닌 질문을 유도하는 신호임을 명확히 합니다. 단일 진실 소스(data/public/licensed.json 및 암호화된 봉투)는 생성 스크립트를 통해 6개 플랫폼 표면으로 배포됩니다: 설치 가능한 오프라인 PWA, 도메인 배지와 빠른 팝업이 있는 Chrome MV3 확장 프로그램, 딥 링크와 홈 화면 위젯이 있는 Android 앱, 의도적으로 데이터를 최소화한 Android Auto 동반 앱, 스마트워치 앱, SPM 의존성이 없는 iOS SwiftUI 앱. 면허 목록은 CSV로도 제공됩니다. 연간 갱신은 각 단계에서 인간 검증이 포함된 단일 명령 워크플로우입니다: MQA 포털에서 모든 기록 재확인, 소스 JSON 편집, 스키마에 대한 유효성 검사, 감시 목록 재암호화, 배포 스크립트 재실행, 릴리스 태그 지정. 릴리스 2026.2는 Fort Pierce에서 Homestead까지 US-1/Federal Hwy 회랑을 따라 5개 카운티, 112개 지자체를 포괄하는 최초의 전체 카운티 조사로, 면허 목록을 1개에서 47개로 늘리고 감시 목록에 첫 44개 항목을 채웠습니다. 모든 기록에는 세 가지 정직한 필드가 있습니다: verified_by(포털 URL), last_checked(확인 날짜), data_as_of(릴리스 날짜). 유지관리자가 해당 날짜에 포털을 직접 확인하지 않으면 어떤 기록도 면허 목록에 들어가지 않습니다. 전용 이슈 템플릿을 통해 수정 제안을 받습니다. 이 프로젝트는 서버 제로, 트래커 제로, 제3자 코드 제로를 강조합니다. 구독자 코드는 어디에도 전송되지 않으며, 사용자 브라우저 세션, 선택적 로컬 저장소, 또는 기기 키체인에만 존재합니다. 암호화 봉투 사양은 공개적이며 동결되어 있습니다. 이 프로젝트는 플로리다 주나 어떤 기관과도 독립적이며 무관합니다. README는 데이터가 실시간 피드가 아닌 스냅샷이며, 사용자는 결정 전에 항상 MQA 포털에서 재검증해야 한다고 반복해서 강조합니다.