[26.10.30] 알툴즈 AI API의 정책 관리를 위한 코드 역분석과 관리 화면 구성하기

기능별 한도를 한 화면에서 비교하고 수정하기

기능을 하나씩 출시하면서 PC와 모바일, 구독 상품별 횟수 규칙도 기능별 코드에서 따로 관리됐습니다. 앞선 작업에서 사용자 정보와 사용 기록이 나뉜 6개 테이블을 ai_request 하나로 통합했고, 이를 바탕으로 횟수 관리 코드도 한곳에 모으려 했습니다.

AS-IS	TO-BE

성공한 요청만 사용 횟수에 포함하도록 통일했다가 기존 동작으로 되돌렸습니다. 원래 실패와 취소도 사용 횟수에 포함하던 기능의 이용 조건이 바뀌었기 때문입니다.

사용 횟수에 포함하는 시점과 조건은 기능별로 유지하고, 코드에 있던 한도 설정을 정책표로 모았습니다.

기능별 한도를 한 화면에서 비교할 수 없었습니다

기존 화면에서는 한 번에 한 기능의 한도만 조회할 수 있었습니다. 다른 기능과 비교하려면 앞서 본 값을 기억하거나 기능을 다시 선택해 확인해야 했습니다. 여러 기능의 한도를 함께 비교하는 화면을 설계하려고 NN/g의 두 자료를 읽었습니다.

Memory Recognition and Recall in User Interfaces에서 배운 점

• Recall과 Recognition 구분: Recall은 기억 속의 정보를 떠올리는 방식이고, Recognition은 보이는 정보나 단서를 통해 대상을 알아보는 방식입니다. 작업에 필요한 값을 화면에 표시하면 사용자가 그 값을 외워둘 필요가 줄어듭니다.
• 조작 방법과 작업 데이터 표시: 메뉴와 버튼의 기능을 이름으로 설명하고, 작업에 필요한 데이터도 화면에서 확인할 수 있게 해야 합니다.
• 현재 작업 화면에 안내 배치: 필요한 도움말을 작업 화면에서 제공해, 사용법을 외워두지 않고 참고할 수 있게 해야 합니다.

Comparison Tables for Products, Services, and Features에서 배운 점

• 항목명과 값 표기 통일: 같은 속성은 항목명과 값의 표기를 통일하고, 비교에 필요한 값이 누락되지 않도록 해야 합니다.
• 비교 대상은 열, 속성은 행에 배치: 비교 대상을 열 제목에, 속성을 행 제목에 놓습니다. 텍스트 정렬을 맞추고 행 경계를 표시해 어느 항목의 값인지 구분하도록 합니다.
• 스크롤 중 열 제목 고정: 열 제목을 고정해, 사용자가 비교 대상의 이름을 다시 확인하려고 표 위쪽으로 돌아가지 않도록 해야 합니다.
• 판단에 영향을 주는 속성 우선: 제품이나 서비스를 고를 때 실제 판단에 쓰는 속성을 우선하고, 선택과 관계없는 정보는 제외해야 합니다.

비교할 한도를 함께 표시하고 표에서 수정하기

이번에는 비교할 값을 함께 표시하는 것과 같은 항목의 값을 같은 행에서 비교하는 것을 적용했습니다. 기능을 행, 사용자 유형을 열로 배치해 여러 기능의 한도를 동시에 표시했습니다. 한도를 확인한 자리에서 수정할 수 있도록 표 안에 입력칸을 뒀습니다.

기존: 선택한 기능의 한도만 표시	개선: 여러 기능의 한도 동시 표시