계약관리시스템 API 가이드

// ─────────────────────────────────────────
// 계약관리시스템 API 클라이언트 (JavaScript)
// ─────────────────────────────────────────
const BASE = 'https://contract.sinwoodnc.com/tables';

// 1. 전체 계약서 조회
async function getContracts(page = 1, limit = 20) {
  const res = await fetch(`${BASE}/contracts?page=${page}&limit=${limit}`);
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return await res.json();
  // { data: [...], total: N, page: 1, limit: 20 }
}

// 2. 특정 계약서 조회
async function getContract(id) {
  const res = await fetch(`${BASE}/contracts/${id}`);
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return await res.json();
}

// 3. 계약서 생성
async function createContract(payload) {
  const res = await fetch(`${BASE}/contracts`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(payload),
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return await res.json(); // 생성된 레코드 반환 (id 포함)
}

// 4. 계약서 상태 변경 (PATCH)
async function updateContractStatus(id, status) {
  const res = await fetch(`${BASE}/contracts/${id}`, {
    method: 'PATCH',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ status }),
  });
  return await res.json();
}

// 5. 계약서 삭제
async function deleteContract(id) {
  const res = await fetch(`${BASE}/contracts/${id}`, {
    method: 'DELETE',
  });
  return res.status === 204; // true면 성공
}

// 6. 만료 임박 계약 (30일 이내) 조회
async function getExpiringContracts() {
  const { data } = await getContracts(1, 200);
  const today = new Date();
  return data.filter(c => {
    if (!c.end_date || c.status === '만료') return false;
    const end  = new Date(c.end_date);
    const diff = Math.round((end - today) / 86400000);
    return diff >= 0 && diff <= 30;
  });
}

// ─── 사용 예시 ───
(async () => {
  // 전체 조회
  const { data, total } = await getContracts();
  console.log(`전체 계약 ${total}건:`, data);

  // 만료 임박 조회
  const expiring = await getExpiringContracts();
  console.log('30일 이내 만료:', expiring.map(c => c.title));

  // 새 계약서 생성
  const newContract = await createContract({
    title: 'API로 생성한 계약',
    contract_number: 'CT-2025-999',
    contract_type: '용역계약',
    status: '초안',
    client_name: '테스트 회사',
    amount: 5000000,
    priority: '보통',
  });
  console.log('생성된 계약 ID:', newContract.id);
})();

import requests
from datetime import date, timedelta

BASE = "https://contract.sinwoodnc.com/tables"

# ─── 1. 전체 계약서 조회 ───
def get_contracts(page=1, limit=50):
    r = requests.get(f"{BASE}/contracts", params={"page": page, "limit": limit})
    r.raise_for_status()
    return r.json()

# ─── 2. 계약서 생성 ───
def create_contract(payload: dict):
    r = requests.post(
        f"{BASE}/contracts",
        json=payload,
        headers={"Content-Type": "application/json"},
    )
    r.raise_for_status()
    return r.json()

# ─── 3. 상태 업데이트 (PATCH) ───
def update_status(contract_id: str, status: str):
    r = requests.patch(
        f"{BASE}/contracts/{contract_id}",
        json={"status": status},
        headers={"Content-Type": "application/json"},
    )
    r.raise_for_status()
    return r.json()

# ─── 4. 만료 임박 조회 → 알림 ───
def alert_expiring(days=30):
    data = get_contracts(limit=200)["data"]
    today = date.today()
    threshold = today + timedelta(days=days)

    expiring = []
    for c in data:
        if not c.get("end_date") or c.get("status") in ("만료", "해지"):
            continue
        end = date.fromisoformat(c["end_date"])
        if today <= end <= threshold:
            expiring.append(c)

    for c in expiring:
        end = date.fromisoformat(c["end_date"])
        remaining = (end - today).days
        print(f"⚠️  [{c['contract_number']}] {c['title']} — D-{remaining} ({c['end_date']})")
    return expiring

# ─── 실행 ───
if __name__ == "__main__":
    result = get_contracts()
    print(f"전체 계약 {result['total']}건")

    # 만료 임박 알림
    alert_expiring(days=30)

# ─── 전체 계약서 조회 ───
curl "https://contract.sinwoodnc.com/tables/contracts?limit=50"

# ─── 특정 계약서 조회 ───
curl "https://contract.sinwoodnc.com/tables/contracts/uuid-xxxx-xxxx"

# ─── 새 계약서 생성 ───
curl -X POST "https://contract.sinwoodnc.com/tables/contracts" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "cURL로 생성한 계약",
    "contract_number": "CT-2025-010",
    "contract_type": "용역계약",
    "status": "초안",
    "client_name": "테스트 클라이언트",
    "amount": 10000000,
    "priority": "보통"
  }'

# ─── 상태 변경 (PATCH) ───
curl -X PATCH "https://contract.sinwoodnc.com/tables/contracts/uuid-xxxx-xxxx" \
  -H "Content-Type: application/json" \
  -d '{"status": "서명완료", "signed_date": "2025-04-10"}'

# ─── 계약서 삭제 ───
curl -X DELETE "https://contract.sinwoodnc.com/tables/contracts/uuid-xxxx-xxxx"

# ─── 첨부파일 목록 조회 ───
curl "https://contract.sinwoodnc.com/tables/contract_files?limit=100"