수업 사진을 포트폴리오로 옮기며 출처 표를 남겼다

사진과 설명을 함께 옮길 때 생기는 질문

포트폴리오를 다시 구성하면 사진 파일과 게시글, 카드 문구가 서로 다른 경로로 움직일 수 있다. 원래 작업에는 자산과 글, 설명 근거를 연결하는 기록이 있다. 나는 이를 이미지 정리표를 넘어서 어떤 문장이 어느 사진을 참고했는지 남기는 구조로 읽었다. 파일 이름만 안다고 주장의 범위까지 알 수는 없다.

이번 글에는 실제 수업 사진과 인물, 장소 정보를 넣지 않았다. 새 예제는 독립 도형 하나와 그 도형이 보인다는 좁은 주장만 사용한다. 기존 작업의 판단을 공개하면서도 고객 원본 미디어와 실제 활동 기록을 함께 노출하지 않기 위해서다. 사진 원본을 쓰지 않아도 연결 계약은 설명할 수 있다.

자산에서 주장으로 가는 참조를 만들었다

새 lineage 함수는 자산 id와 origin, permission_note를 받고 주장 id와 asset, claim, evidence, reviewed를 연결한다. 존재하지 않는 자산을 가리키는 주장과 중복 식별자는 거절한다. 검토 표시가 없거나 참이 아니어도 실패한다. 어떤 파일과 어떤 문장을 함께 살펴야 하는지 찾을 수 있게 만드는 검사다.

reviewed가 참이라고 실제 사람이 무엇을 확인했는지 자동으로 증명하지는 않는다. 코드가 사진을 인식하거나 인물 동의를 확인하는 것도 아니다. 자동 참조 검사와 실제 설명의 적절성을 판단하는 검토는 다른 책임이다. 함수 이름과 출력에도 자동 진실 판단을 하지 않는다고 남겼다.

보이는 사실과 해석한 성과를 구별한다

합성 도형이 보인다는 주장과 그 도형을 본 사람이 어떤 능력을 얻었다는 주장은 다르다. 사진도 마찬가지다. 공간과 활동 도구가 보이는 장면을 참여자의 만족도와 교육 효과의 근거처럼 확대하지 않도록 문장을 좁혀야 한다. 이번 예제는 실제 교육 효과를 소개하거나 평가하지 않는다.

캡션은 사진에서 확인할 수 있는 장면과 제공자가 별도로 확인한 맥락을 구별하면 좋다. 원래 작업 기록을 읽을 때도 요청한 문구와 실제 자료가 뒷받침하는 문구를 같은 것으로 취급하지 않았다. 계획과 최종 파일이 다를 수 있으므로 공개 문장에는 확인한 범위만 남기는 편집 기준을 적용했다.

이미지를 교체할 때 참조도 다시 본다

같은 자산 id 아래에 다른 파일을 덮어쓰면 참조 검사만으로는 내용 변경을 모를 수 있다. 현재 작은 모듈은 바이트 해시와 파일 저장을 구현하지 않는다. 실제 적용에서는 파일 버전이나 해시를 연결하고 이미지를 바꾼 뒤 관련 주장을 다시 검토하는 절차를 추가해야 한다. id가 같다고 같은 근거라고 가정하지 않는다.

사용 범위 메모 역시 권한을 부여하는 증서가 아니다. 실제 공개 권한과 인물 정보 처리는 별도 확인이 필요하다. 나는 이 제한을 감추지 않고 어떤 부분이 자동 검사이고 어떤 부분이 사람이 이어갈 검토인지 문서에 남겼다. 원래 고객 사진을 더 많이 가져오는 것으로 이 차이를 해결하지 않았다.

포트폴리오의 설득을 근거와 연결한다

근거 표현 패키지의 전체 12개 테스트에는 참조 연결과 고아 주장, 중복 자산과 입력 보존이 있다. 기록 뷰어는 실제 실행에서 남긴 합성 결과를 보여 준다. 브라우저에서 고객 사진을 불러오거나 원래 업체 사이트를 변경하지 않는다. 패키지에는 수정·재사용 가능한 새 코드만 담았다.

포트폴리오는 멋진 이미지를 나열하면서도 그 장면을 왜 골랐고 무엇을 설명하는지 말할 수 있어야 한다. 나는 제작자가 사진을 선택한 판단과 설명의 근거를 함께 남기고 싶었다. 다른 업종에서도 이미지가 보여 주는 것과 그 옆 문장이 요구하는 증거를 한 번씩 나누어 보면 과장 없이 구체적인 이야기를 만들 수 있다.

설명에 필요한 자료가 없을 때

근거가 모자란 문장을 사진 옆에 두어 설득력을 보충하지 않는다. 표현을 확인한 장면으로 좁히거나 추가 자료가 필요하다고 남길 수 있다. 이것은 포트폴리오를 약하게 만드는 일보다 설명의 책임을 분명히 하는 일이다. 새 모듈의 고아 참조 오류도 같은 방향으로, 없는 근거를 그럴듯한 기본값으로 바꾸지 않는다.