다크모드
FMS 장기수선충당금 현황 — FMS↔회계(9112) 연동 (BE 참고)
독자: BE 개발자/AI. 시설관리 단독으로 동작하는 장기수선충당금 조회 projection. 정본 코드:
src/composables/useRepairReserve.js,src/composables/repairReserveProjection.js.
1. 적립(accrual) — 선택적 projection
- 연결이 없으면 수기 fallback을 사용한다. 관리비관리·회계·장기수선계획은 직접 FK/join/import하지 않고 선택적 provider projection만 전달한다.
- 적립 누계 = 개시 잔액(전년도까지 이월·데모 시드
OPENING_BALANCE=280,000,000) + 당기 적립. - 중복 분개 없음: 당기 부과는 회계 E2(부과확정
vouchersInvoicing)에서 이미 9112 부채로 계상됨. 본 모듈은 표시 집계만(display-only).
2. 사용(usage) — 장기수선공사
- 장기수선공사(공용부 대수선) 지출 = 데모 시드
WORKS(승강기/옥상방수/외벽, Σ=32,000,000). 항목{date, name, category, amount, vendor, status}. - ⚠ 충당 대상 범위: 장기수선계획상 공용부 대수선이지,
facility/maintenance/unit·equipment/task의 per-unit 워크오더(유상/무상 routine)가 아니다. 워크오더를 충당금에 매핑하면 회계 오류. - 실 분개(BE 계약): 실서비스 지출 시
DR 9112 장기수선충당부채 / CR 현금(또는 0253 미지급금)— 충당금 차감. 현재 프로토는 display-only(미전기).
3. 잔액·정합
- 잔액 = 적립 누계 − 사용 합 = 280,450,000 − 32,000,000 = 248,450,000(데모).
- 계정 =
REPAIR_RESERVE_ACCOUNT9112(공동주택 기준, 별표 1 비유동부채 제19조). 집합건물=9113. - 예산/결산 관계:
budgetStructure의 세출 장기수선비(결산 55M)는 연간 plan/actual, 본 현황은 충당금 stock(잔액) — 다른 관점(plan vs reserve). 향후 일치 시 사용=결산 장기수선비로 연동 가능.
4. 확장
- 개시 잔액·공사 시드 → 실데이터(회계 9112 기초잔액·실 공사대장)로 교체(동일 계약).
- 사용 시 실 분개 배선(DR 9112) + 충당금 부족 가드.
- 장기수선계획(주기·예상비용) 연동, 적립률 시뮬레이션.
- 테스트:
src/composables/__tests__/useRepairReserve.spec.js(수기 fallback·선택 provider·적립누계·사용·잔액).