Add 標準版/給与システム/entity/xcshoyo_[賞与計算制御情報].md

標準版/給与システム/entity/xcshoyo_[賞与計算制御情報].md

@@ -0,0 +1,58 @@
+# xcshoyo [ｺﾝﾄﾛｰﾙ]賞与計算制御情報 — xlsx vs DB 対照
+
+- xlsx: /mnt/d/25.テーブル一覧/10.テーブル定義/30.給与/xcshoyo.xlsx
+- DB: updsv7_opho_ci (192.168.1.72:5432) / public.xcshoyo
+- 改訂履歴: 7.0.0 新規作成 (2023-10-04 NSC) — 改訂なし
+
+## 1. 全体対数
+
+| 区分 | 項目 | 値 |
+|---|---|---|
+| 列数 | xlsx | 13 |
+| 列数 | DB | 13 |
+| 列差 | DB のみ | 0 |
+| 列差 | xlsx のみ | 0 |
+| 行数 | DB | 0 行 (CI 環境、表は空) |
+| 表サイズ | DB | 16 kB (内 0 bytes は本体、残り索引) |
+| 主キー | xcshoyo_idx UNIQUE | (ccompkb, cqtaikeikb, dyymm, nseq) |
+| 補助索引 | xcshoyo_idx_2 | (ccompkb, cqtaikeikb, dyymm, dsikyngp) — 支給年月日検索用 |
+
+## 2. 業務身份
+
+- **UPDS-V7 給与システムの「賞与計算制御情報」** — 期末/勤勉/一般賞与などの賞与計算バッチ（QCAL2011 プロシージャ等）の実行可否・実行状態を PK 単位（会社×体系×処理月×回数）で管理する小さい親テーブル
+- 1 つの処理月の中で複数回（nseq=1, 2, ...）実行可能（再作成/追加のみのシナリオ用）
+- 主要利用箇所（例）:
+  - 画面 KCL00120「期末勤勉手当計算準備」3.4.2 存在チェック → 当月の制御情報が既にあれば再作成フラグで挙動分岐
+  - 画面 KCL00120 3.5 賞与計算制御情報作成 (DELETE → INSERT)
+  - 画面 KCL00120 3.6 賞与計算制御情報更新 (フラグ=9 で完了マーク)
+
+## 3. カラム対照（13 列 全一致）
+
+| No | カラム名 | カラムID | xlsx型 | xlsx桁 | xlsx制約 | DB型 | DB桁 | NOT NULL | xlsx idx | 用途 |
+|---|---|---|---|---|---|---|---|---|---|---|
+| 1 | 会社区分 | ccompkb | varchar | 2 | N | varchar | 2 | YES | 1 | PK候補 |
+| 2 | 給与体系区分 | cqtaikeikb | varchar | 2 | N | varchar | 2 | YES | 2 | PK候補 (00固定) |
+| 3 | 処理月 | dyymm | date | - | N | date | - | YES | 3 | PK候補 (YYYY/MM) |
+| 4 | SEQ | nseq | numeric | 1 | N | numeric | 1,0 | YES (default 0) | 4 | PK候補 (同一処理月内の実行回数) |
+| 5 | 更新ﾕｰｻﾞ)端末ID | cmnclient | varchar | 10 | - | varchar | 10 | NO | - | 更新ログ |
+| 6 | 更新ﾕｰｻﾞ)会社区分 | cmncomp | varchar | 2 | - | varchar | 2 | NO | - | 更新ログ |
+| 7 | 更新ﾕｰｻﾞ)ﾕｰｻﾞID | cmnuser | varchar | 10 | - | varchar | 10 | NO | - | 更新ログ |
+| 8 | 更新ﾕｰｻﾞ)更新日時 | dmndate | timestamp | - | - | timestamp | - | NO | - | 更新ログ |
+| 9 | 賞与基準年月 | dkijun | date | - | - | date | - | NO | - | 賞与計算の基準年月 (支給年月と異なる場合あり) |
+| 10 | 支給年月日 | dsikyngp | date | - | - | date | - | NO | 3 | 賞与の支給日 (xcshoyo_idx_2 索引列) |
+| 11 | 確定済フラグ | nkakuteiflg | numeric | 1 | - | numeric | 1,0 | NO (default 0) | - | xlsx 備考: 0:未 / 1:済 |
+| 12 | (xlsx: 非常勤の準備処理FLG) | ntaishokb1 | numeric | 1 | - | numeric | 1,0 | NO (default 0) | - | xlsx 備考: 0:未 / 1:今回処理 / 9:準備処理済 — **画面 KCL00120 概要では「フラグ1(定員内)」と記載され名称不一致、xlsx 備考が正** |
+| 13 | (名称未記載) | ntaishokb2 | numeric | 1 | - | numeric | 1,0 | NO (default 0) | - | xlsx カラム名・備考とも空欄、用途不明 |
+
+## 4. 主キー
+
+- UNIQUE INDEX: xcshoyo_idx (ccompkb, cqtaikeikb, dyymm, nseq) — 4 列複合キー
+- xlsx H列「インデックス」記載: ccompkb=1, cqtaikeikb=2, dyymm=3, nseq=4 → 順序含め DB と完全一致
+- nseq のみ DB で `DEFAULT 0` あり、xlsx には初期値記載なし
+
+## 5. 観察事項
+
+1. **ntaishokb1 の業務名不一致** — 画面設計書 KCL00120 業務概要（`画面設計書_KCL00120_期末勤勉手当計算準備_業務概要.md`）71 行付近では「フラグ1(定員内)」と記載されているが、xlsx カラム備考（No.12）は「非常勤の準備処理FLG 0:未 1:今回処理 9:準備処理済」と全く逆の意味で記載されている。xlsx 備考は「非常勤の準備処理FLG」の方が xkkihon.CTEIINKB の対応（画面 3.2.1A/B 定員内 vs 3.2.1C/D 非常勤）と整合する。**要確認**。
+2. **ntaishokb2 はカラム名・備考とも未記載** — xlsx No.13 行はカラム名セルが空。テーブルとして存在するが用途不明。KCL00120 概要では「フラグ2(非常勤)」と記載、xlsx は完全空欄。**要確認**。
+3. **CI 環境では表が空** — 0 行のためサンプルデータなし。実環境（運用/開発）でどのような nseq/dkijun 値で運用されているかは要確認。
+4. **xcshoyo_month.xlsx が同フォルダに存在** — 別表。本ドキュメントの対象外。