get_safety_agreement (무사고 동의서 조회)

본인이 업로드한 무사고 동의서 파일 목록을 조회합니다.

기본 정보

항목	값
URL	https://asia-northeast3-construction24-test.cloudfunctions.net/get_safety_agreement
Method	POST
인증	Firebase ID Token 필요
권한	현장 소속 근로자/장비

요청

Body

필드	타입	필수	설명	검증
company_id	string	O	회사 ID	-
site_id	string	O	현장 ID	-

요청 예시

{
  "company_id": "company_123",
  "site_id": "site_456"
}

응답

성공 (200)

{
  "status": "ok",
  "message": "무사고 동의서 조회 완료",
  "data": {
    "files": [
      {
        "id": "file_doc_id",
        "filename": "agreement.jpg",
        "size": 1048576,
        "mime": "image/jpeg",
        "doc_page": "safety-agreement",
        "related_doc_id": "user_uid",
        "tags": {
          "signed_date": "2026-02-25"
        },
        "uploaded_at": "2026-02-25T10:30:00+09:00"
      }
    ]
  }
}

파일이 없는 경우 (200)

{
  "status": "ok",
  "message": "무사고 동의서 조회 완료",
  "data": {
    "files": []
  }
}

실패

코드	message	원인
400	"필수 필드가 누락되었습니다"	필수 입력값 누락
403	"권한이 없습니다"	현장 소속이 아님
500	"서버 오류"	내부 오류

참고

• 본인이 업로드한 무사고 동의서만 조회됩니다 (UID 기준 필터링).
• get_safety_agreement_upload_token으로 업로드한 파일의 메타데이터를 반환합니다.
• 파일 메타데이터는 companies/{company_id}/sites/{site_id}/files 컬렉션에 저장되어 있습니다.