Devin.KR

AI 개발 · 실무

AI와 함께 만드는 웹 서비스 - 설계도에서 배포·운영까지

완성한 사이트를 점검하고 다음 개선 고르기

기능·보안·성능·접근성·운영 점검표로 스스로 감사하기, 남은 위험 목록과 우선순위, 포트폴리오로 설명하는 법(설계도·결정 이유·검증 근거), 완성 코드는 점검표 JSON 을 채점해 영역별 점수와 다음 할 일 3개를 출력

개발자KR · 원고 갱신

이 장에서 배우는 것

동네 소모임 사이트에는 모임 공지와 참가 신청, 로그인, 운영 기록이 있다. 앞 장에서 공지의 요약과 분류도 붙였다. 이제 사이트를 넘겨받을 사람이 있다고 가정해 보자. 그 사람에게는 어느 기능을 어떤 조건에서 확인했는지, 아직 어떤 문제가 남아 있는지, 다음 작업을 왜 먼저 해야 하는지 알려 줄 자료가 필요하다. 이 장에서는 다섯 영역의 점검표를 작성하고, 그 기록을 채점하는 작은 프로그램으로 개선 순서를 정한다. 예제에 들어 있는 근거와 위험은 이 사이트를 가정한 실습용 기록이다. 자신의 사이트에 적용할 때는 직접 확인한 결과로 바꾼다.

  • 기능, 보안, 성능, 접근성, 운영의 점검 항목에 관찰 가능한 통과 조건을 적는다.
  • 확인 범위와 근거를 남겨 통과, 일부 확인, 미확인을 구분한다.
  • 영향과 발생 가능성을 비교해 남은 위험에서 다음 작업 세 개를 고른다.
  • 설계도, 결정 이유, 검증 근거를 연결해 포트폴리오에서 설명한다.

문제 상황

토요일에 열리는 동네 책 교환 모임을 공지했다. 운영자는 시험 계정으로 신청 한 건을 넣었고 화면에 완료 메시지가 떴다. 두 사람이 마지막 한 자리를 거의 동시에 신청할 때 어떻게 되는지는 확인하지 않았다. 회원 본인의 신청 내역은 열어 봤지만, 다른 회원의 신청이 화면이나 응답에 섞이지 않는지 보여 주는 기록은 없다. 공지 목록은 시험 데이터 몇 건으로 빠르게 열렸다. 모집이 끝난 공지가 쌓였을 때도 같은 결과가 나올지는 모른다.

모바일 화면에서는 신청 버튼이 보인다. 키보드만으로 메뉴를 건너 신청 양식에 들어가고, 입력 오류를 수정한 뒤 제출을 마칠 수 있는지는 아직 살피지 않았다. 운영자는 신청 오류가 로그에 남는 것도 확인했다. 운영 담당자가 자리를 비웠을 때 다른 사람이 기록을 찾아 상황을 파악할 수 있는지는 확인할 차례다. 앞 장의 요약 기능도 마찬가지다. 요약이 잘 보이는 공지 한 건을 확인한 뒤, 요약이 비어 있는 공지에서도 원문과 신청 안내가 유지되는지 별도로 살펴야 한다.

이런 상태를 인수인계 문서에 모두 ‘완료’로 적으면 다음 담당자는 어디부터 다시 확인해야 할지 알기 어렵다. 반대로 점검 항목을 모두 같은 무게로 늘어놓으면 첫 작업을 고르기 어렵다. 모집을 앞둔 운영자는 어떤 문제부터 확인해야 참가자의 신청을 보호할 수 있는지 알아야 한다. 이때 점검표에는 확인 사실을, 위험 목록에는 그 사실에서 도출한 영향을, 작업 목록에는 결과를 바꿀 구체적 행동을 적는다. 하나의 항목에서 이 세 기록을 서로 연결하면 다음 담당자가 판단을 이어갈 수 있다.

판정에 근거를 붙이는 점검표

자체 점검은 공개할 기능과 그 기능을 사용하는 사람부터 정하는 일이다. 여기서는 방문자가 공지를 읽고, 회원이 신청하고, 운영자가 문의와 오류에 대응하는 흐름을 기준으로 삼는다. 각 점검 항목을 ‘누가, 어떤 조건에서, 무엇을 확인했을 때 통과하는가’로 작성한다. 예를 들어 ‘접근성 확인’보다 ‘키보드만으로 공지에서 신청 양식까지 이동하고, 오류가 난 입력으로 돌아가 값을 고친 뒤 제출할 수 있다’가 결과를 재현하기 쉽다.

모임 사이트의 영역별 점검 조건과 남길 근거
영역통과 조건의 예남길 근거
기능신청이 완료되면 같은 계정의 신청 내역에 해당 모임이 표시된다.가상 계정의 신청 전후 내역과 두 화면에서 확인한 모임 식별자
보안회원 화면과 응답에서 로그인한 계정의 신청만 조회된다.서로 다른 가상 계정의 정상 조회 결과와 소유권 확인 테스트 결과
성능미리 정한 공지 수와 조회 조건에서 목록 응답이 팀의 목표 범위에 든다.데이터 규모, 실행 환경, 반복 횟수, 결과 요약
접근성키보드로 신청 양식을 끝까지 이용하고 입력 오류를 찾아 수정할 수 있다.이동 순서, 현재 선택 위치의 표시, 오류 안내와 수정 후 제출 결과
운영당번이 가상 장애 기록을 찾아 사용자 영향과 다음 대응을 설명할 수 있다.실습에 사용한 기록 식별자, 담당자 역할, 찾은 단서와 결정한 조치

직접 확인을 시작하기 전에 대상 버전과 조건을 적는다. 같은 신청이라도 계정 상태, 모집 기간, 남은 자리 수에 따라 기대 결과가 다르다. 성능은 측정 대상을 함께 남긴다. 내부 요청 처리 함수의 소요 시간을 쟀다면 그 사실을 적고, 브라우저에서 목록이 보이기까지 걸린 시간을 따로 기록한다. 접근성은 키보드 이동 중 현재 위치가 보이는지, 잘못 입력한 항목과 수정 방법을 알아볼 수 있는지까지 관찰한다. 운영 점검에는 연습에서 실제로 사용한 안내 문서의 버전과 역할도 남긴다. 이 정보가 있어야 다른 사람이 같은 조건을 만들어 결과를 비교할 수 있다.

예제에서는 통과 조건 전부를 확인했고 근거가 있으면 pass, 조건 일부를 확인했고 남은 범위가 있으면 partial, 확인에 착수하지 않았거나 판정에 쓸 관찰 기록이 없으면 unchecked로 기록한다. 확인한 결과가 통과 조건에 어긋났다면 fail을 쓴다. 신청 양식에 키보드로 진입했지만 오류 수정은 아직 시도하지 않았다면 일부 확인이다. 오류가 표시된 뒤 입력 위치로 돌아갈 수 없음을 관찰했다면 실패다. 두 판정의 다음 작업도 달라진다. 일부 확인은 남은 절차를 진행하고, 실패는 관찰한 문제를 고쳐 같은 조건에서 다시 확인한다.

근거 한 줄에는 최소한 무엇을 관찰했는지 적는다. 더 긴 결과가 있다면 식별자를 붙여 실행 기록이나 화면 기록을 찾을 수 있게 한다. 예제의 F-01은 가상 계정에서 신청 완료와 내역 표시를 함께 확인했다는 관찰을 담는다. 실제 기록에는 사용한 버전과 가상 데이터도 붙인다. 미확인 상태의 근거 칸은 비워 두되, 남은 위험과 다음 작업은 적는다. 새 버전을 점검할 때는 해당 기능이 바뀌었는지 살핀 뒤 근거를 다시 수집한다. 지난 결과를 참고할 때도 어느 버전에서 얻었는지 알아볼 수 있어야 한다.

점검 조건에서 관찰 근거를 얻어 판정하고, 남은 위험을 다음 작업에 연결한다.

남은 위험에서 다음 개선 고르기

영역별 점수는 어느 영역의 확인이 덜 끝났는지 보는 데 쓴다. 이 장에서는 한 영역 안에서 항목의 배점을 같게 두고 통과에 2점, 일부 확인에 1점, 실패와 미확인에 각각 0점을 준다. 얻은 점수를 가능한 최대 점수로 나누고, 정수 백분율로 표시할 때 소수 부분은 버린다. 예를 들어 기능의 두 항목이 통과와 일부 확인이면 4점 중 3점을 얻어 75%다. 성능의 50%는 예제에서 정한 성능 점검 두 항목의 채점 결과다. 목록이 목표보다 두 배 느리다거나 실제 사용자의 절반이 불편하다는 뜻은 점수에서 읽을 수 없다. 항목 수와 범위가 달라지면 점수 옆에 그 변경을 기록한다.

작업 순서는 남은 위험을 따로 평가해 정한다. 위험 문장에는 어떤 조건에서 누구에게 어떤 일이 생길 수 있는지 적는다. 예를 들어 ‘회원 화면 점검 필요’는 작업을 가리킨다. ‘회원별 조회 범위가 어긋나면 다른 회원의 신청 정보가 노출될 수 있다’는 그 작업을 앞당길 이유다. 반환 범위를 확인하지 않았다는 기록과 실제 노출을 관찰했다는 기록은 판정에서 구분한다. 위험을 추정할 때는 관찰한 사실과 아직 확인이 필요한 가정을 함께 적어 두면 다음 점검에서 평가를 수정할 수 있다.

영향과 발생 가능성에 1부터 3까지 부여하는 기준
값영향발생 가능성
1일부 표시나 안내가 불편하며 바로 이어서 이용할 수 있다.드문 조건이 겹쳐야 해당 문제가 생길 수 있다.
2신청이 지연되거나 참가자 또는 운영자가 추가 작업을 해야 한다.특정 모집 상황이나 운영 교대 때 조건이 생길 수 있다.
3신청 기회를 잃거나 회원 정보가 노출되거나 대응이 크게 늦어질 수 있다.일상적인 사용 경로에서 조건이 반복해서 생길 수 있다.

두 값을 곱한 수가 큰 항목부터 다룬다. 곱이 같으면 영향이 큰 항목을 먼저 고른다. 영향까지 같으면 확인된 실패, 미확인, 일부 확인 순으로 정하고, 그래도 같으면 항목 식별자 순으로 정한다. 이 순서는 이 예제의 운영자가 정한 규칙이다. 실패를 먼저 둔 이유는 재현된 문제에 바로 착수할 수 있기 때문이다. 실제로 모집 일정이 바뀌거나 영향을 받는 사용자가 달라지면 그 근거를 남기고 평가값을 갱신한다. 예제에서 회원별 신청 조회의 가능성을 3으로 둔 것은 회원이 신청 내역을 확인하는 일이 반복되는 경로라고 보았기 때문이다. 이 값만으로 실제 정보 노출 여부를 판정할 수는 없다.

예제에서는 접근성의 영역 점수가 운영보다 낮다. 작업 순서에서는 당번 교대 대응을 먼저 고른다. 두 항목의 위험값은 모두 6이지만, 이 사례에서는 장애 대응 지연의 영향을 3으로, 키보드 오류 수정 지연의 영향을 2로 평가했다. 오류 수정이 막혀 신청 기회를 잃는 상황을 관찰했다면 접근성의 영향도 다시 정해야 한다. 선택한 세 항목에는 담당자와 종료 조건을 붙인다. 예를 들어 ‘당번 교대 훈련’은 운영자가 안내 문서에서 가상 오류 기록을 찾아 사용자 영향과 후속 조치를 말할 수 있을 때 마친다. 한 항목을 마치면 근거와 판정을 바꾸고 목록을 다시 계산한다. 나머지 위험은 전체 기록에 남아 다음 선택에 들어간다.

같은 점검 기록에서 영역별 점수는 판정으로 계산하고 다음 작업은 남은 위험의 우선순위로 고른다.

포트폴리오에 설계와 검증을 연결하기

첫 화면에는 이 사이트를 누가 왜 쓰는지 한 문단으로 설명하고, 처음 그린 설계도에서 신청 경로를 표시한다. 방문자가 공지를 열고, 회원이 신청을 보내고, 서버가 계정과 모임의 상태를 확인한 뒤 결과를 보여 주는 흐름을 담는다. 설계도에 표시한 이름은 기록에서도 그대로 쓴다. ‘신청 내역 화면’에서 확인한 사실을 찾기 쉽도록 화면 옆에 점검 항목 F-01을 표시할 수 있다. 처음 설계와 실제 구현의 흐름이 달라졌다면 바뀐 부분과 그때 내린 결정을 기록한다.

결정 이유에는 선택 당시의 제약과 확인한 결과를 붙인다. 예를 들어 ‘공지 원문과 신청 안내를 먼저 표시한다. 요약은 원문을 다시 찾아가기 쉽게 별도 위치에 둔다. 요약을 비운 시험 공지에서 원문과 신청 안내가 보이는지 확인했다’라고 적을 수 있다. 여기에 어떤 시험 공지를 썼는지와 그 결과를 담은 기록을 연결한다. 검토자는 설계도에서 시작해 결정 이유를 읽고 같은 조건에서 화면을 확인할 수 있다. 화면 자료와 기록에는 가상 계정과 가상 모임을 사용한다. 남은 위험도 함께 공개하면 다음 작업이 어떤 사용자 경험을 바꾸는지 설명할 수 있다.

AI에게는 한 번에 검토할 수 있는 크기로 요청하고, 받은 초안과 사람이 적용한 변경을 함께 남긴다. 다음 표는 이 장의 채점기를 작성하는 과정을 설명하는 예시다. 실제 작업에서는 초안과 수정본의 변경 내역(diff)을 열어 표에 적은 차이가 코드에 반영되었는지 확인한다. 이어서 같은 입력으로 프로그램을 실행하고, 동점 조건이나 잘못된 입력처럼 두 버전의 동작이 달라지는 사례를 따로 시험한다.

채점기 초안을 검토하며 남길 작업 기록의 예
AI에게 보낸 요청문받은 초안의 동작사람이 고친 부분확인 방법
점검표를 영역별로 채점하고 남은 위험에서 다음 작업 세 개를 출력해 달라.점수가 낮은 영역의 항목을 먼저 골랐다.점수 계산과 작업 선택을 별도 함수로 두고 위험값과 영향으로 정렬했다.변경 내역에서 정렬 기준을 확인한다. 기본 예제를 실행해 운영 작업이 접근성 작업보다 앞에 있는지 본다.
판정과 관찰 근거가 서로 맞는지 검사해 달라.통과 항목의 빈 근거도 받아들였다.통과, 일부 확인, 실패에 관찰 기록을 요구했다.통과 항목의 근거를 공백으로 바꿔 실행하고 해당 식별자가 오류에 표시되는지 본다.
같은 입력의 작업 순서를 일정하게 유지해 달라.위험값이 같은 두 항목은 입력 순서대로 표시했다.영향과 판정이 같은 경우 식별자로 순서를 정했다.동점인 두 항목을 만든 뒤 JSON 배열 순서를 뒤집어도 같은 작업 순서가 나오는지 확인한다.

완성 코드

아래 프로그램을 main.py로 저장한다. 모임 사이트에서 확인한 내용을 담는 점검표를 코드 안에 JSON 문자열로 넣었다. 프로그램은 점검 기록을 읽어 형식을 검증하고 결과를 출력한다. 모임 사이트나 데이터베이스에 접속하지 않으므로 기록을 바꾸면 채점 결과가 어떻게 달라지는지 바로 비교할 수 있다. 각 항목의 check는 확인할 조건, evidence는 관찰 근거, risk는 남은 위험, action은 다음 작업이다.

import json

AREAS = ("기능", "보안", "성능", "접근성", "운영")
POINTS = {"pass": 2, "partial": 1, "unchecked": 0, "fail": 0}
STATUS_ORDER = {"fail": 0, "unchecked": 1, "partial": 2}

CHECKLIST_JSON = """
[
  {
    "id": "F-01", "area": "기능", "status": "pass",
    "check": "신청을 완료하면 본인의 신청 내역에 모임이 표시된다.",
    "evidence": "가상 계정으로 신청한 뒤 내역에서 같은 모임을 확인했다."
  },
  {
    "id": "F-02", "area": "기능", "status": "partial",
    "check": "마지막 한 자리에는 한 사람만 신청된다.",
    "evidence": "순차 신청에서는 두 번째 신청이 거절됐다.",
    "risk": "동시에 신청하면 정원을 넘길 수 있다.",
    "impact": 2, "likelihood": 2,
    "action": "마지막 한 자리의 동시 신청 결과를 확인한다."
  },
  {
    "id": "S-01", "area": "보안", "status": "unchecked",
    "check": "회원 화면과 응답에는 본인의 신청만 표시된다.",
    "evidence": "",
    "risk": "조회 범위가 어긋나면 다른 회원의 신청 정보가 노출될 수 있다.",
    "impact": 3, "likelihood": 3,
    "action": "가상 계정 두 개로 신청 내역의 소유권 검사를 확인한다."
  },
  {
    "id": "S-02", "area": "보안", "status": "pass",
    "check": "로그아웃하면 기존 세션으로 회원 화면을 열 수 없다.",
    "evidence": "로그아웃 뒤 기존 시험 세션이 로그인 화면으로 안내됐다."
  },
  {
    "id": "P-01", "area": "성능", "status": "unchecked",
    "check": "공지 이력이 쌓여도 목록 응답이 팀의 목표 범위에 든다.",
    "evidence": "",
    "risk": "공지 이력이 늘면 목록을 여는 데 시간이 걸릴 수 있다.",
    "impact": 2, "likelihood": 2,
    "action": "공지 이력이 쌓인 가상 데이터로 목록 응답을 측정한다."
  },
  {
    "id": "P-02", "area": "성능", "status": "pass",
    "check": "요약이 비어 있어도 공지 조회는 요약 작업을 기다리지 않는다.",
    "evidence": "가상 공지 조회 기록에서 요청 중 요약 호출이 없음을 확인했다."
  },
  {
    "id": "A-01", "area": "접근성", "status": "partial",
    "check": "키보드로 신청하고 입력 오류를 찾아 수정할 수 있다.",
    "evidence": "키보드로 신청 양식의 모든 입력과 제출 버튼에 도달했다.",
    "risk": "키보드 사용자가 오류 위치를 찾는 동안 신청이 지연될 수 있다.",
    "impact": 2, "likelihood": 3,
    "action": "키보드로 신청 양식의 오류 수정부터 재제출까지 확인한다."
  },
  {
    "id": "A-02", "area": "접근성", "status": "fail",
    "check": "공지의 첨부 자료 링크에서 자료의 이름을 알아볼 수 있다.",
    "evidence": "가상 공지의 첨부 자료 링크 두 개가 모두 같은 이름으로 표시됐다.",
    "risk": "참가자가 필요한 자료를 찾으려 여러 링크를 열 수 있다.",
    "impact": 1, "likelihood": 2,
    "action": "첨부 자료 링크에 자료 이름을 표시하고 다시 확인한다."
  },
  {
    "id": "O-01", "area": "운영", "status": "partial",
    "check": "교대 당번이 신청 오류 기록을 찾아 영향을 설명할 수 있다.",
    "evidence": "현재 당번이 가상 신청 오류 기록을 찾았다.",
    "risk": "당번 교대 때 신청 장애의 대응이 늦어질 수 있다.",
    "impact": 3, "likelihood": 2,
    "action": "교대 당번이 신청 오류 기록을 찾고 대응하는 훈련을 한다."
  },
  {
    "id": "O-02", "area": "운영", "status": "pass",
    "check": "신청 오류 기록에서 요청 식별자와 오류 분류를 읽을 수 있다.",
    "evidence": "가상 신청 오류 기록에서 요청 식별자와 오류 분류를 확인했다."
  }
]
"""


def read_checklist(raw_json):
    items = json.loads(raw_json)
    if not isinstance(items, list):
        raise ValueError("점검표는 JSON 배열이어야 한다.")

    seen_ids = set()
    for position, item in enumerate(items, start=1):
        label = f"{position}번째 항목"
        if not isinstance(item, dict):
            raise ValueError(f"{label}은 JSON 객체여야 한다.")

        for field in ("id", "area", "status", "check"):
            value = item.get(field)
            if not isinstance(value, str) or not value.strip():
                raise ValueError(f"{label}의 {field}에 문자열을 적어야 한다.")

        item_id = item["id"]
        if item_id in seen_ids:
            raise ValueError(f"{item_id} 식별자가 중복됐다.")
        seen_ids.add(item_id)

        if item["area"] not in AREAS:
            raise ValueError(f"{item_id}에 등록된 영역을 적어야 한다.")

        status = item["status"]
        if status not in POINTS:
            raise ValueError(f"{item_id}에 등록된 판정을 적어야 한다.")

        evidence = item.get("evidence")
        if not isinstance(evidence, str):
            raise ValueError(f"{item_id}의 근거는 문자열이어야 한다.")
        if status == "unchecked":
            if evidence.strip():
                raise ValueError(f"{item_id}의 미확인 근거 칸은 비워 둔다.")
        elif not evidence.strip():
            raise ValueError(f"{item_id}의 판정에는 관찰 근거가 필요하다.")

        if status != "pass":
            for field in ("risk", "action"):
                value = item.get(field)
                if not isinstance(value, str) or not value.strip():
                    raise ValueError(f"{item_id}의 {field}에 설명을 적어야 한다.")
            for field in ("impact", "likelihood"):
                value = item.get(field)
                if type(value) is not int or value not in (1, 2, 3):
                    raise ValueError(f"{item_id}의 {field}는 1~3의 정수여야 한다.")

    return items


def area_scores(items):
    for area in AREAS:
        area_items = [item for item in items if item["area"] == area]
        earned = sum(POINTS[item["status"]] for item in area_items)
        maximum = 2 * len(area_items)
        yield area, earned, maximum


def risk_value(item):
    return item["impact"] * item["likelihood"]


def priority_key(item):
    return (
        -risk_value(item),
        -item["impact"],
        STATUS_ORDER[item["status"]],
        item["id"],
    )


def next_actions(items):
    remaining = [item for item in items if item["status"] != "pass"]
    return sorted(remaining, key=priority_key)[:3]


def main():
    items = read_checklist(CHECKLIST_JSON)

    print("영역별 점수")
    for area, earned, maximum in area_scores(items):
        if maximum:
            percent = earned * 100 // maximum
            print(f"- {area}: {earned}/{maximum}점 ({percent}%)")
        else:
            print(f"- {area}: 점검 항목 없음")

    print()
    print("다음 할 일 (최대 3개)")
    actions = next_actions(items)
    if not actions:
        print("- 남은 점검 작업 없음")
    for rank, item in enumerate(actions, start=1):
        print(
            f"{rank}. [{item['id']} / {item['area']}] {item['action']} "
            f"(위험값 {risk_value(item)})"
        )


if __name__ == "__main__":
    main()

줄별 해설

  1. import json은 표준 라이브러리의 JSON 읽기 기능을 가져온다. AREAS는 화면에 표시할 영역의 순서를 고정한다. POINTS에서 영역별 점수에 쓸 배점을 찾고, STATUS_ORDER에서 위험과 영향이 같은 남은 항목의 순서를 찾는다. 통과 항목은 작업 후보에 들어가지 않으므로 두 번째 사전에는 통과 키가 없어도 된다.

  2. json.loads(raw_json)은 문자열을 파이썬 값으로 읽는다. 바로 이어지는 검사에서 최상위 값이 리스트인지 확인한다. enumerate(items, start=1)은 배열 안에서 몇 번째 항목을 고쳐야 하는지 알려 준다. 식별자를 읽은 뒤에는 seen_ids를 사용해 같은 식별자가 두 번 나오는 경우를 잡는다. 하나의 식별자로 설계도와 점검표를 오가려면 각각의 항목을 구분할 수 있어야 한다.

  3. evidence.strip()은 공백만 채운 근거를 빈 근거로 다룬다. 미확인 항목은 근거 칸을 비워 두며, 나머지 판정에는 관찰이 필요하다. 이어서 통과하지 않은 항목의 위험 문장과 작업 문장, 두 평가값을 검사한다. type(value) is not int는 정확하게 정수만 받도록 한다. 파이썬에서 불리언은 정수의 하위 유형이므로 이 검사가 없으면 JSON의 true가 값 1처럼 들어갈 수 있다. 이 검사는 기록 양식을 확인한다. 관찰 자체가 정확한지는 작성자가 실제 결과와 대조해 판단한다.

  4. area_scores는 영역마다 해당 항목을 모으고, 배점의 합과 가능한 최대 점수를 한 묶음으로 전달한다. yield를 만나면 호출하는 쪽에서 그 영역의 값을 받고, 반복을 계속할 때 다음 영역을 계산한다. main의 earned * 100 // maximum이 정수 백분율을 만든다. 항목이 없는 영역은 분모가 0이므로 별도 문구를 출력한다. 점검표가 비어 있을 때도 이 경로를 따른다.

  5. priority_key는 비교 기준 네 개를 튜플로 반환한다. 파이썬은 튜플을 앞 원소부터 비교하고 값이 같으면 다음 원소로 넘어간다. 위험값과 영향에는 음수를 붙여 큰 값이 오름차순 정렬의 앞에 오게 한다. 판정 순서와 항목 식별자는 그대로 비교한다. next_actions는 후보 전체를 정렬한 뒤 [:3]으로 앞의 세 항목만 고른다. 후보가 한두 개면 있는 만큼 출력한다.

  6. 마지막 if는 파일을 직접 실행할 때 main()을 호출한다. 이 조건 덕분에 별도의 검사에서는 같은 파일을 가져와 read_checklist나 next_actions에 직접 입력을 넣어 볼 수 있다. 기본 실행에서는 기록을 읽어 한 번 출력하고 끝난다.

실행 결과

첫 번째 명령은 경고를 오류로 처리하며 문법을 검사한다. 성공하면 메시지 없이 끝난다. 두 번째 명령으로 프로그램을 실행하면 아래 결과가 나온다. 기능의 3점은 통과 2점과 일부 확인 1점의 합이다. 두 번째와 세 번째 작업은 위험값이 각각 6이며, 영향이 3인 운영 항목이 영향이 2인 접근성 항목보다 먼저 나온다.

python3 -W error -m py_compile main.py
python3 main.py
영역별 점수
- 기능: 3/4점 (75%)
- 보안: 2/4점 (50%)
- 성능: 2/4점 (50%)
- 접근성: 1/4점 (25%)
- 운영: 3/4점 (75%)

다음 할 일 (최대 3개)
1. [S-01 / 보안] 가상 계정 두 개로 신청 내역의 소유권 검사를 확인한다. (위험값 9)
2. [O-01 / 운영] 교대 당번이 신청 오류 기록을 찾고 대응하는 훈련을 한다. (위험값 6)
3. [A-01 / 접근성] 키보드로 신청 양식의 오류 수정부터 재제출까지 확인한다. (위험값 6)

실무에서 자주 틀리는 것

공백도 관찰 근거로 받아들이는 경우

문자열의 참과 거짓만 검사하면 공백이 들어 있는 칸이 통과한다. 다음 잘못된 코드는 공백 세 칸을 근거가 있다고 판단해 True를 출력한다.

evidence = "   "
print(bool(evidence))

앞뒤 공백을 걷어 낸 뒤 빈 문자열인지 검사하면 False가 나온다. 완성 코드에서는 먼저 문자열인지 확인하므로 이 검사를 안전하게 적용할 수 있다.

evidence = "   "
print(bool(evidence.strip()))

실패를 분모에서 빼는 경우

통과한 항목만 남기고 가능한 최대 점수를 계산하면, 점검 결과가 통과와 실패인 영역도 100%로 보인다. 분모에서 빠진 실패는 화면에서도 눈에 띄기 어렵다.

points = [2, 0]
passed = [point for point in points if point == 2]
print(sum(passed) * 100 // (2 * len(passed)))

영역 안의 전체 항목으로 분모를 계산하면 같은 입력에서 50%가 나온다. 항목이 없는 경우에는 완성 코드처럼 별도 문구를 표시한다.

points = [2, 0]
maximum = 2 * len(points)
print(sum(points) * 100 // maximum if maximum else "점검 항목 없음")

동점을 입력 순서에 맡기는 경우

위험값만 정렬하면 동점에서 JSON에 먼저 적은 항목이 먼저 나온다. 아래에서는 두 항목의 위험값이 6이고, 접근성이 먼저 나온다. 표 편집 중 행을 옮기기만 해도 출력 순서가 바뀐다.

actions = [("접근성", 2, 3), ("운영", 3, 2)]
ordered = sorted(actions, key=lambda row: -(row[1] * row[2]))
print(ordered[0][0])

동점에서는 영향이 큰 항목을 앞에 둔다는 규칙을 추가하면 운영이 먼저 나온다. 완성 코드에서는 영향까지 같은 경우를 위해 판정과 식별자도 확인한다.

actions = [("접근성", 2, 3), ("운영", 3, 2)]
ordered = sorted(actions, key=lambda row: (-(row[1] * row[2]), -row[1]))
print(ordered[0][0])

한눈에 보기

다음 점검 때 다시 사용할 기록과 판단 기준
기록적을 내용사용할 때
점검표식별자, 영역, 통과 조건, 판정, 관찰 근거다른 사람이 같은 조건으로 확인한다.
영역별 점수얻은 점수, 최대 점수, 정수 백분율확인이 덜 끝난 영역을 찾는다.
남은 위험 목록발생 조건, 사용자에게 생길 결과, 영향, 가능성가정과 관찰 결과를 비교해 평가를 갱신한다.
다음 작업위험 우선순위가 높은 세 항목의 행동, 담당자, 종료 조건착수할 일을 고르고 마친 뒤 다시 점검한다.
포트폴리오설계도의 경로, 결정 이유, 관련 점검 식별자와 근거검토자가 선택 이유와 검증 결과를 따라간다.

연습 문제

  1. 가상 계정 두 개로 각각 본인의 신청만 조회된다는 사실을 확인했다고 가정한다. S-01의 판정과 근거를 바꾼다. 보안 점수와 다음 작업 세 개의 순서를 실행 전에 계산하고 출력과 비교한다.
  2. F-02와 P-01의 판정을 모두 미확인으로 맞추고, 여섯 개의 남은 후보를 모두 보고 싶다면 잠시 [:3]을 [:6]으로 바꾼다. 두 항목의 순서를 확인하고 JSON에서 두 항목의 위치를 맞바꿔 다시 실행한다.
  3. O-02의 근거를 공백으로만 바꿔 실행한다. 어떤 검사에서 멈추는지 확인한다. 이어서 기본 JSON으로 되돌리고 운영 항목 두 개를 모두 제거한 뒤 영역별 점수를 확인한다.
  4. 요약이 비어 있는 공지에서도 신청 안내가 보이는지 확인한 경험을 포트폴리오 문단으로 작성한다. 설계도에서 가리킬 위치, 그렇게 설계한 이유, 확인에 사용한 조건과 관찰 결과를 포함한다. 확인한 적이 없다면 가상 시험 계획과 예상 결과로 표시한다.

정답과 해설

  1. S-01의 판정을 pass로 바꾸고 evidence에 ‘가상 계정 두 개로 각각 로그인해 화면과 응답에 본인의 신청만 표시됨을 확인했다’라고 적을 수 있다. 남은 위험과 관련한 네 필드는 지워도 된다. 보안은 4/4점으로 100%가 된다. 작업 순서는 O-01, A-01, P-01이다. 마지막 자리는 위험값과 영향이 같은 F-02와 P-01이 경쟁하며, 미확인인 P-01이 일부 확인인 F-02보다 앞선다.

  2. F-02의 판정을 unchecked로 바꾸면서 근거를 빈 문자열로 바꾼다. 두 항목의 위험값은 4, 영향은 2, 판정은 미확인으로 같다. 식별자에서 F-02가 P-01보다 앞선다. 배열에서 위치를 바꿔도 이 순서는 유지된다. 확인을 마치면 출력 제한을 세 개로 되돌린다.

  3. O-02는 통과 항목이므로 read_checklist에서 O-02의 판정에는 관찰 근거가 필요하다.라는 오류가 발생한다. 읽기 단계에서 멈추므로 영역 점수를 출력하기 전이다. 기본 JSON에서 운영 두 항목을 모두 제거하면 영역 목록에는 운영이 남아 있어 - 운영: 점검 항목 없음이 출력된다. 후보 목록에서도 O-01이 빠진다. 기본 예제와 같은 범위를 다시 확인하려면 제거한 두 항목을 복구한다.

  4. ‘설계도의 공지 상세 화면에서 원문 아래에 신청 안내를 둔다. 요약을 만들 수 없는 상태에서도 참가자가 모집 조건을 읽고 신청 경로를 찾을 수 있게 하기 위해서다. 가상 공지의 요약을 비운 뒤 상세 화면을 열어 원문과 신청 안내가 둘 다 표시되는지 확인한다. 확인 결과는 공지 상세 화면의 점검 항목에 연결한다’라고 쓸 수 있다. 이 예시는 시험 계획이다. 실행한 뒤에는 사용한 공지 식별자와 실제 관찰을 적고 판정을 갱신한다.

처음 그린 설계도는 어떤 사이트를 만들지 이야기하는 데 쓰였다. 책을 마치는 시점에는 같은 설계도에서 무엇을 확인했고 다음에 어디를 손볼지 설명할 수 있다. 첫 개선을 마치면 당시의 관찰을 점검표에 남기고 새 순서를 계산한다. 그 기록을 다음 운영 담당자에게 넘기면 담당자는 같은 조건에서 결과를 확인하고 이어서 개선할 수 있다.

오탈자·오류 제보 비공개로 접수되어 원고 수정에 반영됩니다

이메일 등 개인정보는 받지 않습니다. 답변이 필요한 질문은 아래 댓글을 이용해 주세요.

READER FEEDBACK

질문·의견

내용에 관한 질문이나 더 나은 설명을 위한 의견을 남겨 주세요. 오탈자는 위의 제보 양식이 더 빨리 반영됩니다. 이 댓글은 원래 게시글과 같은 자리에 쌓입니다.

댓글 0

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

댓글을 남기려면 로그인이 필요합니다.