본문으로 건너뛰기
시골프로그래머의 블로그
블로그 메뉴

대한민국 법령을 내 PC에서 조문 단위로 검색하기 — legalize-search

legalize-kr의 법령 Markdown 데이터를 SQLite FTS5 검색 DB로 만들고, 웹 화면에서 조문과 개정 이력을 찾아보게 한 Python 프로그램입니다.

풀빛컴퓨팅3분 읽기#오픈소스#Python#법령#SQLite

"벌금과 징역이 함께 나오는 조문"이나 "개인정보를 다루면서 파기 이야기는 없는 조문"을 법령 전체에서 찾고 싶을 때가 있습니다. 법령 한 건씩 열어 보는 방식으로는 이런 질문에 답하기 어렵습니다.

legalize-kr는 대한민국 법령을 Markdown 파일로 정리해 Git 저장소로 관리하는 프로젝트입니다. legalize-search는 이 데이터를 받아 SQLite FTS5 전문 검색 DB로 만들고, 브라우저에서 검색하는 화면을 붙였습니다.

써 보기

Python 3.12 이상이 필요합니다.

# 1. 법령 데이터 클론
git clone https://github.com/legalize-kr/legalize-kr.git

# 2. 의존성 설치
pip install pyyaml flask

# 3. DB 구축
python build_db.py --data ./legalize-kr/kr

# 4. 검색 서버 실행
python search_app.py
# → http://localhost:8080 에서 검색

search_app.py는 --db(DB 파일), --port(기본 8080), --no-browser(브라우저 자동 열기 끄기) 옵션을 받습니다.

DB는 이렇게 만듭니다

build_db.py는 kr/ 아래 법령 폴더를 돌면서 파일마다 다음을 처리합니다.

  1. 위쪽 YAML 머리말에서 제목, 법령 구분, 소관 부처, 공포일, 시행일, 상태 같은 정보를 꺼냅니다.
  2. 본문을 ##### 제N조 (제목) 형태의 제목 기준으로 잘라 조문 하나를 레코드 하나로 저장합니다. 장·편 제목도 함께 기록하고, 부칙 아래는 한 덩어리로 둡니다.
  3. legalize-kr이 Git 저장소이므로 git log를 읽어 법령 파일별 개정 이력을 모읍니다. 커밋 메시지의 괄호에서 일부개정, 타법개정 같은 개정 유형도 뽑습니다.

한 폴더 안의 법률, 시행령, 시행규칙은 한 묶음으로 저장해 서로 오갈 수 있게 했습니다. 입력 파일 6,884개를 넣으면 빌드에 약 2분(Git 이력 포함) 걸리고, DB는 약 473MB, 개정 이력은 약 81,500건이 됩니다.

검색 문법

검색어에는 SQLite FTS5 문법을 그대로 씁니다.

문법 예시 설명
AND 징역 AND 벌금 둘 다 포함
OR 벌금 OR 과태료 하나 이상 포함
NOT 개인정보 NOT 파기 제외
구문 "개인정보 보호" 이어진 구문
접두어 행정* 앞부분 일치
근접 NEAR(벌금 징역, 5) 5토큰 이내

법률, 대통령령, 부령 같은 분류로 좁힐 수 있고, 결과에는 걸린 부분이 강조 표시된 조문 일부가 나옵니다. 결과를 누르면 법령 전체 조문과 변경 이력 탭, 같은 묶음의 시행령·시행규칙으로 가는 버튼이 있는 상세 창이 열립니다. 같은 기능을 /api/search, /api/law/:id, /api/law/:id/history 같은 REST API로도 부를 수 있습니다.

낱말 단위 검색

토크나이저는 unicode61이라 한글을 공백과 문장부호 기준으로 자릅니다. 글자 단위가 아니므로 개인정보는 하나의 토큰으로 처리됩니다.

알아 둘 점

  • legalize-kr 저장소를 Git으로 받아야 개정 이력이 채워집니다. .git이 없으면 이력 수집을 건너뜁니다.
  • 데이터가 바뀌면(git pull 후) build_db.py를 다시 돌립니다. 기존 DB는 지우고 새로 만듭니다.
  • 검색 화면은 CSS와 JavaScript를 넣은 HTML 파일 하나(web/index.html)라 따로 빌드하지 않습니다.

소스와 설계 문서(docs/)는 GitHub 저장소에 있습니다.

함께 읽으면 좋은 글