협력사 품질서류와 갱신일을 관리하는 포털 플랫폼 제작하기

핵심 요약

1. 품목별 필수서류와 유효기간을 함께 관리해 협력사가 제출하거나 갱신할 서류를 확인하도록 만듭니다. 2. FastAPI의 파일 접수, Django의 인증, Celery beat의 주기 작업을 업무에 맞게 연결합니다. 3. 필수첨부 검사, 협력사별 열람 제한, 반려·재제출 이력과 담당자 확인 절차는 직접 개발합니다.

제조사 협력사의 품질서류는 파일을 받는 것만으로 관리가 끝나지 않습니다. 어떤 품목에 필요한 서류인지, 언제 만료되는지, 담당자가 확인했는지까지 연결되어야 합니다. 이 글은 이러한 플랫폼 제작을 발주할 때 정할 기능과 검수 기준을 설명하는 구현안입니다.

품목별 필수첨부와 FastAPI 파일 접수

협력사가 품목을 선택하면 해당 품목에 필요한 서류와 입력 항목을 보여줍니다. 발주 자료로는 ‘품목코드 A-102, 필수서류 시험성적서, 허용 형식 PDF’처럼 정리한 품목별 서류 목록을 요청합니다. FastAPI는 UploadFile로 업로드 파일을 받을 수 있습니다.

접수 기능에 더해 파일 형식·크기 검사, 보관 방식과 품목 연결 규칙을 직접 개발합니다. 제출 버튼을 누르면 필수서류가 모두 있는지 확인하고, 빠진 항목을 파일 선택란 옆에 표시합니다. 검수에서는 파일을 선택하지 않았거나 허용하지 않은 형식으로 첨부했을 때 제출이 막히는지 확인합니다.

Django 인증으로 협력사별 열람 범위 연결

Django는 사용자·그룹·권한을 다루는 인증 체계를 제공합니다. 여기에 계정별 소속 협력사와 제조사 담당자의 관리 품목을 연결하는 업무 규칙을 추가합니다. 협력사 담당자는 자기 회사의 제출 내역을 보고, 제조사 담당자는 배정받은 범위의 서류를 확인하도록 만듭니다.

목록 화면에서 다른 회사의 서류를 숨기는 것만으로는 충분하지 않습니다. 파일 접수·조회·다운로드 요청마다 서버가 소속과 권한을 검사하도록 연결해야 합니다. 대표적인 실패 사례는 A사 계정이 B사의 파일 주소를 직접 입력했을 때 서류가 열리는 경우이며, 이 요청이 차단되는지 검수합니다.

반려 사유가 이어지는 재제출 화면

제조사 담당자가 반려 버튼을 누르면 사유를 입력하고 수정이 필요한 첨부파일을 지정하게 합니다. 협력사 화면에는 해당 사유와 재제출 버튼을 함께 표시합니다. 여러 서류 중 한 장만 수정해야 할 때 전체 자료를 다시 올려야 하는지는 발주 단계에서 정합니다.

파일 접수 기능 위에 제출 차수와 이전 파일을 연결하는 이력 관리 규칙을 직접 개발합니다. 새 파일을 올려도 이전 제출본과 반려 사유를 남기고, 검토 화면에서는 이번에 바뀐 첨부를 구분해 보여줍니다. 재제출 후에는 담당자가 새 파일을 다시 확인해야 하며, 이전 파일의 확인 결과가 그대로 적용되지 않는지 점검합니다.

Celery beat로 유효기간 갱신 대상 확인

유효기간 관리를 위해 발급일과 만료일을 입력받고, 만료일이 없는 서류는 별도로 구분합니다. 준비 자료로는 실제 사용하는 품질서류 견본에 ‘만료일 위치, 갱신 안내 시점, 확인 담당자’를 표시한 예시를 요청합니다. Celery beat는 정해진 주기로 작업을 보내고 워커라는 실행 프로그램이 이를 처리하게 합니다.

만료일을 비교해 갱신 대상을 찾는 기준과 안내 내역을 기록하는 기능은 직접 개발합니다. 중복 스케줄러나 겹치는 작업 때문에 같은 안내가 반복되지 않도록 실행과 발송을 통제합니다. 검수에서는 만료일이 오늘인 서류, 이미 지난 서류, 만료일이 없는 서류가 합의한 기준에 따라 구분되고 중복 안내가 발생하지 않는지 확인합니다.

담당자 확인과 품목별 제출 현황

제조사 담당자의 확인 화면에는 첨부파일, 제출 회사, 대상 품목과 유효기간을 함께 보여줍니다. 담당자가 내용을 검토한 뒤 확인 버튼을 누르면 확인자와 확인 일시를 기록합니다. 파일 업로드 성공만으로 내용 검토가 완료된 것으로 처리하지 않도록 별도 절차를 만듭니다.

품목별 현황 화면에서는 필수서류 누락, 담당자 확인 대기, 갱신 필요 항목을 구분해 보여줍니다. 웹 개발 외주 범위에는 각 표시의 판단 기준과 갱신 서류를 언제 유효한 제출본으로 인정할지도 포함합니다. 새 서류를 올린 직후와 담당자가 확인한 이후의 화면을 각각 점검하면, 갱신 대상에서 서류가 너무 일찍 빠지는 문제를 확인할 수 있습니다.

품목별 필수서류 목록과 만료일을 표시한 서류 견본을 준비해, 협력사별 열람 범위와 반려·재제출 절차를 포함한 포털 개발을 트램스 AI에 문의해 주시기 바랍니다. 트램스 AI 제작 문의 (https://trams.co.kr/ai-si/contact/#inquiry)