settlement-invoice Templates
`settlement-invoice` 스킬이 산출물을 만들 때 쓰는 세 가지 템플릿입니다 — 아티팩트 HTML,
settlement-invoice 스킬이 산출물을 만들 때 쓰는 세 가지 템플릿입니다 — 아티팩트 HTML,
구글 시트 워크북 생성 스크립트, 로컬 설정 파일. 전부 {{PLACEHOLDER}} 토큰을 실제 값으로
치환해서 씁니다. 이 문서 자체에는 실제 회사 정보·연락처를 넣지 않습니다 — 이 저장소는
공개 저장소이고, 실제 값은 항상 대상 프로젝트의 로컬 설정에서만 옵니다.
1. 로컬 설정 템플릿#
<대상 저장소>/.claude/settlement/<slug>.config.md 에 이 형태로 만듭니다. 예시 값은 전부
가상의 자리표시자입니다 — 실제 등록번호·연락처로 바꿔 쓰세요.
---
project: "{{프로젝트 이름 (예: 예시서비스)}}"
slug: "{{URL/파일명에 쓸 짧은 식별자 (예: example-app)}}"
---
## 공급자 (용역 수행사)
- 회사명: {{공급자 회사명}}
- 사업자등록번호: {{등록번호}}
- 대표자: {{대표자명}}
- 사업장 주소: {{주소}}
- 담당자: {{담당자명}} ({{직책}})
- 담당자 연락처: {{이메일 / 전화 — 개인정보라 판단되면 별도 gitignore 파일로 분리}}
## 발주처 (클라이언트)
- 회사명: {{발주처 회사명}}
- 담당자: {{담당자명}}
- 담당자 연락처: {{이메일 / 전화}}
## 요율
- 단가: {{예: 200000}} 원 / M·D
- 표준 공수 적용률: {{예: 0.2}}
- VAT: {{별도 | 포함}}
## 분류 체계 (기능 영역)
- {{영역 1 (예: 회원·인증·계정)}}
- {{영역 2 (예: 결제·정산)}}
- ...(프로젝트 실제 모듈 구성에 맞춰 정의)
## 이전 계약 범위로 이미 합의된 항목
- {{계약서 조항 인용 1}}
- {{계약서 조항 인용 2}}
## CI/CD 인프라 사용료 별도 청구 여부
- {{예 (자체 러너 운영) | 아니오 (클라우드 CI만 사용)}}
## 구글 시트
- 기존 추적 시트 fileId: {{URL의 /d/ 뒤 문자열}}
- (get_file_metadata 로 조회한) 상위 폴더 parentId: {{조회 결과 캐시 — 최초 1회 확인 후 기록}}2. 아티팩트 HTML 템플릿#
CSS는 그대로 재사용합니다(테마 대응·반응형이 이미 처리돼 있습니다). {{...}} 부분과
`` 로 표시된 반복 구간만 실제 데이터로 채웁니다. 발행 전 artifact-design
스킬을 먼저 로드하세요 — 이 템플릿은 그 스킬이 요구하는 시스템 규약(테마 토큰 완전성·
반응형·자기완결 CSS)을 이미 만족하도록 만들어졌습니다.
<title>{{PROJECT_NAME}} {{PERIOD_LABEL}} 정산 내역</title>
<style>
:root {
--paper: #FCFDFC;
--card: #FFFFFF;
--panel: #F1F5F3;
--ink: #121917;
--ink-2: #4B5754;
--ink-3: #7E8B87;
--rule: #DEE6E2;
--rule-2: #BCC8C3;
--accent: #16594B;
--accent-2: #0E3F35;
--accent-soft:#E3EEEA;
--free: #6F7C78;
--free-soft: #EDF0EE;
--warn: #8A5E1C;
--warn-soft: #F7F0E4;
--on-accent: #FFFFFF;
--sans: "Pretendard Variable", Pretendard, -apple-system, BlinkMacSystemFont,
"Apple SD Gothic Neo", "Noto Sans KR", "Malgun Gothic", system-ui, sans-serif;
--mono: ui-monospace, "SF Mono", SFMono-Regular, Menlo, "Cascadia Mono", Consolas, monospace;
}
@media (prefers-color-scheme: dark) {
:root:not([data-theme="light"]) {
--paper:#0E1413; --card:#151D1B; --panel:#1A2422; --ink:#E8EEEB; --ink-2:#A7B4B0;
--ink-3:#78857F; --rule:#26312E; --rule-2:#3A4844;
--accent:#6FB3A0; --accent-2:#A6D4C5; --accent-soft:#16302A;
--free:#78857F; --free-soft:#18211F; --warn:#C99A54; --warn-soft:#2A2216;
--on-accent:#0E1413;
}
}
:root[data-theme="dark"] {
--paper:#0E1413; --card:#151D1B; --panel:#1A2422; --ink:#E8EEEB; --ink-2:#A7B4B0;
--ink-3:#78857F; --rule:#26312E; --rule-2:#3A4844;
--accent:#6FB3A0; --accent-2:#A6D4C5; --accent-soft:#16302A;
--free:#78857F; --free-soft:#18211F; --warn:#C99A54; --warn-soft:#2A2216;
--on-accent:#0E1413;
}
* { box-sizing: border-box; }
body {
margin: 0; background: var(--paper); color: var(--ink);
font-family: var(--sans); font-size: 16px; line-height: 1.7;
-webkit-font-smoothing: antialiased;
}
.wrap { max-width: 940px; margin: 0 auto; padding: 0 24px 110px; }
h1,h2,h3,h4 { margin:0; letter-spacing:-0.022em; font-weight:700; text-wrap:balance; }
h1 { font-size:40px; line-height:1.2; }
h2 { font-size:27px; line-height:1.3; }
h3 { font-size:19px; line-height:1.4; }
p { margin:0; }
b, strong { font-weight: 700; }
.eyebrow { font-size:12px; font-weight:700; letter-spacing:.16em; text-transform:uppercase;
color:var(--accent); font-family:var(--mono); }
.lead { color:var(--ink-2); font-size:17px; max-width:64ch; text-wrap:pretty; }
.note { color:var(--ink-3); font-size:14px; text-wrap:pretty; }
.num { font-family:var(--mono); font-variant-numeric:tabular-nums; }
section { padding-top:72px; }
.head { display:flex; flex-direction:column; gap:12px; margin-bottom:28px; }
.stack { display:flex; flex-direction:column; gap:18px; }
.stack-s { display:flex; flex-direction:column; gap:10px; }
.cover { padding:64px 0 0; display:flex; flex-direction:column; gap:22px; }
.cover .meta { display:flex; flex-wrap:wrap; gap:8px 24px; font-family:var(--mono);
font-size:13px; color:var(--ink-2); font-variant-numeric:tabular-nums; }
.cover .meta b { color:var(--ink); font-weight:600; }
.total {
background:var(--accent); color:var(--on-accent); border-radius:6px; padding:30px 32px;
display:flex; flex-wrap:wrap; gap:20px; align-items:flex-end; justify-content:space-between;
}
.total .k { font-size:13px; letter-spacing:.1em; text-transform:uppercase;
font-family:var(--mono); opacity:.82; display:block; margin-bottom:6px; }
.total .v { font-family:var(--mono); font-variant-numeric:tabular-nums;
font-size:44px; font-weight:700; line-height:1; letter-spacing:-0.03em; }
.total .sub { font-size:14px; opacity:.85; font-family:var(--mono); }
.sum { border:1px solid var(--rule); border-radius:6px; background:var(--card); overflow:hidden; }
.sum .r { display:grid; grid-template-columns:1fr auto auto; gap:18px; align-items:baseline;
padding:16px 22px; border-bottom:1px solid var(--rule); }
.sum .r:last-child { border-bottom:0; }
.sum .t { font-size:15px; font-weight:600; }
.sum .d { display:block; color:var(--ink-3); font-size:13px; font-weight:400; }
.sum .q { color:var(--ink-2); font-size:13.5px; text-align:right; min-width:120px; }
.sum .a { font-size:16px; font-weight:700; text-align:right; min-width:140px; }
.sum .r.minus .t, .sum .r.minus .a { color:var(--free); }
.sum .r.last { background:var(--accent-soft); border-top:2px solid var(--accent); padding:20px 22px; }
.sum .r.last .t { color:var(--accent-2); font-size:16px; }
.sum .r.last .a { color:var(--accent-2); font-size:22px; }
.cards { display:grid; grid-template-columns:repeat(auto-fit,minmax(220px,1fr)); gap:14px; }
.card { border:1px solid var(--rule); border-radius:6px; background:var(--card);
padding:20px; display:flex; flex-direction:column; gap:8px; }
.card .cn { font-family:var(--mono); font-size:12px; font-weight:700; color:var(--accent);
letter-spacing:.08em; }
.card .cp { font-family:var(--mono); font-size:12.5px; color:var(--ink-3);
font-variant-numeric:tabular-nums; }
.card .ca { font-family:var(--mono); font-variant-numeric:tabular-nums; font-size:24px;
font-weight:700; letter-spacing:-0.02em; }
.card .cs { font-size:13px; color:var(--ink-2); }
.items { border:1px solid var(--rule); border-radius:6px; background:var(--card); overflow:hidden; }
.item { display:grid; grid-template-columns:1fr 108px 132px; gap:20px;
padding:20px 22px; border-bottom:1px solid var(--rule); align-items:start; }
.item:last-child { border-bottom:0; }
.item .it { font-weight:600; font-size:15.5px; display:block; margin-bottom:6px; text-wrap:pretty; }
.item .idesc { color:var(--ink-2); font-size:14px; line-height:1.65; text-wrap:pretty; }
.item .iscope { display:inline-block; margin-top:9px; font-size:12px; color:var(--ink-3);
font-family:var(--mono); }
.item .imd { text-align:right; font-family:var(--mono); font-variant-numeric:tabular-nums;
font-size:14px; color:var(--ink-2); white-space:nowrap; }
.item .imd small { display:block; font-size:11px; color:var(--ink-3); letter-spacing:.06em; }
.item .iamt { text-align:right; font-family:var(--mono); font-variant-numeric:tabular-nums;
font-size:16px; font-weight:700; white-space:nowrap; }
.group { padding:12px 22px; background:var(--panel); border-top:1px solid var(--rule);
border-bottom:1px solid var(--rule); font-size:13.5px; font-weight:700; color:var(--ink-2);
display:flex; justify-content:space-between; gap:12px; flex-wrap:wrap; }
.group span:last-child { font-family:var(--mono); font-weight:600; color:var(--ink-3);
font-variant-numeric:tabular-nums; }
.week { display:flex; flex-direction:column; gap:20px; margin-top:14px; }
.wbar { display:flex; flex-wrap:wrap; gap:18px; align-items:baseline; justify-content:space-between;
padding-bottom:14px; border-bottom:2px solid var(--ink); }
.wbar .wl { display:flex; flex-direction:column; gap:3px; }
.wbar .wt { font-size:21px; font-weight:700; }
.wbar .wp { font-family:var(--mono); font-size:13px; color:var(--ink-3);
font-variant-numeric:tabular-nums; }
.wbar .wa { font-family:var(--mono); font-variant-numeric:tabular-nums; font-size:24px;
font-weight:700; color:var(--accent); }
.tiles { display:grid; grid-template-columns:repeat(auto-fit,minmax(170px,1fr)); gap:10px; }
.tile { border:1px solid var(--rule); border-radius:5px; background:var(--card);
padding:14px 16px; display:flex; align-items:baseline; justify-content:space-between; gap:10px; }
.tile .tn { font-size:14px; color:var(--ink-2); }
.tile .tc { font-family:var(--mono); font-variant-numeric:tabular-nums; font-size:17px;
font-weight:700; }
.freelist { display:grid; grid-template-columns:repeat(auto-fill,minmax(340px,1fr)); gap:0 26px; }
.freelist .fl { padding:9px 0 9px 14px; border-bottom:1px solid var(--rule); font-size:13.5px;
color:var(--ink-2); position:relative; line-height:1.55; }
.freelist .fl::before { content:"·"; position:absolute; left:2px; color:var(--ink-3); }
.box { border:1px solid var(--rule); border-left:4px solid var(--accent); border-radius:5px;
background:var(--accent-soft); padding:18px 22px; font-size:15px; color:var(--ink-2); }
.box b { color:var(--ink); }
.box.g { border-left-color:var(--rule-2); background:var(--panel); }
.box.w { border-left-color:var(--warn); background:var(--warn-soft); }
.tw { overflow-x:auto; border:1px solid var(--rule); border-radius:6px; background:var(--card); }
table { width:100%; border-collapse:collapse; font-size:14.5px; table-layout:fixed; min-width:640px; }
thead th { text-align:left; font-size:11.5px; font-weight:700; letter-spacing:.09em;
text-transform:uppercase; color:var(--ink-3); padding:12px 16px; background:var(--panel);
border-bottom:1px solid var(--rule-2); white-space:nowrap; }
thead th.r { text-align:right; }
tbody td { padding:14px 16px; border-bottom:1px solid var(--rule); vertical-align:top;
overflow-wrap:break-word; }
tbody tr:last-child td { border-bottom:0; }
td.r { text-align:right; white-space:nowrap; font-family:var(--mono);
font-variant-numeric:tabular-nums; }
td .sm { color:var(--ink-2); font-size:13.5px; display:block; margin-top:4px; line-height:1.6; }
footer { margin-top:88px; padding-top:26px; border-top:2px solid var(--ink);
display:flex; flex-wrap:wrap; gap:10px 24px; justify-content:space-between;
font-family:var(--mono); font-size:13px; color:var(--ink-2); }
footer b { color:var(--ink); }
@media (max-width:760px) {
body { font-size:15px; }
h1 { font-size:30px; } h2 { font-size:22px; }
.wrap { padding:0 16px 70px; }
.total .v { font-size:34px; }
.item { grid-template-columns:1fr; gap:10px; }
.item .imd, .item .iamt { text-align:left; }
.item .iamt { font-size:18px; color:var(--accent); }
.sum .r { grid-template-columns:1fr auto; }
.sum .q { display:none; }
}
@media print { body { background:#fff; } section { break-inside:avoid; } }
</style>
<div class="wrap">
<header class="cover">
<span class="eyebrow">추가 개발 견적서</span>
<h1>{{PROJECT_NAME}} {{PERIOD_LABEL}}<br>추가 개발 정산 내역</h1>
<p class="lead">{{기간 설명 문장 — 예: "N월 N일부터 N월 N일까지 반영한 작업의 전체
내역입니다. 계약 범위에 포함된 작업과 기존 기능의 하자 보수는 같은 기준으로 산출한 뒤
청구에서 전액 제외했습니다."}}</p>
<div class="meta">
<span>대상 기간 <b>{{START_DATE}} — {{END_DATE}}</b></span>
<span>영업일 <b>{{BUSINESS_DAYS}}일</b></span>
<span>단가 <b>{{UNIT_RATE}}원 / M·D</b></span>
<span>표준 공수 <b>{{APPLIED_RATE_PCT}}% 적용</b></span>
<span><b>{{VAT_LABEL}}</b></span>
</div>
<div class="total">
<div><span class="k">최종 청구액</span><span class="v">{{TOTAL_AMOUNT}}원</span></div>
<div class="sub">개발 {{BILLABLE_COUNT}}건 {{BILLABLE_MD}} M/D{{ · CI 인프라 사용료 있으면 " + 인프라 사용료" }} · VAT {{VAT_INCLUDED_OR_NOT}}</div>
</div>
</header>
<section><div class="head"><span class="eyebrow">Summary</span><h2>한눈에 보기</h2>
<p class="lead">이 기간에 수행한 작업 전체를 같은 기준으로 산출한 뒤, 청구 대상만 남기고 덜어낸 결과입니다.</p></div>
<div class="stack">
<div class="sum">
<div class="r"><div class="t">개발 공수 청구액<span class="d">발주처 요청 또는 계약 범위 밖으로 확인된 작업</span></div>
<div class="q num">{{BILLABLE_COUNT}}건 · {{BILLABLE_MD}} M/D</div><div class="a num">{{BILLABLE_AMOUNT}}원</div></div>
<!-- 자체 CI 러너를 쓰는 프로젝트만: -->
<div class="r"><div class="t">CI/CD 인프라 사용료<span class="d">자체 빌드 서버에서 처리한 빌드·검증·배포 사용량</span></div>
<div class="q num">{{CI_RUNS}}회 · {{CI_HOURS}}시간</div><div class="a num">{{CI_AMOUNT}}원</div></div>
<!-- /선택 모듈 -->
<div class="r minus"><div class="t">이전 계약 범위 · 내부 작업<span class="d">계약에 포함된 항목과 화면 동작이 달라지지 않는 내부 작업</span></div>
<div class="q num">{{EXCLUDED_COUNT}}건{{ · MD 있으면 표기 }}</div><div class="a num">0원</div></div>
<div class="r minus"><div class="t">하자 보수 · 내부 작업 (무상)<span class="d">기존 기능이 설계대로 동작하지 않은 건</span></div>
<div class="q num">{{FREE_COUNT}}건</div><div class="a num">0원</div></div>
<div class="r last"><div class="t">최종 청구액<span class="d">{{VAT_LABEL}}</span></div>
<div class="q num">{{BILLABLE_COUNT}}건 · {{BILLABLE_MD}} M/D{{ + 사용료 }}</div><div class="a num">{{TOTAL_AMOUNT}}원</div></div>
</div>
<!-- LOOP: 이월 구간(있으면) + 주차별 카드 -->
<div class="cards">
<div class="card"><span class="cn">{{WEEK_LABEL}}</span>
<span class="cp">{{WEEK_PERIOD}}</span>
<span class="ca">{{WEEK_AMOUNT}}원</span>
<span class="cs">{{WEEK_COUNT}}건 · {{WEEK_MD}} M/D</span></div>
<!-- /LOOP -->
</div>
<div class="box"><b>이 기간에 반영한 작업은 모두 {{TOTAL_COUNT}}건입니다.</b>
그 가운데 청구 대상 <b>{{BILLABLE_COUNT}}건</b>만 청구하고, 계약범위 제외 {{EXCLUDED_COUNT}}건,
하자 보수 {{FREE_COUNT}}건은 <b>청구하지 않았습니다</b>. 청구하지 않은 항목도 무엇을 했는지
확인하실 수 있도록 아래에 전부 기재했습니다.</div>
</div></section>
<section><div class="head"><span class="eyebrow">Work</span><h2>반영한 작업 {{BILLABLE_COUNT}}건</h2>
<p class="lead">청구 대상 작업입니다. 각 항목의 M/D 는 표준 공수에 {{APPLIED_RATE_PCT}}%를 적용한 값입니다.</p></div>
<!-- LOOP: 주차 (이월분 먼저, 그 다음 1주차 2주차 ...) -->
<div class="week"><div class="wbar">
<div class="wl"><span class="wt">{{WEEK_LABEL}}</span><span class="wp">{{WEEK_PERIOD}} · {{WEEK_COUNT}}건</span></div>
<span class="wa">{{WEEK_AMOUNT}}원</span></div>
<p class="lead" style="max-width:70ch">{{그 주의 한 줄 요약}}</p>
<div class="items">
<!-- LOOP: 기능 영역 그룹 -->
<div class="group"><span>{{AREA_NAME}}</span><span>{{AREA_COUNT}}건 · {{AREA_AMOUNT}}원</span></div>
<!-- LOOP: 항목 -->
<div class="item">
<div><span class="it">{{ITEM_TITLE}}</span>
<span class="idesc">{{ITEM_DESCRIPTION — 무엇을 어떻게 바꿨는지 3~5문장, 클라이언트가 읽고 이해할 수 있는 서술}}</span>
<span class="iscope">{{IMPACTED_LAYERS — 예: 앱 · 서버}}</span></div>
<div class="imd">{{ITEM_MD}}<small>M/D</small></div>
<div class="iamt">{{ITEM_AMOUNT}}</div>
</div>
<!-- /LOOP 항목 -->
<!-- /LOOP 그룹 -->
</div>
</div>
<!-- /LOOP 주차 -->
</section>
<!-- 선택 섹션: CI/CD 인프라 사용료를 별도 청구하는 프로젝트만 포함 -->
<section><div class="head"><span class="eyebrow">Compute</span>
<h2>CI/CD 인프라 사용료</h2>
<p class="lead">코드를 고칠 때마다 자동으로 도는 빌드·검증·배포에 자체 빌드 서버가 사용된 대가입니다.
대상 기간에 <b>{{CI_RUNS}}회</b>가 실행되어 <b>약 {{CI_HOURS}}시간</b>이 쓰였습니다.</p></div>
<div class="stack">
<div class="tw"><table>
<thead><tr><th>구분</th><th class="r">실행</th><th class="r">평균</th><th class="r">컴퓨팅 시간</th></tr></thead>
<tbody>
<!-- LOOP: 잡 종류 -->
<tr><td><b>{{JOB_KIND}}</b><span class="sm">{{JOB_KIND_DESC}}</span></td><td class="r">{{JOB_RUNS}}</td><td class="r">{{JOB_AVG}}</td><td class="r">{{JOB_HOURS}}시간</td></tr>
<!-- /LOOP -->
<tr><td><b>합계</b></td><td class="r"><b>{{CI_RUNS}}</b></td><td class="r">—</td><td class="r"><b>{{CI_HOURS}}시간</b></td></tr>
</tbody></table></div>
<div class="stack-s"><h3>산정 내역</h3>
<div class="tw"><table>
<thead><tr><th>구분</th><th class="r">사용량</th><th class="r">단가</th><th class="r">금액</th></tr></thead>
<tbody>
<tr><td><b>시장가</b><span class="sm">클라우드 macOS 표준 러너 공개 요금 기준</span></td>
<td class="r">{{CI_HOURS}}시간</td><td class="r">{{CLOUD_RATE}}</td><td class="r">{{MARKET_AMOUNT}}원</td></tr>
<tr><td><b>적용률 {{APPLIED_RATE_PCT}}%</b><span class="sm">개발 공수와 같은 비율을 적용</span></td>
<td class="r">—</td><td class="r">×{{APPLIED_RATE}}</td><td class="r"><b>{{CI_APPLIED_AMOUNT}}원</b></td></tr>
<tr><td><b>합계</b></td><td class="r">{{CI_HOURS}}시간</td><td class="r">—</td><td class="r"><b>{{CI_AMOUNT}}원</b></td></tr>
</tbody></table></div></div>
<p class="note">환율·산정 기준이 다르면 그에 맞춰 조정합니다.</p>
</div></section>
<!-- /선택 섹션 -->
<section><div class="head"><span class="eyebrow">No charge</span><h2>무상으로 처리한 작업 {{FREE_COUNT}}건</h2>
<p class="lead">기존 기능이 설계대로 동작하지 않은 건과 내부 작업입니다. 청구 금액에 포함되지 않습니다.</p></div>
<div class="stack">
<div class="tiles">
<!-- LOOP: 영역별 카운트 -->
<div class="tile"><span class="tn">{{AREA_NAME}}</span><span class="tc">{{AREA_COUNT}}</span></div>
<!-- /LOOP -->
</div>
<!-- LOOP: 영역별 상세 -->
<h4 style="margin-top:22px;color:var(--ink-2)">{{AREA_NAME}} <span class="note" style="font-weight:400">{{AREA_COUNT}}건</span></h4>
<div class="freelist">
<!-- LOOP: 항목 -->
<div class="fl">{{ITEM_ONE_LINE}}</div>
<!-- /LOOP -->
</div>
<!-- /LOOP -->
</div></section>
<section><div class="head"><span class="eyebrow">Excluded</span><h2>청구하지 않은 작업 {{EXCLUDED_COUNT}}건</h2>
<p class="lead">이전 계약에 포함되어 있거나, 화면 동작이 달라지지 않는 내부 작업입니다. 청구하지 않지만 무엇을 했는지 확인하실 수 있도록 전체를 기재합니다.</p></div>
<div class="stack">
<div class="tiles"><!-- LOOP: 영역별 카운트 (No-charge 섹션과 동일 패턴) --></div>
<div class="stack-s">
<h3>어떤 작업인가</h3>
<ul class="bul">
<li><b>이전 계약 범위</b> — {{계약서 조항 인용}}</li>
<li><b>화면 동작이 달라지지 않는 내부 작업</b> — {{설명}}</li>
<li><b>사내 개발·배포 환경</b> — {{설명}}</li>
<li><b>자체 점검에서 발견한 조치</b> — {{설명}}</li>
</ul></div>
<!-- LOOP: 영역별 상세 (No-charge 섹션과 동일 패턴) -->
</div></section>
</div>
ul.bul { margin:0; padding-left:20px; color:var(--ink-2); font-size:15px; display:flex; flex-direction:column; gap:10px; } ul.bul b { color:var(--ink); }
를 CSS 에 추가하는 것을 잊지 마세요(위 <ul class="bul"> 가 참조합니다).
3. 워크북 생성 스크립트#
정산 실행 시 아래 스크립트를 scratchpad(세션 임시 디렉터리)에 build_settlement_workbook.py
로 써서 실행합니다. 입력은 분류·산정이 끝난 JSON(§4 스키마)이고, 출력은 .xlsx 파일 경로입니다.
#!/usr/bin/env python3
"""정산 데이터(JSON) → 견적서/상세내역 2탭 워크북(.xlsx).
입력 JSON 스키마는 TEMPLATES.md §4 참조. openpyxl 이 없으면 자동 설치를 시도하고,
그래도 안 되면 CSV 2개(요약/상세)로 폴백한다.
"""
import json
import subprocess
import sys
def ensure_openpyxl():
try:
import openpyxl # noqa: F401
return True
except ImportError:
pass
try:
subprocess.run(
[sys.executable, "-m", "pip", "install", "--quiet", "openpyxl"],
check=True, timeout=60,
)
import openpyxl # noqa: F401
return True
except Exception:
return False
def build_xlsx(data: dict, out_path: str) -> str:
from openpyxl import Workbook
from openpyxl.styles import Font, Alignment
from openpyxl.utils import get_column_letter
wb = Workbook()
# --- 탭 1: 견적서 (요약) ---
ws1 = wb.active
ws1.title = "견적서"
bold = Font(bold=True)
ws1.append(["NO", data["invoice_no"], "회 사 명", data["supplier"]["name"]])
ws1.append([data["client"]["name"], "등록번호", data["supplier"]["reg_no"]])
ws1.append(["대 표", data["supplier"]["ceo"]])
ws1.append(["담당자", data["client"]["contact_name"], "사업장주소", data["supplier"]["address"]])
ws1.append(["전 화", data["client"].get("contact_phone", ""), "담 당 자", data["supplier"]["contact_name"]])
ws1.append(["이메일", data["client"].get("contact_email", ""), "전화번호", data["supplier"].get("contact_phone", "")])
ws1.append(["", "", "이 메 일", data["supplier"].get("contact_email", "")])
ws1.append(["견 적 일", data["invoice_date"]])
ws1.append(["공 급 자", data["supplier"]["name"]])
ws1.append(["견적내용", f"{data['project']} {data['period_label']} 추가 개발 정산"])
ws1.append(["총 비 용", f"{data['total_amount']:,}원 ({data['vat_label']})"])
ws1.append(["개발 소요 기간", f"{data['start_date']} ~ {data['end_date']}"])
ws1.append([])
ws1.append(["<견적내용>"])
ws1.append(["(단위 : 원)"])
ws1.append(["구분", "설 명", "M/D", "금액"])
for c in range(1, 5):
ws1.cell(row=ws1.max_row, column=c).font = bold
for group in data["billable_groups"]:
ws1.append([group["label"], "", "", ""])
for area in group["areas"]:
for item in area["items"]:
ws1.append(["", f"{area['name']} — {item['title']}", item["md"], item["amount"]])
ws1.append([f"{group['label']} 소계 ({group['count']}건 · {group['md']} M/D)",
"", "", group["amount"]])
ws1.cell(row=ws1.max_row, column=1).font = bold
ws1.append([f"전체 수행 작업 산출액 ({data['total_count']}건 · {data['total_md']} M/D)",
"", "", data["gross_amount"]])
ws1.append([f"이전 계약 범위 내 작업 전액 제외 ({data['excluded_count']}건)",
"", "", -data.get("excluded_would_be_amount", 0)])
ws1.append([f"하자 보수·내부 작업 무상 처리 ({data['free_count']}건)", "", "", 0])
ws1.append([f"최종 청구액 ({data['billable_count']}건 · {data['billable_md']} M/D)",
"", "", data["total_amount"]])
ws1.cell(row=ws1.max_row, column=1).font = bold
ws1.append(["공급가액", "(부가세 별도)" if data["vat_separate"] else "(부가세 포함)", "", data["total_amount"]])
if data["vat_separate"]:
vat = round(data["total_amount"] * 0.1)
ws1.append(["부 가 세", "(10%)", "", vat])
ws1.append(["합 계", "(부가세 포함)", "", data["total_amount"] + vat])
for col, width in zip("ABCD", (34, 44, 10, 14)):
ws1.column_dimensions[col].width = width
# --- 탭 2: 상세내역 ---
ws2 = wb.create_sheet("상세내역")
ws2.append([f"{data['project']} {data['period_label']} 추가 개발 정산 — 전체 작업 상세내역"])
ws2.append(["(단위 : 원)"])
header = ["NO", "구분", "분류", "기능 / 작업", "적용 범위", "요청 출처 / 판정", "규모", "M/D", "금액"]
ws2.append(header)
for c in range(1, len(header) + 1):
ws2.cell(row=ws2.max_row, column=c).font = bold
for idx, row in enumerate(data["detail_rows"], start=1):
ws2.append([
idx, row["category"], row["area"], row["title"], row["layers"],
row["source"], row["size"], row["md"], row["amount"],
])
widths = (6, 20, 16, 44, 18, 26, 8, 8, 12)
for i, w in enumerate(widths, start=1):
ws2.column_dimensions[get_column_letter(i)].width = w
ws2.freeze_panes = "A4"
wb.save(out_path)
return out_path
def build_csv_fallback(data: dict, out_dir: str) -> list:
import csv
import os
summary_path = os.path.join(out_dir, "settlement_summary.csv")
detail_path = os.path.join(out_dir, "settlement_detail.csv")
with open(summary_path, "w", newline="", encoding="utf-8-sig") as f:
w = csv.writer(f)
w.writerow(["구분", "설명", "M/D", "금액"])
for group in data["billable_groups"]:
for area in group["areas"]:
for item in area["items"]:
w.writerow([group["label"], f"{area['name']} — {item['title']}", item["md"], item["amount"]])
w.writerow(["최종 청구액", "", data["billable_md"], data["total_amount"]])
with open(detail_path, "w", newline="", encoding="utf-8-sig") as f:
w = csv.writer(f)
w.writerow(["NO", "구분", "분류", "기능 / 작업", "적용 범위", "요청 출처 / 판정", "규모", "M/D", "금액"])
for idx, row in enumerate(data["detail_rows"], start=1):
w.writerow([idx, row["category"], row["area"], row["title"], row["layers"],
row["source"], row["size"], row["md"], row["amount"]])
return [summary_path, detail_path]
if __name__ == "__main__":
data_path, out_path = sys.argv[1], sys.argv[2]
with open(data_path, encoding="utf-8") as f:
data = json.load(f)
if ensure_openpyxl():
result = build_xlsx(data, out_path)
print(f"XLSX:{result}")
else:
import os
results = build_csv_fallback(data, os.path.dirname(out_path) or ".")
print("CSV_FALLBACK:" + ",".join(results))실행:
python3 build_settlement_workbook.py settlement_data.json settlement_{{SLUG}}_{{YYYYMMDD}}.xlsx
출력이 XLSX:... 면 그 파일을 base64 인코딩해 Google_Drive.create_file 의 base64Content
로 업로드합니다(contentMimeType: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet).
CSV_FALLBACK:... 이면 두 CSV 를 각각 textContent 로 업로드하고(자동으로 Google Sheets
파일로 변환됩니다 — 탭은 나뉘지 않고 파일이 2개가 됩니다), 최종 보고에 이 경로로 대체됐음을
명시합니다.
4. 입력 JSON 스키마 (settlement_data.json)#
{
"project": "{{프로젝트명}}",
"slug": "{{slug}}",
"period_label": "{{예: 2026년 8월}}",
"start_date": "YYYY-MM-DD",
"end_date": "YYYY-MM-DD",
"invoice_no": "{{YYYYMMDD-순번}}",
"invoice_date": "YYYY년 M월 D일",
"vat_separate": true,
"vat_label": "VAT 별도",
"supplier": {"name": "", "reg_no": "", "ceo": "", "address": "", "contact_name": "", "contact_email": "", "contact_phone": ""},
"client": {"name": "", "contact_name": "", "contact_email": "", "contact_phone": ""},
"total_count": 0, "total_md": 0, "gross_amount": 0,
"billable_count": 0, "billable_md": 0,
"free_count": 0, "excluded_count": 0, "excluded_would_be_amount": 0,
"total_amount": 0,
"billable_groups": [
{"label": "① 발주처 요청 신규 기능", "count": 0, "md": 0, "amount": 0,
"areas": [{"name": "", "items": [{"title": "", "md": 0, "amount": 0}]}]}
],
"detail_rows": [
{"category": "청구", "area": "", "title": "", "layers": "", "source": "UB-000 / GitHub #000",
"size": "M", "md": 0, "amount": 0}
]
}
detail_rows 는 청구·무상·제외를 전부 담습니다(REFERENCE.md §4 참조) — 아티팩트의 각 섹션은
이 배열을 category 로 필터링해 채웁니다.