계약관리시스템 API 가이드

// 계약서 + 청구 데이터를 조합하여 입금 현황 집계
async function getBillingStatus(contractId) {
  // 계약 정보 조회
  const cRes = await fetch(
    `https://contract.sinwoodnc.com/tables/contracts/${contractId}`
  );
  const contract = await cRes.json();

  // 해당 계약의 청구 내역 조회 (전체)
  const bRes = await fetch(
    `https://contract.sinwoodnc.com/tables/billing_records?limit=200`
  );
  const { data: allBillings } = await bRes.json();
  const billings = allBillings
    .filter(b => b.contract_id === contractId)
    .sort((a, b) => a.billing_seq - b.billing_seq);

  // 집계
  const totalAmount  = contract.amount || 0;
  const totalBilled  = billings.reduce((s, b) => s + (b.billing_amount || 0), 0);
  const totalPaid    = billings.reduce((s, b) => s + (b.paid_amount    || 0), 0);
  const remaining    = totalAmount - totalBilled;
  const collectRate  = totalAmount > 0
    ? Math.round(totalPaid / totalAmount * 100) : 0;

  // 연체 항목 확인
  const today    = new Date();
  const overdues = billings.filter(b =>
    b.due_date &&
    new Date(b.due_date) < today &&
    b.status !== 'paid'
  );

  return {
    contract,
    billings,
    summary: {
      totalAmount,   // 계약 총액
      totalBilled,   // 총 청구액
      totalPaid,     // 총 입금액
      remaining,     // 잔여 미청구액
      collectRate,   // 입금률(%)
      overdueCount: overdues.length  // 연체 건수
    }
  };
}

// 사용 예시
const result = await getBillingStatus('YOUR_CONTRACT_ID');
console.log(`입금률: ${result.summary.collectRate}%`);
console.log(`연체 ${result.summary.overdueCount}건`);

const BASE = 'https://YOUR_DOMAIN/tables/transactions';

// ── 거래 목록 조회 (전체) ──
async function getTxList(page=1, limit=100) {
  const res = await fetch(`${BASE}?page=${page}&limit=${limit}`);
  return await res.json();
  // { data: [...], total: 50, page: 1, limit: 100 }
}

// ── 거래 등록 예시: 부가세 납부 ──
async function addTax() {
  const res = await fetch(BASE, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      tx_date:    '2025-04-01',
      tx_type:    'expense',       // 출금
      category:   '부가세납부',
      title:      '2025년 1기 부가세 확정신고 납부',
      amount:     3850000,
      counterpart:'국세청',
      account:    '국민은행 123-456',
      department: '공통',
      tax_invoice_no: '',
      note:       '홈택스 납부'
    })
  });
  return await res.json();
}

// ── 거래 등록 예시: 대금 입금 (계약 연결) ──
async function addPaymentReceived(contractId) {
  const res = await fetch(BASE, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      tx_date:    '2025-04-10',
      tx_type:    'income',        // 입금
      category:   '대금입금',
      title:      'DH25007-30 1회차 기성금 입금',
      amount:     55000000,
      counterpart:'㈜테크솔루션',
      account:    '국민은행 123-456',
      department: '감리부',
      contract_id: contractId,    // 계약서 연결
      tax_invoice_no: '20250405-001'
    })
  });
  return await res.json();
}

// ── 월별 입출금 집계 ──
async function getMonthlySummary(yearMonth) {
  // yearMonth: '2025-04'
  const res = await fetch(`${BASE}?limit=200`);
  const { data } = await res.json();
  const monthData = data.filter(t => (t.tx_date||'').startsWith(yearMonth));
  const income  = monthData.filter(t=>t.tx_type==='income' ).reduce((s,t)=>s+Number(t.amount||0),0);
  const expense = monthData.filter(t=>t.tx_type==='expense').reduce((s,t)=>s+Number(t.amount||0),0);
  return { income, expense, balance: income - expense, count: monthData.length };
}

// ─────────────────────────────────────────
// 계약관리시스템 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 === '만료' || 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: 'DH25999-30',
    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": "DH25010-30",
    "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"