init

標準版/給与システム/entity/XKKIHON_[基本]給与基本情報.md

@@ -0,0 +1,114 @@
+# XKKIHON [基本]給与基本情報 — xlsx vs DB 対照
+
+- xlsx: /mnt/d/25.テーブル一覧/10.テーブル定義/30.給与/xkkihon.xlsx
+- DB: updsv7_opho_ci (192.168.1.72:5432) / public.xkkihon
+- 改訂履歴: 7.0.0 新規作成 (2023-10-04 NSC) / 7.0.1 年末調整法改正_2025_例月計算（税扶養情報登録）対応 (2025-10-09 王琳) → 源泉控除対象親族）特親人数追加
+
+## 1. 全体対数
+
+| 区分 | 項目 | 値 |
+|---|---|---|
+| 列数 | xlsx | 287 |
+| 列数 | DB | 288 |
+| 列差 | DB のみ | +1 列（ccalcuser）|
+| 列差 | xlsx のみ | 0 |
+
+## 2. 主キー（DB 実測 NOT NULL 6 列）
+
+xlsx は F 列「制約」で「N」と書く運用だが、PK 表記はなし。同型 PK 头部 6 列は他表（xkkijun, xkkijunhw 等）と共通。
+
+| # | カラムID | xlsx型 | xlsx桁 | xlsx制約 | DB型 | DB桁 | DB NOT NULL | DB DEFAULT |
+|---|---|---|---|---|---|---|---|---|
+| 1 | ccompkb | varchar | 2 | N | varchar | 2 | YES | - |
+| 2 | cqtaikeikb | varchar | 2 | N | varchar | 2 | YES | - |
+| 3 | dgaitong | date | - | N | date | - | YES | - |
+| 4 | nqshoyokb | numeric | 1 | N | numeric | 1,0 | YES | 0 |
+| 5 | nqshoyoseq | numeric | 1 | N | numeric | 1,0 | YES | 0 |
+| 6 | cshainno | varchar | 10 | N | varchar | 10 | YES | - |
+
+## 3. DB のみ存在列（1 件）
+
+| # | カラムID | 型 | 桁 | NOT NULL | DEFAULT | 想定位置 | 改訂履歴記載 |
+|---|---|---|---|---|---|---|---|
+| 288 | ccalcuser | varchar | 20 | NO | - | xlsx No.286 直後（kyosai_nme の次、ntokuszk の前）| なし |
+
+→ xlsx 7.0.1 改訂（ntokuszk 追加）時に ccalcuser も同時追加されたが、xlsx 側に記載漏れ。軽微な文書不整合。DB 側に存在するため本番動作には影響なし。
+
+## 4. 28 件の「表現差」（データ差ではない）
+
+xlsx が小数桁付き numeric を「全桁,小数桁」と書く表記形式 vs DB の information_schema が全桁のみ返す違い。**データ定義上一致**:
+
+| xlsx No | カラムID | xlsx桁 | DB桁 | DB scale | 判定 |
+|---|---|---|---|---|---|
+| 48 | nszeiritu | 6,3 | 6 | 3 | 一致 |
+| 129 | ntanka | 12,4 | 12 | 4 | 一致 |
+| 161 | hkts_tysi_num | 7,2 | 7 | 2 | 一致 |
+| 162 | tysi_num_gen | 7,2 | 7 | 2 | 一致 |
+| 164 | tysisum_num | 4,2 | 4 | 2 | 一致 |
+| 165 | cho_siky_ritu | 8,2 | 8 | 2 | 一致 |
+| 188 | tsta_skr | 8,2 | 8 | 2 | 一致 |
+| 191 | skyust_tanka | 6 | 8 | 0 | **不一致**（DB全桁 8 / xlsx桁 6）|
+| 231 | skyust_tanka2 | 6 | 8 | 0 | **不一致**（DB全桁 8 / xlsx桁 6）|
+| 240-244 | nyobi01〜05 | 12,4 | 12 | 4 | 一致 |
+| 250 | koiki_ritu | 5,2 | 5 | 2 | 一致 |
+| 253 | nikujitanjikan | 7,2 | 7 | 2 | 一致 |
+| 254 | nsyoteijikan | 7,2 | 7 | 2 | 一致 |
+| 265 | saininyo_kinmu | 7,2 | 7 | 2 | 一致 |
+| 266 | saininyo_syotei | 7,2 | 7 | 2 | 一致 |
+| 138 | knmei_cde | 1 | (無制限) | - | 一致（xlsx の桁 1 は設計最大長）|
+| 140 | syksy_cde | 5 | (無制限) | - | 一致 |
+| 142 | yosan_cde | 2 | (無制限) | - | 一致 |
+| 147 | kei_cde | 1 | (無制限) | - | 一致 |
+| 149 | kkrkoza_cde | 6 | (無制限) | - | 一致 |
+| 159 | hktys_yosan_cde | 6 | (無制限) | - | 一致 |
+| 179 | hjksyk_misy_cde | 3 | (無制限) | - | 一致 |
+| 181 | hjksyk_kih_cde | 2 | (無制限) | - | 一致 |
+| 277 | rowid | int8 | bigint | 0 | 表記差（PostgreSQL: int8 ≡ bigint）|
+
+真の不一致:
+- **skyust_tanka** (No.191) xlsx桁 6 / DB全桁 8 — データ規模注意
+- **skyust_tanka2** (No.231) xlsx桁 6 / DB全桁 8 — 同上
+
+## 5. 業務カテゴリ別 列分布（288 列構成）
+
+| カテゴリ | 列数（代表）| 概要 |
+|---|---|---|
+| ヘッダ業務識別 | 6 | PK 头部 ccompkb/cqtaikeikb/dgaitong/nqshoyokb/nqshoyoseq/cshainno |
+| 更新ログ | 4 | cmnclient/cmncomp/cmnuser/dmndate |
+| 個人情報 | 5 | cnamekna/cnameknj/cseibetukb/cseibetunm/dbirth |
+| 入退情報 | 11 | 入社/退職/休職関連 |
+| 所属・住所 | 15+ | 部局コード/名称、住所、郵便番号 |
+| 給与計算制御フラグ | 6+ | nqyocalcflg/nsyocalcflg/nnencalcflg/ngensenflg/nszeicalcflg/ncalckb/ncalckb2 |
+| 扶養・配偶者 | 17 | nhonshogip/tk/otto/misei/ronen/kafuf/kafut/kafum/kinro/dead/saig/gaijin, nhaigusha, nkojohaigu/ro |
+| 社会保険（労災/雇用/社保/介護）| 40+ | crousai*/ckoyou*/cshaho*/ckenpo*/ckplost*/ckgmenjyo* |
+| 年金（厚生年金/国民年金）| 25+ | cknnenkinno/cknseirino/dnenkine/cknlost*/cnknenkinno/dkikine/cnklost*/cksnenkinno/dchokie/ccklost* |
+| 税（住民税/所得税）| 30+ | cjzeiadr*/cjzeibnck*/cjzeisitei/cjzeikojin/njzei*/njzeikai*/djzeikaitei/cgensen*/ngensenflg/ckplost*/ctankino/ctklost*/ckkgmenjyo*/cchokino |
+| 共済 | 30+ | ckyosai*/nkyosai*/nkyo*/nkyosaibutu*/ckyosai_ktti*/nkyoprevflg/kyosai*/ckyosai_ktti*_nk |
+| 雇用保険 | 5 | ckoyou*/dkoyous/dkoyoue |
+| 通勤 | 6 | cshurou*/nshurouflg/ntanka |
+| 業務・所属項目 | 30+ | nnmn*/kmkbn*/k_skin*/kkn*/knmei*/syksy*/yosan*/bkyk*/sort_jyn/kei*/kkrkoza*/hkyh*/kyu/goho |
+| 給与計算基準連携 | 13 | nxt_syky_dte/hktys_siky*/hktys_yosan*/hkts_tysi_num/tysi_num_gen/add/sum/cho_siky_ritu/tysi_num_kei |
+| 労働組合 | 8 | kumiai_no/kumi_sositu_dte/dkumi_sositu_dte/kyu_kn_nme/kyu_kj_nme/nme_prt_flg |
+| 非常勤関連 | 20+ | hjksyk_* 多数 |
+| 育児・介護関連 | 18 | ctankino/dtabkie/dkyokaigos/e/ckkgmenjyokb/ckkgmenjyonm/cksnenkinno/ccklostkb/ccklostnm/cchokino/dchokis/e |
+| 予備・拡張 | 15 | cyobi01-05/nyobi01-05/dyobi01-05 |
+| 各種制御フラグ | 25+ | cmeisaikb/cszeijgkb/project_cde/csiharaikb/ngakunaih_tanka*/skyust_tanka2/koiki_ritu/nikujitanflg/nsyoteijikan/dikujitans/e/nshastophonflg/cseirino/saininyo*/cnenpo*/dincentive/nincentive*/nhikyojyu |
+| 年末調整関連（7.0.1 追加）| 2 | ccalcuser/ntokuszk |
+| 代理キー | 1 | rowid bigint (NOT NULL, DEFAULT nextval) |
+
+## 6. 構造的特徴
+
+- **「社員×処理月」スナップショット表** — dtaisha（退職年月日）は PK 外の NULLABLE → 同処理月内に複数 dtaisha の同社員が存在し得る（再入職/異動）
+- **200槽位五花拡張は無し** — 個別項目ごとに物理カラム化（nsikyu01, nkojyoXX 等の五花槽ではなく、業務項目ごとに独立カラム: nszeiritu, nfuyoippan, ntanka 等）
+- 対比: xkkijun は 200槽位五花（ccode01..200 / cname01..200 / nnumber01..200 / ddate01..200 / nflag01..200 = 1000 業務列）の汎用基準表。xkkihon は項目ごとの物理カラム化の特化型
+- **同型 PK 構造**: xkkijun, xkkijunhw, xkkijunhwn, xkkihon 等 UPDS-V7 給与系は PK 头部 6 列 (ccompkb, cqtaikeikb, dgaitong, nqshoyokb, nqshoyoseq, cshainno) で統一
+
+## 7. 結論
+
+- 列定義（列名・型・桁・NOT NULL）は概ね一致（286/287 = 99.7%）
+- DB のみ `ccalcuser` 1 列あり（軽微な xlsx 記載漏れ）
+- 真の桁数不一致: `skyust_tanka` (No.191) と `skyust_tanka2` (No.231) で xlsx桁 6 / DB桁 8 — 要確認（DB側が大きい=安全側なので本番影響なし）
+- 致命的差分なし
+- 要確認 2件:
+  1. `ccalcuser` の用途（改訂履歴 7.0.1 に記載なし、xlsx にも記載なし）
+  2. `skyust_tanka` / `skyust_tanka2` の桁数設計根拠（DB 8 桁 vs xlsx 6 桁）