NextEngine API Integration Suite (GAS)

ネクストエンジンAPIを活用し、EC運営における在庫・受注・売上管理を自動化するためのGoogle Apps Script（GAS）プロジェクト群です。 ネクストエンジンから取得した情報を、Googleスプレッドシートへ出力するプログラム郡となります。 フォルダごとにGASのプロジェクトを分けていますので、必要な機能だけを使用することが出来ます。

🚀 Key Achievement: 認証基盤の完全内製化と高速処理の実装

本プロジェクトの最大の実績は、ネクストエンジン独自のOAuth2.0認証フローを完全に独自実装し、共通ライブラリ化した点にあります。

• 認証の突破とライブラリ化: 複雑なuidパラメータを含む認証フローを解析し、認証_ライブラリ.gsとして共通化。2週間の試行錯誤を経て、AIとの「バイブコーディング」により突破。
• 高速データ処理: 1回のAPIコールで1,000行、合計3,000行以上の在庫情報を約18秒で取得・同期するロジックを構築。
• 拡張性: 00_認証ライブラリ使用必須関数.gsを介して、新しいプロジェクトへ即座に認証機能を展開できるアーキテクチャを採用。
• 堅牢な運用基盤: 指数バックオフを用いたリトライ機構、詳細なログ制御、エラー通知機能を標準搭載し、無人運用における信頼性を最大化。

🛠 Technical Standards (共通品質基準)

本リポジトリの各プロジェクトは、以下の技術基準に基づいて設計・実装されています。

• Robustness: ネットワーク不安定時を想定した指数バックオフによる自動リトライ処理の実装。
• Maintainability: 全関数への JSDoc 完備による型安全性の確保と、IDE での高度な開発サポート。
• Observability: ログレベル（詳細/通常/なし）の動的制御による、デバッグとパフォーマンスの両立。
• Reliability: 処理失敗時の管理者への自動メール通知および復旧手順のガイド。

📂 Project Structure

現在、以下の8つの専門プロジェクトを運用しており、各業務を自動化しています。

1. GetInventoryData: 在庫情報の高速取得・同期
2. GetOrdersByShipDate: 出荷予定日に基づく受注データの抽出とステータス管理
3. GetSalesSummaryAcquisition: 過去7日間の売上集計とトレンド分析
4. GetScheduledShipmentQuantity: 将来の出荷予定数の可視化
5. GetSetMasterData: 複雑なセット商品マスタの展開・取得
6. GetShipmentCompletionSlip: 出荷済み伝票（同梱処理含む）のデータ管理
7. GetStoreMasterAcquisition: 各モール・カートのマスタ情報一括管理
8. GetAmazonOrderInformation: Amazon 受注情報の取得と詳細分析

🛠 Development Policy

私は**「アジャイル開発」と「スモールステップ」**を信条としています。

• 温故知新: N88-BASIC時代から培った論理的思考をベースに、最新の生成AI（Claude/Gemini/Copilot）をパートナーとして使いこなす「バイブコーディング」を実践。
• 徹底したドキュメント化: コードの文脈を重視し、JSDoc形式での詳細な定義を徹底。単なる「動くコード」ではなく「読み継がれるコード」を追求。
• 継続的改善: 毎日一歩でも前進することを目標に、全体の設計から細部への実装へとステップバイステップで開発を進めています。