From a3f4105c8f3d7236163c8e493ec1d606bbadfc46 Mon Sep 17 00:00:00 2001
From: guanxiangwei <guanxiangwei@onehr.jp>
Date: Wed, 9 Sep 2026 12:35:22 +0900
Subject: [PATCH] fix: add entity

---
 .../entity/urtukin_[基本]通勤交通費情報.md    | 57 ++++++++++++++++++
 .../entity/xcshoyo_[賞与計算制御情報].md      | 58 +++++++++++++++++++
 2 files changed, 115 insertions(+)
 create mode 100644 標準版/給与システム/entity/urtukin_[基本]通勤交通費情報.md
 create mode 100644 標準版/給与システム/entity/xcshoyo_[賞与計算制御情報].md

diff --git a/標準版/給与システム/entity/urtukin_[基本]通勤交通費情報.md b/標準版/給与システム/entity/urtukin_[基本]通勤交通費情報.md
new file mode 100644
index 0000000..e83998f
--- /dev/null
+++ b/標準版/給与システム/entity/urtukin_[基本]通勤交通費情報.md
@@ -0,0 +1,57 @@
+# urtukin 解析报告
+
+## 基本情報
+
+| 項目 | 内容 |
+|---|---|
+| テーブル名称 | `[基本]通勤交通費情報` |
+| テーブルID | `urtukin` |
+| テーブル概要 | (空) |
+| 改訂履歴 sheet | B1:BM14,65 列 |
+| 列定義 sheet 行数 | 28 列(行 7~34) |
+
+## 列定義(28 列全表)
+
+| No. | カラム名称 | カラムID | データ型 | 桁数 | 制約 | 初期値 | インデックス | 備考 |
+|---|---|---|---|---|---|---|---|---|
+| 1 | 会社区分 | `ccompkb` | varchar | 2 | N | — | 1 | — |
+| 2 | 給与体系区分 | `cqtaikeikb` | varchar | 2 | N | — | 2 | 00固定 |
+| 3 | 適用開始月 | `dstart` | date | — | N | — | 4 | — |
+| 4 | 適用終了月 | `dend` | date | — | — | — | — | — |
+| 5 | 社員番号 | `cshainno` | varchar | 10 | N | — | 3 | — |
+| 6 | 更新ﾕｰｻﾞ)端末ID | `cmnclient` | varchar | 10 | — | — | — | — |
+| 7 | 更新ﾕｰｻﾞ)会社区分 | `cmncomp` | varchar | 2 | — | — | — | — |
+| 8 | 更新ﾕｰｻﾞ)ﾕｰｻﾞID | `cmnuser` | varchar | 10 | — | — | — | — |
+| 9 | 更新ﾕｰｻﾞ)更新日時 | `dmndate` | timestamp | — | — | — | — | — |
+| 10 | 認定日 | `dnintei` | date | — | — | — | — | — |
+| 11 | 通勤方法)手段 | `ctukinhokb` | varchar | 2 | — | — | — | — |
+| 12 | 通勤方法)名称 | `ctukinhonm` | varchar | 20 | — | — | — | — |
+| 13 | 自動車)片道距離 | `ncarkyorih` | numeric | 12,4 | — | — | — | — |
+| 14 | 特例)特別料金等 | `ntokurei` | numeric | 12,4 | — | — | — | — |
+| 15 | 特例)支給間隔(月数) | `nmonth` | numeric | 2 | — | — | — | — |
+| 16 | 特例)支給開始年月 | `dsikyus` | date | — | — | — | — | — |
+| 17 | 調整支給額 | `nchoseishiq` | numeric | 12,4 | — | — | — | — |
+| 18 | 非課税限度額 | `nhigen` | numeric | 12,4 | — | — | — | — |
+| 19 | 現金支払済み | `nmonysumi` | numeric | 1 | — | — | — | — |
+| 20 | 支給額非課税分 | `nshiqgakuhi` | numeric | 12,4 | — | — | — | — |
+| 21 | 支給額課税分 | `nshiqgakuka` | numeric | 12,4 | — | — | — | — |
+| 22 | １ヶ月分交通費 | `nkoutuuhi1` | numeric | 12,4 | — | — | — | — |
+| 23 | 支給停止 | `nshiqstop` | numeric | 1 | — | — | — | — |
+| 24 | 特例)特別運賃等 | `ntokurei_2` | numeric | 12,4 | — | — | — | — |
+| 25 | 特例)支給間隔(月数) | `nmonth_2` | numeric | 2 | — | — | — | — |
+| 26 | 特例)支給開始年月 | `dsikyus_2` | date | — | — | — | — | — |
+| 27 | 特例)特別料金等(うち課税) | `ntokurei_ka` | numeric | 12,4 | — | — | — | — |
+| 28 | 通勤所要回数10回未満 | `nunder10` | numeric | 1 | — | — | — | — |
+
+## 索引结构(从 H6~H11 抽出)
+
+| index_no | 列 |
+|---|---|
+| U | (unique constraint 全 PK/UNIQUE 行) |
+| 1 | 会社区分(`ccompkb`) |
+| 2 | 給与体系区分(`cqtaikeikb`) |
+| 3 | 社員番号(`cshainno`) |
+| 4 | 適用開始月(`dstart`) |
+
+⚠ **PK 未明示** —索引 1~4 不连续(没有 5+),但 H6='U' 表示某行有 UNIQUE 约束。从 NOT NULL 列看(`F7~F11` 全是 N):
+- `ccompkb` + `cqtaikeikb` + `dstart` + `cshainno`(4 列 NOT NULL)— 这4 列**极可能**是 PK(UNIQUE 索引 H6='U'标记的应该就是这 4 列的组合)
diff --git a/標準版/給与システム/entity/xcshoyo_[賞与計算制御情報].md b/標準版/給与システム/entity/xcshoyo_[賞与計算制御情報].md
new file mode 100644
index 0000000..be56974
--- /dev/null
+++ b/標準版/給与システム/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 が同フォルダに存在** — 別表。本ドキュメントの対象外。