repository restructure: move .git to production/, rename dirs (design→基本設計書, list→品質管理, docs→参考資料), add Subsystem A KIN01-03 files, update AGENTS.md and README.md, cleanup tmp/ tools/ bk/

This commit is contained in:
qiuqiuqiu
2026-06-27 01:09:40 +08:00
parent 6754df70cd
commit 3379941b44
22 changed files with 3325 additions and 57 deletions
+30 -44
View File
@@ -1,56 +1,42 @@
# 勤怠管理システム - 生产环境资源
# 勤怠管理システム
本リポジトリは勤怠管理システム(サブシステムA:勤怠休暇管理、サブシステムB:残業統計管理、サブシステムC:給与計算)の生产环境リソースを管理する。
## システム概要
## 目录结构
IBM z/OS + DB2 で動作する COBOL バッチシステム。勤怠休暇管理・残業統計管理・給与計算の3サブシステムで構成される。
```
production/
├── src/ # 主プログラムソース(COBOL)
├── sub/ # 共通サブプログラム
├── cpy/ # COPY書式ファイル(レコード定義・連絡領域)
├── bin/ # 実行ファイル(.exe)+サブプログラムDLL(.dll)
├── ddl/ # DB2スキーマ定義(DDL
├── design/ # サブシステム全体設計書
├── 詳細設計書/ # 詳細設計ドキュメント
└── 使用資源一覧/ # 使用資源一覧(COPY・CALL・I/Oファイル・DBテーブル)
```
### 本番環境
- OS: IBM z/OS
- DB: DB2 for LUW
- 実行: JCL から COBOL プログラムを CALL
- コンパイラ: IBM Enterprise COBOL
### 開発環境(参考
- Windows + GnuCOBOL 3.2.0
- DB: SQLite3`tools/` の変換スクリプトで EXEC SQL を SQLite 用に自動変換)
- 本番とは別環境であり、あくまで動作確認用
## サブシステム構成
| サブシステム | 役割 | COBOLプログラム |
|-------------|------|----------------|
| A: 勤怠休暇管理 | 休暇申請取込・打刻照合・日別計算・DB更新 | 後続追加予定 |
| B: 残業統計管理 | 加班申請取込・重複チェック・照合・集計・DB更新 | ZAN01CHKZAN06UPD6本) |
| C: 給与計算 | 欠勤統計取込・給与計算・明細出力 | 後続追加予定 |
| サブシステム | 役割 | プログラム数 | 状態 |
|-------------|------|-------------|------|
| A: 勤怠休暇管理 | 休暇申請取込・打刻照合・日別計算・DB更新・CSV出力 | KIN01INPKIN07DAI7本) | 一部完了 |
| B: 残業統計管理 | 申請取込・重複チェック・照合・マッチング・集約・DB更新 | ZAN01CHKZAN06UPD6本) | 完了 |
| C: 給与計算 | 欠勤統計取込・給与計算・給与明細出力 | 未定 | 未着手 |
## 构建与运行
### 共通サブプログラム(5本)
### 编译
SUB01DAT(日付), SUB02MSG(メッセージ), SUB03ENDABEND, SUB04CHK(バリデーション), SUB05TIM(丸め)
ソースコードはCOBOL + DB2向けに実装されている。
開発環境(Windows + GnuCOBOL 3.2.0)にはDB2がないため、プリプロセッサ`convert-sql.mjs``EXEC SQL`をSQLite3用の`CALL 'br_exec'`に変換し、SQLite3で動作させる。
## ディレクトリ構成
```batch
rem プロジェクトルートで実行
tools\build.bat src\<program>.cbl
```
### 実行
```batch
set COB_CONFIG_DIR=C:\mingw64\share\gnucobol\config
set COB_LIBRARY_PATH=bin
cd <project_root>
bin\<program>.exe
src/ COBOL主プログラム(本番確定版)
sub/ COBOLサブプログラム
bin/ コンパイル済み実行ファイル(.exe)+ DLL(.dll
cpy/ COPY書式ファイル(レコード定義・連絡領域)
ddl/ DB2スキーマ定義(DDL)
基本設計書/ サブシステム全体設計書
詳細設計書/ プログラム個別詳細設計書
使用資源一覧/ 使用資源一覧(COPY・CALL・I/Oファイル・DBテーブル)
品質管理/ テスト基準・キーワード網羅定義書・カバレッジ状況
```
### サブシステムB テスト実行順序
```batch
ZAN01CHK → ZAN02CHK → ZAN03CHK → ZAN04MAT → ZAN05CAL → ZAN06UPD
```
## 编码
源文件使用 ASCII/JIS 编码保存。COPYファイルは元の命名を維持する。