이수 기준이 둘 필요한 분류

그룹 교육 포털에 과정을 publish_course() 로 등록하는데 이수 기준 completion_rule 을 조회할 수 없다는 오류가 났다. 값의 형식이 문제인가 싶어서 몇 가지로 바꿔 보냈지만 결과가 같았다.

Open Table of contents

증상 — 조회할 수 없다는 오류

형식을 바꿔서 안 되면 형식 문제가 아니라는 뜻이다. 그래서 같은 category 의 다른 과정은 어떻게 등록됐는지를 portal_course_links 에서 보기로 했다.

다른 과정들을 보니 그것들도 이 category 에서는 등록이 안 돼 있었다. 특정 건의 문제가 아니라 이 분류 전체의 문제였다.

포털 쪽 요구사항을 확인해 보니 직무교육 분류는 이수 기준을 출석과 평가 두 종류로 나눠서 보내야 하는 것이었다. 우리 구조는 과정 하나에 completion_rule 하나만 붙일 수 있었다.

그러면 값을 어떻게 고쳐도 등록이 안 된다. 개별 정정을 이어가는 것 대신 구조적 제약을 먼저 보는 쪽을 골랐다. 이유는 개별 건을 정정하는 방향으로 계속 갔으면 될 때까지 값만 바꿔 보다가 시간을 썼을 것이라서다.

찾는 과정에서 비슷한 오류가 예전 issues.md 에 있었던 기록을 봤는데 그때는 값을 고쳐서 해결됐다고 적혀 있었다. 그것을 보고 같은 방법을 시도한 것이 처음에 시간을 쓴 이유였다.

확인해 보니 그 사례는 category 가 달라서 조건 자체가 달랐다. 그래서 기록에 이 사례가 그 건의 해결 사례가 아니라는 것을 명시해 뒀다.

더 찾아보니 이 제약이 예전에도 한 번 확인된 적이 있었는데 그 결론이 메신저 대화에만 남고 docs/portal-api.md 에는 안 들어가 있었다. 그래서 이번에 다시 처음부터 발견한 셈이 됐다.

대화에 있는 것은 어떤 표현으로 찾아야 할지를 알아야 검색되므로 사실상 안 찾아진다. 문서화가 안 되면 같은 것이 여러 번 발견되고 그때마다 같은 시간이 든다.

이 제약은 우리 구조를 바꿔야 풀리는 것이라 그 자리에서 조치할 수 없었다. 그래서 completion_rule 을 다중으로 바꾸는 스키마 변경이 필요하다는 것과 왜 지금 못 하는지를 docs/portal-api.md 에 함께 적어 두었다.

기록에 미완인 것을 그대로 적어 두는 것이 다음 사람에게는 답이 된다. CHECKLIST.md 의 확인 순서도 함께 바꿨는데 개별 정정 전에 구조적 제약을 먼저 보는 것이 첫 항목이 됐다.