マスタ管理システム課題管理

※本RMプロジェクトは村上さんから閲覧できないため、「マスタ管理システム課題管理」プロジェクトに移動します。
　合わせてタイトルを運用規則に合わせて変更いたします。

2024/7/2 Mtg

■連携ファイル名（JP様より営業日付の方が良いのでは？との意見有り）
　→現状：整形したタイミングの日付
　　・7/3朝に送られるデータ　現状の仕様
　　　7/2の営業日データ
　　　7/1の営業日データ
　　　→ztotal_202407030201.csv(両データが1ファイルにマージ)

　　　JPご提案仕様
　　　7/2の営業日データ　ztotal_20240702.csv
　　　7/1の営業日データ　ztotal_20240701.csv
　　　が送られる。
　　→現行の仕様を踏襲が良いか。

・クリエデータ連携時間の確認
　→VEが2:00,KKが4:00なので、
　　2:30までにアップロード（VEと同タイミングは避ける）

・ファイルアップロード時刻と概要のメール通知が実装可能
　→仕様に盛り込む（武田）

■モバイルオーダー売上の連携ファイル
　→JP側では t 系のフォーマットに準じたフォーマットとしている
　　→z 系は対応が難しい

　→モバイル分のz, t 系を別途出力してもらう？
　　→メリット：運用・管理面が楽。ベンダー変更時の移管工数が少ない、データを独立して集計できる
　　　デメリット：データ基盤側の取込処理の作りこみが必要

　→合算して出力してもらう？
　　→メリット：データ基盤取込側の実装・改修が軽微
　　　デメリット：POSデータのみ、モバイルデータのみで修正等が発生する場合のメンテの手間がかかる、モバイルデータを独立して管理したい場合、別途仕組み検討が必要

【結論】
・モバイル分の精算ファイルを別途出力
必須な情報
　必要なファイル種別：基本は12種類を出力依頼
・ztotal_yyyymmddHHMM_m_cc.csv

「ztotal」「ztime」「zticket」「zkkum」「zitem」「zcredit」「zaudit」
「ttotal」「ttend」「tslip」「titem」「tcredit」

■イレギュラー時の仕様について
　→売上修正発生時（すでにトランデータがS3にアップされているケース）・・・修正用ファイルを別途出力
　　NWエラー時（トランデータがS3にアップされていないケース）・・・後日該当営業日のファイルが正常時ルートで連携
　　精算忘れ（複数日分のトランデータが1つの営業日付になっているケース）・・・z系の売上、客数のみ分割し正しい営業日付データを連携
　　2回精算時・・・まかせてネット側で検知が可能　→　検知後の動作を含めて検討

【結論】
・修正ファイルは別途出力してもらう仕様とする。
　→ファイル名で区別できるようにする。
　TODO：連携内容を、差分のみ送るか全内容を送るか決めてJP様側へ打診
　　　　DWH以降でdelete/insert形式で自動化が可能か技術検討

■発注データ連携について（仕様をJP様より入手予定）
・JP様側からサンプル受領後に検討
・購買　井上さんに利用シーンをヒアリング
　→transactionデータのみを提供で大丈夫か？

■KK精算データについて
　・TECトラン形式に変換してデータ基盤側に受領する方針
　　→TECとNECで取得できるデータの差分の洗い出し、要不要の仕分けが必要
　　　例：テーブル稼働データ、ハンディ系データ、会計時間-オーダー時間、客数、クッキングタイム

【結論】
・KKトランについてはJP様と別途検討の場を設ける

【TODO】
・上記検討結果を要求仕様資料としてまとめJP送付。

先日の会議内容を元に要求仕様案をまとめました。
【JP様 要求仕様案】POS売上データ連携仕様_20240712.xlsx

臼木さん、村上さん
内容とご認識に相違ないかご確認をよろしくお願いいたします。

また、まとめるにあたってztotal以外もファイルフォーマットの検証を実施いたしました。
VEとCCの形式で一部差分があるものがありましたので方針について追加でご相談させていただけますと幸いです。
詳細については上記資料の各ファイル種別整形仕様シートをご参照ください。

2024/7/12 Mtg　レビュー内容を元に「概要・その他仕様」シート内容の修正を実施いたしました。
・【JP様 要求仕様案】POS売上データ連携仕様_20240712_02.xlsx

臼木さん　村上さん
ご指摘いただいた内容が修正されているかご確認いただけますと幸いです。
・３．データ連携タイミング
　→業態ごと、データ種類ごとにアップロード時刻を明記

・CC業態　モバイル売上データについて
　→対象データの範囲、ファイル名、ファイルフォーマット等の指定を追記

・精算データに修正が発生した場合
　→対象データの範囲、ファイル名、ファイルフォーマット等の指定を追記

モバイル売上用ファイルフォーマットを追加した改訂版を作成いたしましたので添付します。

臼木さんよりレビューを実施いただき、内容の修正を実施いたしました。

【レビュー内容】
◆データ連携タイミング
・おそらく、打合せでの履歴を残す意味合いで記載いただいていると思いますが、
　仕様関連の資料に「・・・にて検討」「・・・要相談」といった記述は出来るだけ
　無くすようにした方が良いです。（JP側も困るので）
・明確に中間成果物として定義しているのであれば良いですが、要求仕様の成果物とする場合は、
　曖昧な表現はさけて、決定内容を記載いただければよいかと思います。
・VE業態、KHK業態：修正データのところですが、「VE連携要件決定時に定義」など、出来るだけ
　明確にしてもらったほうが良いかと思います。（修正データの要件定義フェーズは無いと思うので）
・CC業態：打合せで決定していると思いますので、決定事項を記載してください。

◆モバイル売上データ
・こちらも、JP様要相談は不要だと思います。決定事項のみ記載してください
・「POS売上とモバイル売上が区別できる情報が含まれること」
　→これって、何か定義しましたっけ？テイクアウトフラグのところで大丈夫であれば、記載不要です。
　※JP様が勝手にカラム追加しても困るので

◆修正データ
・ファイル内容ですが、修正ファイルかどうかの判別は、最後の「バージョン番号」となります？
・ちなみに、この指定の仕方だと、修正が必要な日のバージョン番号ではなく、修正日とは関係ない
　ファイル作成当日のバージョン番号になりませんかね？
　→バージョン番号の意味があまりないので、どこかにcorrectionの「C」＋ケース番号？を入れるとか、
　 何か分かりやすい判別方法が良いかもしれません。
・修正ファイルは修正した店舗のレコードのみですよね？
　→その仕様も追記しておいた方が良さそうです　

【修正内容】
◆データ連携タイミング
　・決議事項以外の記載、あいまいな表現となっている記載を削除し決定内容ベースの記載に修正
　　→他大項目へ水平展開実施

◆モバイル売上データ
　・以下表現についてはご指摘の通りテイクアウトフラグを想定したものとなるため削除
　　「POS売上とモバイル売上が区別できる情報が含まれること」

◆修正データ
　・修正ファイル名称について、以下規則に修正いたしました。
　　[ファイル種別]_yyyymmddHHMM[_m][_CC]_C[ケース番号].csv
　　例：ztotal_202407240215_m_CC_C01.csv

　・修正ファイルの対象データ範囲及び連携条件について以下追記いたしました。
　　▽ 売上データに修正が発生した場合のみ秀英ファイルが連携されること
・ 修正対象店舗、該当営業日付の情報のみがデータに含まれること
・ 修正対象店舗、該当営業日内のデータ全件を正常精算データと同じフォーマットで連携すること

また、以下について別途ご指摘をいただき修正をいたしました。
・モバイル売上データ　「POS番号」項目の固定値
　→9999　→　0010　に変更

・zitem　テイクアウトフラグ系項目
　→モバイル用のフラグ番号、名称を明記

JP送付済みのためクローズします。