Check whether your feed is valid. For more information about JSON Feed, see the specification. Find the validator source code on GitHub.
GET validation response in JSON format.
{ "version": "https://jsonfeed.org/version/1.1", "title": "Engineer — 実績とブログ", "home_page_url": "https://engineer.company/ja/", "feed_url": "https://engineer.company/ja/feed.json", "description": "Engineer ApSはコペンハーゲンでソフトウェア開発とITコンサルティングを提供しています。主な実績、サービスの範囲、明確な料金をご覧ください。", "language": "ja", "icon": "https://engineer.company/assets/images/brand/card.webp", "favicon": "https://engineer.company/assets/icons/apple/apple-touch-icon.png", "authors": [ { "name": "Engineer ApS", "url": "https://engineer.company/ja/" } ], "items": [ { "id": "https://engineer.company/ja/portfolio/a-brand-200-times-better-known/", "url": "https://engineer.company/ja/portfolio/a-brand-200-times-better-known/", "title": "複数チャネルで一貫したアイデンティティ", "summary": "Engineer ApSのオンライン・オフラインのブランド素材を構築し、一貫した視覚的アイデンティティを技術実績集に結びつけた。", "content_html": "<p><strong>状況.</strong> Engineer ApSは、確かな技術力がありながら、ほとんど知られていない新設のコンサルティング会社だった。能力も、良い仕事を提供できる見込みもあるのに、それを求める顧客や協力先が会社の存在を知らなければ機会につながらないという、もどかしい状況だった。若い会社が仕事を獲得するには、まず知ってもらう必要があった。</p>\n<p><strong>課題.</strong> オンラインとオフラインの両方で、実際に認知されるブランドを築くことが課題だった。技術への信頼を、知る人ぞ知る長所にとどめず、市場で見える存在へと変える必要があった。</p>\n<p><strong>行動.</strong> ブランドを意図的に構築し、一貫性を保った。まず、文体、視覚表現、具体的な技術成果を前面に出す実績集からなる、明確なアイデンティティを整えた。ありふれた「価値を提供する」という曖昧な表現には頼らなかった。続いて、この種の企業に重要なWebサイト、LinkedIn、GitHub、対面イベントへ展開し、接点ごとに方向がずれるのではなく、同じメッセージを伝えた。一貫して実際の事例と成果を先に示し、信頼性を単なる主張ではなく、根拠を確認できるものにした。</p>\n<p><strong>結果.</strong> 創業者の報告では、この取り組みによりブランド認知度が200倍になった。これは創業者自身による成果の説明である。独立したブランド認知度の測定資料は確認できていないが、その不在は報告された成果を否定する根拠にはならない。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "ブランド・マーケティング", "プロダクト・要件", "関係者との調整・報告", "ブランド・マーケティング・SEO", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/twice-the-engagement-from-listening-first/", "url": "https://engineer.company/ja/portfolio/twice-the-engagement-from-listening-first/", "title": "読み手の反応に基づくブランド発信", "summary": "市場調査と読み手の意見を基に、Engineer ApSの各チャネルのブランド発信、コンテンツ、働きかけを整えた。", "content_html": "<p><strong>状況.</strong> 認知の拡大に伴い、Engineer ApSはより多くの人に届くようになったが、エンゲージメントは浅かった。人々は目に留めても通り過ぎ、最初の関心が長く続く関係にはつながっていなかった。エンゲージメントを伴わない到達は雑音にとどまり、ブランドはつながりよりも発信そのものを増やしていた。</p>\n<p><strong>課題.</strong> 市場と読み手が何に反応しているかを実際に調べ、直感任せにせず、エンゲージメントとロイヤルティを深めることを目指した。</p>\n<p><strong>行動.</strong> ブランド運営を、直感主導からデータに基づくものへ改めた。市場動向と、各チャネルでの読み手の実際の行動を調べ、好まれるはずだという想定ではなく、確認できる反応を見た。そこから本当の関心を集める話題と形式を見極め、コンテンツと働きかけをそちらへ向けた。重視したのは改善の循環を短くすることだった。何が届いたかを観察し、次回はその形をより多く取り入れ、繰り返すたびに狙いを絞った。</p>\n<p><strong>結果.</strong> 市場調査と読み手の意見を、コンテンツと働きかけに反映した。提供した仕事は調査と発信の工程であり、エンゲージメントやロイヤルティの向上率はここでは数値化していない。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "データ分析", "ブランド・マーケティング", "プロダクト・要件", "関係者との調整・報告", "データ分析・BIダッシュボード", "ブランド・マーケティング・SEO", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/a-month-of-meter-readings-in-180-milliseconds/", "url": "https://engineer.company/ja/portfolio/a-month-of-meter-readings-in-180-milliseconds/", "title": "30日分の電力データを180 msで処理", "summary": "Python、SQL、Bash + Jqで電力消費量の集計を実装・測定し、Pythonで30日分のJSONLデータセットを180 msで処理した。", "content_html": "<p><strong>状況.</strong> 同社は複数のソースから来る、形式の異なる大量の電力データを処理していた。報告間隔も1時間ごとから15分ごとまで異なり、不規則な時刻の記録もあった。この違いが、一貫して比較できるデータセットの作成を難しくしていた。正確な電力分析のため、データを一定の時間別消費量へ正規化し、地域ごとに集計する必要があった。</p>\n<p><strong>課題.</strong> JSONL形式の履歴データにある生のイベントを、1時間・1地域につき1行の、時刻のそろった電力消費量へ変換することが目的だった。具体的な作業は次のとおりだった:</p>\n<ul>\n<li>時刻付きデータを厳密な1時間間隔にそろえる。</li>\n<li>電源構成の値を加算し、各区間の総発電量を集計する。</li>\n<li>輸入を加え輸出を差し引き、国境を越える電力融通を反映する。</li>\n<li>続く分析に適した、構造化され拡張可能な形式で結果を出力する。</li>\n<li>さらに、30日以上の長期間と複数の国・地域にも対応できる処理効率が必要だった。</li>\n</ul>\n<p><strong>行動.</strong> Python、コマンドラインJSON処理用のJQ、SQLの3通りを実装し、それぞれ異なる状況に合わせて最適化した:</p>\n<p>Pythonは、柔軟性、データ操作のしやすさ、メモリー内変換の効率から選んだ。純粋なPython関数を使い、次のパイプラインを構築した:</p>\n<ul>\n<li>JSONLファイルをデータフレームへ読み込む。</li>\n<li>時系列を1時間間隔に再サンプリングする。</li>\n<li>発電量を集計し、正味消費量(発電 + 輸入 − 輸出)を計算する。</li>\n<li>CSVへ出力するか、確認用の軽量SQLiteデータベースへ読み込む。</li>\n</ul>\n<p>JQでは、コマンドライン環境向けに、依存関係が少なく素早く使えるフィルターチェーンを構築した。</p>\n<p>PostgreSQLではJSONLデータを取り込み、正規化テーブルを作成して一連のSQLクエリを記述した。</p>\n<p>性能評価には、各実装で1日分と30日分の履歴データを使用した。</p>\n<p><strong>結果.</strong> Python実装が最も速く、拡張性も高い結果となった:</p>\n<ul>\n<li>1日分の処理は34 ms。</li>\n<li>30日分のデータセットは180 ms。</li>\n</ul>\n<p>この結果から、1秒未満の性能を保ちながら長期間を扱えることを確認した。コードも明確で保守しやすく、複数地域への拡張やETLパイプラインへの組み込みが容易だった。</p>\n<p>複数ツールでの実装を通じ、現実の電力データパイプラインにおける時刻合わせと集計の課題に、柔軟な道具選びと性能最適化をもって対応できることを示した。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "PostgreSQL", "Python", "SQL", "データベース", "データエンジニアリング", "データパイプライン(ETL/ELT)", "データ分析", "自動化・CI/CD", "性能改善", "データベース性能改善", "データパイプライン開発(ETL/ELT)", "データ分析・BIダッシュボード" ] }, { "id": "https://engineer.company/ja/portfolio/made-a-geographical-data-pipeline-50x-faster/", "url": "https://engineer.company/ja/portfolio/made-a-geographical-data-pipeline-50x-faster/", "title": "地理情報パイプラインを50倍に高速化", "summary": "創業者はUtiligizeで、PostgreSQL、MS SQL、BigQueryにまたがるSQLとデータモデルの作業により、地理データパイプラインの50倍の改善を記録している。", "content_html": "<p><strong>状況.</strong> 組織は大量の地理データの処理に大幅な遅延を抱えており、データに基づく意思決定と分析レポートの作成の効率に影響が出ていた。</p>\n<p><strong>課題.</strong> 地理データパイプラインを最適化して性能を高め、処理時間を短縮し、より効果的にリアルタイムでデータを分析できるようにすることが目標だった。</p>\n<p><strong>行動.</strong> PostgreSQL、MS SQL、Google Cloud BigQueryにまたがる既存のSQLプログラムとデータモデルの構造を詳しく分析したところ、非効率なインデックス戦略、不適切なクエリ設計、必要な制約の不足によるボトルネックが明らかになった。これらに対処するため、次の作業を実施した:</p>\n<ul>\n<li>データモデルを再設計して重要なデータセットを正規化し、データ取得時間を改善するためにパーティション分割を導入した。</li>\n<li>PostgreSQLのB‑treeおよびGiSTインデックス、MS SQLのフィルター付きインデックス、BigQueryのクラスタリングなど、高度なインデックス技法を適用した。</li>\n<li>サブクエリの書き換え、結合処理の削減、適切な箇所へのマテリアライズドビューの導入により、複雑なSQLクエリを最適化した。</li>\n<li>外部キーやCHECK制約などのデータ整合性制約を設定し、性能を損なわずにデータの一貫性を確保した。</li>\n</ul>\n<p><strong>結果.</strong> 創業者の実績記録では、この業務における地理データパイプラインの50倍の改善が報告されている。これは記録されたプロジェクトの結果であり、別のデータセットやシステムに対する保証ではない。公開された記録には、ベンチマークに用いたデータセット、ハードウェア、比較手順の記載はない。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "PostgreSQL", "SQL", "データウェアハウス", "データベース", "データエンジニアリング", "データガバナンス", "データパイプライン(ETL/ELT)", "性能改善", "AIが使えるデータの整備", "GIS・地理空間ソリューション", "データウェアハウス設計", "データベース性能改善", "データパイプライン開発(ETL/ELT)" ] }, { "id": "https://engineer.company/ja/portfolio/wrote-1000-rbac-rules-to-secure-linux-servers/", "url": "https://engineer.company/ja/portfolio/wrote-1000-rbac-rules-to-secure-linux-servers/", "title": "Linuxサーバーを守る1,000件のRBACルールを作成", "summary": "開発者、アプリケーション、データベース、Linuxへのアクセスに、記録上1,000のRBACルールを実装。Ansible設定を文書化した。", "content_html": "<p><strong>状況.</strong> 組織は、開発環境、アプリケーションインスタンス、PostgreSQL、MS SQL、Linuxサーバーなど、複数のシステムにわたるアクセス制御を強化する必要があった。基礎となるRBACモデルは単純だったが、多様な利用者の役割とシステム要件に対応する1,000を超える個別ルールの管理が課題だった。複雑さを持ち込まずに、厳密なアクセス制限を実現することが目標だった。</p>\n<p><strong>課題.</strong> アクセス制御のための1,000以上のルールを定義して適用し、拡張可能なRBACの仕組みを実装することだった。開発者、アプリケーションインスタンス、データベース管理者などの役割に権限を対応付け、すべてのシステムで一貫してルールを適用する必要があった。また、手作業による誤りを避けるため、ルールを文書化し、そのデプロイを自動化することも求められた。</p>\n<p><strong>行動.</strong> 単純でモジュール化されたRBAC構造を重視し、権限を「本番データベースへの読み取り専用アクセス」などの明確で再利用可能な区分に分けた。Ansibleで各ルールの設定を自動化し、環境間の一貫性を確保した。例えば、開発者には指定されたサーバーへのアクセスだけを認め、アプリケーションインスタンスには権限を限定して、侵入後の他のシステムへの横展開を防いだ。複雑さより分かりやすさを優先し、各ルールを特定の役割とシステムに明示的に結び付けた。</p>\n<p><strong>結果.</strong> 記録された作業は、開発環境、アプリケーションインスタンス、データベースサーバー、Linuxサーバーにまたがる1,000のアクセスルールと、文書化されたAnsible設定を対象としている。納品した成果は、役割に基づくルール群と、それを繰り返し適用・確認する方法である。この記録は、セキュリティリスクの低減率やデプロイ時間の削減量を数値化していない。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "DevOps", "Linux・サーバー", "インフラ", "データベース", "システム管理", "セキュリティ", "自動化・CI/CD", "文書作成", "AIエージェントのセキュリティ", "データベース管理(DBA)", "コードによるインフラ管理", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/saved-4000-hours-growing-a-team-from-2-to-18/", "url": "https://engineer.company/ja/portfolio/saved-4000-hours-growing-a-team-from-2-to-18/", "title": "推定4,000時間を削減、チームは2人から18人へ", "summary": "2人から18人に成長したチームを指導し、作業手順と部門間の連携を改善する中で、4,000時間の削減を見積もった。", "content_html": "<p><strong>状況.</strong> 2人のチームでは増える仕事に追いつけなくなっていた。知識は人の頭の中にあり、実質的な共通規約もなく、その進め方のまま規模を広げることはできなかった。整っていないチームに人だけを加えると、通常は混乱も大きくなる。</p>\n<p><strong>課題.</strong> チームを拡大すると同時に、人数が増えて遅くなるのではなく速く動ける構造をつくることが課題だった。新しい人の指導が半分、他の人を待って止まらない作業手順を整えることが残り半分だった。</p>\n<p><strong>行動.</strong> 時間をかけて2人から18人へ拡大し、採用と育成を同じ仕事として扱った。加わった全員が監督なしでも働けるようになる必要があった。共通基準によって、誰が書いてもコードと手順がそろうようにした。チームの時間が気づかないうちに失われる専門領域間の引き継ぎにも力を注いだ。繰り返しつまずく点は、症状ではなく工程に手を入れた。</p>\n<p><strong>結果.</strong> きちんと設計した手順で動く、人数が多く十分に育成されたチームにより、約4,000時間を削減した。ただし数値だけが成果ではない。特定の誰かがその場にいるかどうかにかかわらず仕事を担える、持続的な技術力を築いた。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "アジャイル・Scrum", "チームの統率", "プロジェクト管理", "技術面の統率", "指導・育成", "チームづくり・人材育成", "プロジェクト管理(アジャイル)", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/established-a-technical-support-department/", "url": "https://engineer.company/ja/portfolio/established-a-technical-support-department/", "title": "技術サポート部門を設立", "summary": "10,000を超える顧客を支える技術サポート部門を立ち上げ、都度の修理対応を拡張可能な会社の強みへ変えた。", "content_html": "<p><strong>状況.</strong> 増える顧客が信頼できる技術サポートを必要としていたが、相応の規模で提供する専任機能がなかった。その都度の対応は少数の顧客には通用しても、数が増えると気づかないうちに限界を迎える。</p>\n<p><strong>課題.</strong> 大規模で、なお増え続ける顧客層を支えられる、本格的な技術サポート体制を立ち上げることが仕事だった。</p>\n<p><strong>行動.</strong> 技術サポート部門を一から構築した。採用より前に、依頼の受付から解決までの工程、多量の依頼を扱うツール、良いサポートの基準を定め、多数の顧客へ同時にITサポートと問題解決を提供する能力を整えた。ゼロから始める利点を生かし、偶然育ったものを修繕するのではなく、会社が向かう規模に合わせて設計できた。</p>\n<p><strong>結果.</strong> 10,000を超える顧客に信頼できる支援と問題解決を提供する部門になった。サポートは事後対応から会社の強みへ変わり、顧客の増加に耐えかねるのではなく、ともに拡張できるものになった。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "チームの統率", "システム管理", "プロジェクト管理", "プロダクト・要件", "関係者との調整・報告", "指導・育成", "ITサポート・ヘルプデスク", "チームづくり・人材育成", "プロジェクト管理(アジャイル)" ] }, { "id": "https://engineer.company/ja/portfolio/engineered-600-pl-pgsql-etl-elt-pipelines/", "url": "https://engineer.company/ja/portfolio/engineered-600-pl-pgsql-etl-elt-pipelines/", "title": "PL/pgSQL ETL/ELTパイプライン600本を構築", "summary": "PostgreSQLの開発環境と本番環境に、記録上600のPL/pgSQL ETL/ELTパイプラインを構築。増分読み込みとログ記録を含む。", "content_html": "<p><strong>状況.</strong> 組織は、複数のPostgreSQL開発環境と本番環境で、大量のトランザクションデータと分析データを管理していた。既存のデータパイプラインは断片化して一貫性を欠き、性能のボトルネックを生んでいたため、事業上重要なレポート作成と意思決定に遅延が生じていた。</p>\n<p><strong>課題.</strong> PL/pgSQLを使い、堅牢で拡張可能かつ効率的なETL/ELTパイプラインを設計・実装して、複雑なデータの取り込み、変換、読み込みの流れを整理することだった。クエリ性能を高め、すべての環境でデータの整合性を確保することが主要な目標だった。</p>\n<p><strong>行動.</strong> PL/pgSQLによる600を超えるETL/ELTパイプラインを構築し、さまざまなソースからのデータの抽出、変換、読み込みを自動化した。主な技術的実装は次のとおりだった:</p>\n<ul>\n<li>パーティションテーブルとマテリアライズドビューを活用し、大規模データセットの読み取り性能を最適化した。</li>\n<li>主キー制約と外部キー制約を適用し、変換中の参照整合性を維持した。</li>\n<li>一意インデックスと複合インデックスを設計し、JOIN操作と複雑な絞り込みを高速化した。</li>\n<li>例外処理とトランザクション制御を組み込み、障害耐性と障害時のロールバックを確保した。</li>\n<li>変更データキャプチャー(CDC)の仕組みとタイムスタンプによる差分を使い、増分読み込みを可能にした。</li>\n<li>自動のログ記録と監査の手続きを開発し、パイプラインの実行を追跡し、異常を監視し、デバッグを容易にした。</li>\n</ul>\n<p><strong>結果.</strong> 実績記録では、PostgreSQLの開発環境と本番環境にまたがる600のPL/pgSQL ETL/ELTパイプラインが報告されている。納品した作業には、変換ロジック、制約、増分読み込み、実行ログの記録が含まれる。性能とデータ品質の改善は目標であり、この記録では比較ベンチマークやエラー率の算定は確立されていない。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "PostgreSQL", "SQL", "データベース", "データエンジニアリング", "データガバナンス", "データパイプライン(ETL/ELT)", "自動化・CI/CD", "性能改善", "データベース管理(DBA)", "データガバナンス・品質管理", "データパイプライン開発(ETL/ELT)" ] }, { "id": "https://engineer.company/ja/portfolio/a-tenth-of-the-cloud-bill-and-nothing-lost/", "url": "https://engineer.company/ja/portfolio/a-tenth-of-the-cloud-bill-and-nothing-lost/", "title": "AWSの外へ移し、インフラを整理", "summary": "海外の顧客のインフラを調査し、使われていないサービスを廃止した。インフラの容量を調整し、ワークロードをAWS以外の環境へ移した。", "content_html": "<p><strong>状況.</strong> 海外顧客のインフラ費用が著しく肥大化していた。AWSの過大な割り当てと、使わなくなったサービスの蓄積により、請求額は実際の業務ニーズとかけ離れていた。意図して浪費するのではなく、使用量を見ないうちに積み重なる、よくある状況だった。</p>\n<p><strong>課題.</strong> 生産性を一切落とさず費用を大幅に下げることが依頼だった。構造的に大きすぎる請求額は周辺を少し削っても変わらず、インフラを適切に再検討する必要があった。</p>\n<p><strong>行動.</strong> 使用されているサービスを調査し、不要なものを廃止し、残る容量を調整して、ワークロードをAWSから移した。これらが依頼の記録に記されている変更である。</p>\n<p><strong>結果.</strong> 創業者の報告では、生産性を損なうことなくクラウド費用を10分の1に削減した。これは創業者自身による成果の説明である。同条件で費用と生産性を比較した独立した資料は確認できていないが、その不在は報告された成果を否定する根拠にはならない。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "DevOps", "インフラ", "クラウド", "ソリューション設計", "プラットフォーム設計", "移行・モダナイゼーション", "DevOps・CI/CD自動化", "クラウドインフラ・移行", "プラットフォーム・ソリューション設計" ] }, { "id": "https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/", "url": "https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/", "title": "成長するデータモデルの時系列順キー", "summary": "PostgreSQL 18で時系列順のUUID v7キーを採用し、B-treeの断片化を減らして、エンティティのテーブルへの挿入と範囲クエリを改善することを狙った。", "content_html": "<p><strong>状況.</strong> 各エンティティには一意なIDが必要で、反射的にはランダムUUIDが選ばれる。しかしランダムIDはB‑treeの各所へ入り、挿入が散らばってインデックスが断片化し、テーブル増加とともに書き込みも範囲走査も不利になる。成長を続ける基盤へ、最初からその緩やかな損失を組み込むことは避けたかった。</p>\n<p><strong>課題.</strong> UUIDの全体での一意性を保ちつつ、ランダムさによる断片化をなくす必要があった。</p>\n<p><strong>行動.</strong> 先頭ビットが時刻で、新しい行がインデックスに散らばらず順に入るUUID v7を標準にした。PostgreSQL 18のネイティブuuidv7()を小さなuuid_generate_v7()で包み、Azure Flexible Serverでも同じ呼び出しを使えるようにした。スキーマ全体のエンティティ主キーの既定値とした。特殊な技術ではなく、早く決めれば安く、後付けでは難しい種類の判断だった。</p>\n<p><strong>結果.</strong> UUID v7が設定上のキー規約となり、新しい識別子に時系列順の性質を持たせた。断片化の抑制とクエリ高速化は設計目標であり、この事例には同じ処理負荷での導入前後のベンチマークは記録されていない。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "PostgreSQL", "データベース", "データエンジニアリング", "バックエンド開発", "性能改善", "データベース性能改善", "データベース設計・モデリング" ] }, { "id": "https://engineer.company/ja/portfolio/built-the-hiring-and-seafarer-career-workspaces/", "url": "https://engineer.company/ja/portfolio/built-the-hiring-and-seafarer-career-workspaces/", "title": "採用と船員キャリアの管理画面を構築", "summary": "採用業務と船員の経歴管理のためのワークスペースを構築した。記録された実装スナップショットでは、48テーブルと151関数という構成だった。", "content_html": "<p><strong>状況.</strong> 海事分野の専門職ネットワークの事業上の意義は採用にある。企業は船員や士官を必要とし、船員は乗り組む仕事を必要としている。両者はすでにプラットフォーム上に存在していたが、適した形にはなっていなかった。企業は名簿に、専門職はプロフィールに登録されていたものの、求人と、その仕事に必要な資格を持つ人を結び付けるものがなかった。難しいのは資格の確認である。この業界では、職名ではなく、資格証明、職位、記録された乗船期間が条件となるためだ。</p>\n<p><strong>課題.</strong> 求人、応募、検証可能な船員資格を、プロフィールの自由記述欄で済ませず、適切にモデル化する必要があった。</p>\n<p><strong>行動.</strong> ここでの件数は、記録された実装時点の状態を表しており、現在のリポジトリや現在のリリース状況を宣言するものではない。二つの領域を構築した。採用側は32テーブルと118関数からなり、求人、応募、候補者の絞り込み、雇用主向けの候補者表示を扱う。経歴管理の作業領域は16テーブルと33関数からなり、資格証明、職位の昇進、乗船期間を保持する。文書のアップロードと審査待ちの仕組みを備え、資格を自己申告で済ませず確認できるようにした。昇進を一覧ではなくグラフでモデル化したことが、照合を有用にしている。特定の資格証明と十分な乗船期間の記録があれば、ある職位から別の職位に進める。この構造により、求人をキーワードではなく経歴と照合できる。記録された時点では、経歴管理の作業領域は機能フラグで制御され、まだ全面公開されておらず、採用側は稼働中とされている。ただし、現在のデプロイ状況を示すものではない。</p>\n<p><strong>結果.</strong> 自己申告の職名ではなく、文書で裏付けられた資格を求人と照合できる。この業界では、そこが単なる求人掲示板と採用ツールを分ける。資格確認は、意図的にボトルネックになっている。審査待ちの仕組みは自動チェックと同じようには処理規模を拡大できないが、自動チェックでは認定すべきでない人まで認定してしまうためである。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "PostgreSQL", "データベース", "データガバナンス", "バックエンド開発", "フルスタック開発", "プロダクト・要件", "データベース設計・モデリング", "バックエンド・API開発", "フルスタックのプロダクト開発", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/a-whole-company-on-one-small-server/", "url": "https://engineer.company/ja/portfolio/a-whole-company-on-one-small-server/", "title": "小型サーバー上の公開サービス", "summary": "昼食より安い月額のマシンで、記録された公開サービス構成を動かし、単なる節約以上に規律で設計が良くなった。気軽に追加する余裕を失ったため、メールは意図的に載せていない。必要な余力をこのマシンは使い切っており、別ホスト待ちの導入ひな形とした。後で発見するのでなく、その判断を記録した。", "content_html": "<p><strong>状況.</strong> 本番は1コア、512 MBメモリー、10 GBディスクのクラウド1台で、利用可能なメモリーは約464 MBだった。7ドメインのTLS終端Webサーバー、git、Tor onion、Gemini、Gopher、侵入元遮断、別途実装したバックアップ自動化など、会社が公開運用するものが載っていた。通常なら大きなマシンを買う構成だった。</p>\n<p><strong>課題.</strong> 大きければ動くかではなく、設計が本当に大きなマシンを必要とするかを問うため、制約を支出で解決する問題でなく、設計の入力として扱う必要があった。</p>\n<p><strong>行動.</strong> メモリーで判断を決めた。監視agent、指標パイプライン、ダッシュボードは置かず、必要時だけ7コマンドが読み取り専用でMarkdownを生成する。監督はsystemdだけとし、上に別の管理器を重ねず、コンテナも同じsystemdのQuadlet ユニットで扱う。Web管理画面も設計段階で除外した。onionサービスを載せられるかは意見でなく1日の実測で判断した。464 MB中の利用可能量は約310 MBを下回らず、スワップ使用は2.6%、CPUは99.7%待機だった。</p>\n<p><strong>結果.</strong> 昼食より安い月額のマシンで、記録された公開サービス構成を動かし、単なる節約以上に規律で設計が良くなった。気軽に追加する余裕を失ったため、メールは意図的に載せていない。必要な余力をこのマシンは使い切っており、別ホスト待ちの導入ひな形とした。後で発見するのでなく、その判断を記録した。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "システム管理", "ソリューション設計", "プラットフォーム設計", "信頼性・バックアップ", "性能改善", "コードによるインフラ管理", "クラウドインフラ・移行", "プラットフォーム・ソリューション設計" ] }, { "id": "https://engineer.company/ja/portfolio/backups-that-have-actually-been-restored/", "url": "https://engineer.company/ja/portfolio/backups-that-have-actually-been-restored/", "title": "復元方法を明示したバックアップ自動化", "summary": "リポジトリにはバックアップと復元テストの実装があり、有効化の前提条件も記録されている。2026-10-27付の実装記録では、リポジトリ未設定のためタイマーは無効で、実環境での復元完了も記録されていない。この日付付きの証拠は自動化の仕事を裏づけるが、現在の稼働状態、災害復旧の成功、復旧時間の約束を示すものではない。", "content_html": "<p><strong>状況.</strong> Engineer ApSには、事業者のスナップショットを超えて自社インフラを守る復旧設計が必要だった。対象はバックアップの自動化、保存先の前提条件、復元を試す方法だった。</p>\n<p><strong>課題.</strong> 暗号化したホスト外スナップショット、保持規則、整合性検査、繰り返せる復元テストを実装する必要があった。これらの制御を書くことと、実環境で復旧を実証することは、別の成果物だった。</p>\n<p><strong>行動.</strong> Ansible ロールがresticスクリプトとsystemd ユニットを導入する。設定がある場合のDBダンプ、スナップショット作成、保持期限に応じた削除、整合性検査を扱う。別の月次手順が既知のファイルを一時領域へ復元し、バイト列を比較する。バックアップと復元の成功通知は別にし、タイマーはリポジトリの設定を前提とする。パスフレーズはsystemdが解釈する環境値でなく、保護したファイルから読む。</p>\n<p><strong>結果.</strong> リポジトリにはバックアップと復元テストの実装があり、有効化の前提条件も記録されている。2026‑10‑27付の実装記録では、リポジトリ未設定のためタイマーは無効で、実環境での復元完了も記録されていない。この日付付きの証拠は自動化の仕事を裏づけるが、現在の稼働状態、災害復旧の成功、復旧時間の約束を示すものではない。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "セキュリティ", "自動化・CI/CD", "信頼性・バックアップ", "文書作成", "コードによるインフラ管理", "サイト信頼性・監視", "システム管理", "バックアップ・災害復旧" ] }, { "id": "https://engineer.company/ja/portfolio/your-code-on-your-own-hardware/", "url": "https://engineer.company/ja/portfolio/your-code-on-your-own-hardware/", "title": "自社サーバーでコードを管理", "summary": "自社ハードウェアでコードを保持し、入口も測定でしか見えないずれを生まず、主サイトの全検査を引き継ぐようになった。差をつけることは可能だが、今後は明示して記す必要がある。", "content_html": "<p><strong>状況.</strong> 会社のソースコードは外部ホスティングにあった。それ自体は妥当でも、顧客データを仲介者へ渡さないと説明する会社には合わなかった。自前で運営するなら、認証、アクセス制御、保存、バックアップ、公開の入口まで、運営する必要がある。</p>\n<p><strong>課題.</strong> 既存ホストに正本のgitサーバーを設け、攻撃面を最小にし、Web管理画面をなくし、古びない入口ページを置く必要があった。</p>\n<p><strong>行動.</strong> OSが管理する単一バイナリを公式パッケージ源から導入し、守る画面を減らすため、管理Web画面のないSSH中心の仕組みを選んだ。初期状態で非公開とし、匿名・鍵なし接続を拒否し、隠すだけでなく全リポジトリを非公開にした。23231番のSSHはループバックだけで待ち受け、外からは踏み台経由として公開ポートを増やさなかった。接続先頭のバイトからHTTPSとgit SSHを共通ポートへ振り分ける仕組みも主スイッチの背後に用意したが、まだ不要な複数利用者gitのために待ち受けを増やさず、無効にした。より興味深かったのは入口ページだった。別リポジトリで主サイトのデザインを手で複製しており、発見した差はすべて判断でなく事故だった。ロゴが約9%大きくなる文字体系、フォント導入済み端末で2つの太さを同じ太さにする定義、携帯幅で常に消える装飾、未配布フォントの太さ、全ページでmain ランドマークと最上位見出しの欠落。5件中5件ともスクリーンショットには表れなかった。複製を削除し、主サイトのテンプレートでビルドして成果物として渡す方式にした。</p>\n<p><strong>結果.</strong> 自社ハードウェアでコードを保持し、入口も測定でしか見えないずれを生まず、主サイトの全検査を引き継ぐようになった。差をつけることは可能だが、今後は明示して記す必要がある。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "DevOps", "Linux・サーバー", "Web開発", "インフラ", "システム管理", "自動化・CI/CD", "DevOps・CI/CD自動化", "Webサイト・CMS開発", "コードによるインフラ管理" ] }, { "id": "https://engineer.company/ja/portfolio/a-site-that-meets-the-accessibility-standard/", "url": "https://engineer.company/ja/portfolio/a-site-that-meets-the-accessibility-standard/", "title": "32ページを両テーマでアクセシビリティ検査", "summary": "適合記録は、代表32ページ、両テーマ、明記したビューポートのサンプルという検査と対象範囲を記録している。WCAG 2.2基準1.4.13は部分達成にとどまり、実際の支援技術による試験も確認されていないと記す。これは実装したアクセシビリティ検査と既知の限界の証拠であり、すべての構成での完全なLevel AA適合ではない。", "content_html": "<p><strong>状況.</strong> 技術判断を販売する会社がアクセシブルでないWebサイトを出せば、アクセシビリティ以前に信頼の問題になる。3言語、2配色、印刷CSS、ダーク中心の配色、手書き注釈、キャラクターと対象も広く、ある構成で通る基準を別構成で落とす可能性がそれぞれにあった。</p>\n<p><strong>課題.</strong> 全ページ、全言語、両テーマでWCAG 2.2 Level AAを満たし、文書の主張でなく検査で適合を守る必要があった。</p>\n<p><strong>行動.</strong> 対象の全基準について、満たす仕組みと検査を記録した。AAAの視覚的提示1項目も全体で目標を超えて扱った。フォーカス外観は写真上のコントラストを実証できないため、適合の主張でなく提供にとどめた。適合規則だけでなく実務推奨規則も有効にし、30ルールの違いが即座に効いた。追加直後、全内部ページのブランドマークがランドマーク外にあると検出した。別の遅い検査は代表32ページを2配色・2幅で試し、実際にTabを押して画素を比較する。マークアップが何を示しても画素が同じなら位置がわからないため、文書でなく画素でフォーカスを実証する。全ページのキーボード閉じ込めを調べ、規定の文字間隔変更、本文サイズ2倍を適用し、行長、均等配置、中央揃え、段落間隔も測定した。</p>\n<p><strong>結果.</strong> 適合記録は、代表32ページ、両テーマ、明記したビューポートのサンプルという検査と対象範囲を記録している。WCAG 2.2基準1.4.13は部分達成にとどまり、実際の支援技術による試験も確認されていないと記す。これは実装したアクセシビリティ検査と既知の限界の証拠であり、すべての構成での完全なLevel AA適合ではない。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "UX・UI設計", "Web開発", "デザインシステム・UI", "テスト・品質保証", "フロントエンド開発", "国際化", "文書作成", "AIエージェントへの対応", "UI/UX設計・デザインシステム", "Webサイト・CMS開発", "国際化・ローカライズ" ] }, { "id": "https://engineer.company/ja/portfolio/mirrored-the-site-to-gemini-and-gopher/", "url": "https://engineer.company/ja/portfolio/mirrored-the-site-to-gemini-and-gopher/", "title": "GeminiとGopherへサイトを複製", "summary": "過去のビルドでGemini文書777件とGopher文書777件を記録。HTMLに変更がなかったのは、これらの出力形式を追加した際の結果。", "content_html": "<p><strong>状況.</strong> このサイトは静的な文書を公開している。GeminiとGopherにより、ブラウザーのスクリプトを使わずに、その内容を読む手段を追加できる。</p>\n<p><strong>課題.</strong> ソースを共有し、追加による影響をHTMLの表示から分離しながら、同じHugoのコンテンツパイプラインに両形式を追加することだった。</p>\n<p><strong>行動.</strong> Hugoの出力形式により、HTMLと並んでGemini文書とGopherメニューを生成する。この実績では、その実装時点で各形式777文書を記録している。両形式は代替表現として扱わない設定を用い、別途行ったビルドの比較では、形式の追加によって変更されたHTMLはゼロバイトと記録された。Gopherの文章は、テキストメニューでの表示に合わせて折り返す。</p>\n<p><strong>結果.</strong> 777という数字は過去の文書数であり、現在の総数や訪問者数ではない。ゼロバイトという結果は出力形式の追加に関するもので、その後の文章や見た目の変更に関するものではない。どちらのプロトコルもウェブサイトのソースを再利用しているが、この記録は、それらが利用可能であることを、測定された読者数や事業上の成果に置き換えるものではない。</p>\n", "date_published": "2026-11-15T20:47:44+01:00", "date_modified": "2026-11-15T20:47:44+01:00", "language": "ja", "tags": [ "Web開発", "インフラ", "フロントエンド開発", "国際化", "自動化・CI/CD", "DevOps・CI/CD自動化", "Webサイト・CMS開発", "国際化・ローカライズ" ] }, { "id": "https://engineer.company/ja/portfolio/one-infrastructure-plan-for-14-departments/", "url": "https://engineer.company/ja/portfolio/one-infrastructure-plan-for-14-departments/", "title": "14部門を支える共通インフラ計画", "summary": "研究機関の14部門に共通する包括的なインフラの枠組みを設計。モジュール構成、統一されたデータパイプライン、支援方針を備えた。", "content_html": "<p><strong>状況.</strong> 14の多様な研究グループからなる研究機関で、各グループが異なるデータソース、形式、規模、ソフトウェアを使っていた。技術的な専門性や利用できるIT資源にも大きな差があった。独自のITソリューションを構築・導入したグループもあった一方、多くは複雑なデータインフラ要件への対応に苦労し、本来の研究から貴重な時間と注意を奪われていた。</p>\n<p><strong>課題.</strong> 研究者がIT上の問題より科学的な仕事に集中できる仕組みを考えることが課題だった。大半の研究グループが持つ幅広く異なる要件に対応できる、拡張可能な機関全体のデータインフラを設計・実装することを目指した。</p>\n<p><strong>行動.</strong> 柔軟性と標準化を両立する、堅実で将来を見据えたインフラ計画を策定した。モジュール型の構成、多様なデータソースの連携経路、技術習熟度に応じた使いやすい画面、拡張可能な保存・処理基盤などの主要部分を定めた。導入と継続利用を支えるため、利用開始時の支援、サポート、ガバナンスの方針も含めた。</p>\n<p><strong>結果.</strong> 技術的な妥当性を備え、機関の研究目標とも整合するインフラ計画ができた。組織全体のデータ管理の方向性を統一し、研究者のIT負担を減らす道筋を示して、共有でき、効率的で、将来の変化に対応できる研究データ環境の基礎を整えた。多様な利用者への配慮、明確さ、適応性が評価され、機関のデータインフラ変革に明確な方向を与えた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "インフラ", "データエンジニアリング", "データガバナンス", "データパイプライン(ETL/ELT)", "ソリューション設計", "プラットフォーム設計", "関係者との調整・報告", "技術面の統率", "文書作成", "データガバナンス・品質管理", "データパイプライン開発(ETL/ELT)", "プラットフォーム・ソリューション設計", "技術文書の作成", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/improved-gis-map-performance-10x-on-postgresql/", "url": "https://engineer.company/ja/portfolio/improved-gis-map-performance-10x-on-postgresql/", "title": "PostgreSQLでGIS地図を10倍に高速化", "summary": "MSSQLからPostgreSQLへの移行でGIS地図アプリケーションを10倍に高速化し、空間クエリを2.5秒から250 ms未満へ短縮した。", "content_html": "<p><strong>状況.</strong> 多数の利用者にリアルタイムの空間クエリを提供する地図アプリケーションで、深刻な性能上のボトルネックが発生していた。地図レイヤーの描画と位置データの問い合わせの遅延が、使い勝手とバックエンドの信頼性に影響していた。基盤は、従来のMicrosoft SQL Server(MSSQL)データベースだった。</p>\n<p><strong>課題.</strong> 空間処理のクエリ遅延を減らし処理量を増やすことを具体的な目標として、地図アプリケーションの性能、拡張性、安全性を向上させる必要があった。</p>\n<p><strong>行動.</strong> 地理空間情報をネイティブに扱えるよう、MSSQLからPostGIS拡張付きPostgreSQLへの計画的な移行を主導した。</p>\n<ul>\n<li>空間データに適した新スキーマを設計し、geometry・geography列にGiST・SP‑GiSTインデックスを設けて問い合わせを高速化した。</li>\n<li>厳密な外部キー・CHECK制約でリレーショナルな整合性を守り、空間座標の検証規則を適用した。</li>\n<li>新しいSRID基準(EPSG:4326)へ合わせる変換を含むETLパイプラインで、5,000万件を超える空間レコードを移行した。</li>\n<li>同時アクセス時のI/O性能に合わせ、work_mem、effective_cache_sizeなどのPostgreSQL設定を調整した。</li>\n<li>ロールベースのアクセス制御(RBAC)と行レベルセキュリティで、複数のユーザーグループにまたがるデータ保護方針を適用した。</li>\n</ul>\n<p><strong>結果.</strong> 空間クエリの性能が10倍に向上し、平均応答時間を2.5秒から250ミリ秒未満へ短縮した。バックエンドCPU負荷は65%低下し、ピーク時の可用性も改善した。細かなアクセス方針とデータ検証制約により安全性も高まり、空間データが破損する可能性を抑えた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "PostgreSQL", "SQL", "データベース", "データエンジニアリング", "データパイプライン(ETL/ELT)", "セキュリティ", "バックエンド開発", "移行・モダナイゼーション", "性能改善", "GIS・地理空間ソリューション", "データベース移行・モダナイゼーション", "データベース性能改善" ] }, { "id": "https://engineer.company/ja/portfolio/ran-100-postgresql-ms-sql-bigquery-warehouses/", "url": "https://engineer.company/ja/portfolio/ran-100-postgresql-ms-sql-bigquery-warehouses/", "title": "PostgreSQL・MS SQL・BigQueryのデータウェアハウス100個を運用", "summary": "GIS・時系列データ用のPostgreSQL、MS SQL、BigQueryデータウェアハウス100個を設計・運用し、クエリ時間を40–60%削減した。", "content_html": "<p><strong>状況.</strong> 急成長する技術企業で、PostgreSQL、Microsoft SQL Server、Google BigQueryにまたがる100個以上の多様なデータベースを構築・管理・最適化する必要があった。主な対象は、空間座標や位置に基づく分析などのGISデータと、センサー値、ログ、リアルタイム指標などの時系列データだった。データ量が指数関数的に増えるなか、既存インフラには拡張性、クエリ性能、データの一貫性の課題があった。信頼性を確保し、運用費用を抑える堅実な設計が必要だった。</p>\n<p><strong>課題.</strong> GIS・時系列データに適した、拡張可能で高性能なデータウェアハウス環境を設計・実装・管理することが主目的だった。具体的には次を含んだ:</p>\n<ul>\n<li>複雑な空間・時間クエリの性能上のボトルネックに対応する。</li>\n<li>費用対効果を保ちながら、増えるデータ量に対応する拡張性を確保する。</li>\n<li>データサイエンティストやプロダクトマネージャーなどと部門横断で協働し、設計を業務ニーズに合わせる。</li>\n</ul>\n<p><strong>行動.</strong> 目標に向け、次を実施した:</p>\n<ol>\n<li>拡張可能な設計:</li>\n</ol>\n<ul>\n<li>PostgreSQLとSQL Serverに正規化・非正規化スキーマを作成し、PostgreSQLのPostGISなどの空間インデックスと時系列パーティションで性能を最適化した。</li>\n<li>BigQueryの時間パーティション・クラスタ化テーブルで、大規模時系列データを効率的に扱った。</li>\n</ul>\n<ol start=\"2\">\n<li>最適化方針の実装:</li>\n</ol>\n<ul>\n<li>インデックス、マテリアライズドビュー、キャッシュで、GIS・時系列クエリの遅延を減らした。</li>\n<li>BigQueryにデータ圧縮と列指向保存を適用し、保存費用とスキャン時間を削減した。</li>\n</ul>\n<ol start=\"3\">\n<li>異なる基盤間の連携:</li>\n</ol>\n<ul>\n<li>GIS・時系列データモデリングの適切な実務慣行を記録し、今後のプロジェクトの指針とした。</li>\n</ul>\n<p><strong>結果.</strong> 取り組みにより、次の改善を得た:</p>\n<ul>\n<li>性能: GIS・時系列のクエリ応答時間を40–60%減らし、分析と判断を迅速化した。</li>\n<li>運用の信頼性: 自動監視で停止時間を50%削減し、標準化した工程でチームの生産性を高め、誤りを減らした。</li>\n<li>事業への効果: 最適化した基盤によってリアルタイム分析ダッシュボードなどの新しいデータ製品を公開でき、データガバナンスに関する規制要件への対応も可能になった。</li>\n</ul>\n<p>複雑なデータ課題に対応する組織の力を確かなものにした。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "PostgreSQL", "SQL", "データウェアハウス", "データベース", "データエンジニアリング", "データガバナンス", "プラットフォーム設計", "信頼性・バックアップ", "性能改善", "GIS・地理空間ソリューション", "データウェアハウス設計", "データベース管理(DBA)", "データベース性能改善", "データベース設計・モデリング" ] }, { "id": "https://engineer.company/ja/portfolio/automated-delivery-of-20-gis-data-pipelines/", "url": "https://engineer.company/ja/portfolio/automated-delivery-of-20-gis-data-pipelines/", "title": "GISデータパイプライン20本の提供を自動化", "summary": "GISデータパイプライン20本とアプリデータのETL処理を自動化し、インフラ自動化を効率化して、信頼できる最新データを届けた。", "content_html": "<p><strong>状況.</strong> プラットフォームを支える多数のGISパイプラインとアプリデータのETLが、手動で提供・監視されていた。手動運用はボトルネックや不一致を生み、何より、静かな失敗に気づかず、下流のデータが誤ってから発覚する危険が常にあった。</p>\n<p><strong>課題.</strong> 担当者が付き添わなくてもデータが確実かつ予測どおり流れるよう、パイプラインとETLの提供を自動化することが課題だった。</p>\n<p><strong>行動.</strong> 20本のGISデータパイプラインとアプリデータのETLを、最初から最後まで自動提供へ移した。予定実行、ログ、失敗時の処理を標準化し、全パイプラインが同じように動き、そうでないときもわかるようにした。失敗が静かなままなのは、監視がないからだった。既存のインフラ自動化と報告にも統合し、実行を覚えておく必要のあるスクリプトの寄せ集めではなく、1つのまとまった仕組みにした。</p>\n<p><strong>結果.</strong> 20本すべてとそのETLが自動かつ予測どおり動き、インフラ自動化と報告の全体も整理された。人が手動で通す必要も、気づかない失敗の危険を抱える必要もなく、事業へ信頼できる最新データを届けられるようになった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "GIS・地理空間情報", "データエンジニアリング", "データパイプライン(ETL/ELT)", "監視・オブザーバビリティ", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "GIS・地理空間ソリューション", "データパイプライン開発(ETL/ELT)" ] }, { "id": "https://engineer.company/ja/portfolio/automated-100-critical-data-backups-using-barman/", "url": "https://engineer.company/ja/portfolio/automated-100-critical-data-backups-using-barman/", "title": "Barmanで重要データのバックアップ100件を自動化", "summary": "Barman、Google Cloud、Bash、Pythonで重要なデータベースバックアップ100件を自動化し、データを復旧できることを実際に検証した。", "content_html": "<p><strong>状況.</strong> 重要なGISデータ、アプリケーション、データベースが複数システムに散らばり、バックアップは不統一で、一部は手動だった。データに依存する製品にとって放置できない危険であり、実際に必要になった日は、不完全なバックアップに初めて気づくには最悪の時機だった。</p>\n<p><strong>課題.</strong> 重要なデータをすべて復旧できるようにすることが課題だった。そのため、環境全体を対象とした、包括的で検証済みのバックアップを自動化する必要があり、とりわけ検証を重視した。</p>\n<p><strong>行動.</strong> バックアップの仕組み全体を構築した。重要なデータのバックアップ100件を自動化し、PostgreSQLにはBarman、遠隔コピーの保管にはGoogle Cloudを用い、全体の制御と検証をBash・Pythonで行った。取得しても確認しないバックアップは、復旧手段というより期待にすぎない。最新性を保つ保持方針と、存在するだけでなく正常であることを確かめる整合性検査を設けた。</p>\n<p><strong>結果.</strong> 全データベースのバックアップが自動化され、検証可能となり、復旧可能性は想定から実証済みの事実へ変わった。大きな運用リスクが、実際に頼れる復旧経路へ置き換わった。設定しただけでなく、確かめたことが違いだった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "PostgreSQL", "Python", "インフラ", "データベース", "クラウド", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "データベース管理(DBA)", "バックアップ・災害復旧" ] }, { "id": "https://engineer.company/ja/portfolio/managed-30-ubuntu-linux-vps-instances/", "url": "https://engineer.company/ja/portfolio/managed-30-ubuntu-linux-vps-instances/", "title": "Ubuntu Linux VPSインスタンス30台を管理", "summary": "検証済みの災害復旧方針と適切なネットワーク構成を備えたUbuntu Linux VPSインスタンス30台を管理し、成長を支える回復力のある基盤を整えた。", "content_html": "<p><strong>状況.</strong> 同社のUbuntu Linux VPS群は、時間をかけて自然に増築されていた。設計に沿って整えたというより、積み重なった状態だった。そのため設定に不一致があり、復旧とネットワークの構成も、計画より過去の成り行きに左右されていた。</p>\n<p><strong>課題.</strong> サーバー群を適切な管理下に置き、災害復旧を強化し、全インスタンスのネットワークを一貫した妥当な構成にすることが課題だった。</p>\n<p><strong>行動.</strong> 30台を個別に手入れする対象ではなく、まとまったサーバー群として計画的に管理した。バックアップと、実際に試した復元手順を導入した。復元を試さなければ、復旧は理論にすぎないためだった。ネットワークも安全性と性能を踏まえて標準化し、各台が偶然行き着いた状態ではなく、同じ堅牢な基準に従うようにした。</p>\n<p><strong>結果.</strong> インフラに一貫性と回復力が備わり、実証した復旧経路と頼れるネットワークを得た。停止の危険が減り、継ぎはぎを手当てし続けるのではなく、成長を支える安定した基盤となった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "Linux・サーバー", "インフラ", "システム管理", "セキュリティ", "ネットワーク・VPN", "信頼性・バックアップ", "ネットワーク・VPN構築", "バックアップ・災害復旧" ] }, { "id": "https://engineer.company/ja/portfolio/led-access-management-across-m365-and-sso/", "url": "https://engineer.company/ja/portfolio/led-access-management-across-m365-and-sso/", "title": "M365・SSO全体のアクセス管理を主導", "summary": "M365、1Password、Red Hat SSO、OKTAでアクセス管理を主導し、不正アクセスリスクを大幅に減らしてアクセスの監査を可能にした。", "content_html": "<p><strong>状況.</strong> 社内システムやサービスの権限が、さまざまな人によって、その都度、一貫性なく付与されていた。意図しないアクセスを許すだけでなく、誰が何に、なぜ接続できるのかを答えられず、監査もほとんどできないという二重の問題があった。</p>\n<p><strong>課題.</strong> 組織全体のアクセス管理を集約・厳格化し、アクセス管理上のリスクを抑えることを目指した。</p>\n<p><strong>行動.</strong> M365、1Password、Red Hat SSO、OKTA SSOのIDとアクセスを統合し、システムごとに散らばる権限ではなく、一貫した全体像を整えた。人にもシステムにも、必要な権限だけを持たせる最小権限を適用した。入社・退社時の手続きも標準化し、アクセスの付与だけでなく、その解除も速やかで一貫したものにした。離れた人の権限が残る状態を防いだ。</p>\n<p><strong>結果.</strong> 不正アクセスのリスクが大きく下がり、アクセスを一貫して監査できるようになった。「誰が、なぜここにアクセスできるのか」に、ようやく答えられる状態となった。同時に日々の仕事も簡単になった。必要な入口は容易に使え、不要な入口は閉じたままになる。それが適切なアクセス管理の実際の使い心地だった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "インフラ", "クラウド", "システム管理", "セキュリティ", "自動化・CI/CD", "AIエージェントのセキュリティ", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/cut-operational-risk-with-grafana-and-prometheus/", "url": "https://engineer.company/ja/portfolio/cut-operational-risk-with-grafana-and-prometheus/", "title": "GrafanaとPrometheusで運用リスクを低減", "summary": "GrafanaとPrometheusで問題の深刻化前に検知する監視ダッシュボードを構築し、事後対応から予防へチームを転換した。", "content_html": "<p><strong>状況.</strong> システムの状態をまとめて見られなかったため、問題に気づくのは利用者に影響が出たあとになることが多かった。可視性がなく、予兆を捉えるより、起きたことへの対応に追われていた。</p>\n<p><strong>課題.</strong> 依存するシステムの状態をリアルタイムに把握できるようにし、運用リスクを減らすことを目指した。</p>\n<p><strong>行動.</strong> オブザーバビリティの層を整えた。GrafanaとPrometheusの監視ダッシュボードを構築し、主要サービスに計測を加えた。忙しく動いているように見せるだけの数値ではなく、意味のある指標を選んだ。それらに警報の閾値を設け、チームが実際に目にする場所に表示し、対処する余地があるうちに行動できるようにした。</p>\n<p><strong>結果.</strong> 問題が深刻になる前に発見・対処されるようになり、システムの信頼性が向上した。事後の火消しから、落ち着いた予防的な運用へ移り、小さく平穏に片づけられるうちに問題を捉えられるようになった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "インフラ", "監視・オブザーバビリティ", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "サイト信頼性・監視" ] }, { "id": "https://engineer.company/ja/portfolio/managed-8-wireguard-and-ipsec-vpn-connections/", "url": "https://engineer.company/ja/portfolio/managed-8-wireguard-and-ipsec-vpn-connections/", "title": "WireGuard・IPsec VPN接続8本を管理", "summary": "Google Cloud・Linux間のWireGuard・IPsec VPN接続8本を管理して問題に対処し、繰り返す接続障害を解消した。", "content_html": "<p><strong>状況.</strong> クラウドとオンプレミスLinuxの安全な接続は複数のVPNトンネルに依存していたが、不安定で、切れたときの診断も難しかった。トンネルが止まると環境間の通信が途切れ、原因調査は遅く不確かで、真因を特定したかどうかにも確信を持てなかった。</p>\n<p><strong>課題.</strong> これらの接続を管理・調査し、安全で途切れない通信を確保することが仕事だった。</p>\n<p><strong>行動.</strong> Google CloudとLinuxの間のWireGuard・IPsecトンネル8本を、8つの別々の謎ではなく、1つのまとまった対象として管理・調査した。設定を標準化し、個別の特殊事情ではなく、一貫して理解できる形にした。健全性を監視し、繰り返す経路設定や鍵交換の問題は、再起動で取り繕わず、根本から解決した。</p>\n<p><strong>結果.</strong> 8本すべてが安全かつ確実に動き、環境間通信が保護され、作業を妨げていた反復的な接続障害がなくなった。症状をなだめるのではなく真因を直すことで、繰り返す悩みの種が、普通に動く仕組みへ変わった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "クラウド", "システム管理", "セキュリティ", "ネットワーク・VPN", "信頼性・バックアップ", "セキュリティ・アクセス管理", "ネットワーク・VPN構築" ] }, { "id": "https://engineer.company/ja/portfolio/presented-200-ui-ux-improvements/", "url": "https://engineer.company/ja/portfolio/presented-200-ui-ux-improvements/", "title": "UI/UX改善200件を提案", "summary": "GIS地図アプリケーションに200件のUI/UX改善を実施し、丁寧なUXを事業成果につなげて売上10倍に寄与した。", "content_html": "<p><strong>状況.</strong> 地図の機能が強力になるにつれ、画面は複雑になっていた。良い機能が不器用な操作の奥に隠れ、すぐ目の前の価値を顧客が得られていない箇所があった。製品にできることと、利用者が簡単にできることの差が、静かに損失を生んでいた。</p>\n<p><strong>課題.</strong> その差を見つけて改善を実現し、製品から価値を得やすくするとともに、商業的な価値も高めることが仕事だった。</p>\n<p><strong>行動.</strong> 問題を推測するのではなく、フィードバックと使用データを調べ、具体的なUI/UX改善200件のバックログを作った。すべてを同等とは扱わず、効果で順位づけし、重要なものは必要性を説明してチームを通じて実装した。文書内で古くなる要望一覧ではなく、実際の機能として届けた。</p>\n<p><strong>結果.</strong> 画面は明らかに使いやすくなり、製品価値も高まり、売上が10倍になることに寄与した。丁寧なUXは見た目だけの話ではなく、売上に表れることを明確に示す事例となった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "UX・UI設計", "データ分析", "デザインシステム・UI", "プロダクト・要件", "フロントエンド開発", "関係者との調整・報告", "UI/UX設計・デザインシステム", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/managed-5000-hours-of-map-development/", "url": "https://engineer.company/ja/portfolio/managed-5000-hours-of-map-development/", "title": "5,000時間の地図開発を管理", "summary": "ScrumとJiraで5,000時間の地図開発を計画・管理し、作業を可視化してロードマップに沿って進めた。", "content_html": "<p><strong>状況.</strong> 地図は1回のスプリントで完成するものではなかった。多数の人と長い期間にまたがる数千時間の作業であり、範囲と日程を守る担当がいなければ方向がずれ、気づかないうちに遅延してしまう。</p>\n<p><strong>課題.</strong> 偶然ではなく計画に沿って成果を届けるよう開発を設計・運営し、優先順位を実態に即したものにし、進捗を誰でも確認できるようにすることが責任だった。</p>\n<p><strong>行動.</strong> アジャイルで進め、Scrumのイベントを形だけでなく実際に役立て、Jiraで状況を問い合わせずに見られるようにした。約5,000時間の地図開発をこの工程で扱った。形式そのものより、重要な目標へ優先順位を向け、安く修正できるうちにずれを捉えることを重視した。</p>\n<p><strong>結果.</strong> 5,000時間がブラックボックスへ消えるのではなく、管理され、見える形で成果になった。終盤の無理に頼らず、目標との整合性とおおむね予定どおりの進行を保った。うまく機能すると目立たないが、本来のプロジェクト管理を果たした。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "アジャイル・Scrum", "チームの統率", "プロジェクト管理", "プロダクト・要件", "関係者との調整・報告", "チームづくり・人材育成", "プロジェクト管理(アジャイル)", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/wrote-50000-words-of-software-documentation/", "url": "https://engineer.company/ja/portfolio/wrote-50000-words-of-software-documentation/", "title": "50,000語のソフトウェア文書を執筆", "summary": "GitHub、Craft、Confluenceに50,000語のソフトウェア文書を書き、知識を継続的に残し、透明性と監査可能性を確保した。", "content_html": "<p><strong>状況.</strong> 製品と仕事の進め方に関する重要な知識の多くが、人の頭の中にあった。新しい人が来るまでは問題に見えずとも、受け入れは遅くなり、誰かが退職すれば組織の記憶の一部が永遠に失われかねなかった。</p>\n<p><strong>課題.</strong> 知識を人の頭から取り出し、実際に保管し利用される文書にすることを目指した。読めるほど明確で、1か月で放置されず維持できるほど構造化する必要があった。</p>\n<p><strong>行動.</strong> 内容に合う場所を選び、GitHub、Craft、ConfluenceにMarkdownで多くの内容を自ら執筆し、最終的に約50,000語になった。設計、工程、実際の操作方法など、人が繰り返し尋ねる内容を扱った。版管理と同じく、見つけやすさも重視した。所在がわからない文書は、存在しないのとほとんど同じだからだった。</p>\n<p><strong>結果.</strong> 知識が失われやすい状態を脱した。新しい人は早く仕事を理解でき、工程は記憶から再構成せず参照できるものになった。信じるだけでなく、どう、なぜ仕事を進めたかを見られる、監査可能な状態となった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "チームの統率", "技術面の統率", "指導・育成", "文書作成", "技術文書の作成", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/automated-ssl-tls-certs-for-100-docker-apps/", "url": "https://engineer.company/ja/portfolio/automated-ssl-tls-certs-for-100-docker-apps/", "title": "Dockerアプリ100個のSSL/TLS証明書を自動化", "summary": "Ubuntu Linux上のDockerアプリ100個のSSL/TLS証明書を自動化し、手動更新と期限切れによる停止を解消した。", "content_html": "<p><strong>状況.</strong> 100個のDockerアプリケーションがSSL/TLS証明書を必要としていた。証明書は、問題が起こる直前までは問題が見えない種類のものだった。100個を手動で発行・更新するのは遅く単調で、1つの更新忘れが最悪の時機に期限切れを起こし、アプリを停止させかねなかった。</p>\n<p><strong>課題.</strong> 作成と更新を自動化し、全アプリが有効で信頼できる暗号化を維持し、誰も作業を覚えておく必要がない状態を目指した。</p>\n<p><strong>行動.</strong> ACME方式で100個のアプリの証明書の作成から有効期限が切れる前の更新までを管理し、ApacheとNginxが混在するUbuntu Linuxホストへ自動配布した。忘れる可能性のある人の作業を取り除くことが狙いだった。</p>\n<p><strong>結果.</strong> 100個すべてが、自動で有効な証明書と安全な接続を保った。手動の証明書作業がなくなり、機器の故障ではなく、気づかぬ証明書の期限切れが原因となる停止も、その種類ごと解消した。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "Linux・サーバー", "インフラ", "コンテナ(Docker/Kubernetes)", "セキュリティ", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "コンテナ化・オーケストレーション", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/managed-a-team-delivering-it-support/", "url": "https://engineer.company/ja/portfolio/managed-a-team-delivering-it-support/", "title": "ITサポートチームを管理", "summary": "1,000を超える顧客にITサポート、データ復旧、機器修理を提供するチームを率い、信頼できるサービスという評価を築いた。", "content_html": "<p><strong>状況.</strong> 多数の顧客が、ITの故障時に、サポート、データ復旧、機器修理など幅広い支援を求めて同社を訪れていた。途切れない日常的な需要に応えるには、一時の奮闘より、日々きちんと動くチームが必要だった。</p>\n<p><strong>課題.</strong> すべてを提供するチームを管理し、静かな週でも依頼が集中しても、一貫した品質を保つことが仕事だった。</p>\n<p><strong>行動.</strong> 1,000を超える顧客へ、ITサポート、データ復旧、機器修理を提供した。依頼を取りこぼさず引き受け、半端な修理を返さないよう「直った」の基準を定め、依頼がたまってもチームが機能するようにする、土台の整理が大きな部分だった。特にデータ復旧は軽く扱えない。ディスクには大切な写真や事業の記録があり、依頼者は来店時点ですでに困難に直面していた。</p>\n<p><strong>結果.</strong> 1,000を超える顧客に対応し、確実なサービスという評価を築いた。この業種では評価が事業を支える。前回の故障を実際に解決できたからこそ、顧客は再び訪れ、他の人にも紹介した。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "チームの統率", "システム管理", "関係者との調整・報告", "指導・育成", "ITサポート・ヘルプデスク", "チームづくり・人材育成", "機器修理・データ復旧" ] }, { "id": "https://engineer.company/ja/portfolio/a-mapping-product-carried-end-to-end/", "url": "https://engineer.company/ja/portfolio/a-mapping-product-carried-end-to-end/", "title": "地図製品を最初から運用まで支える", "summary": "2年間にわたりインフラ、データ処理、地図アプリケーションを設計・構築・支援し、開発成果の提供と運用保守を担った。", "content_html": "<p><strong>状況.</strong> 地図製品には、インフラ、データ処理、顧客向け地図アプリケーションが必要だった。実績記録には、2年間の業務として記されている。</p>\n<p><strong>課題.</strong> 各層の設計、実装、サポートを担当した。範囲は提供した技術業務と保守であり、稼働率や人員配置の約束ではない。</p>\n<p><strong>行動.</strong> 業務期間を通じて、インフラ、データ処理の流れ、地図アプリケーションを設計・構築・保守した。製品が用いるデータと画面を、稼働環境に結びつけた。</p>\n<p><strong>結果.</strong> 記録は、インフラ、データ、アプリケーションの各層にわたる継続的な提供を説明する。期間と範囲を示すもので、可用性測定、応答時間の統計、無停止サービスの保証を示すものではない。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "インフラ", "データエンジニアリング", "データパイプライン(ETL/ELT)", "プラットフォーム設計", "フルスタック開発", "信頼性・バックアップ", "GIS・地理空間ソリューション", "データパイプライン開発(ETL/ELT)", "サイト信頼性・監視", "プラットフォーム・ソリューション設計", "フルスタックのプロダクト開発" ] }, { "id": "https://engineer.company/ja/portfolio/migrated-the-api-to-huma-v2-at-100-parity/", "url": "https://engineer.company/ja/portfolio/migrated-the-api-to-huma-v2-at-100-parity/", "title": "APIを100%の一致でHuma v2へ移行", "summary": "649パス・760操作のHTTP APIをFiberからHuma v2へ移行し、登録ルートと公開OpenAPI記述を100%一致させた。", "content_html": "<p><strong>状況.</strong> APIはFiberで始まり、エンドポイントごとにリクエスト検証を手書きしていた。少数ならよくても、増えるにつれ保守負担となり、各実装が独自であるため小さな不一致が入り込んだ。API全体の構造を表す単一の記述もなかった。</p>\n<p><strong>課題.</strong> 全面的な一括書き直しのために止まることなく、手書き検査の代わりに型から検証を生み、APIの構造を記述する仕様を得ることが目標だった。</p>\n<p><strong>行動.</strong> 既存ランタイムを保ち、Fiber上のHuma v2へHTTP層を移した。各エンドポイントに入力・出力構造体を設け、型からHumaが検証と応答モデルを生成する。OpenAPI記述も自動で得られ、wikiで古くなるのでなくコードに追随する。新規はすべてHumaで書き、既存も移行した。ただし、ソケット自体が必要でリクエスト・応答モデルに合わないWebSocketの2エンドポイントだけを、生のFiberに残した。規模は649パス・760操作となり、実際の登録ルートとOpenAPIが公表するルートをCIで比較する。未記述ルートがビルドを失敗させるため、一致率100%を維持する。</p>\n<p><strong>結果.</strong> 追加作業なしで新規エンドポイントに検証と最新文書が備わり、項目の検査忘れのようなリクエスト処理バグの一群がなくなった。760操作では、APIを読む実用的な手段は記述しかなく、完全性の保証は50操作だったころ以上に重要だった。型によって期待する入力を伝えるAPI仕様によって、安全に変更でき、人に引き継ぎやすいAPIとなった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "API・システム連携", "テスト・品質保証", "バックエンド開発", "プラットフォーム設計", "移行・モダナイゼーション", "文書作成", "AIエージェント用ツール・MCPサーバー", "バックエンド・API開発", "プラットフォーム・ソリューション設計", "技術文書の作成" ] }, { "id": "https://engineer.company/ja/portfolio/generated-the-api-contract-from-the-database-out/", "url": "https://engineer.company/ja/portfolio/generated-the-api-contract-from-the-database-out/", "title": "データベースを起点にAPI契約を生成", "summary": "データベースからOpenAPI、型付きTypeScriptクライアント、モックハンドラー、UI制限を生成し、各段階に検査を設けた。", "content_html": "<p><strong>状況.</strong> フロントエンドとバックエンドは別々の速度で進み、リクエストのペイロードへの想定が、気づかないうちに食い違うことがある。通常は、不一致を公開したあと、ブラウザーの422応答で初めてわかる。最も修正費用が高い時点だった。同じ文書から両側を手で書いても、文書を読み直し忘れた人へ不一致の発生場所が移るだけだった。</p>\n<p><strong>課題.</strong> 両側で合意するのでなく単一の情報源から生成し、生成の各段階を信頼任せにせず検証する必要があった。</p>\n<p><strong>行動.</strong> 生成の連鎖をデータベースから外へ伸ばした。スキーマと関数が構造を、Goの型がAPIを定義し、HumaがOpenAPIを出力する。その記述から44,076行の型付きTypeScriptクライアントを生成し、61個のモックハンドラーも生成した。フロントエンドのテストは手書きの固定データではなく実際のAPI仕様に従う。フォームが適用する制限も検証器へ再入力せず、同じ場所から取得する。各段階に検査を設けた。CIで送信内容とAPIの期待値を比較し、不一致でビルドを止め、その下には記述でなく実際の構造を調べるスキーマ検査を置いた。特に「未指定」と「null」を混同しやすい任意の本文項目と、許容値が静かにずれやすいクエリ引数の列挙値を対象とした。</p>\n<p><strong>結果.</strong> 片側だけの項目変更は、気づいた最初の段階で、変更後数分のビルド中に失敗する。レビューでは見えず、実行時にしか現れなかった反復的で厄介なバグを除去した。代償は途中の再生成作業であり、連鎖の信頼性は最も守りの弱い箇所までしかない。そのため、各段階に検査を設けた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "API・システム連携", "DevOps", "テスト・品質保証", "バックエンド開発", "自動化・CI/CD", "信頼性・バックアップ", "AIエージェント用ツール・MCPサーバー", "DevOps・CI/CD自動化", "バックエンド・API開発" ] }, { "id": "https://engineer.company/ja/portfolio/built-email-with-failover-and-delivery-logging/", "url": "https://engineer.company/ja/portfolio/built-email-with-failover-and-delivery-logging/", "title": "切り替えと配信ログを備えるメール機能を構築", "summary": "3プロバイダーのフェイルオーバー、配信Webhook、送信・配信ログ、テンプレート、キャンペーン一斉送信を備える共通メール機能を構築した。", "content_html": "<p><strong>状況.</strong> メールは、認証、通知、定期まとめ、キャンペーンなど、利用者が実際に待つ重要な役割を担っていた。プロバイダーは静かに失敗し得る依存先であり、設定が正しく見え、起動しても、約束した通知が届かなかった人によって初めて故障がわかる。それは最悪の発見方法だった。1社だけなら全面停止となり、修正も相手任せになる。</p>\n<p><strong>課題.</strong> メールを呼び出すライブラリではなく、プラットフォームが責任を持つ機能として扱い、供給元の障害に耐え、個々の通知の経緯を説明し、沈黙が危険な環境では起動時に明確に失敗させる必要があった。</p>\n<p><strong>行動.</strong> SendGridを主に、SMTP2GOとAzure Communication Servicesを控えとして、3社を共通インターフェースの背後に置き、緊急時の設定変更ではなく自動で切り替えた。到達を想定で済ませず、受信Webhookで処理結果を報告させ、送信ログと配信イベントテーブルの両方に記録した。認証メールが届いたかは推測でなく問い合わせで確認する。本文はテンプレートに分離し、トランザクションメールとは別の問題である一斉配信は、5テーブル・24関数の専用スキーマで利用者層ごとのキャンペーンを扱った。フラグ付きの起動検査は実際に1通送信する。開発では期限切れの実験用鍵で端末を起動不能にしないよう警告で続行し、ステージング・本番では送信不能の版を導入しないよう、失敗を致命的として終了する。送信はSSRF対策と30秒制限付きクライアントを通し、非同期配信は再試行とバックオフで一時的な失敗による欠落を防いだ。</p>\n<p><strong>結果.</strong> 静かな失敗の一群が「数日後に利用者が発見する」から「デプロイが止まる」へ移り、供給元の一時的な不調は全面停止でなく縮退した経路になった。1社ではなく3社の連携維持と、増える配信ログの削除が必要になったが、代わりのない連絡経路であるため受け入れた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "API・システム連携", "クラウド", "セキュリティ", "バックエンド開発", "信頼性・バックアップ", "サイト信頼性・監視", "セキュリティ・アクセス管理", "バックエンド・API開発" ] }, { "id": "https://engineer.company/ja/portfolio/implemented-a-catalogue-driven-deep-merge/", "url": "https://engineer.company/ja/portfolio/implemented-a-catalogue-driven-deep-merge/", "title": "カタログに基づくディープマージを実装", "summary": "保存済みJSON設定にカタログに基づくディープマージを実装し、スキーマの発展に伴うキー欠落のクラッシュを防いだ。", "content_html": "<p><strong>状況.</strong> 通知設定などのJSON設定を、既定値の上に利用者の保存値を重ねる形で保持していた。元のマージは1階層だけだった。既定値に新しいキーを加えると、それ以前の保存行にはキーがなく、クライアントがundefinedを読んで落ちる。長く使っている利用者ほど影響を受ける問題だった。</p>\n<p><strong>課題.</strong> 以前からの利用者に設定の追加で支障が出ないよう、安全にスキーマを拡張する必要があった。</p>\n<p><strong>行動.</strong> 単層のマージを、既定値をカタログにしたディープマージへ置き換えた。存在すべき全キーの正本として既定値を扱い、その上へ利用者の保存値を再帰的に重ねる。保存された塊にあってもなくても、カタログ内のキーは必ず結果に含まれる。既定値に追加すれば、入れ子も含め既存行すべての実効設定へ自動で現れる。再保存を待たず既存データも直ちに恩恵を受けるよう、マイグレーションで導入した。</p>\n<p><strong>結果.</strong> 安心して設定を増やせるようになった。新しい設定の追加が未定義項目によるクラッシュを招かず、フロントエンドで読み取り箇所ごとに防御的な検査を散らす必要もなくなった。1つの修正にとどまらず、保存済みJSON全般を拡張するための、頼れる方式を他の部分にも提供した。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "PostgreSQL", "データベース", "データガバナンス", "バックエンド開発", "移行・モダナイゼーション", "データベース設計・モデリング", "データガバナンス・品質管理", "バックエンド・API開発" ] }, { "id": "https://engineer.company/ja/portfolio/implemented-backups-and-disaster-recovery-as-code/", "url": "https://engineer.company/ja/portfolio/implemented-backups-and-disaster-recovery-as-code/", "title": "バックアップと災害復旧をコードで実装", "summary": "コードで管理するインフラ設定にデータベースのバックアップ保持期間を定義し、復旧状況を監査。復元手順と残る不足を文書化した。", "content_html": "<p><strong>状況.</strong> データに依存する製品で損失は許されず、「どこかにバックアップがある」は期待であって復旧計画ではなかった。価値があるのは、再構築できるとわかっている環境へ、復元できるとわかっているバックアップだけだが、製品ではその両方が未記録だった。</p>\n<p><strong>課題.</strong> データと周辺環境、現時点での実際の適用範囲を、想定でなく明示された復旧状況として定める必要があった。</p>\n<p><strong>行動.</strong> 保護対象DBと同じBicepで保持期間を設定し、特定時点復元を、誰かがポータルで一度設定した値でなくテンプレートの性質にした。周囲の環境もコードに定義した。環境を記憶で手動再構築しなければDBを戻せないのでは、本当の復旧とはいえない。その後、復元手順、測定するための訓練、残る不足を監査・記録した。地理冗長性は無効で、訓練をまだ実施していないため、目標復旧時間は実測でなく提案値であることを明示した。</p>\n<p><strong>結果.</strong> 復旧は曖昧な安心材料から、不足を名指しした記録へ変わった。「災害復旧完了」ほど華やかではなくても、次の担当者が対象内・対象外と、その差を埋める訓練を正確に理解できる点で、はるかに価値があった。明示した不足は塞げるが、不明な不足は障害時に発覚する。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "PostgreSQL", "インフラ", "データベース", "クラウド", "信頼性・バックアップ", "データベース管理(DBA)", "コードによるインフラ管理", "バックアップ・災害復旧" ] }, { "id": "https://engineer.company/ja/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/", "url": "https://engineer.company/ja/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/", "title": "Next.js 16でSSR・SSG・CSRの画面を構築", "summary": "SSR/SSG/CSRとサーバー側の事前取得・ハイドレーションでNext.js 16フロントエンドを構築し、移行済みページのN+1データ取得を除去した。", "content_html": "<p><strong>状況.</strong> 認証後のダッシュボードには速さと十分な対話性が必要だった。すべてをクライアントで取得すると初期表示が遅くなり、各コンポーネントが個別に要求を送るN+1によって、1ページが連続する通信往復に変わっていた。</p>\n<p><strong>課題.</strong> 必要なクライアント側の操作性を失わず、各部分に実際に適した描画方法を選ぶ必要があった。</p>\n<p><strong>行動.</strong> Next.js 16で、全体を一律にせず部分ごとに方式を選んだ。宣伝用・公開ページは利用者ごとに変わらないため静的生成とし、本当に対話的な部分はクライアント描画にした。N+1が問題となる認証後ダッシュボードと大きな一覧は、毎回手書きせず、createPrefetchedServerPageに共通化した。サーバーが取得し、データ入りでクライアントへ渡すので、各コンポーネントは取得要求を出さずに起動する。各データ要求にキャッシュ無効化の方針を記録し、すでにある情報を取り直さず鮮度を保った。</p>\n<p><strong>結果.</strong> 共通生成処理へ移したページは、多数の通信でなく1往復で表示され、次に移すページも手作業で方式を複製せず、その動作を引き継ぐ。他の認証後画面はまだクライアント描画で、今後の移行対象として残る。全面完了ではなく、機能する仕組みと明確な次の対象がある移行となった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Web開発", "プラットフォーム設計", "フルスタック開発", "フロントエンド開発", "性能改善", "Webサイト・CMS開発", "フルスタックのプロダクト開発" ] }, { "id": "https://engineer.company/ja/portfolio/delivered-full-progressive-web-app-support/", "url": "https://engineer.company/ja/portfolio/delivered-full-progressive-web-app-support/", "title": "Progressive Web Appに完全対応", "summary": "next-pwa経由のWorkboxランタイムキャッシュで、インストール可能かつオフライン対応のProgressive Web Appを実現した。", "content_html": "<p><strong>状況.</strong> 利用者の多くは海上にいた。船員や現場担当者は携帯端末を使い、しばしばオフラインか不安定な回線に接続していた。安定したオフィスWi‑Fiの机にいる人ではなかった。速く常時接続できる前提は、実際の利用者の多くを静かに排除してしまう。</p>\n<p><strong>課題.</strong> ネイティブアプリのようにインストールでき、回線が途切れても使える必要があった。</p>\n<p><strong>行動.</strong> 完全なProgressive Web Appとして提供した。各サイズの適切なアイコン、起動画面、テーマ色でホーム画面へ追加でき、単なるブックマークでなくアプリのように見え、起動する。next‑pwaでサービスワーカーを設定し、リクエストごとに変わらないフォント、画像、音声、動画、CDN素材に、適切なHTTPキャッシュヘッダーとともにWorkboxのCacheFirstを適用した。サービスワーカーが実質的にHTTPSを必要とするため、期待任せにせず、HTTPS環境で実機のオフライン・インストール挙動を検証した。</p>\n<p><strong>結果.</strong> インストールしてオフラインでも使え、再訪時には通信でなくキャッシュから速く読み込めるようになった。実際に携行する端末でネイティブアプリのように動くことは、この利用者層には付加的な利点ではなく、海上で使えるかどうかを分ける条件だった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Web開発", "フルスタック開発", "フロントエンド開発", "信頼性・バックアップ", "性能改善", "Webサイト・CMS開発" ] }, { "id": "https://engineer.company/ja/portfolio/hardened-the-application-with-nonce-based-csp/", "url": "https://engineer.company/ja/portfolio/hardened-the-application-with-nonce-based-csp/", "title": "nonce付きCSPでアプリケーションを堅牢化", "summary": "nonce付きCSP、HSTS、SameSite Cookie、最小権限のDBロール、サーバーでの利用権限再検証でアプリを堅牢化した。", "content_html": "<p><strong>状況.</strong> 専門家と組織の情報を扱う以上、適切な取り扱いが期待され、防御線1つでは不十分だった。ブラウザー側の制限は操作者が解除できるという、クライアントを敵対的とみなす前提で、それでも安全性を保つ必要があった。</p>\n<p><strong>課題.</strong> 画面が何を許すかとは独立してサーバーが制御できるよう、フロントエンド、API、DBの各層を堅牢化する必要があった。</p>\n<p><strong>行動.</strong> Next.jsのproxy.tsで、要求ごとのnonceとstrict‑dynamicを持つCSP、HSTS、SameSite Cookieを設定し、ブラウザーの実行と送信を制限した。APIにはレート制限、CORS、サイズ上限、DBへ渡す前の入力検証、セキュリティ関連イベントのログを設けた。DBにはアプリ関数のEXECUTEのみを持つ最小権限ロールで接続し、関数はSECURITY DEFINERとし、すべてパラメーター化した。利用プラン、ロール、組織、船舶範囲の権限を毎回サーバーで再検証し、画面の制限はUXとしてのみ扱った。何が見えるかは画面、何を実行できるかはサーバーが決める。</p>\n<p><strong>結果.</strong> UIが想定どおり動くことに安全性が依存しなくなった。単一の制御に依存しないよう、防御を多層化した。サーバー側の認可はクライアント側の検証から独立して機能するよう設計し、画面をアクセス判断の根拠にしない構成とした。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "API・システム連携", "データベース", "セキュリティ", "バックエンド開発", "プラットフォーム設計", "フロントエンド開発", "セキュリティ・アクセス管理", "バックエンド・API開発" ] }, { "id": "https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/", "url": "https://engineer.company/ja/portfolio/built-an-english-danish-i18n-system/", "title": "英語・デンマーク語のi18nシステムを構築", "summary": "458ファイルに言語ごと12,027メッセージを持つ英語・デンマーク語i18n基盤を構築し、用語とサイズ上限を静的検査で適用した。", "content_html": "<p><strong>状況.</strong> 英語とデンマーク語で動く基盤の翻訳管理は、無秩序になりやすかった。ファイルが際限なく増え、片方にしかキーがなくなり、言語固有の慣行がばらつくと、互いに話していない委員会が訳したような文章になる。専門的な製品では、単なる小さな欠点でなく、不注意と読まれる。</p>\n<p><strong>課題.</strong> 両言語の一貫性と正確さを保ち、1年後にも人が保守できるファイルとして、国際化の仕組みを拡張可能にする必要があった。</p>\n<p><strong>行動.</strong> next‑intlを基盤に、ツールで実際に守る規則を設けた。デンマーク語はæøåの字形、くだけたdu、命令形の正しいアクセント、複合名詞の語ごとでなく意味による訳を含む語彙・文体を固定し、静的検査した。名前空間の各ファイルを最大400行に制限し、分割した入れ子ファイルをきちんと再統合する方式とした。言語ごとの12,027件を巨大な少数ファイルでなく458ファイルへ分けたのは、この上限のためだった。キーを言語間で比較し、漏れを防いだ。保存済み上書き値は、脆い最上位のフォールバックでなく、設定と同じカタログ中心のディープマージで統合した。</p>\n<p><strong>結果.</strong> 計24,054メッセージでも両言語が正確で一貫し、増加しても保守可能になった。ツールは、各コミットで文書化された語彙・文体・カタログの規則を適用する。各翻訳の意味や自然さの評価には、引き続き文脈に沿った読み直しが必要である。1ファイルの上限こそ要であり、なければ458ファイルが12ファイルになり、誰も開かなくなっていた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "フルスタック開発", "フロントエンド開発", "国際化", "自動化・CI/CD", "文書作成", "国際化・ローカライズ" ] }, { "id": "https://engineer.company/ja/portfolio/set-a-zero-warnings-bar-across-six-languages/", "url": "https://engineer.company/ja/portfolio/set-a-zero-warnings-bar-across-six-languages/", "title": "6言語に警告ゼロの基準を設定", "summary": "Go、TypeScript、SQL、Python、Shell、Markdownの警告ゼロ基準を設け、pre-commitフックで守った。", "content_html": "<p><strong>状況.</strong> 積み重なる警告は徐々に基準を損なう。指摘を無視するたび少しずつ基準が下がり、ビルドが40件出すようになると誰も読まず、本当の問題も背景の雑音の中に埋もれる。多言語コードでは、その雑音の発生源がさらに多かった。</p>\n<p><strong>課題.</strong> 各言語に共通する妥協のない基準を設け、問題を蓄積せず直す必要があった。</p>\n<p><strong>行動.</strong> 忙しい週には個人の注意に頼る方針は破れるため、ツールが適用する警告ゼロ方針を導入した。全指摘をエラーとし、逃げ込める警告区分を置かなかった。Goはgolangci‑lint、TypeScriptはESLint、SQLはSQLFluff、PythonはRuff、ShellはShellCheck、Markdownはmarkdownlintで、全体に同じ基準を設けた。行内抑制を禁じ、隠すのでなく修正を必須にした。pre‑commit・pre‑pushで静的検査とテストを実行し、対象の規則やテストで失敗した場合は、それぞれコミットまたはpushを止めるようにした。読みやすさを超えて膨張しないよう、関数・ファイル長の制限も設けた。</p>\n<p><strong>結果.</strong> 未消化の課題へ先送りせず発生源で修正し、ときどきの大掃除でなく、通常状態としてコードを整えた。言語によらず同じ基準を、意志力でなくツールが守るため、実際に維持できた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "テスト・品質保証", "技術面の統率", "自動化・CI/CD", "文書作成", "DevOps・CI/CD自動化", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/", "url": "https://engineer.company/ja/portfolio/set-the-platforms-founding-technical-decisions/", "title": "プラットフォームの基礎技術方針を策定", "summary": "2025年11月に多層構成、データベース中心のアクセス、警告ゼロという基礎方針を定め、現在まで維持した。", "content_html": "<p><strong>状況.</strong> リポジトリは2025年11月25日、空の状態で始まった。層の分け方、業務ロジックの置き場、品質基準など、最初の数週間の判断が大きく影響する。3日目には安い判断も、6か月目には後続のすべてが前提にしていて、覆すのがほぼ不可能になる。</p>\n<p><strong>課題.</strong> 他の人や当時よりはるかに大きなコードへ引き継いでも残る形で、基礎方針を早期に、意図的に決める必要があった。</p>\n<p><strong>行動.</strong> 3つの判断が大半を支えた。まず、その日の便利さでロジックを置かず、Next.js画面、検証・転送のGo API、業務ルールを持つPostgreSQL関数の各層に1つずつ役割を与えた。次に、後付けなら全ハンドラーを書き直すことになるため、最初からデータアクセスをストアド関数の背後に置いた。最後に、5,000コミット目なら大規模な修正作業を要する基準も、50コミット目なら通常の進め方になるため、コードが少ないうちから警告ゼロを適用した。どれも当時の簡単な選択ではなく、最初の月の進行速度を犠牲にした。</p>\n<p><strong>結果.</strong> 9か月、数千コミット後にも3つすべてが残った。層は曖昧にならず、ハンドラーはテーブルを直接扱わず、ビルドに警告はない。基礎判断は正しく聞こえたかでなく、その後の作業量に耐えたかで評価すべきだった。便利さだけの選択は、その時点で静かに捨てられることが多いためだった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "チームの統率", "データベース", "セキュリティ", "ソリューション設計", "バックエンド開発", "プラットフォーム設計", "フルスタック開発", "フロントエンド開発", "技術面の統率", "バックエンド・API開発", "プラットフォーム・ソリューション設計", "フルスタックのプロダクト開発", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/built-the-entire-core-infrastructure-from-scratch/", "url": "https://engineer.company/ja/portfolio/built-the-entire-core-infrastructure-from-scratch/", "title": "基幹インフラ全体を一から構築", "summary": "初期に採用された社員の1人として、グリーンエネルギーSaaSスタートアップの基幹インフラ全体を一から設計・構築し、急成長を可能にした。", "content_html": "<p><strong>状況.</strong> 有望な構想はあるが技術基盤がほぼない、グリーンエネルギーSaaSスタートアップだった。初期採用者の1人として加わることは、まだ何も存在せず保守するものもない段階で、全員が乗る土台を築くことを意味した。</p>\n<p><strong>課題.</strong> 基幹インフラと、その周辺の工程を一からつくることが仕事だった。</p>\n<p><strong>行動.</strong> サーバー、ネットワーク、データの流れ、セキュリティ、運用面を含む、基幹インフラ全体と支援工程を設計・構築した。後から覆しにくい判断をするため、単に動かすのではなく、会社が大きくなった途端に取り替えずに済む、急成長の重さを支える土台を目指した。初期の選択は、拡大を可能にするものにも、1年かけて取り消すものにもなるため、明確に前者を狙った。</p>\n<p><strong>結果.</strong> 堅実な技術基盤を得て、その後の急成長が可能になった。何もないところから土台を築く責任は、正しければ誰も気づかず、誤れば全員が気づく種類のものだったが、この基盤は持ちこたえた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "インフラ", "クラウド", "システム管理", "セキュリティ", "ソリューション設計", "プラットフォーム設計", "DevOps・CI/CD自動化", "クラウドインフラ・移行", "プラットフォーム・ソリューション設計" ] }, { "id": "https://engineer.company/ja/portfolio/maintained-a-legacy-hugo-site-and-improved-its-ui/", "url": "https://engineer.company/ja/portfolio/maintained-a-legacy-hugo-site-and-improved-its-ui/", "title": "Hugoサイトを保守し製品のUIを改善", "summary": "Hugoで構築された従来の静的ウェブサイトの保守と改善を行った。それと並行して、主力の資産管理製品のUI/UXを洗練させる改善にも貢献した。", "content_html": "<p><strong>状況.</strong> 主力の資産管理製品と並行して、静的サイト生成器Hugoの既存Webサイトが動いていた。サイトは従来からの確立したもの、実際の主要な価値は製品側にあった。</p>\n<p><strong>課題.</strong> サイトを健全に保つとともに、製品の利用体験も改善することが担当範囲だった。</p>\n<p><strong>行動.</strong> Hugoサイトを最新で機能する状態に保ち、保守・改善しながら、主力製品にもUI/UX改善と意見を反映した。新しいものへ集中する間も古いものを劣化させないよう注意を分けた。どちらも誰かに会社を示す接点であり、両方を適切な状態に保つ必要があった。</p>\n<p><strong>結果.</strong> サイトは静かに古びず最新に保たれ、主力製品は継続的で実情に即した改善で使いやすくなった。一度の大改装ではなく、実際に使い、考えることから生まれる改善だった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "UX・UI設計", "Web開発", "フルスタック開発", "フロントエンド開発", "UI/UX設計・デザインシステム", "Webサイト・CMS開発" ] }, { "id": "https://engineer.company/ja/portfolio/integrated-a-company-wide-password-manager/", "url": "https://engineer.company/ja/portfolio/integrated-a-company-wide-password-manager/", "title": "全社共通のパスワード管理を導入", "summary": "会社全体で利用するパスワード管理システムを統合した。組織全体のセキュリティを強化するとともに、アクセス制御の運用を効率化した。", "content_html": "<p><strong>状況.</strong> 認証情報の保存・共有が、人ごとにその場しのぎの方法で行われていた。この不一致自体が危険だった。派手な侵害というより、チャット内のパスワード、更新されない共有ログインなど、小さな露出が積み重なるものだった。</p>\n<p><strong>課題.</strong> 認証情報を集約し、安全にすることが課題だった。</p>\n<p><strong>行動.</strong> 全社共通のパスワード管理を導入し、個人の習慣ではなく、一貫して安全に保存・共有する方法を整えた。全社共通とは、人ごとに任意ではないことに価値があった。半数しか使わなければ、残り半数に危険が残るため効果は限られる。安全な方法を、どこでも通常の方法にすることを重視した。</p>\n<p><strong>結果.</strong> 認証情報の保存と共有を、共通のアクセス制御の下へ集約した。その場しのぎの取り扱いを減らし、組織全体でアクセス規則を統一しやすくした。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "インフラ", "システム管理", "セキュリティ", "自動化・CI/CD", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/combined-web-development-with-seo-and-content/", "url": "https://engineer.company/ja/portfolio/combined-web-development-with-seo-and-content/", "title": "Web開発にSEOとコンテンツを統合", "summary": "独自のWeb開発・デザインにSEO、コンテンツ戦略、コピーライティングを組み合わせ、顧客の成果を支えた。", "content_html": "<p><strong>状況.</strong> 顧客が本当に欲しいのはWebサイトそのものではなく、見つけてもらい、顧客を呼び、実際の経路として働く成果だった。誰にも見つからない美しいサイトは、成功に見える失敗だった。</p>\n<p><strong>課題.</strong> サイトを引き渡して幸運を祈るのでなく、構築と成長の両方を1つの提供内容にすることが課題だった。</p>\n<p><strong>行動.</strong> 独自のWeb開発・設計と、SEO、コンテンツ戦略、コピーライティングを合わせ、良い実装と見つけやすさを両立した。通常これらを別仕事にするため、美しいが検索されないサイトや、最適化されても使いにくいサイトが生まれる。両方を担い、後付けの検索対策でなく、最初から見つかることを前提に設計した。</p>\n<p><strong>結果.</strong> 顧客の認知度とエンゲージメントが高まり、サイトはオンラインのパンフレットではなく成長経路として機能した。構築と発見可能性を一度に扱ったことが、単なる費用から、対価に見合う成果を生むものへ変えた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "UX・UI設計", "Web開発", "ブランド・マーケティング", "プロダクト・要件", "フロントエンド開発", "UI/UX設計・デザインシステム", "Webサイト・CMS開発", "ブランド・マーケティング・SEO" ] }, { "id": "https://engineer.company/ja/portfolio/built-a-test-suite-across-go-sql-and-browser/", "url": "https://engineer.company/ja/portfolio/built-a-test-suite-across-go-sql-and-browser/", "title": "Go・SQL・ブラウザーのテスト群を構築", "summary": "981件のGoテスト、543件のフロントエンドテスト、494件のSQL動作テストに、ミューテーション・プロパティ・アクセシビリティのゲートを加えた。", "content_html": "<p><strong>状況.</strong> 業務ロジックをDBに置く基盤には、多くのプロジェクトとは違うテストの難しさがあった。ロジックはテスト基盤が得意な言語でなく、関数境界の内側のSQLにあり、扱いにくいため未テストになりやすかった。その上へGo APIとNext.jsを載せると、「重要部分を検査した」が、気づかないうちに「簡単に検査できる部分を検査した」に変わる。</p>\n<p><strong>課題.</strong> すべてをブラウザーから外側経由で調べるのでなく、各層の動作を、実際にその動作がある場所で検証する必要があった。</p>\n<p><strong>行動.</strong> 4層に4種類のテストを設けた。Go APIは310ファイルに981テスト関数、画面には543件のVitest・Playwrightテストがあり、48のE2Eファイルと30件のブラウザーテストを含む。DBには494動作テストファイル、116,876行のSQL、6,654件の例外による検証を置き、ストアド関数を上の3層経由でなくDB内で試す。その上に、意図的に行を壊して未検知なら失敗するStrykerのミューテーションテストと、人が考えなかった入力を生むfast‑checkを加えた。axe‑coreでWCAG 2.0・2.1のA・AA違反を0件とし、アクセシビリティを数か月後の監査指摘でなくビルド失敗にした。カバレッジ下限は引き上げのみ許す。全体を612行のワークフロー内の10ジョブで実行する。</p>\n<p><strong>結果.</strong> 構造変更を恐れずに済むようになり、この規模のコードが硬直するのを防いだ。率直な代償は時間である。テスト群は遅く、毎回の変更に負担がかかり、自体の保守も必要になる。その数分以上に価値がある、速く動き続ける能力を得た。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "PostgreSQL", "テスト・品質保証", "バックエンド開発", "フロントエンド開発", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "バックエンド・API開発", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/", "url": "https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/", "title": "268検査を持つリポジトリの検査基盤を構築", "summary": "268件のコミット検査、277件の静的検査ルール、15件の独自ESLintルールと、検査自体の146テストを持つ検査基盤を構築した。", "content_html": "<p><strong>状況.</strong> 参加ガイドに書いただけの基準は提案にとどまる。全員が同意しても、金曜の小さな変更ではガイドが負ける。警告ゼロは善意以外の何かが支えなければ続かず、言語標準の静的検査だけでは、このコード特有の動かし方という重要な規則まで届かなかった。</p>\n<p><strong>課題.</strong> 時間と記憶のあるレビュー担当者を待たず、違反がコミットを失敗させるよう、大切な規則を実行可能にする必要があった。</p>\n<p><strong>行動.</strong> 検査基盤を構築した。274本の検査スクリプト中268本をコミットフックへ登録し、277本のJavaScript検査、96本のShell、17本のPython検証を組み合わせた。マイグレーションを戻せるか、翻訳キーが両言語にあるか、登録ルートがOpenAPIにあるか、行内抑制が追加されていないかなど、汎用ツールの対象外を扱う。独自ESLintルール15個でTypeScriptの社内方式を守る。fix:で始まるコミットには、その修正なしで失敗するテストを必須とし、その不具合に対する実行可能な回帰テストを用意した。壊れた検査はすべてを通して誰も気づかず、検査がないより悪いため、検査自体にも146テストを設けた。</p>\n<p><strong>結果.</strong> ブランチのプッシュ前に、自動検査が組み込まれた定型的な規則を確認するため、レビュー担当者は設計により多くの時間を割けるようになった。実際のトレードオフとして、コミットは遅く、出来の悪い検査は対応に強い苛立ちを生む。そうした経験があったため、146テストを設けた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "テスト・品質保証", "技術面の統率", "自動化・CI/CD", "文書作成", "DevOps・CI/CD自動化", "技術文書の作成", "技術面の統率・コンサルティング", "専用AIエージェント開発" ] }, { "id": "https://engineer.company/ja/portfolio/moved-slow-work-onto-a-river-job-queue/", "url": "https://engineer.company/ja/portfolio/moved-slow-work-onto-a-river-job-queue/", "title": "遅い処理をRiverジョブキューへ移行", "summary": "遅い処理をRiverキューへ移し、15ワーカーモジュール、8定期タスク、20件のpg_cron保守ジョブでリクエスト経路を軽くした。", "content_html": "<p><strong>状況.</strong> メール、検索インデックス再構築、文書生成、順位再計算などは、利用者を待たせながら行うべき仕事ではなかった。リクエスト内では求めていない処理の待機表示を見せ、goroutineなら、デプロイ中の再起動で、実行予定だった記録もなく消えてしまう。</p>\n<p><strong>課題.</strong> 再起動に耐え、失敗を再試行し、未実行を確認できる、永続的なバックグラウンド処理の置き場が必要だった。</p>\n<p><strong>行動.</strong> 主にPostgreSQL内にキューを持つことからRiverを選んだ。DBはすでに記録の正本なので、ジョブと対象行を一緒にコミット・ロールバックでき、別の基盤を運用して理解する必要がない。15のワーカーモジュールと8定期タスクを設けた。その下では20個のpg_cronジョブが、パーティション削除、ソルト更新、集約更新など、DB自身に適した保守を担う。気になるほど遅い作業を、このどちらかへ移した。</p>\n<p><strong>結果.</strong> リクエストは早く返り、遅い作業も完了し、未完了なら再試行と履歴が残る。専用ブローカーでなくPostgresに置くのは意図的な限界であり、無限には伸びず、一定量では不適切になる。いずれにせよDBが制約となる基盤では、使わない余力より可動部分を1つ減らすことに価値を置いた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "PostgreSQL", "データベース", "バックエンド開発", "自動化・CI/CD", "信頼性・バックアップ", "性能改善", "AIエージェント用ツール・MCPサーバー", "データベース設計・モデリング", "サイト信頼性・監視", "バックエンド・API開発" ] }, { "id": "https://engineer.company/ja/portfolio/built-fail-closed-rate-limiting-and-anti-abuse/", "url": "https://engineer.company/ja/portfolio/built-fail-closed-rate-limiting-and-anti-abuse/", "title": "異常時拒否のレート制限・不正利用対策を構築", "summary": "Redisによる22レートリミッター、Cloudflare Turnstile、リクエストの冪等性、オリジン制限を備える、異常時拒否の不正利用対策を構築した。", "content_html": "<p><strong>状況.</strong> 企業と専門家の公開一覧は、公開初日から標的になる。スクレイパーはデータを、迷惑アカウントは到達範囲を求め、検索、出力、外部APIなど実費がかかる機能も、無料で呼べるだけで悪用価値がある。特定の基盤への悪意でなく、公開インターネットの通常の環境だった。</p>\n<p><strong>課題.</strong> 制限自身の依存先が落ちる圧力も含め、負荷のもとで保てる制限を、費用や悪用可能性の高い経路に設ける必要があった。</p>\n<p><strong>行動.</strong> 全体に単一上限を置かず、守る経路ごとに22個の制限を設けた。ログイン、検索、大量出力では悪用となる頻度が大きく違う。状態はRedisに置き、プロセスごとで簡単に回避されずインスタンス間で共有する。Redisが不在なら、通すのでなく拒否する方を選んだ。不便でも正当化できる唯一の選択だった。周辺に、追加検証が必要な経路へのCloudflare Turnstile、再試行した書き込みを重複させない351行の冪等性middleware、正規入口を通らない要求を拒否するオリジン制限、一覧専用の独自チャレンジ検証を設けた。</p>\n<p><strong>結果.</strong> 悪用者の費用を高く、基盤の費用を低くし、制限の保存先の障害は無制限開放でなく拒否へ縮退する。Redis問題が利用者に見える問題になることは、請求額の問題になるよりよいとして意図的に受け入れた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "API・システム連携", "セキュリティ", "ネットワーク・VPN", "バックエンド開発", "信頼性・バックアップ", "性能改善", "AIエージェントのセキュリティ", "サイト信頼性・監視", "セキュリティ・アクセス管理", "バックエンド・API開発" ] }, { "id": "https://engineer.company/ja/portfolio/built-first-party-analytics-inside-postgresql/", "url": "https://engineer.company/ja/portfolio/built-first-party-analytics-inside-postgresql/", "title": "PostgreSQL内に独自の分析機能を構築", "summary": "古いパーティションを自動削除するテーブルと47関数で、PostgreSQL内の独自製品分析を構築。仮名化と同意に基づく実行を適用した。", "content_html": "<p><strong>状況.</strong> 製品の意思決定には数値が必要で、通常は各ページに第三者のタグを置き、他社のサーバーに利用者を観察させる。少量なら速く無料でも、専門家の交流基盤で誰がどの企業を見て何を検索したかが、広告会社の資産になる。身元を特定できる海事専門家が利用する製品には、不適切な交換条件だった。</p>\n<p><strong>課題.</strong> 製品チームには、プラットフォームが責任を持て、利用者が拒否できる方法で収集する、ファネル、継続利用、イベントのデータが必要だった。</p>\n<p><strong>行動.</strong> 7テーブル・47関数のPostgreSQLスキーマへ分析を実装した。イベントテーブルは22のパーティション定義で分割し、自社分析の費用は収集より永久保存にあるため、定期的に自動削除する。定期変更するソルトで仮名化し、DB内部からでも変更前後を同一人物として追えなくした。これは答えられる問いへの意図的な上限だった。クライアントは送信後に除外せず、同意前には何も送らない。コンバージョンファネルは外部へ出して結合し直さず、データのそばのDBで計算する。</p>\n<p><strong>結果.</strong> ページにタグを置かず、データを外へ出さず、自社テーブルから使われ方に答えられるようになった。限界も明確にした。ソルト変更で長期コホート分析を失い、外部サービスに付属するダッシュボードも得られない。両方を理解して受け入れた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "PostgreSQL", "SQL", "データベース", "データエンジニアリング", "データガバナンス", "データ分析", "性能改善", "データベース設計・モデリング", "データガバナンス・品質管理", "データパイプライン開発(ETL/ELT)", "データ分析・BIダッシュボード" ] }, { "id": "https://engineer.company/ja/portfolio/ran-a-continuous-security-scanning-programme/", "url": "https://engineer.company/ja/portfolio/ran-a-continuous-security-scanning-programme/", "title": "継続的なセキュリティ検査を運用", "summary": "コード検査、DAST、依存関係検査、SBOM、秘密情報検査、固定版Actionsを用いる継続的なセキュリティ活動と、21件の監査を実施した。", "content_html": "<p><strong>状況.</strong> CSP、最小権限DBロール、利用権限再検証などは実行時を守るが、配布物については何も示さない。先週判明した依存先の脆弱性、コミット後に取り消された認証情報、タグ固定の外部Actionが別コードに変わった可能性は、別の問題だった。</p>\n<p><strong>課題.</strong> サプライチェーンとコードの安全性を、意見でなくビルド結果として示せるよう、継続的に自動検査する必要があった。</p>\n<p><strong>行動.</strong> CodeQLで静的分析、ZAPで稼働環境への動的試験、govulncheckでGo依存先を検査した。毎ビルドでAnchore・SyftのSBOMを生成し、後で推定せず配布内容を把握する。Gitleaksで履歴内の認証情報を探し、第三者GitHub Actionは移動可能なタグでなくコミットハッシュへ固定した。Dependabotは6つのエコシステムを監視する。自動化と並行して、脅威モデルとOWASP試験ガイドに基づく評価を含む21件の監査を文書化した。検査器は既知の問題を探すもので、この基盤特有の問題は脅威モデルで名指しする必要があるためだった。</p>\n<p><strong>結果.</strong> 設定した検査が認識した脆弱性によって、ビルドを失敗させられるようになった。実際の費用は指摘量である。何でも報告する検査器は無視を学習させるため、有用な情報を保つには一度の設定ではなく、継続的な選別が必要だった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "セキュリティ", "自動化・CI/CD", "信頼性・バックアップ", "文書作成", "AIエージェントのセキュリティ", "DevOps・CI/CD自動化", "セキュリティ・アクセス管理", "技術文書の作成" ] }, { "id": "https://engineer.company/ja/portfolio/servers-you-can-rebuild-from-scratch/", "url": "https://engineer.company/ja/portfolio/servers-you-can-rebuild-from-scratch/", "title": "リポジトリで定義するインフラ", "summary": "リポジトリには宣言した環境の再構築に使う設定があり、誰かが覚えていたから成立していた部分が、失敗する検証へ変わった。サーバーのファイルを直接編集するより毎変更は遅く、途中まで適用される実行は最初から拒否するより悪いという、実際の費用もあった。そのため後に事前検査を置いた。意図的な交換条件として選び、維持した。", "content_html": "<p><strong>状況.</strong> Engineer ApSは自社インフラをコードとして管理している。リポジトリは稼働中の公開サービスと、バックアップ・メール自動化を含むその他の構成を扱うが、それらを運用開始することは別の段階である。この範囲をコードに残すことで、記憶に依存せず調べられるようになる。</p>\n<p><strong>課題.</strong> 頭の中でなくリポジトリに全環境を記述し、ホストを説明するだけでなく、実際のホストを収束させる形式にする必要があった。</p>\n<p><strong>行動.</strong> 記録された実装は、12,065行のYAMLにわたる19のプレイブックと34のロールからなる。これらの数値は記録時点の段階を示し、現在のリポジトリ規模ではない。大きさ以上に構造が重要だった。構成はフラグでなくデータとし、ホストのtier group変数が実行ロールを宣言するため、引数なしの構築でも全ホストを宣言状態へ収束させる。冪等性を願望でなく契約とし、収束済みなら変更0件、そう言えないプレイは未完了とした。4つのコマンド名前空間で、ホストへ触れない品質ゲート、読むだけのレポート、宣言に合わせて変更する構築、意図して変更し判定する検証の責務を分けた。</p>\n<p><strong>結果.</strong> リポジトリには宣言した環境の再構築に使う設定があり、誰かが覚えていたから成立していた部分が、失敗する検証へ変わった。サーバーのファイルを直接編集するより毎変更は遅く、途中まで適用される実行は最初から拒否するより悪いという、実際の費用もあった。そのため後に事前検査を置いた。意図的な交換条件として選び、維持した。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "Linux・サーバー", "インフラ", "システム管理", "プラットフォーム設計", "自動化・CI/CD", "信頼性・バックアップ", "文書作成", "DevOps・CI/CD自動化", "コードによるインフラ管理", "クラウドインフラ・移行" ] }, { "id": "https://engineer.company/ja/portfolio/three-locks-on-the-door-none-of-them-locked/", "url": "https://engineer.company/ja/portfolio/three-locks-on-the-door-none-of-them-locked/", "title": "3つあったが、どれも機能していなかった防御", "summary": "一度も働いていなかった3対策が動くようになり、故障しても正常報告を続ける類の不具合を、基盤の検査が捉えるようになった。3つとも起動初日から無効なのに、見ていた場所ではすべて正常だった。それこそが長く残った理由だった。", "content_html": "<p><strong>状況.</strong> 2026年8月の本番堅牢化レビューで、通常は自信を持って答える「SSH総当たり攻撃対策は動くか」を問うた。3つとも設定され、見られていた全レポートに現れたが、構築当初からすべて無効だった。</p>\n<p><strong>課題.</strong> パケットに起こるはずのことを記す設定ではなく、カーネルが実際に行うことに対して安全策を検証する必要があった。</p>\n<p><strong>行動.</strong> 設定を読むだけなら3回誤答するため、実行中のシステムを読んだ。遮断jailは、初期堅牢化で1986へ移したSSHに対し22番を監視し、誰も待ち受けないポートを遮断していた。ファイアウォールの制限はさらに微妙で、上に先に一致する広い許可があった。先頭から最初の一致で決まるため、一覧には出ても制限は到達不能だった。3つ目は、必須でなく推奨依存のパケットフィルターバイナリを呼ぶアクションで、未導入ホストではjailが起動・集計・判断しても、遮断するときだけ失敗した。修正はいずれも小さかったが、重要なのは2つの規則だった。安全策にはコメントでなく検証を設け、ファイアウォールは存在でなく位置で確かめる。</p>\n<p><strong>結果.</strong> 一度も働いていなかった3対策が動くようになり、故障しても正常報告を続ける類の不具合を、基盤の検査が捉えるようになった。3つとも起動初日から無効なのに、見ていた場所ではすべて正常だった。それこそが長く残った理由だった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "システム管理", "セキュリティ", "ネットワーク・VPN", "監視・オブザーバビリティ", "AIエージェントのセキュリティ", "サイト信頼性・監視", "セキュリティ・アクセス管理", "ネットワーク・VPN構築" ] }, { "id": "https://engineer.company/ja/portfolio/hardened-ssh-to-24-validated-directives/", "url": "https://engineer.company/ja/portfolio/hardened-ssh-to-24-validated-directives/", "title": "SSHの24設定項目を検証・堅牢化", "summary": "SSHの状態はリポジトリの主張でなくデーモンの回答になった。その違いは仮説でなく、検査時点ですでに2項目あった。効果を見られない収束処理は安全策を検証しておらず、設定名の文字列検索は、書いたことしか証明しない。", "content_html": "<p><strong>状況.</strong> SSHは自社ホストへの唯一の対話的な入口で、何か月も正常終了してきた自動化ロールが設定していた。2026年9月のアクセスレポートがデーモン自身の実効設定を読み、毎回書き込んでいた設定と2項目が違うことを見つけた。</p>\n<p><strong>課題.</strong> 何か月も見えなかった差をなくすため、リポジトリの主張でなくデーモンが確認する堅牢化にする必要があった。</p>\n<p><strong>行動.</strong> 原因は順序だった。OSはドロップインより先にコメント解除済みの既定値を置き、該当2項目は先勝ちだった。OS提供元のファイルより前に並ぶ接頭辞へ変える修正は、1文字規模であり、誰も見ようとしないため壊れたままになりやすい変更だった。周辺に毎回3段階の検証を構築した。導入前の候補ファイルを構文検査して不正設定を渡さず、導入後は統合済み設定を確認し、最後にデーモンの実効値を読み戻して24項目を検証する。書いても上書きされれば失敗する。デーモンが実装しなくなった2項目は、書くだけでは念入りに見えるだけなので意図的に除外した。</p>\n<p><strong>結果.</strong> SSHの状態はリポジトリの主張でなくデーモンの回答になった。その違いは仮説でなく、検査時点ですでに2項目あった。効果を見られない収束処理は安全策を検証しておらず、設定名の文字列検索は、書いたことしか証明しない。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "システム管理", "セキュリティ", "テスト・品質保証", "自動化・CI/CD", "コードによるインフラ管理", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/built-dead-mans-switch-host-monitoring/", "url": "https://engineer.company/ja/portfolio/built-dead-mans-switch-host-monitoring/", "title": "デッドマンズスイッチによるホスト監視を構築", "summary": "期待した信号が届かなければ警報を出す仕組みを設け、誤解を招く変数名も修正した。信号の受信は、スクリプトが動作し、利用可能メモリーと空きディスク容量が設定した閾値の条件を満たしたことを確認する。ホスト全体の健全性や、サイトが配信できていることを証明するものではない。", "content_html": "<p><strong>状況.</strong> gitフォージとウェブサーバーを動かす464 MBのホストにとって、メモリー不足とディスク容量不足は重要な2つの障害リスクだった。監視によって兆候を捉えられるが、その時期は負荷や観測する条件によって異なる。</p>\n<p><strong>課題.</strong> 故障の瞬間に送信する必要がある方式ではなく、ホストが動かないときに働く警報が必要だった。</p>\n<p><strong>行動.</strong> 時間を少し揺らした15分ごとのタイマーでデッドマンズスイッチを動かした。小さなスクリプトが利用可能メモリーと空きディスクを測り、両方が閾値以上のときだけ外部へ通知する。沈黙が警報になる。メモリー切れ、通信断、起動不能も不健康と同じ信号になることが正しく、状態を送るagentでなくこの形を選ぶ理由だった。測るのはfreeでなくavailableであり、ここが最も示唆に富んだ。スクリプトは正しい列を読んでいたが、周辺6変数の名がfreeだった。正常Linuxでも空きメモリーはキャッシュ利用でほぼ0に近いため、10%閾値と変数名を見た人が、464 MB中12 MBしか空いていないと誤解し、壊れていると判断して1文字直すと、正常な警報が常時違反となり、1週間で消音されかねなかった。</p>\n<p><strong>結果.</strong> 期待した信号が届かなければ警報を出す仕組みを設け、誤解を招く変数名も修正した。信号の受信は、スクリプトが動作し、利用可能メモリーと空きディスク容量が設定した閾値の条件を満たしたことを確認する。ホスト全体の健全性や、サイトが配信できていることを証明するものではない。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "監視・オブザーバビリティ", "自動化・CI/CD", "信頼性・バックアップ", "性能改善", "コードによるインフラ管理", "サイト信頼性・監視", "システム管理" ] }, { "id": "https://engineer.company/ja/portfolio/added-a-one-second-preflight-for-secrets/", "url": "https://engineer.company/ja/portfolio/added-a-one-second-preflight-for-secrets/", "title": "秘密情報の1秒の事前検査を追加", "summary": "解決できない秘密情報は、稼働サーバーへの部分的変更でなく、端末上の2秒の拒否で済む。事前検査に常時実行タグを付けず、直列化もしないことを意図的に選び、既定値として放置せず理由を記録した。", "content_html": "<p><strong>状況.</strong> ホストごとにバックアップ先、パスフレーズ、通知スイッチを持つよう秘密情報を分離した直後だった。コードは正しくても、担当者の暗号化vaultは旧来の単一ホスト値を保持していた。vaultは意図的に担当者の端末にだけあり、リポジトリの品質ゲートには見えず、不一致を検出できなかった。</p>\n<p><strong>課題.</strong> 高い代償を払って失敗したこの種の問題を、安く失敗させる場所が必要だった。</p>\n<p><strong>行動.</strong> 最初の実行は本番へ接続し、8タスクを行って9番目で正しく拒否したが、その時点でスワップ設定は書き込み済みだった。途中適用は最初の拒否より悪いため、ホストへ一切接続せず、factsも収集せず、実際の実行と同じ2つのタスクファイルをローカルvaultへ適用する事前検査プレイを作った。約1秒で答え、構築前に実行する。別実装の規則はいつか静かに食い違うため、同じコードであることが要だった。作成時には、プレイで設定したfactsが残るという新たな罠も見つけた。事前検査と本実行を1回でつなぐと、解決済みのパスフレーズが本ロールへ渡り、誤ったvaultでも検査を通る。その再現を確認してから、両タスクで防いだ。</p>\n<p><strong>結果.</strong> 解決できない秘密情報は、稼働サーバーへの部分的変更でなく、端末上の2秒の拒否で済む。事前検査に常時実行タグを付けず、直列化もしないことを意図的に選び、既定値として放置せず理由を記録した。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "インフラ", "セキュリティ", "テスト・品質保証", "自動化・CI/CD", "信頼性・バックアップ", "AIエージェントのセキュリティ", "DevOps・CI/CD自動化", "コードによるインフラ管理", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/cut-systemd-sandbox-exposure-on-every-unit/", "url": "https://engineer.company/ja/portfolio/cut-systemd-sandbox-exposure-on-every-unit/", "title": "全ユニットのsystemdサンドボックス露出を低減", "summary": "必要な権限だけで各ユニットが動き、数値は主張でなく実測となった。誤記で制御が静かに欠ける不具合が、実行失敗になった。測定の限界も隣に記録し、次の読み手が緑の表示を過信しないようにした。", "content_html": "<p><strong>状況.</strong> 13個のユニットが、本番で監督プロセスの既定の、ほぼ広範な権限で動いていた。デッドマンズスイッチは堅牢化評点9.6でunsafe、公開gitは8.3でexposedだった。正しい数値でも、閾値がなければ読み飛ばされ、行動につながっていなかった。</p>\n<p><strong>課題.</strong> 各ユニットの実務に合うサンドボックスと、その検証が必要だった。誤ると起動はしても構文検査に見えない実行箇所で壊れるためだった。</p>\n<p><strong>行動.</strong> 全テンプレートに、ユニット自身の権限を上限とする制限、システムコールフィルター、アドレス種別の制限、書き込みと実行を同時に許さないメモリーを設定した。実測でスイッチは9.6から1.5、gitは8.3から1.5、バックアップ2 ユニットは9.6から2.3と2.5になった。さらに、3テンプレートに以前から誤記された、もっともらしいが存在しない設定名を発見した。監督プロセスは不明キーをログに記して起動を続けていた。文字列検索は書いたことしか示さず、構文解析こそ適用を示すため、全導入ロールが呼ぶ検証ロールで、収束時に全ユニットを標準の検証器へ通した。ただし、これらを壊す設定は解析時でなく実行時に壊すため、スコアはスクリプトが最終行まで届くかを示さないという限界も記した。</p>\n<p><strong>結果.</strong> 必要な権限だけで各ユニットが動き、数値は主張でなく実測となった。誤記で制御が静かに欠ける不具合が、実行失敗になった。測定の限界も隣に記録し、次の読み手が緑の表示を過信しないようにした。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "コンテナ(Docker/Kubernetes)", "セキュリティ", "テスト・品質保証", "自動化・CI/CD", "コードによるインフラ管理", "コンテナ化・オーケストレーション", "システム管理", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/built-7-read-only-host-reporting-roles/", "url": "https://engineer.company/ja/portfolio/built-7-read-only-host-reporting-roles/", "title": "読み取り専用のホストレポートロールを7個構築", "summary": "必要に応じリポジトリから環境を説明でき、無効な安全策2件、未宣言ポート、最後に回収した時点までしかトラフィックの保管がないことを発見した。最後の限界には、回収の間にローテーションで失い、どこにも存在しない1サイトの16日分という具体的な損失も記した。", "content_html": "<p><strong>状況.</strong> 464 MBには指標収集基盤が収まらず、収まっても費用に見合わないため、ホストにダッシュボードを設ける予定はなかった。そのため、誰がアクセスできるか、リポジトリの増加量、トラフィック、堅牢化の実効性などに答える手段がないという不足があった。</p>\n<p><strong>課題.</strong> 必要時に答えを出し、尋ねていない間はホストに費用をかけず、説明する対象を決して変えない仕組みが必要だった。</p>\n<p><strong>行動.</strong> 7個の読み取り専用ロールで、稼働ホストをリポジトリ内のMarkdownへ描いた。factsはOS、ハード、保存領域、ネットワーク、サービス、パッケージ、待受ソケット、カーネルの2標本から計算したCPU使用を示す。アクセスはアカウント、sudo範囲、鍵指紋、git利用者、DBロール。gitはリポジトリ別、指標はその日の標本、トラフィックはプライバシー保護したWebログ。事業者一覧はDNS、2クラウドAPI、専用サーバーAPIの4面を扱う。セキュリティは設定ではなく効いているかを問い、一致順のファイアウォールと稼働遮断一覧を示す。全7種で、実測しない数値を出さないことを規則とした。もっともらしい数字で空白を埋めるほうが、空欄より信じられるため悪いからだった。</p>\n<p><strong>結果.</strong> 必要に応じリポジトリから環境を説明でき、無効な安全策2件、未宣言ポート、最後に回収した時点までしかトラフィックの保管がないことを発見した。最後の限界には、回収の間にローテーションで失い、どこにも存在しない1サイトの16日分という具体的な損失も記した。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "監視・オブザーバビリティ", "関係者との調整・報告", "自動化・CI/CD", "文書作成", "サイト信頼性・監視", "システム管理", "技術文書の作成" ] }, { "id": "https://engineer.company/ja/portfolio/ran-containers-on-podman-and-quadlet/", "url": "https://engineer.company/ja/portfolio/ran-containers-on-podman-and-quadlet/", "title": "PodmanとQuadletでコンテナを運用", "summary": "既存の信頼済み管理機構の下、宣言済みファイアウォールの背後で動き、通常のリリースはrootシェルを使わず、実行範囲を限定したコマンド1つで行う。次の人は読む記事すべてから標準を勧められるため、標準に逆らう選択以上に、その理由を記したことが重要だった。", "content_html": "<p><strong>状況.</strong> アプリ用コンテナの実行基盤が必要だった。業界標準の選択肢は、このホストでは不適切だった。カーネルのパケットフィルターを書き換え、堅牢化ロールのルールより前にポートを公開するため、ファイアウォールへ何を指示してもコンテナが静かに公開されるためだった。</p>\n<p><strong>課題.</strong> ファイアウォールを迂回せず、信頼済みの管理機構に加えて別の監督プロセスを置かず、rootにならずにリリースできる基盤が必要だった。</p>\n<p><strong>行動.</strong> デーモンを持たないコンテナエンジンと、OSの監督機構が生成するユニットを採用した。別の管理器はなく、コンテナも同じ宣言形式の通常サービスとして起動する。ポート公開なしのhost networkとし、迂回を軽減するのでなく問題自体をなくした。rootlessでなくsystem ユニットで動かす点は、強い分離と引き換えに自動化を簡単で標準的に保つ選択として記録し、脱出リスクが簡便さより重要になった場合の移行先も示した。構築とデプロイを分け、rootが一度経路を整えた後は、引数なしの固定スクリプト1つだけを許す限定ルールで非特権ユーザーが再導入する。イメージを作りサービスを再起動するだけで、root Shellも任意コマンドも与えない。</p>\n<p><strong>結果.</strong> 既存の信頼済み管理機構の下、宣言済みファイアウォールの背後で動き、通常のリリースはrootシェルを使わず、実行範囲を限定したコマンド1つで行う。次の人は読む記事すべてから標準を勧められるため、標準に逆らう選択以上に、その理由を記したことが重要だった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "Linux・サーバー", "インフラ", "コンテナ(Docker/Kubernetes)", "セキュリティ", "自動化・CI/CD", "DevOps・CI/CD自動化", "クラウドインフラ・移行", "コンテナ化・オーケストレーション", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/wrote-a-scope-rule-after-a-credential-leak/", "url": "https://engineer.company/ja/portfolio/wrote-a-scope-rule-after-a-credential-leak/", "title": "認証情報漏出後に対象範囲の規則を記述", "summary": "範囲の境界は判断基準付きの規則となり、残存物は埋もれず見え、漏れた具体的な形態はコミットを失敗させるようになった。一般的な教訓も記した。危険な成果物は実行するものより、誰も二度と読まない、実行しないものにある。", "content_html": "<p><strong>状況.</strong> 別会社の仕事がリポジトリの構成変更に伴って入り、残っていた。実際の平文認証情報を含む作業ログは、履歴の大半で全検査を通り抜け、古い資産一覧はその会社のホストを名指しし、ファイアウォールのタスクファイルには、16の顧客ネットワークへポートを開ける設定が残っていた。どれも実行されなかった。それこそ、再び読まれず残った理由だった。</p>\n<p><strong>課題.</strong> 境界を意図でなく検証付きの規則にし、残存物を単に隠さず扱う必要があった。</p>\n<p><strong>行動.</strong> 指示書冒頭に、1社のインフラだけを管理し、他社のホスト、資産、許可、DNS、認証情報は、無効・コメント・未読ファイルであっても置かないと記した。「関係が終わっても当社が責任を持つか」という実践的な判断基準も添えた。履歴を読めるよう削除せず明確な名の隔離ディレクトリへ移し、構造検査2つだけを対象外とした。混入物を見つけられる秘密情報検査、vault検査、絵文字検査の3つは読み続ける。標準が検知しなかった、コマンドラインフラグに認証情報を渡す漏出形態には、独自の検査パターンを設けた。</p>\n<p><strong>結果.</strong> 範囲の境界は判断基準付きの規則となり、残存物は埋もれず見え、漏れた具体的な形態はコミットを失敗させるようになった。一般的な教訓も記した。危険な成果物は実行するものより、誰も二度と読まない、実行しないものにある。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "インフラ", "データガバナンス", "セキュリティ", "自動化・CI/CD", "文書作成", "AIエージェントのセキュリティ", "データガバナンス・品質管理", "セキュリティ・アクセス管理", "技術文書の作成" ] }, { "id": "https://engineer.company/ja/portfolio/split-every-operational-secret-per-host/", "url": "https://engineer.company/ja/portfolio/split-every-operational-secret-per-host/", "title": "すべての運用秘密情報をホストごとに分離", "summary": "仕組み上ホストごとの秘密情報となり、共有による2つの故障形態を次の編集者が読む場所に残した。空欄は、接続の仕組みはあるが値がないという、キー欠落とは違う有用な情報であり、維持する意味があった。", "content_html": "<p><strong>状況.</strong> 1ホスト向けの基盤が2台になる直前で、バックアップ先、パスフレーズ、通知スイッチなどが単一値として書かれていた。そのまま共有するのが簡単でも、静かに失敗する2つの異なる問題があった。</p>\n<p><strong>課題.</strong> ホスト別マップに変えるとともに、共有版は問題の日まで正しく安く見えるため、その理由も書く必要があった。</p>\n<p><strong>行動.</strong> 2つの理由を設定のそばへ記した。2ホストが同じスイッチを使うと、片方の通知で他方の停止が隠れ、監視範囲は増えるどころか既存ホストについても減る。また、バックアップリポジトリの指定文字列が示すのは保存先であり、それだけで認証情報が独立しているとはいえない。同じパスフレーズを使っていても、別々のresticリポジトリは異なるマスターキーを持つ場合がある。しかし、そのパスフレーズを入手し、両方のリポジトリの暗号化データと鍵ファイルを読める者は、両方を復号できる。そのため、共有はホストごとの分離ではなく、両方の情報が漏れるリスクを結び付ける。各値をインベントリ hostname別のマップにし、収束・事前検査が共用するタスクで解決する。既存ホストを4 マップすべてへ登録し、保存先と2スイッチは空欄にした。それが実態であり、残る2施策の半分がコードでなく担当者の作業待ちであることを正直に示した。</p>\n<p><strong>結果.</strong> 仕組み上ホストごとの秘密情報となり、共有による2つの故障形態を次の編集者が読む場所に残した。空欄は、接続の仕組みはあるが値がないという、キー欠落とは違う有用な情報であり、維持する意味があった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "セキュリティ", "ソリューション設計", "自動化・CI/CD", "信頼性・バックアップ", "AIエージェントのセキュリティ", "コードによるインフラ管理", "サイト信頼性・監視", "セキュリティ・アクセス管理", "バックアップ・災害復旧" ] }, { "id": "https://engineer.company/ja/portfolio/built-a-multilingual-hugo-site-in-3-languages/", "url": "https://engineer.company/ja/portfolio/built-a-multilingual-hugo-site-in-3-languages/", "title": "3言語の多言語Hugoサイトを構築", "summary": "その段階では、1つのツリーから3言語・4形式を提供し、リクエスト時に動くアプリケーションのバックエンドや、別料金のアプリケーションサービスを必要としなかった。唯一のJavaScriptには、静的検査で適用する規約があった。その例外を除き、対話的な機能はビルド時に実現するか、追加を見送る必要があった。", "content_html": "<p><strong>状況.</strong> 3言語で動き、能力を主張でなく仕事で示し、運用費をかけず、訪問者を他社へ渡さない公開サイトが必要だった。個々は普通の要件でも、組み合わせれば、安全対策、更新、支払い、プライバシー説明が必要な実行時バックエンドを持つCMSの大半を除外する。</p>\n<p><strong>課題.</strong> すべてをビルド時に生成しながら、検索、インストール、配信、印刷、各言語での読み上げに対応する現代的なサイトが必要だった。</p>\n<p><strong>行動.</strong> 記録された設計段階では、53のパーシャルと18のショートコードを含む108テンプレート、3言語の静的サイトだった。実行時バックエンドはなく、実行まで全操作部を隠す実績フィルターだけに、範囲を限定した例外として自社スクリプト1つを認めていた。機能はブラウザーでなくビルド時に加えるという製品判断を記録していた。1つのコンテンツツリーから各ページをHTML、Markdown、Gemini、Gopherのメニュー項目という4形式で公開し、トップページには3フィードとインストール用マニフェストも付けていた。分類は意図して2種類にしていた。カテゴリーは仕事の話題、サービスは販売するものとし、混同して技能一覧になるのを防いだ。同じツリーを別のコンテンツディレクトリへ向け、コードを分岐させず、7つの専門サブドメインとして追加ビルドしていた。</p>\n<p><strong>結果.</strong> その段階では、1つのツリーから3言語・4形式を提供し、リクエスト時に動くアプリケーションのバックエンドや、別料金のアプリケーションサービスを必要としなかった。唯一のJavaScriptには、静的検査で適用する規約があった。その例外を除き、対話的な機能はビルド時に実現するか、追加を見送る必要があった。アプリケーションサーバーなら簡単だった複数の案を見送り、検索インデックスも費用を見積もって保留にした理由がそこにあった。これは記録された設計段階の説明であり、現在のサイトの構成や実装を示すものではない。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Web開発", "デザインシステム・UI", "フルスタック開発", "フロントエンド開発", "国際化", "性能改善", "AIエージェントへの対応", "Webサイト・CMS開発", "フルスタックのプロダクト開発", "国際化・ローカライズ" ] }, { "id": "https://engineer.company/ja/portfolio/a-safety-net-that-no-longer-costs-half-an-hour/", "url": "https://engineer.company/ja/portfolio/a-safety-net-that-no-longer-costs-half-an-hour/", "title": "30分も待たずに済む品質検査", "summary": "直列の総費用は増えたが、全体は1,636秒から615秒になり、検査範囲も広がった。もっともらしい全同時実行と記述順実行が、別案より実測で悪かったという測定こそ残す価値があった。", "content_html": "<p><strong>状況.</strong> ヘッドレスブラウザーを使う11検査が、各窓形状の配置、文字体系、訳文の伸長、コントラスト、アクセシビリティ、強制配色、マスコット寸法、動き、6用紙組み合わせの印刷、コンソール、視覚差分を調べていた。直列では1,636秒、27分超を要した。27分のゲートは省略され、省略した検査と合格した検査は区別できなかった。</p>\n<p><strong>課題.</strong> 何も弱めず、実行を決断ではなく通常の行為にできるほど、経過時間を短くする必要があった。</p>\n<p><strong>行動.</strong> 12コア端末で個別計測から始めた。配置405秒、文字301秒、翻訳282秒、コントラスト189秒、アクセシビリティ178秒から、最短17秒まであった。2つの発見で決めた。内部で並列処理するブラウザーを過剰に動かすため、全同時は265秒で4並列の224秒より遅かった。費用が20倍違うため、最長処理からの順は、名前順320秒に対し224秒と約3分の1改善した。コア数から決める2–4並列の上限付きプールへ、最長順で渡した。同時に検査を狭めず広げ、実際の全メディアクエリから導く22窓形状を共有した。そのため配置単体は95秒から405秒へ増えた。</p>\n<p><strong>結果.</strong> 直列の総費用は増えたが、全体は1,636秒から615秒になり、検査範囲も広がった。もっともらしい全同時実行と記述順実行が、別案より実測で悪かったという測定こそ残す価値があった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "Python", "テスト・品質保証", "フロントエンド開発", "自動化・CI/CD", "性能改善", "DevOps・CI/CD自動化", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/replaced-27-font-sizes-with-a-6-step-scale/", "url": "https://engineer.company/ja/portfolio/replaced-27-font-sizes-with-a-6-step-scale/", "title": "27種類の文字サイズを6段階の体系に統一", "summary": "27種類が6種類となり、比率と行長を明示して、次の未計画値を拒否した。制約は実際に不便な場合もあり、中間サイズが欲しければ既存段階へ移るか体系変更を提案する必要がある。その提案は、すでに何度も退けられた。", "content_html": "<p><strong>状況.</strong> 実際の描画を測ると文字サイズは27種類あった。1%未満の差もあり、本文比0.8–0.85の間に5値が同時存在した。読み手には区別できず、編集者は増やしてしまう。2見出しはCSS指定すらなく、他の比率と合わないブラウザー既定の1.33倍へ落ちていた。</p>\n<p><strong>課題.</strong> 明示した比率の体系へ整理し、28種類目を防ぐ必要があった。</p>\n<p><strong>行動.</strong> 比率1.25の長3度を採用し、小さな文字から大見出しまで6つの名前付きトークンにした。見出しを明示的に割り当て、未指定2件を直した。最下段だけ下限を設け、全体を固定せず携帯端末でも小さな文字を読めるようにした。ロゴは偶然でなく名前で除外する。描画して28種類目で失敗する検査が実効性を支えた。本文比1.17の見出しを検出して比率を示し、体系が防ぐべき0.9の行内コードも検出して、すでに2度役立った。継承した固定幅でレビューが91文字、連絡ページが110文字になっていた行長も、約72文字へ変えた。</p>\n<p><strong>結果.</strong> 27種類が6種類となり、比率と行長を明示して、次の未計画値を拒否した。制約は実際に不便な場合もあり、中間サイズが欲しければ既存段階へ移るか体系変更を提案する必要がある。その提案は、すでに何度も退けられた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "UX・UI設計", "デザインシステム・UI", "テスト・品質保証", "フロントエンド開発", "自動化・CI/CD", "文書作成", "UI/UX設計・デザインシステム", "ブランド・マーケティング・SEO" ] }, { "id": "https://engineer.company/ja/portfolio/the-accessibility-faults-your-checker-misses/", "url": "https://engineer.company/ja/portfolio/the-accessibility-faults-your-checker-misses/", "title": "自動検査が見逃すアクセシビリティの問題", "summary": "11不備を直し、さらに長く使える4規則を得た。1軸の検査は1軸しか守らず、含まれない規則は適用できず、高さも検査すべき寸法であり、可視性は文書でなく画素で示す。配置検査を正しく広げると3言語で128件失敗し、携帯端末幅の画面でヒーローの末尾が画面下21 pxに隠れる例も捉えた。", "content_html": "<p><strong>状況.</strong> サイトは自動アクセシビリティ検査を通っていたが、マークアップでなく描画の性質による11件の不備があった。検証器は正常と報告しても、キーボード利用者は数秒で遭遇する種類だった。</p>\n<p><strong>課題.</strong> 個別例だけでなく種類ごと解決するため、発見・修正し、それぞれが生んだ規則とともに台帳へ記録する必要があった。</p>\n<p><strong>行動.</strong> 3群に分かれた。寸法では、相対値のつもりのキーワードが本文22 pxに対して領域全体を16 pxに固定し、下付き文字用の要素を「小さい」の意味で使い、縮小が行を96文字に延ばし、高さ上限を対応を主張する文字間隔変更自体が超えていた。フォーカスと切り取りでは、ポインターしか無効にしない指定の背後に8リンクがTab順として残り、overflowが不要なスクロール領域を作り、短くてスクロールできないページで無効なスクロール連動アニメーションが、3ページのフッターを恒久的に切っていた。検査自体の2不備もあった。すべての窓高が900 pxで、852×393の横向き携帯で項目間7 pxとなる配置を誰も見ず、105ルール中70しか動かず、ランドマーク欠落のルールは含まれていなかった。</p>\n<p><strong>結果.</strong> 11不備を直し、さらに長く使える4規則を得た。1軸の検査は1軸しか守らず、含まれない規則は適用できず、高さも検査すべき寸法であり、可視性は文書でなく画素で示す。配置検査を正しく広げると3言語で128件失敗し、携帯端末幅の画面でヒーローの末尾が画面下21 pxに隠れる例も捉えた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "UX・UI設計", "Web開発", "デザインシステム・UI", "テスト・品質保証", "フロントエンド開発", "自動化・CI/CD", "UI/UX設計・デザインシステム", "Webサイト・CMS開発" ] }, { "id": "https://engineer.company/ja/portfolio/made-the-reduced-motion-setting-honest/", "url": "https://engineer.company/ja/portfolio/made-the-reduced-motion-setting-honest/", "title": "「動きを減らす」設定を正しく反映", "summary": "意図だけでなく実際に設定を尊重し、一括ルールで対応したように見えた11の動きを止めた。詳細度で負けるルールは静かに失敗し、どの報告も別の名で呼ぶという教訓を、文書の冒頭に記した。", "content_html": "<p><strong>状況.</strong> 全トランジションを止める1ルールで「動きを減らす」に対応していた。完全に見え、静的検査も通ったが、設定を模擬すると11セレクターが動いていた。</p>\n<p><strong>課題.</strong> 実際に設定を尊重し、明白に見える規則が失敗した理由を、次の人が繰り返せない仕組みにする必要があった。</p>\n<p><strong>行動.</strong> 原因は詳細度だった。全要素指定は最下位で、クラス付きのどの動きにも負けるため、一括トランジション‑noneは止めたいすべてに敗れる。継ぎ当てでなく構造を変え、動きは最後の専用CSSへ集め、他所のtransform トランジションを検査で拒否した。色変化は動きではなく、それまで消すと求めていない人にも画面が壊れた感覚になるため、色のトランジションは通し、移動は通さない。また簡単に解除できるトランジションを使い、難しいキーフレームは避ける。関連する2つの罠も測定とともに記した。メニュー装飾は半分見える前に60度中31度回っていたが、周期形なので半回転でも同じ見え方を3分の1の費用で得られる。また5種類の指定がビューポート基準の子の包含ブロックを変え、閉じるための面を画面の一部へ縮めていた。</p>\n<p><strong>結果.</strong> 意図だけでなく実際に設定を尊重し、一括ルールで対応したように見えた11の動きを止めた。詳細度で負けるルールは静かに失敗し、どの報告も別の名で呼ぶという教訓を、文書の冒頭に記した。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "UX・UI設計", "Web開発", "デザインシステム・UI", "テスト・品質保証", "フロントエンド開発", "UI/UX設計・デザインシステム", "Webサイト・CMS開発" ] }, { "id": "https://engineer.company/ja/portfolio/built-a-637-line-print-stylesheet/", "url": "https://engineer.company/ja/portfolio/built-a-637-line-print-stylesheet/", "title": "637行の印刷スタイルシートを構築", "summary": "両テーマで未知の用紙に印刷でき、各エンジン挙動と不備を記録した。ページ番号・柱なし、あるエンジンはwidow/orphan制御を無視、drop capは共通でないという限界も隠さなかった。余分なコメント終端でCSS検査が1ルール全体を飲み込み2回通った際も、印刷検査だけが気づいた。", "content_html": "<p><strong>状況.</strong> 事例は印刷して会議へ持参する成果物でもあった。紙は配慮でなく実際の出力であり、サイズ・向きが不明で、画面では見えないエンジン差もある、細い画面とは違う媒体だった。</p>\n<p><strong>課題.</strong> Web版の隣に別文書を維持せず、未知の紙と両テーマで正しく印刷する必要があった。</p>\n<p><strong>行動.</strong> 637行のCSSにpage rule1つとprint block1つを置いた。余白は定めても紙サイズは固定せず、利用者の選択へ適応する。rootの文字サイズをptで固定して相対値の物理的基準にし、上位4ブロックを約72文字に制限した。さもなければ横向きは約110文字になるため、意匠より紙を優先した。実際に欠陥を生んだ4挙動を記した。ビューポート単位が紙基準か窓基準かで、広い窓から印刷すると行の3分の1が切れる。固定配置の要素は全紙に出るため装飾を除き、2つをレターヘッドと奥付に転用する。ダーク由来の白文字で行内の4節ラベルが白地に消える。flex/gridのボックスは紙をまたげず、実績ページの1枚目が白紙になる。6要素の検査で、6用紙・向き組、両配色設定、内容高から想定する実ページ数を検証した。</p>\n<p><strong>結果.</strong> 両テーマで未知の用紙に印刷でき、各エンジン挙動と不備を記録した。ページ番号・柱なし、あるエンジンはwidow/orphan制御を無視、drop capは共通でないという限界も隠さなかった。余分なコメント終端でCSS検査が1ルール全体を飲み込み2回通った際も、印刷検査だけが気づいた。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "UX・UI設計", "Web開発", "デザインシステム・UI", "フロントエンド開発", "文書作成", "UI/UX設計・デザインシステム", "Webサイト・CMS開発" ] }, { "id": "https://engineer.company/ja/portfolio/held-the-generator-to-981-tests-and-92-coverage/", "url": "https://engineer.company/ja/portfolio/held-the-generator-to-981-tests-and-92-coverage/", "title": "生成器に981テストと92%カバレッジを適用", "summary": "稼働DBへ安心して再実行でき、少しずつの内容更新を可能にした。下限は目標ではなく、92%でも未実行分岐は残る。数値は危険を限定するだけで除去せず、後で見つかった2不具合も、カバレッジ報告では実行済みとされていたコード内にあった。", "content_html": "<p><strong>状況.</strong> DBを一から組む生成器には、初回は動いて2回目で壊す固有のバグがある。確認せず挿入、前段の出力順へ依存、単体なら安全でも組み合わせると危険など、空から一度だけ走る試験では見えない。</p>\n<p><strong>課題.</strong> 単に動くのでなく繰り返せると実証し、回帰を静かに通さない十分な量と厳しさのテストが必要だった。</p>\n<p><strong>行動.</strong> 全DBを空から作り、保存状態を記録し、19段階を再度適用して、行数、内容、IDが一切変わらないことを要求した。この単純な冪等性試験を中心に、45ファイル・7,944行、383関数、パラメーター展開後981ケースで、構築、描画、読み込み、読者別調整、検査器を対象とした。分岐カバレッジ92%を報告値でなくビルドの下限とし、現状約95%なので、飾りでなく余裕も持つ。特に重要な設定として警告を失敗にした。2年間表示される非推奨通知は読まれず、赤い試験にした実行で初めて直されるためだった。</p>\n<p><strong>結果.</strong> 稼働DBへ安心して再実行でき、少しずつの内容更新を可能にした。下限は目標ではなく、92%でも未実行分岐は残る。数値は危険を限定するだけで除去せず、後で見つかった2不具合も、カバレッジ報告では実行済みとされていたコード内にあった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "Python", "データベース", "テスト・品質保証", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "バックエンド・API開発", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/reached-pdf-ua-1-conformance-at-106-of-106/", "url": "https://engineer.company/ja/portfolio/reached-pdf-ua-1-conformance-at-106-of-106/", "title": "PDF/UA‑1プロファイルの106項目中106項目に合格", "summary": "設定したアクセシビリティプロファイルの検査はすべて合格した。保存用は具体的な不足を持つ僅かな未達として率直に示した。両数値とも1つの検証器の結果で、別実装は異なる可能性があり、合格はその検査器が指摘しなかった証拠にとどまるという限界も明確にした。", "content_html": "<p><strong>状況.</strong> 画面で正しく見えるPDFだけでは、読み上げ、見出し構造、言語宣言、20年後に開けるかはわからない。アクセシブルPDFと保存用PDFは機械検証できる基準であり、検証器を通さない適合主張は未検証だった。</p>\n<p><strong>課題.</strong> 両基準で生成文書を測り、意図でなく数値として記録する必要があった。</p>\n<p><strong>行動.</strong> 言語にまたがる履歴書各版、推薦者一覧、実績集、応募書類の9文書を、独立した検証器で2つのプロファイルでそれぞれ検査した。アクセシビリティは106項目中106を通過した。タグ構造、文書言語、非装飾画像すべての代替文、メタデータの実タイトル、配置任せでない明示的な読み順が必要だった。一方、保存用は146中ちょうど1項目失敗した。145合格は要約では適合に見えても、基準を適用するシステムは拒否するため適合ではない。失敗の内容と未解決理由を記し、端数として丸めなかった。</p>\n<p><strong>結果.</strong> 設定したアクセシビリティプロファイルの検査はすべて合格した。保存用は具体的な不足を持つ僅かな未達として率直に示した。両数値とも1つの検証器の結果で、別実装は異なる可能性があり、合格はその検査器が指摘しなかった証拠にとどまるという限界も明確にした。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Python", "UX・UI設計", "Web開発", "テスト・品質保証", "自動化・CI/CD", "文書作成", "UI/UX設計・デザインシステム", "Webサイト・CMS開発", "技術文書の作成" ] }, { "id": "https://engineer.company/ja/portfolio/rehearsed-the-forge-ci-hook-found-2-defects/", "url": "https://engineer.company/ja/portfolio/rehearsed-the-forge-ci-hook-found-2-defects/", "title": "gitホスティングCIを試し2不具合を発見", "summary": "両経路が動き、実際のpushが遭う前に2件を直した。ただし予行は模擬であり、1種類のpushを証明するだけで、本番が見る強制更新やブランチ削除などは含まないという限界を残した。", "content_html": "<p><strong>状況.</strong> 自前gitはpushを受け、ゲート不合格をサーバーフックで拒否できる。しかしフックは作業ツリーのないbareリポジトリで、gitが与える環境と標準入力の参照を使うため、単に手元で動かしては検証できない。読んで正しいと判断するのは推測だった。</p>\n<p><strong>課題.</strong> 導入して発見するのでなく、信頼前に実際のbareとpushで予行する必要があった。</p>\n<p><strong>行動.</strong> bareを作り、フックを導入し、clone、commit、pushして、受理・拒否の両経路を検証した。ファイルからは見えない2不具合を発見した。参照不明時の代替が解決不能な仮値で、引数でなく標準入力から入るため、遠い後段の無関係なエラーとして現れた。さらに、gitがフックへリポジトリディレクトリの環境変数を渡し、全子処理が継承していた。ゲートがpush版をcheckoutして試験しても、19のgitテストはbareを指して誤ったリポジトリを使い、正しいコードで失敗した。境界で環境を消す必要があり、その境界は実行しなければ見えなかった。</p>\n<p><strong>結果.</strong> 両経路が動き、実際のpushが遭う前に2件を直した。ただし予行は模擬であり、1種類のpushを証明するだけで、本番が見る強制更新やブランチ削除などは含まないという限界を残した。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "DevOps", "Linux・サーバー", "Python", "インフラ", "テスト・品質保証", "自動化・CI/CD", "DevOps・CI/CD自動化", "コードによるインフラ管理", "システム管理" ] }, { "id": "https://engineer.company/ja/portfolio/built-a-native-macos-client-in-swift-6/", "url": "https://engineer.company/ja/portfolio/built-a-native-macos-client-in-swift-6/", "title": "Swift 6でネイティブmacOSクライアントを構築", "summary": "標準の素材と操作部品を使い、埋め込みブラウザーを持たず、Macアプリとして起動するものになった。ただし公開リリースではなく、公証済み配布、更新経路、多言語UIはない。動くアプリであって、他の人が使う製品ではないことを明示した。", "content_html": "<p><strong>状況.</strong> メッセージングには十分に試されたRustコアと各プラットフォームのクライアントがあったが、macOS版はクロスプラットフォームの外枠を使っており、Macらしく見えず動かず、ネイティブなら不要な実行環境も載せていた。コアはCインターフェースを公開しており、Cを呼べるSwiftでも構築できた。</p>\n<p><strong>課題.</strong> 現行の言語とUI基盤で、コアを併設配布せず内部へリンクし、Cの上に直接ネイティブクライアントをつくる必要があった。</p>\n<p><strong>行動.</strong> アプリターゲットの53ファイル、11,141行のSwiftとSwiftUIで構築し、上流の固定リビジョンからコンパイルしたRust静的アーカイブをリンクした。ブランチを追わず固定したのは、Swiftを変えずにCインターフェースの仕様が変わるのを防ぎ、再現可能にするためだった。薄いラッパーが境界を渡る全ポインター・文字列を所有し、上のモデルは通常のSwift値とし、画面に生ポインターを見せず、危険な面を小さくした。Cの返り値の所有規則を誤ると警告なしに漏出かクラッシュとなるため、ラッパーが全体のメモリー規律を担う。コアのコンパイル、Swiftのビルド、試験、静的検査、パッケージ化を56ターゲットのタスクで動かした。</p>\n<p><strong>結果.</strong> 標準の素材と操作部品を使い、埋め込みブラウザーを持たず、Macアプリとして起動するものになった。ただし公開リリースではなく、公証済み配布、更新経路、多言語UIはない。動くアプリであって、他の人が使う製品ではないことを明示した。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "API・システム連携", "UX・UI設計", "ソリューション設計", "デザインシステム・UI", "フルスタック開発", "フロントエンド開発", "UI/UX設計・デザインシステム", "プラットフォーム・ソリューション設計", "フルスタックのプロダクト開発" ] }, { "id": "https://engineer.company/ja/portfolio/an-app-that-ate-41-mb-a-second-stopped/", "url": "https://engineer.company/ja/portfolio/an-app-that-ate-41-mb-a-second-stopped/", "title": "macOSアプリのイベントパイプラインに上限を設定", "summary": "障害記録には全テスト実行の比較があり、コアのログ行が610,996から1,411へ、取得ログ量が63 MBから388 KBへ減った。記録されたテスト実行の測定であって、本番トラフィックのベンチマークや修正後メモリーの実測ではない。ログ変更だけでは別の終了タイムアウトを直せず、それには別の修正が必要だった。", "content_html": "<p><strong>状況.</strong> 2026‑09‑01、診断レポートは、36 GBの端末上のmacOSアプリについて、111 GBの圧縮ページを記録した。接続再試行ループがコアイベントを発する間、別のメモリー使用量サンプルでは毎秒約41 MBの増加を記録した。</p>\n<p><strong>課題.</strong> イベント経路に明示的なメモリー上限が必要だった。コアのログイベントの急増が、無制限の主ストリームに残り、そのログイベントを使わない消費者を持つ7つの購読ストリームへ複製されていた。</p>\n<p><strong>行動.</strong> バッファに上限を設け、購読をイベント種別で絞り、ログ出力に頻度予算を設けた。あふれた場合、反復する診断イベントは捨て、無制限に保持する代わりに対象状態を再取得できるという、交換条件を明示した。構成検査とアプリ資源予算テストが、有界な設計を守る。</p>\n<p><strong>結果.</strong> 障害記録には全テスト実行の比較があり、コアのログ行が610,996から1,411へ、取得ログ量が63 MBから388 KBへ減った。記録されたテスト実行の測定であって、本番トラフィックのベンチマークや修正後メモリーの実測ではない。ログ変更だけでは別の終了タイムアウトを直せず、それには別の修正が必要だった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "ソリューション設計", "テスト・品質保証", "フロントエンド開発", "監視・オブザーバビリティ", "信頼性・バックアップ", "性能改善", "サイト信頼性・監視", "プラットフォーム・ソリューション設計" ] }, { "id": "https://engineer.company/ja/portfolio/named-all-17-icons-for-screen-readers/", "url": "https://engineer.company/ja/portfolio/named-all-17-icons-for-screen-readers/", "title": "全17アイコンに読み上げ用の名前を付与", "summary": "17操作が機能を読み上げ、18個目はラベルなしに追加できなくなった。ただし隣のビューのラベルでも満たし得るため、近くの存在を証明するだけで正しさは証明しないと定義箇所に記した。正確さには今も誰かが聞く必要がある。", "content_html": "<p><strong>状況.</strong> 標準シンボルを操作に使い、ラベルがなければスクリーンリーダーは内部名を読んでいた。送信は「arrow up circle, button」で、ほかのアイコン操作も同様で、計17個が機能ではなく、それぞれの図柄を説明していた。</p>\n<p><strong>課題.</strong> すべてに動作を示すラベルを付け、次の追加で直ちに再発しないよう検査も加える必要があった。</p>\n<p><strong>行動.</strong> 17個それぞれに形でなく動作の名を与え、状態で意味が変わればラベルも変えた。汎用の「アクセシブルか」規則はないため、アイコンだけの操作をつくる構文を探し、8行以内にラベルを必須とする検査を設けた。8行は意図的に粗いが、修飾を含む全正当な書き方を覆い、下の別ビューのラベルでは偶然満たしにくいと測って選んだ。精密にはSwiftUI修飾鎖を木として理解する必要があるが、実際のミスは誤ラベルでなく未ラベルなので、安い近接規則で捉えられる。</p>\n<p><strong>結果.</strong> 17操作が機能を読み上げ、18個目はラベルなしに追加できなくなった。ただし隣のビューのラベルでも満たし得るため、近くの存在を証明するだけで正しさは証明しないと定義箇所に記した。正確さには今も誰かが聞く必要がある。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "UX・UI設計", "デザインシステム・UI", "テスト・品質保証", "フロントエンド開発", "自動化・CI/CD", "文書作成", "UI/UX設計・デザインシステム" ] }, { "id": "https://engineer.company/ja/portfolio/built-a-48-token-macos-design-system/", "url": "https://engineer.company/ja/portfolio/built-a-48-token-macos-design-system/", "title": "48トークンのmacOSデザインシステムを構築", "summary": "48トークンが全画面を表し、外観はシステムに従い、3種の崩れをコミットできなくなった。ただし体系は一貫性を制限しても品質を判断しない。すべて合うことと、良い設計であることは別で、どの検査もその判断はしない。", "content_html": "<p><strong>状況.</strong> ビューを足す画面には、角丸、14 pt、0.2秒の動きなどがたまる。個々は妥当でも、50ファイルに少し違う40の角丸があれば、「角丸」という変更対象がなく、全体として変更できない設計になる。</p>\n<p><strong>課題.</strong> 視覚表現を名前付きの集合に絞り、独自再発明でなく標準素材を使い、検査で少数の状態を保つ必要があった。</p>\n<p><strong>行動.</strong> 余白、文字、色、角丸、立体感、動きの6群・48トークンとした。固定値でなく標準の意味付き色とガラス素材を使い、監視コードなしで外観、アクセントカラー、コントラスト設定に追従させる。文字もpt固定でなく標準テキストスタイルに対応づけ、利用者のサイズに合わせる。検査は、トークンを使うべき数値、あらゆる固定文字サイズ、動きを減らす設定を尊重しないアニメーションの3つを拒否する。仕上げ時に追加され設定確認を飛ばしやすい動きは特に崩れやすく、覚えてもらうのでなく、確認なしには書けない規則にした。</p>\n<p><strong>結果.</strong> 48トークンが全画面を表し、外観はシステムに従い、3種の崩れをコミットできなくなった。ただし体系は一貫性を制限しても品質を判断しない。すべて合うことと、良い設計であることは別で、どの検査もその判断はしない。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "UX・UI設計", "デザインシステム・UI", "テスト・品質保証", "フロントエンド開発", "自動化・CI/CD", "UI/UX設計・デザインシステム", "ブランド・マーケティング・SEO" ] }, { "id": "https://engineer.company/ja/portfolio/reached-the-unused-half-of-the-core/", "url": "https://engineer.company/ja/portfolio/reached-the-unused-half-of-the-core/", "title": "未使用だったコアの半分の機能を実装", "summary": "以前未到達だった半分を、実ライブラリ相手の試験で動かし、ラッパーに最も高いカバレッジ下限を設けた。実ライブラリは遅く、環境要因でも失敗し得るという、速度と決定性の代償がある。それは本当の理由で失敗できるための費用だった。", "content_html": "<p><strong>状況.</strong> クライアントはコアの約半分しか使っていなかった。残りは端末間バックアップ、消えるメッセージ、編集・再送、確認済み招待、プロキシ、チャットの暗号化方針など、利用者が期待する機能だった。同時にC境界の未テスト領域であり、そこに所有権の誤りが潜むことのほうが危険だった。</p>\n<p><strong>課題.</strong> 未到達機能を動かして検査し、代用品でなく実ライブラリを使う必要があった。</p>\n<p><strong>行動.</strong> コアはモック禁止とした。Cのモックは開発者の想定を符号化するが、見つけるべき不備は想定が誤る場所なので、合格してもモックの証拠にしかならない。代わりに一時ディレクトリで実アカウントを作り、実際の戻り値を検証して各試験が状態を片づける。バックアップは実転送の状態機械と失敗経路、招待は実リンクの構築と解析を試すため、意味のある検査となった。下限は一括でなく層別にし、ラッパー84%、ユーティリティ75%、モデル65%とした。ポインターを触る層を最も厳しくし、保存プロパティ中心のモデルを平均のため水増ししない考えだった。</p>\n<p><strong>結果.</strong> 以前未到達だった半分を、実ライブラリ相手の試験で動かし、ラッパーに最も高いカバレッジ下限を設けた。実ライブラリは遅く、環境要因でも失敗し得るという、速度と決定性の代償がある。それは本当の理由で失敗できるための費用だった。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "API・システム連携", "セキュリティ", "テスト・品質保証", "バックエンド開発", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "セキュリティ・アクセス管理", "バックエンド・API開発" ] }, { "id": "https://engineer.company/ja/portfolio/measured-13-addresses-with-no-tracking/", "url": "https://engineer.company/ja/portfolio/measured-13-addresses-with-no-tracking/", "title": "追跡せずに13アドレスを測定", "summary": "13アドレスを計測し、Cookie、追跡、第三者要求を送らないため同意対象もタグの実行先もない。ユニーク利用者、検索語、閲覧経路、滞在、クリック、地域、端末は答えられないと明記する。粗い数を精密に読ませるほうが無数値より悪いため、限界は小さな注記でなく数値のそばに表示した。", "content_html": "<p><strong>状況.</strong> サイトは読まれているかわからなかった。通常の答えはCookie、スクリプト、pixel、訪問者を知る外部サービスなど読み手に何かを負担させるため、書き始める前にすべて退けた。残ったのは、応答のため元々存在するWebアクセスログだった。</p>\n<p><strong>課題.</strong> 識別部分を除去済みの行から有用な閲覧記録を作れるか、除去を約束でなく実証できるかが問いだった。</p>\n<p><strong>行動.</strong> 後で掃除すれば一度保存しない約束を破るため、書き込み時点でマスクした。アドレスを2名で保持するため両方を処理し、片方だけでは別名に完全値が残ることを実プローブで発見した。エンコーダーは送信されたヘッダーマップをそのまま記すため、企業proxy利用者の完全アドレスを混入させる転送元アドレスを含む7種類のヘッダーを削除した。Cookie、認可、一時的な送信元ポートも除き、パスを読む前にクエリ文字列を除いて、検索エンジンやサイト検索の入力語をファイルへ届かせない。標準ライブラリのみのスクリプトが稼働ログとローテーション済みログをストリームで読み、行でなく件数を返す。464 MBなので使用量はログ容量でなく異なるパス数で制限する。容量と期間を同じ保持枠に置くと小さい方が勝ち、多いサイトは30日でなく10日、静かなサイトは永久に消えないとわかり、保持を2機構に分けた。残すのは日別21種類の集計値と月別20分析軸で、観測窓は不足しか起こせない規則で追記でなくマージし、順位表ごとに総数も保存して切り捨て量を示した。</p>\n<p><strong>結果.</strong> 13アドレスを計測し、Cookie、追跡、第三者要求を送らないため同意対象もタグの実行先もない。ユニーク利用者、検索語、閲覧経路、滞在、クリック、地域、端末は答えられないと明記する。粗い数を精密に読ませるほうが無数値より悪いため、限界は小さな注記でなく数値のそばに表示した。</p>\n", "date_published": "2026-11-12T06:34:23+01:00", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja", "tags": [ "Python", "インフラ", "データガバナンス", "セキュリティ", "監視・オブザーバビリティ", "自動化・CI/CD", "データガバナンス・品質管理", "サイト信頼性・監視", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/resolved-1000-issues-in-geographical-data/", "url": "https://engineer.company/ja/portfolio/resolved-1000-issues-in-geographical-data/", "title": "地理情報データの問題1,000件を解決", "summary": "GDAL、PostGIS、ArcGIS、Mapbox、QGIS、SQLで地理情報・時系列大規模データの問題1,000件以上を解決し、クエリを35%高速化した。", "content_html": "<p><strong>状況.</strong> 大規模な地理空間分析プロジェクトで、地理情報・時系列データセットに多くの不整合や異常が見つかった。これらは、複数部門で利用する空間分析と意思決定ツールの精度に影響していた。</p>\n<p><strong>課題.</strong> 下流のアプリケーションと可視化の整合性・性能を確保するため、複雑なデータセット内の1,000件を超える品質問題を特定・解決し、処理を改善することが担当範囲だった。</p>\n<p><strong>行動.</strong> GDAL、QGIS、ArcGISなどを組み合わせ、空間上の誤りを体系的に診断・修正した。繰り返すクレンジング作業はBashスクリプトで自動化した。高度な空間クエリと空間インデックスにはPostGISを用い、PostgreSQL・SQL Server内の地理情報・時間データを管理・変換する手続きをPL/pgSQLとTransact‑SQLで作成した。さらに、整備したデータをMapboxの対話型可視化に組み込み、利用者がアクセスしやすくした。</p>\n<p><strong>結果.</strong> 重要な問題を1,000件以上解決し、データの精度と処理速度を大幅に改善した。空間クエリの実行時間の35%短縮に直接つながり、より信頼できる空間分析が可能になった。分析・報告にすぐ使える高品質なデータを継続的に提供し、組織全体の戦略判断を支えた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "PostgreSQL", "SQL", "データベース", "データエンジニアリング", "データガバナンス", "データパイプライン(ETL/ELT)", "自動化・CI/CD", "性能改善", "GIS・地理空間ソリューション", "データガバナンス・品質管理", "データパイプライン開発(ETL/ELT)" ] }, { "id": "https://engineer.company/ja/portfolio/designed-and-ran-6-etl-elt-pipelines/", "url": "https://engineer.company/ja/portfolio/designed-and-ran-6-etl-elt-pipelines/", "title": "ETL/ELTパイプライン6本を設計・運用", "summary": "BigQuery、MSSQL、PostgreSQLのETL/ELTパイプライン6本を設計・運用し、毎日同期することで3時間の手作業を20分未満に短縮した。", "content_html": "<p><strong>状況.</strong> IPsec VPNの背後にある遠隔データウェアハウスから、大量の表形式データを統合・処理する必要があった。社内の分析ダッシュボードと、顧客・協力先が利用する外部向けPython APIを動かす重要なデータだった。</p>\n<p><strong>課題.</strong> データを安全に取得・変換してGoogle BigQueryへ読み込む、堅実な自動ETL/ELTパイプライン群を設計・実装・保守し、システム全体で精度、性能、拡張性を確保することが目的だった。</p>\n<p><strong>行動.</strong> Google BigQuery、MSSQL、PostgreSQL、Shellスクリプト、PL/pgSQL、Transact‑SQLにまたがる、一貫したETL/ELTパイプライン6本を設計・実装・管理した。</p>\n<ul>\n<li>IPsec VPNで保護された遠隔サーバーへ安全に接続し、データ取得を自動化した。</li>\n<li>Parquet、CSV、.bakを含む圧縮アーカイブのダウンロードを予定・実行した。</li>\n<li>形式とスキーマに応じてファイルを抽出・分類するBash・Pythonスクリプトを作成した。</li>\n<li>.bakはRESTORE DATABASEの手順でローカルMSSQL Serverへ復元し、スキーマの整合性を検証した。</li>\n<li>元の形式に応じ、bcp、psql、SSISを用いて、MSSQL・PostgreSQLのステージングスキーマへ表データを読み込んだ。</li>\n<li>業務ロジックに沿うクレンジング、正規化、情報追加のため、再利用可能なPL/pgSQL・T‑SQL手続きをモジュール化して作成した。</li>\n<li>整備したデータセットとテーブルを中間形式に出力し、gzipで圧縮してGoogle Cloud Storageバケットへ安全に転送した。</li>\n<li>bq CLIとPythonの取り込みスクリプトで、BigQueryへのアップロードとスキーマ対応付けを自動化した。</li>\n</ul>\n<p><strong>結果.</strong> 3時間以上の手作業を一連の処理で20分未満へ短縮し、更新頻度も週次から日次同期へ高めた。データを利用するPython APIの性能が30%向上し、可視性の改善によって業務分析担当者が関係者へより早く知見を届けられた。事業の成長に合わせて新たなソースを受け入れられる、拡張性のある構成となった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "PostgreSQL", "Python", "SQL", "データウェアハウス", "データベース", "データエンジニアリング", "データパイプライン(ETL/ELT)", "クラウド", "ネットワーク・VPN", "自動化・CI/CD", "AIが使えるデータの整備", "データウェアハウス設計", "データベース設計・モデリング", "データパイプライン開発(ETL/ELT)", "バックエンド・API開発" ] }, { "id": "https://engineer.company/ja/portfolio/built-the-companys-first-observability-dashboard/", "url": "https://engineer.company/ja/portfolio/built-the-companys-first-observability-dashboard/", "title": "社内初のオブザーバビリティダッシュボードを構築", "summary": "社内初のオブザーバビリティダッシュボードでシステムをリアルタイムに可視化し、障害の検知と解決を40%迅速化した。", "content_html": "<p><strong>状況.</strong> リアルタイムのシステム性能監視に課題があり、障害対応の遅れと、インフラの健全性の把握不足につながっていた。チームが運用指標を確認できる集約された仕組みはなかった。</p>\n<p><strong>課題.</strong> 技術者にもそれ以外の関係者にも、主要なシステム指標をリアルタイムで確認できる仕組みを開発することが課題だった。利用しやすさ、わかりやすさ、問題の早期発見を重視した。</p>\n<p><strong>行動.</strong> 社内初のオブザーバビリティダッシュボードを設計・実装し、SSHで遠隔LinuxサーバーからCPU、RAM、HDD、温度などの重要指標を収集した。Dockerコンテナも同じ方法で監視した。その後、可視化・監視を高度化するため、GrafanaとPrometheusを使う第2版を設計・実装した。DevOps・開発チームと協働して、CPU使用率、メモリー使用量、稼働時間、API遅延などの重要指標を特定した。各種システムから性能指標を取り込み処理するパイプラインを設定し、多くの人が見られるよう、オフィスの大型テレビに表示した。閾値超過を知らせる仕組みも組み込み、即座に対処できるようにした。</p>\n<p><strong>結果.</strong> システムの透明性と運用上の問題への応答時間が大幅に改善し、障害の検知・解決を40%迅速化した。オフィスの全員が性能データを見られるようになり、システムの健全性に共同で責任を持つ文化も育ち、より安定的で効率のよい本番環境に寄与した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "Linux・サーバー", "インフラ", "データ分析", "コンテナ(Docker/Kubernetes)", "監視・オブザーバビリティ", "自動化・CI/CD", "信頼性・バックアップ", "データ分析・BIダッシュボード", "サイト信頼性・監視" ] }, { "id": "https://engineer.company/ja/portfolio/delivered-8-power-bi-projects-with-manuals/", "url": "https://engineer.company/ja/portfolio/delivered-8-power-bi-projects-with-manuals/", "title": "マニュアル付きPower BIプロジェクト8件を提供", "summary": "Node.js API・Python FastAPIによるPower BI分析8プロジェクトを完全なマニュアルとともに提供し、レポート作成効率を60%向上させた。", "content_html": "<p><strong>状況.</strong> 技術面・戦略面のチームの意思決定を支えるため、電力網の性能と地理的分布に関する複雑なデータから、動的で視覚的な知見を得る必要があった。</p>\n<p><strong>課題.</strong> リアルタイムと過去の地理情報・電力データを効果的に提示する対話型ダッシュボードとレポートを開発し、関係者が傾向、異常、性能指標を素早く把握できるようにする必要があった。</p>\n<p><strong>行動.</strong> Microsoft Power BIを、NodeJS APIとPython FastAPIによる独自バックエンドに連携させ、データ取り込み、変換、可視化を効率化した。地図表示、電力消費指標、停電追跡、電力網の効率指標を持つダッシュボードを設計・実装した。拡張と利用を容易にする、再利用可能なテンプレートと詳しい文書も作成した。</p>\n<p><strong>結果.</strong> データ分析プロジェクト8件を提供し、レポート作成効率を60%改善して、部門を横断するチームのデータに基づく迅速な意思決定を可能にした。関係者からは、地域別の電力性能への理解と、資源計画の精度が大きく高まったとの報告があった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "GIS・地理空間情報", "Python", "データエンジニアリング", "データ分析", "バックエンド開発", "プロダクト・要件", "文書作成", "データ分析・BIダッシュボード", "バックエンド・API開発", "技術文書の作成" ] }, { "id": "https://engineer.company/ja/portfolio/released-500-electricity-and-gis-data-reports/", "url": "https://engineer.company/ja/portfolio/released-500-electricity-and-gis-data-reports/", "title": "電力・GISデータレポート500件を公開", "summary": "電力・GISのデータ分析レポート500件を公開し、負荷分散、効率改善、異常検知に使う部門共通の参照資料とした。", "content_html": "<p><strong>状況.</strong> 複数地域に設置したスマートメーターが生成する膨大なデータを管理していた。電力消費の細かな時系列データを、電力分析担当者、技術者、地域計画担当者が、運用と戦略の意思決定に使っていた。</p>\n<p><strong>課題.</strong> 電力消費のパターン、異常、地域別の傾向を明らかにし、技術者以外にも理解・再利用しやすい、高品質で透明性と再現性のある分析レポートを作成することが担当範囲だった。</p>\n<p><strong>行動.</strong> PostgreSQLやBigQueryなどのクラウド環境で直接作業し、抽出、変換、分析のすべてをSQLのみで実行して、詳細な分析レポート500件以上を作成・提供した。位置座標、メーターID、時刻付きの電力使用量、環境に関する付帯情報を扱った。CTE、ウィンドウ関数、サブクエリ、地理空間結合を使い、効率と拡張性を備えた処理にした。</p>\n<p>各レポートに注釈付きSQLを含め、同僚や協力者が調査を完全に再現・監査できるようにし、追加分析に必要な時間を大きく減らした。問題解決のメモも添え、GPS座標の欠落や壊れたメーター値など、よくある品質問題と推奨される対応を記録した。</p>\n<p><strong>結果.</strong> レポートは部門共通の標準資料となり、地域ごとの負荷分散、省エネ計画、異常検知に役立った。完全な透明性と再現性がデータへの信頼を高め、予測モデルの精度向上と、運用計画の効率の10–15%改善に寄与した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "PostgreSQL", "SQL", "データウェアハウス", "データベース", "データガバナンス", "データ分析", "関係者との調整・報告", "文書作成", "GIS・地理空間ソリューション", "データガバナンス・品質管理", "データ分析・BIダッシュボード" ] }, { "id": "https://engineer.company/ja/portfolio/ran-10-postgresql-and-ms-sql-servers-on-ubuntu/", "url": "https://engineer.company/ja/portfolio/ran-10-postgresql-and-ms-sql-servers-on-ubuntu/", "title": "UbuntuでPostgreSQL・MS SQLサーバー10台を運用", "summary": "Ubuntu Linux VPSでPostgreSQL・MS SQLサーバー10台を設計・保守し、稼働率99.9%と、調整によるクエリの30%高速化を達成した。", "content_html": "<p><strong>状況.</strong> 中規模の技術企業のDevOps担当として、増える利用者と重要業務アプリケーションを支えるデータベース基盤の管理・最適化を担った。組織は保存と分析をPostgreSQLとMicrosoft SQL Serverに大きく依存し、高可用性、拡張性、セキュリティを必要としていた。</p>\n<p><strong>課題.</strong> Ubuntu Linux VPS上で、PostgreSQL・MS SQL Serverインスタンス10台の設計、デプロイ、設定、保守を行うことが主な責任だった。性能の最適化、堅実なセキュリティ対策、停止を防ぐ予防的監視を含んだ。費用を抑え、業界基準を守りながら、将来の成長に応じてインフラを拡大することも求められた。</p>\n<p><strong>行動.</strong> 1. 導入・設定:</p>\n<ul>\n<li>Ubuntu 20.04 LTS VPSにPostgreSQL 14とMS SQL Server 2019を導入・設定し、会社のアプリケーションとの互換性を確保した。</li>\n<li>PostgreSQLには<code>pg_dump</code>、MS SQLにはSQL Server Agentジョブを使い、保持方針と遠隔保存を備える自動バックアップを設定した。</li>\n<li>メモリー割り当て、クエリキャッシュ、接続プールなどを調整し、クエリ性能を高めて遅延を減らした。</li>\n</ul>\n<ol start=\"2\">\n<li>\n<p>監視・保守:</p>\n<ul>\n<li>Prometheus、Grafanaなどで、CPU、メモリー、ディスクI/O、クエリ性能をリアルタイムに追跡した。</li>\n<li>データベースとUbuntu OSを定期更新し、脆弱性と規則への適合に対応した。</li>\n<li>ログ分析用の独自スクリプトを作成した。</li>\n</ul>\n</li>\n<li>\n<p>セキュリティ・拡張性:</p>\n<ul>\n<li>UFWファイアウォールとRBACを設定し、機微なデータを保護した。</li>\n<li>特定時点への復元やフェイルオーバーを含む災害復旧手順を記録した。</li>\n</ul>\n</li>\n</ol>\n<p><strong>結果.</strong> - データベースサーバー10台すべてで稼働率99.9%を達成した。</p>\n<ul>\n<li>設定とインデックスを調整してクエリ応答時間を30%改善し、アプリケーションを高速化した。</li>\n<li>自動化で手動保守を50%減らし、月10時間以上を戦略的な仕事に充てられるようにした。</li>\n<li>サービスを劣化させず利用者トラフィック40%増に対応し、次の四半期の売上20%増に寄与した。</li>\n<li>データ侵害を防ぐ適切なセキュリティ対策についてCTOから評価を受けた。</li>\n</ul>\n<p>複雑な企業環境に、信頼でき、安全で、拡張可能な仕組みを提供し、データベース管理、DevOps自動化、インフラ最適化の専門性を深めた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "Linux・サーバー", "PostgreSQL", "インフラ", "データベース", "システム管理", "セキュリティ", "監視・オブザーバビリティ", "自動化・CI/CD", "信頼性・バックアップ", "性能改善", "データベース管理(DBA)", "サイト信頼性・監視" ] }, { "id": "https://engineer.company/ja/portfolio/accelerated-postgresql-performance-by-10x/", "url": "https://engineer.company/ja/portfolio/accelerated-postgresql-performance-by-10x/", "title": "PostgreSQLを10倍に高速化", "summary": "ユーザー、テナント、地理空間、時系列データ向けにPostgreSQLをインデックス・パーティション・クエリ調整で10倍に高速化し、資源使用を40%削減した。", "content_html": "<p><strong>状況.</strong> PostgreSQLが、中規模アプリケーションの利用者アカウント、テナント、場所・地域などの地理情報、日別電力消費を管理していた。低負荷では動いたが、データ増加に伴い性能上の問題が生じた。地理空間と電力時系列ログのクエリが遅くなり、応答時間が不安定だった。最適化不足のインデックス、断片化したクエリ、未分割のテーブルが、認証、テナント管理、報告などの重要処理の障害となった。</p>\n<p><strong>課題.</strong> 既存構成を全面的に変えず、データベース性能を10倍に高めることを目標とした。実行の最適化、遅延削減、将来のデータ増への対応を重視した。地理空間・時間クエリの応答改善、資源競合の抑制、変更中のデータ整合性維持を主要な優先事項とした。</p>\n<p><strong>行動.</strong> 1. <strong>インデックス:</strong> 利用者ID、テナントID、位置座標など、頻繁に問い合わせる列を分析し、適切なインデックスを作った。空間データにはGiSTを、電力データのテナントIDと日付範囲など複数列の絞り込みには複合インデックスを導入した。\n2. <strong>パーティション:</strong> 電力テーブルを日・月単位の時間範囲で分割し、問い合わせ対象のデータ量を減らして走査を効率化した。地理情報にはハッシュ分割を使い、ノード間で負荷を均等化した。\n3. <strong>クエリ最適化:</strong> 全件走査を避けるよう複雑なクエリを書き換え、頻繁に使うデータセットにCTE(共通テーブル式)とマテリアライズドビューを用いた。<code>EXPLAIN ANALYZE</code>で非効率な結合・サブクエリを特定し、よりよい実行計画へ再構成した。キャッシュと接続プールで余分な負荷も減らした。</p>\n<p><strong>結果.</strong> クエリ応答が10倍改善し、認証や位置検索などの重要処理がミリ秒単位で動くようになった。資源使用量は40%減り、増えるデータを性能低下なく扱えるようになった。利用者からも操作が滑らかになったと報告され、将来の成長への拡張性が高まった。ハードウェア更新の必要性も減り、長期的な信頼性を保ちながら費用を抑えた。計画的なインデックス、分割、クエリ改善が、低負荷のシステムさえ効率的で将来に備えるデータベースへ変えられることを示した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "PostgreSQL", "SQL", "データベース", "データエンジニアリング", "性能改善", "データベース管理(DBA)", "データベース性能改善" ] }, { "id": "https://engineer.company/ja/portfolio/automated-gis-saas-deployment-with-github-actions/", "url": "https://engineer.company/ja/portfolio/automated-gis-saas-deployment-with-github-actions/", "title": "GitHub ActionsでGIS SaaSのデプロイを自動化", "summary": "GitHub Actions CI/CD、Python、Bash、SQLでGIS SaaSのデプロイ、データ処理、報告を自動化し、短く確実なリリースを実現した。", "content_html": "<p><strong>状況.</strong> GIS SaaSアプリのデプロイ、データ処理、レポート作成がすべて手動だった。手動工程は遅いうえ、気づきにくい危険も伴う。毎回のリリースが技術者の時間を使い、ミスの可能性を抱え、繰り返すデータ・報告作業が週ごとにチームの余力を消費していた。</p>\n<p><strong>課題.</strong> コードから本番までの経路全体と、定期的なデータ処理・報告を自動化することが課題だった。毎回慎重な手作業を行うのではなく、速く、安全で、繰り返せるリリースを目指した。</p>\n<p><strong>行動.</strong> 経路全体を自動化した。GitHub Actionsがテスト・ビルド・デプロイを担い、手順を誰かが覚えていることへの依存をなくした。反復的なデータ処理とレポートはPython、Bash、SQLの定期ジョブに移し、誰かの雑務ではなく、自動で動くようにした。設定と秘密情報も標準化し、全環境が同じ動作をするよう整えた。本番と異なる「自分の端末」という状態をなくすことで、「手元では動く」という想定外を排除した。</p>\n<p><strong>結果.</strong> デプロイ、データ処理、報告が自動で確実に動くようになり、手作業の負担がチームから取り除かれ、リリース周期も短縮した。周辺の運用ではなく、製品へ注意を向けられるようになった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "GIS・地理空間情報", "Python", "SQL", "データエンジニアリング", "データパイプライン(ETL/ELT)", "クラウド", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "GIS・地理空間ソリューション", "データパイプライン開発(ETL/ELT)" ] }, { "id": "https://engineer.company/ja/portfolio/ran-20-docker-apps-on-google-cloud-and-aws/", "url": "https://engineer.company/ja/portfolio/ran-20-docker-apps-on-google-cloud-and-aws/", "title": "Google Cloud・AWSでDockerアプリ20個を運用", "summary": "Google CloudとAWSでDockerアプリ20個をデプロイ・保守し、PodmanとKubernetesで問題を調査して安定したリリースを支えた。", "content_html": "<p><strong>状況.</strong> Rの分析アプリを含め、コンテナ化したアプリケーションが増え、Google CloudとAWSにまたがって動いていた。2つのクラウドと複数のコンテナランタイムで、一貫してデプロイし、問題を素早く診断する必要があった。どの環境も少しずつ違うなかでは、簡単ではなかった。</p>\n<p><strong>課題.</strong> クラウドやランタイムをまたいでワークロードを確実にデプロイ・保守し、問題を迅速に診断できるようにすることが仕事だった。</p>\n<p><strong>行動.</strong> 両クラウドのコンテナ環境を管理し、20個のDockerアプリケーションを、個別にばらばらの状態ではなく、共通の設定と監視で導入・保守した。問題の調査にはPodman、オーケストレーションのデバッグにはKubernetesを用いた。Rの分析アプリはGoogle Cloud・AWSの本番環境で特に注意を払い、安定性と再現性を維持した。分析において、再現できない結果の価値は限られるためだった。</p>\n<p><strong>結果.</strong> 両クラウドのコンテナ環境が安定して動き、診断が速くなり、デプロイは安定性と再現性を保った。製品を支えるアプリケーションが、どちらのクラウド上でも信頼できる状態となった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "インフラ", "データ分析", "クラウド", "コンテナ(Docker/Kubernetes)", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "クラウドインフラ・移行", "コンテナ化・オーケストレーション" ] }, { "id": "https://engineer.company/ja/portfolio/led-a-gis-map-application-to-10x-revenue-growth/", "url": "https://engineer.company/ja/portfolio/led-a-gis-map-application-to-10x-revenue-growth/", "title": "GIS地図アプリの開発を主導し売上を10倍に", "summary": "基盤の中核となるGIS地図アプリケーションの開発を主導し、追加販売とデータライセンスにより売上を10倍にした。", "content_html": "<p><strong>状況.</strong> 太陽光パネルや風力タービンなどの再生可能エネルギー資産を追跡・監視・最適化する基盤の構築が中心課題だった。しかし初期版は地理空間機能が弱く、顧客が資産の位置を可視化し、空間データを分析し、行動につながる知見を得ることが難しかった。経営側はこの不足を認識し、価値を高め、変化する顧客ニーズに応えるため、GIS(地理情報システム)地図アプリの開発を優先した。</p>\n<p><strong>課題.</strong> 競争の激しいグリーンエネルギー市場で製品を差別化するGISアプリの開発を主導することが課題だった。役割はソフトウェア開発にとどまらず、技術責任者、DevOpsエンジニア、データエンジニア、SREを兼ね、会社の成長と方向を合わせる必要があった。SaaS基盤と自然に連携し、資産位置、性能指標、空間データに基づく判断を利用者に提供する、直感的で拡張可能なGISツールを目指した。成長中のスタートアップの制約と技術的な工夫を両立し、会社とともに発展できる製品にする必要があった。</p>\n<p><strong>行動.</strong> 関係者と協働して主要機能を定め、既存SaaSとの連携とリアルタイムの可視化を重視した。小さなチームに合わせ、オープンソースGISライブラリによる、軽量で拡張可能なモジュール構成を設計した。信頼性のため、CI/CD、インフラ構築の自動化、監視も導入した。拡大に伴い、新しい技術者を育成し、部門間の協働を促し、利用者の意見を優先して反復的に改善した。基本的な試作から、高度な分析と専用ダッシュボードで顧客の要望に応える基盤へ発展させた。</p>\n<p><strong>結果.</strong> GISアプリはSaaS基盤の中核となり、追加販売、データライセンス、新規顧客の獲得で売上を10倍にした。再生可能エネルギー資産のリアルタイム可視化が顧客の運用効率を高め、継続的な改善によって主要なデータ資産に位置づけられた。再生可能エネルギー分野での会社の評価を確立するとともに、変化の速いスタートアップで複数分野を組み合わせる価値を示した。技術力と戦略的な視点を合わせることで、長期的な成長と革新を促す主要な差別化要素になった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "GIS・地理空間情報", "チームの統率", "ソリューション設計", "プラットフォーム設計", "フルスタック開発", "プロダクト・要件", "技術面の統率", "指導・育成", "信頼性・バックアップ", "GIS・地理空間ソリューション", "プラットフォーム・ソリューション設計", "フルスタックのプロダクト開発", "プロダクト戦略・要件定義", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/directed-full-stack-gis-map-development/", "url": "https://engineer.company/ja/portfolio/directed-full-stack-gis-map-development/", "title": "フルスタックのGIS地図開発を指揮", "summary": "PostgreSQL、Mapbox、React、Node.jsによるフルスタックのGIS地図開発を指揮し、統合され拡張可能な基盤の中核を提供した。", "content_html": "<p><strong>状況.</strong> GIS地図は、機能の1つではなく、顧客がログインする理由になっていた。ただし、各部分が別々に育っていた。空間データはPostgreSQL、描画はMapbox、周辺アプリはReactJSとNodeJSで、個々には動いても、組み合わせを前提につくられておらず、継ぎ目が目立ち始めていた。</p>\n<p><strong>課題.</strong> データモデル、描画、API、Reactフロントエンドを含む地図のフルスタック開発と、技術的な方向づけを担った。同じリポジトリに偶然収まった4つの仕組みを、責任を持てる1つの製品にすることが目標だった。</p>\n<p><strong>行動.</strong> 最初に設計を定め、その後も遠くから指示するのではなく、コードの近くで作業した。データ側ではPostgreSQLの空間モデルを整え、データが増えてもクエリが極端に遅くならないようにした。Mapboxには一度にすべてを渡さず、拡大率に合った適切なデータを渡した。ReactJS・NodeJSの実装をレビューし、共通の規約へ導き、層の責任が別の層に漏れ始めたら本来の場所へ戻した。多くは、小さな不一致が固定的な構成になる前に捉える、目立たない仕事だった。</p>\n<p><strong>結果.</strong> データ、描画、画面が同じ方向へ働く、統合された地図アプリケーションとなった。基盤の中核となり、レイヤーを加えるたびに破綻することなく、継続的に拡張できる製品になった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "GIS・地理空間情報", "PostgreSQL", "データベース", "バックエンド開発", "プラットフォーム設計", "フルスタック開発", "フロントエンド開発", "技術面の統率", "性能改善", "GIS・地理空間ソリューション", "バックエンド・API開発", "フルスタックのプロダクト開発", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/optimized-forecasting-and-investment-strategies/", "url": "https://engineer.company/ja/portfolio/optimized-forecasting-and-investment-strategies/", "title": "予測と投資戦略を最適化", "summary": "データに基づくGISで11社の電力系統運用事業者の予測・投資戦略を改善し、信頼できる的を絞った計画を支えた。", "content_html": "<p><strong>状況.</strong> 電力系統運用事業者にとって、網のどこを強化し、どこへ投資するかの判断は極めて重要だった。11事業者が、十分な地理空間分析なしでその判断を行っていた。運用データはあったが、実際のパターンが現れる地図上で見る手段がなかった。</p>\n<p><strong>課題.</strong> GISで予測と投資戦略を精緻化し、観測値の表を、容量が逼迫する場所、リスクが高まる場所、次の投資が最も有効な場所を示すものへ変えることが仕事だった。</p>\n<p><strong>行動.</strong> 運用データと地理空間モデリングを統合し、互いを補強する形にした。抽象的に予測するのではなく、網を空間的に見て、限界に近づく区間や、優先して投資すべき地域を具体的に問えるようにした。11事業者に同じひな形を配って適合を期待するのではなく、それぞれの実際の運用に分析を合わせた。</p>\n<p><strong>結果.</strong> 事業者は、信頼できる予測と、期待任せではない的を絞った投資判断を得た。地図が示す事実を基礎にすることで計画が効率化し、慣習ではなくデータが示す場所に資金と注意を向けられるようになった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "データエンジニアリング", "データ分析", "プロダクト・要件", "関係者との調整・報告", "GIS・地理空間ソリューション", "データ分析・BIダッシュボード", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/gathered-and-analyzed-business-requirements/", "url": "https://engineer.company/ja/portfolio/gathered-and-analyzed-business-requirements/", "title": "業務要件を収集・分析", "summary": "業務要件をデータガバナンス基準に沿う明確な機能とユーザーストーリーへ変換し、曖昧さと手戻りを減らした。", "content_html": "<p><strong>状況.</strong> 要件は会話として届くことが多かった。誰かが大まかに何かを求め、境界の解釈は開発者に委ねられていた。推測は手戻りを生み、手戻りは開発における極めて高価な進め方だった。</p>\n<p><strong>課題.</strong> 業務側と技術側の間に立ち、曖昧な要望を、開発者が推測せず取り組める作業に変え、その過程でデータガバナンス基準に合わせることが役割だった。</p>\n<p><strong>行動.</strong> 関係者と直接要件を詰め、難しい質問をあとで発見せず早い段階で尋ね、「完了」の意味が伝わる機能・ユーザーストーリーとして記述した。便利でもデータの扱いを誤る機能は完成していないため、それぞれをガバナンス規則と照合した。読んだ人が最初から適切なものを構築できることを目指した。</p>\n<p><strong>結果.</strong> 不十分に理解した依頼ではなく、明確で合意済みの機能に基づいて開発が進んだ。曖昧さと手戻りが減り、後からガバナンスに合わせるのではなく、その範囲内で実際の業務目標に向かう提供を維持した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "アジャイル・Scrum", "データガバナンス", "プロジェクト管理", "プロダクト・要件", "関係者との調整・報告", "文書作成", "データガバナンス・品質管理", "プロジェクト管理(アジャイル)", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/managed-30-successful-gis-projects-to-delivery/", "url": "https://engineer.company/ja/portfolio/managed-30-successful-gis-projects-to-delivery/", "title": "GISプロジェクト30件を提供まで管理", "summary": "GISプロジェクト30件を成功させ、一貫した新しい解決策の提供により、顧客の継続的な信頼を獲得した。", "content_html": "<p><strong>状況.</strong> 会社はGISプロジェクトの提供で収益を得ており、多数を同時進行していた。成長を支えるには、代表作1件を見事に仕上げるだけでなく、一連の案件を期限内に、まとまった品質で継続して届ける必要があった。それにはチームの調整が実際に機能していなければならなかった。</p>\n<p><strong>課題.</strong> 全体の範囲、人員、日程をそろえ、チームに提供までの方向を示して、案件群を完成させることが責任だった。</p>\n<p><strong>行動.</strong> 数年間で30件のGISプロジェクトの提供を担当した。範囲が広がろうとするときに保ち、適任者を適切な仕事へ配し、問題が小さいうちに気づける距離で各案件を見た。遅れが見込まれれば、締め切りに知るより早く把握して調整した。多くは、複数の仕事を動かし続け、何がいつ届くかについて顧客の期待を実態に合わせる仕事だった。</p>\n<p><strong>結果.</strong> 30件すべてを提供した。個別の1件以上に、その一貫性が重要だった。30回の提供を見た顧客は31回目を不安に思わず、その評価が会社の継続的な成長を支えた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "アジャイル・Scrum", "チームの統率", "プロジェクト管理", "関係者との調整・報告", "GIS・地理空間ソリューション", "チームづくり・人材育成", "プロジェクト管理(アジャイル)" ] }, { "id": "https://engineer.company/ja/portfolio/led-company-growth-from-4-to-14-employees/", "url": "https://engineer.company/ja/portfolio/led-company-growth-from-4-to-14-employees/", "title": "従業員4人から14人への成長を主導", "summary": "アジャイルの実践を取り入れ、従業員4人から14人への会社の成長を主導した。品質やチームの一体感を損なうことなく、チームの規模を拡大した。", "content_html": "<p><strong>状況.</strong> 会社が成長する段階に入り、人の増加に工程の整備が追いつかず、品質と仕事の進め方の共通理解が弱まる危険があった。全員の仕事がわかる4人と、そうではない14人では、状況が大きく違った。</p>\n<p><strong>課題.</strong> 人を迎えながら、規律ある提供と、同じ方向へ進むチームを維持し、その成長を主導することが仕事だった。</p>\n<p><strong>行動.</strong> 4人から14人へ拡大した。採用と受け入れは場当たり的に急ぐのではなく計画的に進めた。さらに重要なのは、この規模でも互いの妨げにならない進め方を整えることだった。アジャイルな実務、実質的なプロジェクト管理、互いの仕事を見えるようにする習慣を導入した。10人目や14人目が、仕事の方法を推測せず、すでに形のある環境に入れるようにした。</p>\n<p><strong>結果.</strong> 品質を落としたり、他の人の仕事が見えない分断を起こしたりせず、14人に到達した。工程を人数増加に遅れさせず、ともに育てるアジャイルな側面が、大きくなったチームの生産性を保った。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "アジャイル・Scrum", "チームの統率", "プロジェクト管理", "技術面の統率", "指導・育成", "チームづくり・人材育成", "プロジェクト管理(アジャイル)", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/improved-team-communication-and-collaboration/", "url": "https://engineer.company/ja/portfolio/improved-team-communication-and-collaboration/", "title": "チームの意思疎通と協働を改善", "summary": "Slack、Mattermost、1Password、Jiraの導入で約8,000時間を削減し、情報探しや作業のやり直しを実際の成果へ変えた。", "content_html": "<p><strong>状況.</strong> チームの拡大に意思疎通とツールが追いつかなくなっていた。必要な人が情報を見逃し、他の人の完了作業が見えないため重複し、調整が仕事そのものより長くかかっていた。日々は見えにくい摩擦でも、失う時間は大きかった。</p>\n<p><strong>課題.</strong> 意思疎通と協働を改善し、摩擦によって静かに失っていた時間を取り戻すことを目指した。</p>\n<p><strong>行動.</strong> ツールを導入・統一し、確認先を増やすだけにならないよう、使い方も定めた。連絡はSlackとMattermost、共有する秘密情報は追跡不能な方法で渡さず1Passwordへ、作業は人の頭や受信箱ではなくJiraの1か所へまとめた。導入自体より、全員が実際に同じ使い方をすることが本当の仕事だった。</p>\n<p><strong>結果.</strong> 意思疎通と協働は明らかに改善し、整えた仕組みで約8,000時間の作業を削減した。情報探しややり直しに使っていた時間を、実際の提供に回せるようになった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "アジャイル・Scrum", "チームの統率", "セキュリティ", "プロジェクト管理", "自動化・CI/CD", "文書作成", "チームづくり・人材育成", "セキュリティ・アクセス管理", "プロジェクト管理(アジャイル)" ] }, { "id": "https://engineer.company/ja/portfolio/led-30-gis-projects-from-build-to-support/", "url": "https://engineer.company/ja/portfolio/led-30-gis-projects-from-build-to-support/", "title": "30件以上のGIS開発を構築からサポートまで主導", "summary": "PostgreSQL、Python、GDAL、ArcGIS、PostGIS、Mapboxで、30件以上のGISプロジェクトの開発・デプロイ・サポートを一貫して主導した。", "content_html": "<p><strong>状況.</strong> 会社の提供物はすべて、顧客固有の課題に合わせたGIS、地図、空間システムであり、公開後の運用も含まれていた。構築は半分にすぎず、本番に出してすぐ動かなくなる地理空間プロジェクトは、提供を完了したとはいえなかった。</p>\n<p><strong>課題.</strong> 幅広い技術構成の方向を定めながら、開発、デプロイ、稼働後のサポートまで、プロジェクト全体を一貫して担当した。</p>\n<p><strong>行動.</strong> 30件以上のGISプロジェクトで、全技術層を自ら扱いながら提供した。空間データはPostgreSQLとPostGIS、shapefile、GeoJSON、GeoTIFF、KML、ベクトルタイルなどの形式間移動はGDAL/OGR、データ作業はQGIS・JOSMを使用した。Web地図はMapbox GL・Leafletで構築し、ArcGIS・HERE APIと接続する場合もあった。アプリケーション層にはJavaScript、Python、PHP、SQLを用いた。対象は2D・3D地図、LiDAR処理、幾何補正、ベクトル化、屋内地図、ナビゲーションまで広がった。責任は公開を越えて続き、デプロイと本番サポートも担うため、問題を引き渡して終わりにはせず、自らの判断の結果を引き受けた。</p>\n<p><strong>結果.</strong> この幅広い範囲で30件以上を構築・デプロイ・サポートした。構築だけでなくライフサイクル全体に責任を持つことが品質を実直に保った。壊れた際の連絡を自分が受けると知っていれば、設計の仕方も変わる。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "PostgreSQL", "Python", "SQL", "Web開発", "チームの統率", "データベース", "データエンジニアリング", "バックエンド開発", "フルスタック開発", "技術面の統率", "信頼性・バックアップ", "GIS・地理空間ソリューション", "データパイプライン開発(ETL/ELT)", "バックエンド・API開発", "フルスタックのプロダクト開発", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/contributed-to-user-interface-design-processes/", "url": "https://engineer.company/ja/portfolio/contributed-to-user-interface-design-processes/", "title": "ユーザーインターフェースの設計に貢献", "summary": "設計の段階で使いやすさについて問いを重ね、UIの設計に貢献した。直感的に操作でき、完成度が高く、利用者にとって扱いやすいインターフェースを実現した。", "content_html": "<p><strong>状況.</strong> プロジェクト間で画面の品質にばらつきがあった。良いものもあれば、使う人よりデータモデルを考えてつくられたものもあり、設計判断が必ずしも利用者を意識して行われていなかった。特にWeb地図では、地図自体より、周囲の操作、絞り込み、流れで人が迷っていた。</p>\n<p><strong>課題.</strong> 単に機能するだけでなく、直感的で心地よい画面にするため、UI設計の工程へ関わることも役割に含まれた。</p>\n<p><strong>行動.</strong> デザイナーそのものの役割ではなかったが、技術の視点から設計に参加し、配置、作業の流れ、その画面が本当に明確なのか、つくった人が慣れているだけなのかを問いかけた。Mapbox・Leaflet地図上のReact、Angular、Vueフロントエンドで、データの絞り込み、屋内地図の階の移動、処理中の状態表示など、細部が使いやすさを左右した。公開後に混乱が問い合わせとなる前に、まだ安く直せる設計時点で、初めて使う人の素朴な疑問を投げかけることが中心だった。</p>\n<p><strong>結果.</strong> 直感性と完成度が高まり、利用者が直接その改善を感じ、提供物全体の品質が向上した。公開後ではなく設計中に使いやすさを問うことが、主な違いを生んだ。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "GIS・地理空間情報", "UX・UI設計", "Web開発", "デザインシステム・UI", "フロントエンド開発", "UI/UX設計・デザインシステム" ] }, { "id": "https://engineer.company/ja/portfolio/guided-company-projects-through-development/", "url": "https://engineer.company/ja/portfolio/guided-company-projects-through-development/", "title": "社内プロジェクトの開発を支援", "summary": "難しいソフトウェア開発段階で専門的に支援し、多くの社内プロジェクトの実行を導いて着実な提供を支えた。", "content_html": "<p><strong>状況.</strong> 多くのプロジェクトが同時に開発中で、方向を保つ継続的な技術支援を必要としていた。放置すると進路がずれ、初期の誤った方法は、気づくころには修正費用が高くなる。</p>\n<p><strong>課題.</strong> 開発段階を通してチームが頼れる技術的支援となり、実行を導くことが仕事だった。</p>\n<p><strong>行動.</strong> 多数の社内プロジェクトに同時に実務で関わり続けた。行き詰まりを解消し、その上に多くを構築する前に方法を吟味し、作り直しではなく進路修正で済むうちに、誤った方向へ向かう兆しを捉えた。すべてを1人待ちにする関門ではなく、必要なときに支援して進められる存在を目指した。</p>\n<p><strong>結果.</strong> 適切な時点で経験者を頼れることで、難しい開発段階をより円滑に進め、会社の案件群全体で提供を安定させた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "チームの統率", "プロジェクト管理", "技術面の統率", "指導・育成", "チームづくり・人材育成", "プロジェクト管理(アジャイル)", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/overhauled-internal-processes-saving-8000-hours/", "url": "https://engineer.company/ja/portfolio/overhauled-internal-processes-saving-8000-hours/", "title": "業務工程の刷新で8,000時間を削減", "summary": "社内の業務プロセスを見直して刷新し、約8,000時間を削減した。ソフトウェアのアーキテクチャとシステムを改善し、日程管理も効率化した。", "content_html": "<p><strong>状況.</strong> 社内の仕事には、設計より継ぎ足しで育ったソフトウェア、動くが効率的ではないシステム、待ち時間や過負荷を生む日程管理など、よくある不要な複雑さが積み重なっていた。急を要する状態ではなかったからこそ放置され、静かに多くの時間を費やしていた。</p>\n<p><strong>課題.</strong> 無駄に費用を払い続けるのではなく、見つけて取り除くため、工程を抜本的に見直すことを目指した。</p>\n<p><strong>行動.</strong> 3つの面で工程を見直した。ソフトウェア構成は、回避して使うのではなく理解して拡張できるものにした。システムは、定型作業が必要以上に長くかからないよう整理した。日程管理は、実際の能力と作業量を合わせた。全員がうなずいて忘れるメモではなく、日々の運営に組み込み、変更を定着させた。恒久化しない工程改善は、元の方法へ戻るためだった。</p>\n<p><strong>結果.</strong> 設計、システム、日程管理の実質的な効率化で約8,000時間を削減した。誰も疑問を持たなかった間接作業ではなく、より価値の高い仕事に、その余力を直接戻せた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "インフラ", "ソリューション設計", "プラットフォーム設計", "プロジェクト管理", "技術面の統率", "自動化・CI/CD", "性能改善", "DevOps・CI/CD自動化", "プラットフォーム・ソリューション設計", "プロジェクト管理(アジャイル)", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/administered-network-infrastructure/", "url": "https://engineer.company/ja/portfolio/administered-network-infrastructure/", "title": "ネットワークインフラを管理", "summary": "1,000台以上のサーバーのネットワークインフラを管理し、確実な構築、適切なセキュリティ、迅速な問題解決を支えた。", "content_html": "<p><strong>状況.</strong> 会社の業務は1,000台を超えるサーバー群に支えられており、この規模の環境は放っておいても安定しない。構築、セキュリティ、次々に生じる不具合を規律を持って運用しなければ、原因も明確でない不安定さが広がってしまう。</p>\n<p><strong>課題.</strong> 不一致が致命的になり得る規模で、ネットワークインフラの安全性、信頼性、一貫性を保つことが仕事だった。</p>\n<p><strong>行動.</strong> 1,000台を超えるサーバーのネットワークを管理した。個別の独自構成ではなく、同じ予測可能な状態で立ち上がるよう構築手順を標準化した。誰も狙わないことを期待せずセキュリティを堅牢化し、故障時には問題を調査した。この規模では標準化が運用を支える。1,000の特殊構成は管理できなくても、同じ構成が1,000あれば、定型の仕事として扱える。</p>\n<p><strong>結果.</strong> 確実な構築、堅実なセキュリティ、放置せず迅速に解決する問題対応を備える環境となった。うまく動くと見えないが、それこそが目的であり、会社のすべてを支える安定した基盤だった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "システム管理", "セキュリティ", "ネットワーク・VPN", "自動化・CI/CD", "信頼性・バックアップ", "セキュリティ・アクセス管理", "ネットワーク・VPN構築" ] }, { "id": "https://engineer.company/ja/portfolio/streamlined-ci-cd-processes-saving-4000-hours/", "url": "https://engineer.company/ja/portfolio/streamlined-ci-cd-processes-saving-4000-hours/", "title": "CI/CDの効率化で4,000時間を削減", "summary": "CI/CDを効率化して約4,000時間を削減し、リリースを迅速・確実にして、安心して提供できるようにした。", "content_html": "<p><strong>状況.</strong> ソフトウェアの公開は、担当者が順序を覚え、毎回少しずつ違う操作をする手動工程に依存していた。リリースが遅くなり、本来開発に使うべき技術者の時間を費やしていた。</p>\n<p><strong>課題.</strong> CI/CDを効率化し、最初から最後まで自動化して、リリースを毎回の手作業の儀式から変えることを目指した。</p>\n<p><strong>行動.</strong> ビルド、テスト、デプロイを自動化し、変更から本番稼働までを、即興ではなく標準の経路にした。遅く、担当者によってやり方も変わる反復的な手動工程を除去した。毎回同じ方法で動く自動化により、「手元では動いた」問題や、曖昧に覚えたデプロイ手順による失敗の一群が起こらなくなった。</p>\n<p><strong>結果.</strong> 約4,000時間を取り戻し、リリースを速く確実にした。全員が注意深いことではなく工程の一貫性が根拠となり、身構えずに提供できるようになった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "テスト・品質保証", "技術面の統率", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/saved-4000-hours-with-github-and-gitlab-ci-cd/", "url": "https://engineer.company/ja/portfolio/saved-4000-hours-with-github-and-gitlab-ci-cd/", "title": "GitHub・GitLab CI/CDで4,000時間を削減", "summary": "GitHub、GitLab、Bash、PythonのCI/CDを導入し、データ分析・開発の速度と一貫性を高めて約4,000時間を削減した。", "content_html": "<p><strong>状況.</strong> データ分析とソフトウェア開発の両方が、手動工程に阻まれていた。開発から提供までの流れは遅く不統一で、分析にも毎回手で行う反復作業が積み重なっていた。</p>\n<p><strong>課題.</strong> まだ自動化されていない作業手順へ、現代的な自動化とCI/CDを導入し、両方を効率化することを目指した。</p>\n<p><strong>行動.</strong> GitHub・GitLabを基盤とし、Bash・Pythonで自動化するCI/CDを導入した。分析・開発双方の反復工程を自動化し、プロジェクトごとに作り直さず、毎回同じ方法で開発から提供まで進むよう標準化した。別の、より手動的な世界として扱われていた分析を、開発と同じ規律ある工程へ組み込むことが重要な部分だった。</p>\n<p><strong>結果.</strong> 約4,000時間を削減し、データ分析とソフトウェア開発の両方を迅速化した。提供物の一貫性も高まり、毎回少し違う方法による想定外が減った。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "Python", "データエンジニアリング", "データパイプライン(ETL/ELT)", "データ分析", "自動化・CI/CD", "DevOps・CI/CD自動化", "データパイプライン開発(ETL/ELT)", "データ分析・BIダッシュボード" ] }, { "id": "https://engineer.company/ja/portfolio/developed-a-data-analytics-reporting-system/", "url": "https://engineer.company/ja/portfolio/developed-a-data-analytics-reporting-system/", "title": "データ分析レポートシステムを開発", "summary": "明確でタイムリーなPDFレポートを作るPythonデータ分析システムを構築し、四半期ソフトウェア売上を400%増加させた。", "content_html": "<p><strong>状況.</strong> 関係者へ、時機に合う読みやすい形で分析結果が届いていなかった。データはあっても判断に使える形への変換が遅く手動だったため、状況の把握が遅れ、商業上の判断も遅れていた。</p>\n<p><strong>課題.</strong> 毎回手でまとめなくても、生データを明確で定期的な知見へ変える、データ分析レポートシステムを構築することが仕事だった。</p>\n<p><strong>行動.</strong> PythonでPDFレポートを生成し、データ取得、分析、読みやすい一貫した形式での提示までを自動化した。定期性と明確さを重視し、同じ品質のレポートが予測どおり届き、わざわざ探すのではなく、日常的に数値を見る状態をつくった。</p>\n<p><strong>結果.</strong> このレポートが四半期ソフトウェア売上の400%増につながった。速く優れた分析は単なる裏方の利便ではなく、意思決定者に明確な数値を適時に示すことで判断を改善し、その効果が売上に直接現れた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "データエンジニアリング", "データ分析", "バックエンド開発", "プロダクト・要件", "関係者との調整・報告", "自動化・CI/CD", "データ分析・BIダッシュボード", "バックエンド・API開発", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/automated-data-processing-in-python-and-pl-pgsql/", "url": "https://engineer.company/ja/portfolio/automated-data-processing-in-python-and-pl-pgsql/", "title": "PythonとPL/pgSQLでデータ処理を自動化", "summary": "Shell、PL/pgSQL、Python、Transact-SQLでデータ処理を自動化し、生産性を高めて小さな反復ミスを解消した。", "content_html": "<p><strong>状況.</strong> 繰り返すデータ処理が継続的に手作業で行われていた。時間を使うだけでなく、同じ作業を何度も手で行えば少しずつ方法が変わり、その違いの一部が誤りになるという、二重の問題があった。</p>\n<p><strong>課題.</strong> 作業を自動化し、時間を取り戻すとともに、確実に実行できるようにすることを目指した。</p>\n<p><strong>行動.</strong> 対象のデータベースとシステムをまたいで、仕事に適した道具で自動化した。接続にはShell、データベース内にはPL/pgSQL・Transact‑SQL、SQLだけでは足りない処理にはPythonを用いた。手動工程を毎回同じ動作のジョブへ置き換えた。スクリプトは退屈せず、手順を飛ばさず、金曜の午後だからと方法を変えないことが意味を持った。</p>\n<p><strong>結果.</strong> 生産性と効率が高まり、人の手作業負担が減った。データ処理は、小さな反復ミスの原因ではなく、一貫して頼れるものになった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "PostgreSQL", "Python", "SQL", "データベース", "データエンジニアリング", "データパイプライン(ETL/ELT)", "自動化・CI/CD", "DevOps・CI/CD自動化", "データベース管理(DBA)", "データパイプライン開発(ETL/ELT)" ] }, { "id": "https://engineer.company/ja/portfolio/saved-150-hours-a-month-across-30-projects/", "url": "https://engineer.company/ja/portfolio/saved-150-hours-a-month-across-30-projects/", "title": "30プロジェクト全体で月150時間を削減", "summary": "30プロジェクト全体で作業の進め方とリソース管理を最適化し、毎月約150時間を削減した。プロジェクト群全体に及ぶ、継続的な時間削減となった。", "content_html": "<p><strong>状況.</strong> 約30件のプロジェクトで、未最適化の手順と偏った資源配分により、毎月時間を失っていた。手が余る人と過負荷の人がいて、計画方法も案件ごとに違っていた。</p>\n<p><strong>課題.</strong> 案件全体を効率化し、毎月失われる時間を取り戻すことを目指した。</p>\n<p><strong>行動.</strong> 30案件を見直し、手順と資源配分を同時に改善した。ボトルネックを除去し、いつも同じ人が制約にならないよう負荷を分散し、各案件を特殊事例にせず計画と実行を標準化した。30案件で少しずつ失う時間は積み重なるため、新奇な工夫より、良い実務を一貫して適用することが中心だった。</p>\n<p><strong>結果.</strong> 案件全体で月約150時間を削減した。一度限りではなく、30案件が毎月効率的に動く、継続的な削減となった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "アジャイル・Scrum", "チームの統率", "プロジェクト管理", "自動化・CI/CD", "性能改善", "チームづくり・人材育成", "プロジェクト管理(アジャイル)" ] }, { "id": "https://engineer.company/ja/portfolio/configured-and-deployed-1000-wi-fi-routers/", "url": "https://engineer.company/ja/portfolio/configured-and-deployed-1000-wi-fi-routers/", "title": "Wi‑Fiルーター1,000台を設定・導入", "summary": "標準構成に基づいて、1,000台のWi-Fiルーターの設定と導入を行った。顧客が利用する無線接続の信頼性と、安定した通信性能を確保した。", "content_html": "<p><strong>状況.</strong> 顧客は普通に使える無線接続を求めており、多数のWi‑Fiルーターを、毎回同じ丁寧さで設定・展開する必要があった。粗雑な設定は危険か遅さを生み、どちらかが後で発覚するためだった。</p>\n<p><strong>課題.</strong> 顧客の接続性と性能を改善するため、ルーターを設定・導入することが仕事だった。</p>\n<p><strong>行動.</strong> 1,000台のWi‑Fiルーターを設定・導入した。この台数では、その場で毎回一から調整するより、安全で妥当な共通設定を標準化することが重要だった。手作りの1,000台は、後で支援すべき1,000種類の構成になる。毎回同じ方法で安全性と性能を設定し、顧客拠点へ確実に展開した。</p>\n<p><strong>結果.</strong> 1,000台が安定した無線接続を提供し、接続性と性能を改善した。即興ではなく標準設定によって、一貫して提供できた。使う人が再び気にする必要のないルーターが目標であり、その大半で達成した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "インフラ", "システム管理", "セキュリティ", "ネットワーク・VPN", "信頼性・バックアップ", "ITサポート・ヘルプデスク", "ネットワーク・VPN構築" ] }, { "id": "https://engineer.company/ja/portfolio/managed-4000-computer-repairs/", "url": "https://engineer.company/ja/portfolio/managed-4000-computer-repairs/", "title": "コンピューター修理4,000件を管理", "summary": "4,000件のコンピューター修理でハード・ソフトの問題を迅速かつ的確に解決し、信頼できるサービスという評価を維持した。", "content_html": "<p><strong>状況.</strong> コンピューター修理が継続的に持ち込まれ、累計4,000件に達した。すべてに、端末を取り戻して日常へ戻りたい人がいた。ハード・ソフトのさまざまな故障があり、顧客は速さと修理の確実さで店を評価した。</p>\n<p><strong>課題.</strong> 修理を管理し、迅速に、そして同じくらい重要なこととして、正しく問題を解決し続けることが仕事だった。</p>\n<p><strong>行動.</strong> 4,000件の修理を扱い、ハード・ソフトの故障を診断し、端末が積み上がらず流れるよう工程を整え、翌週また故障する状態で返さず、正しく直す品質を保った。再修理は、遅い修理より悪い。顧客に再訪を強い、店の信頼を失うため、処理量は大事でも、初回で直すことを犠牲にはしなかった。</p>\n<p><strong>結果.</strong> 4,000件すべてを迅速に解決した。人々は動く端末を取り戻し、仕事や日常を再開できた。修理店の事業そのものである、確実なサービスへの評価を維持した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "システム管理", "プロジェクト管理", "ITサポート・ヘルプデスク", "機器修理・データ復旧" ] }, { "id": "https://engineer.company/ja/portfolio/administered-100-bare-bone-servers/", "url": "https://engineer.company/ja/portfolio/administered-100-bare-bone-servers/", "title": "ベアボーンサーバー100台を管理", "summary": "ベアボーンサーバー100台に加え、物理ネットワークとIP電話の管理を担当した。会社が成長を遂げるうえで土台となる、堅牢なインフラ基盤を提供した。", "content_html": "<p><strong>状況.</strong> 会社のあらゆる仕事の下には、サーバー、物理ネットワーク、IP電話があり、すべてが普通に動く必要があった。正常時には見えないこの層は、故障した瞬間に目立つ。会社の成長は、その信頼性にかかっていた。</p>\n<p><strong>課題.</strong> 会社の成長に応じて、インフラを管理し安定させることが仕事だった。</p>\n<p><strong>行動.</strong> ベアボーンサーバー100台と、物理ネットワーク、IP電話の構築、保守、問題解決を担当した。ハードウェアを直接扱うため、配線、機器、通話が途切れた瞬間に全員が気づく電話システムなど、物理的な実務もあった。良い意味で、すべてを平穏に保つことが仕事だった。</p>\n<p><strong>結果.</strong> サーバー、ネットワーク、電話が確実に稼働し、足元が揺らがない信頼できる物理基盤が、会社の継続的な成長を支えた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "システム管理", "ネットワーク・VPN", "信頼性・バックアップ", "ネットワーク・VPN構築" ] }, { "id": "https://engineer.company/ja/portfolio/developed-100-web-applications-using-html-html5/", "url": "https://engineer.company/ja/portfolio/developed-100-web-applications-using-html-html5/", "title": "HTML/HTML5でWebアプリケーション100個を開発", "summary": "HTML5、CSS/SCSS、Django、WordPress、Joomlaで100個のWebアプリケーションを開発し、それぞれを顧客の実際のニーズに合わせた。", "content_html": "<p><strong>状況.</strong> 顧客が求めるWebアプリケーションは、規模、予算、単にオンラインへ出たいのか、独自の仕組みが欲しいのかまで、さまざまだった。全員を同じ技術へ押し込むのではなく、柔軟に応える必要があった。</p>\n<p><strong>課題.</strong> 顧客ごとに多様で効果的なオンライン展開を可能にするWebアプリケーションを構築することが仕事だった。</p>\n<p><strong>行動.</strong> 100個のアプリケーションを、好みではなく仕事に道具を合わせて構築した。独自開発にはHTML/HTML5、CSS/SCSS、Django、標準的で顧客自身も管理できる仕組みには、速く妥当なWordPress・Joomlaを選んだ。不要な独自開発を勧めず、必要なときにはその必要性を説明できる見極めも、技量の一部だった。</p>\n<p><strong>結果.</strong> 100個それぞれを実際に適した技術で提供し、多様で十分な機能を持つオンライン展開を支えた。顧客を手法に合わせず、手法を顧客に合わせたことが、単なる納品ではなく効果につながった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "Web開発", "バックエンド開発", "フルスタック開発", "フロントエンド開発", "Webサイト・CMS開発", "フルスタックのプロダクト開発" ] }, { "id": "https://engineer.company/ja/portfolio/designed-30-websites-from-photoshop-to-html/", "url": "https://engineer.company/ja/portfolio/designed-30-websites-from-photoshop-to-html/", "title": "PhotoshopからHTMLへWebサイト30件を設計", "summary": "PhotoshopのデザインをHTMLへ変換して30件のWebサイトを設計し、独自性、完成度、保守性を備えたWebでの展開を実現した。", "content_html": "<p><strong>状況.</strong> 顧客は希望する外観、多くの場合は完成したビジュアルデザインを持ち込み、忠実なWebサイトへの実装を求めていた。デザインファイルと動くサイトの間で品質は大きく変わる。おおむね正しく見えながら、細部が違う実装は容易に起こる。</p>\n<p><strong>課題.</strong> サイトを設計し、正確で柔軟な実装へデザインを変換することが仕事だった。</p>\n<p><strong>行動.</strong> 30件のWebサイトを設計し、Photoshopのデザインを手作業でHTMLへ変換した。余白、文字、デザイナーが意図した細部を近似で済ませず、忠実にすることを基準とした。同時に柔軟性も求めた。見本とピクセル単位で一致しても、文章が変わると壊れるサイトでは良い実装とはいえないため、意図に忠実で、その後も保守できるマークアップを目指した。</p>\n<p><strong>結果.</strong> 30サイトはデザインを再現しながら、運用可能な状態を保った。初回の編集で壊れない、独自性と完成度のあるWebサイトになった。重視した、デザインへの忠実さと保守性の両立を実現した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "UX・UI設計", "Web開発", "デザインシステム・UI", "フロントエンド開発", "UI/UX設計・デザインシステム", "Webサイト・CMS開発" ] }, { "id": "https://engineer.company/ja/portfolio/administered-40-websites-on-apache-and-nginx/", "url": "https://engineer.company/ja/portfolio/administered-40-websites-on-apache-and-nginx/", "title": "Apache・NginxでWebサイト40件を管理", "summary": "Ubuntu Linux上のApache・Nginxで40件のWebサイトの可用性と性能を維持し、顧客が運用を気にせずに済むホスティングを提供した。", "content_html": "<p><strong>状況.</strong> 公開中の多数のWebサイトを、止めず、速く保つ必要があった。ホスティングも正常時には見えず、停止した瞬間には誰もが最も気にする仕事だった。</p>\n<p><strong>課題.</strong> 高い可用性と速度を維持しながら、これらのサイトを管理することが仕事だった。</p>\n<p><strong>行動.</strong> Ubuntu Linux上のApache・Nginxで40サイトを運用し、実際のアクセス下で信頼性を保つ設定、性能調整、継続的な保守を行った。利用がないときは正常でも、利用者が来ると倒れるサイトは、管理したのではなく放置したものにすぎない。実負荷のもとで健全に保つことが作業の中心だった。</p>\n<p><strong>結果.</strong> 40サイトすべてで高可用性と良好な性能を保ち、顧客が気にしなくても済むホスティングを提供した。実際の利用でも安定して頼れるという、ホスティング本来の目的を果たした。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Linux・サーバー", "Web開発", "インフラ", "システム管理", "信頼性・バックアップ", "性能改善", "Webサイト・CMS開発", "サイト信頼性・監視" ] }, { "id": "https://engineer.company/ja/portfolio/a-maritime-platform-built-in-clean-layers/", "url": "https://engineer.company/ja/portfolio/a-maritime-platform-built-in-clean-layers/", "title": "システムの境界を明確にした海事プラットフォーム", "summary": "Next.js PWA、Go(Huma/Fiber)API、業務ロジックをすべて収めるPostgreSQL関数層からなる多層の海事プラットフォームを設計した。", "content_html": "<p><strong>状況.</strong> NextMarinerは、専門家の交流、企業レビュー、教育支援を扱う海事プラットフォームである。創業者の設計面の貢献は、2025年11月に始まるNextMarinerでの業務に記録されている。記録は後の雇用期間を区別しておらず、製品全体をEngineer ApSが提供したと実証するものでもない。</p>\n<p><strong>課題.</strong> 設計者として、各種ロジックをどこに置くかを初めに決め、急いだときに曖昧になるのではなく、圧力のもとでも保てる明白な境界を設ける必要があった。</p>\n<p><strong>行動.</strong> それぞれ1つの仕事を持つ3層へ整理した。Next.jsは表示と操作だけを担当する。Fiber上のHumaによるGo APIは意図的に薄くし、経路制御、リクエスト検証、セキュリティフィルター、処理調整だけを行い、業務ロジックを持たせない。業務ロジックはすべてPostgreSQL関数に置き、完成した結果を組み立ててAPIへ返し、そのまま転送する。ルール変更はSQLの1層だけで済み、他の2層は意識しなくてよい。境界を文書化し、守られない規約にならないようレビューで適用した。</p>\n<p><strong>結果.</strong> 実装した構成は、表示、リクエスト処理、業務ルールに別々の責任を与えている。情報源はその分離と理由を記録しており、提供速度、信頼性、事業成果の測定済みの改善を実証するものではない。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "PostgreSQL", "データベース", "ソリューション設計", "バックエンド開発", "プラットフォーム設計", "フルスタック開発", "フロントエンド開発", "技術面の統率", "データベース設計・モデリング", "バックエンド・API開発", "プラットフォーム・ソリューション設計", "フルスタックのプロダクト開発" ] }, { "id": "https://engineer.company/ja/portfolio/designed-a-json-passthrough-from-postgres-to-api/", "url": "https://engineer.company/ja/portfolio/designed-a-json-passthrough-from-postgres-to-api/", "title": "PostgresからAPIへのJSONパススルーを設計", "summary": "PostgreSQL関数が返す完成したJSONをGo APIがそのまま転送する仕組みを設計し、フロントエンドをスキーマから切り離した。", "content_html": "<p><strong>状況.</strong> 通常、データベースからブラウザーへは、変換を連ねてデータを渡す。DBが行を返し、APIが構造体へ読み込み、形を変え、JSONへ再変換して、ようやく外へ送る。各段階にコードとテストが必要で、APIとDBの認識が食い違う場所も増える。</p>\n<p><strong>課題.</strong> この変換の中継を省くことを考えた。DBが完成した応答を返せば、APIはそのまま通し、フロントエンドもGo内の手作業で維持する複製ではなく、DBの構造に直接依存できる。</p>\n<p><strong>行動.</strong> 直接通過させる構成にした。PostgreSQL関数が、データのある場所で、SQLの責任としてJSON応答全体を組み立てる。Goハンドラーはjson.RawMessageで受け取り、分解も再符号化もせず転送する。小さなQueryJSON補助関数で、意識して覚えなくてもこの方法が最も簡単な実装になるようにした。従来の多層APIで増えるDTO、マッパー、応答構造体など、中間の仕組みが不要になった。</p>\n<p><strong>結果.</strong> ハンドラーが大幅に短くなり、特にフロントエンドとGoの結合がなくなった。関数の返す内容を変えれば、ハンドラーを1行も直さず新しい形がクライアントへ届く。可動部分が減り、層間の不一致という種類の問題自体が存在しなくなった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "PostgreSQL", "SQL", "データベース", "バックエンド開発", "プラットフォーム設計", "性能改善", "AIエージェント用ツール・MCPサーバー", "データベース設計・モデリング", "バックエンド・API開発", "プラットフォーム・ソリューション設計" ] }, { "id": "https://engineer.company/ja/portfolio/built-organization-context-switching-for-users/", "url": "https://engineer.company/ja/portfolio/built-organization-context-switching-for-users/", "title": "利用者の組織コンテキスト切り替えを構築", "summary": "localStorageとサーバーCookieへの複製で組織コンテキスト切り替えを構築し、最小権限の認可下で管理対象組織として操作できるようにした。", "content_html": "<p><strong>状況.</strong> 海事専門家の利用者が、独自のログインを持たない企業や教育機関を管理できるプラットフォームだった。アカウントは人にあり、組織はその人が代理する対象だった。アプリ全体で管理する組織として自由に切り替えて操作する必要があったが、便利さが認可の穴になってはいけなかった。</p>\n<p><strong>課題.</strong> 素早く邪魔にならない切り替えを実現するとともに、選択中のコンテキストだけで、本来ない権限を渡すことが絶対にないようにする必要があった。</p>\n<p><strong>行動.</strong> 両側に保存するOrganizationContextで扱った。クライアントでは、現在どの組織として操作するかの正本をlocalStorageとし、通信往復なしに即座に切り替える。サーバーCookieに複製し、SSRでも同じ状態を解決できるよう、getServerViewModeで読み取る。重要なのは、それらをアクセス判断では一切信頼しないことだった。毎リクエストでサーバーが認可を再検証する。画面側は適切なものを見せる体験のためにあり、実行可能な操作の決定権はサーバーだけが持つ。</p>\n<p><strong>結果.</strong> 利用者は管理するどの組織としても円滑に操作でき、クライアントとサーバーで表示がそろった。一方、権限は毎回サーバーで検証するため便利さが安全性を弱めない。localStorageを改変しても自分の画面が変わるだけで、サーバーは拒否を続ける。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "セキュリティ", "バックエンド開発", "プラットフォーム設計", "フルスタック開発", "フロントエンド開発", "セキュリティ・アクセス管理", "バックエンド・API開発", "プラットフォーム・ソリューション設計" ] }, { "id": "https://engineer.company/ja/portfolio/designed-a-function-first-postgresql-data-layer/", "url": "https://engineer.company/ja/portfolio/designed-a-function-first-postgresql-data-layer/", "title": "PostgreSQL関数中心のデータ層を設計", "summary": "34スキーマ・1,275個のストアド関数を持つPostgreSQL関数中心のデータ層を設計し、データベース自体でアクセス境界を適用した。", "content_html": "<p><strong>状況.</strong> 業務ロジックは漏れ出しやすい。APIの一部や、ハンドラー内で実行するSQLに分散し、同じルールが少しずつ異なる2通り、3通りで書かれ、データをどう扱うシステムかを指し示せる場所がなくなる。そこからバグやセキュリティの穴が生じる。</p>\n<p><strong>課題.</strong> ロジックの置き場を1つにし、すべての読み書きをデータベース経由にして、APIを業務ルールを知らない薄いアダプターに保ち、全体を厳密に制限することを目指した。</p>\n<p><strong>行動.</strong> 関数中心のデータ層にした。スキーマはidentity、organization、review、message、notificationと他29領域、計34に分け、アプリの全操作を1,275個のPostgreSQL関数経由にし、Goからテーブルへ直接アクセスさせない。データベースでこの境界を強制した。APIのログインロールmarinerにはアプリ関数のEXECUTEとスキーマのUSAGEだけを与え、SELECTもINSERTも直接操作も許さない。一括付与でなく約4,000件の明示的な権限を用いた。関数は、ログインできない別ロールfunction_ownerの所有で、固定search_pathを持つSECURITY DEFINERとして実行する。スーパーユーザーはマイグレーションとcron専用にし、稼働アプリから遠ざけた。</p>\n<p><strong>結果.</strong> 監査できる1か所にロジックがまとまり、APIは良い意味で薄く単調に保たれた。境界は全員の記憶でなくPostgres自体が守る。APIが侵害されても関数の許さない操作はできない。1,275関数では規律に実際の費用があり、新項目はクエリの1行でなく、マイグレーションと関数変更を要する。この摩擦が境界を保つ代償だった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "PostgreSQL", "SQL", "データベース", "データガバナンス", "セキュリティ", "バックエンド開発", "プラットフォーム設計", "データベース設計・モデリング", "データガバナンス・品質管理", "バックエンド・API開発", "プラットフォーム・ソリューション設計" ] }, { "id": "https://engineer.company/ja/portfolio/modeled-348-tables-across-34-postgres-schemas/", "url": "https://engineer.company/ja/portfolio/modeled-348-tables-across-34-postgres-schemas/", "title": "34のPostgresスキーマに348テーブルをモデル化", "summary": "海事領域を34個のPostgreSQLスキーマと348個の正規化テーブルにモデル化し、SMALLINT参照、UUID v7、統一命名を採用した。", "content_html": "<p><strong>状況.</strong> 基盤の中心には、専門家、企業、船舶、求人、レビューが常に互いを参照する密な海事領域があった。専門家は乗船し、企業で働き、レビューを書き、企業は船を所有し求人を掲載する。ほぼ全機能がこの関係網を横断するため、モデルの良し悪しが、性能と拡張のしやすさを左右した。</p>\n<p><strong>課題.</strong> 速度と整合性を保ち、新たなエンティティを加えるたびにスキーマと格闘しなくて済むモデルが必要だった。</p>\n<p><strong>行動.</strong> 領域別の正規化PostgreSQLスキーマ34個に、348テーブルを配置した。状態、型、分類など多数の小さく安定した列挙値は、各所へ文字列を保存せず、行を小さく結合を安くするSMALLINTの参照テーブルにした。主キーは全体で一意かつインデックス内で時系列順となるUUID v7にした。単数名のスキーマ内に複数形のテーブル名を置く共通規約を例外なく適用し、予約語との衝突も避けた。関係は実際の外部キー・制約で守り、整合性をアプリの記憶でなくDBの仕事にした。</p>\n<p><strong>結果.</strong> 速く一貫した、どこでも同じ規則が通り、覚える特殊事例のないモデルになった。多くの機能追加はスキーマと対立せず、既存の方向へ拡張することで済む。34スキーマを無秩序な広がりでなく構造として保ち、残りの基盤全体を支える土台となった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "PostgreSQL", "SQL", "データベース", "データエンジニアリング", "データガバナンス", "プラットフォーム設計", "性能改善", "AIが使えるデータの整備", "データベース設計・モデリング", "データガバナンス・品質管理", "プラットフォーム・ソリューション設計" ] }, { "id": "https://engineer.company/ja/portfolio/provisioned-azure-infrastructure-as-code/", "url": "https://engineer.company/ja/portfolio/provisioned-azure-infrastructure-as-code/", "title": "Azureインフラをコードとして構築", "summary": "BicepでContainer Apps、PostgreSQL、Front Door/WAFなどのAzureインフラをコード化し、開発・ステージング・本番で再現可能にした。", "content_html": "<p><strong>状況.</strong> プラットフォームはAzure上で動いていた。ポータルをクリックし個別に設定を変える手動運用は、ずれを生み、理由の記憶が失われ、障害後の再構築が遅く不安なものになる。複数環境をそろえる必要があれば、問題はさらに大きくなる。</p>\n<p><strong>課題.</strong> 手動状態の山ではなく、読んでレビューし、再現できる環境とするため、全体をコードにする必要があった。</p>\n<p><strong>行動.</strong> Bicepで環境を定義した。テスト、ステージング、本番は同じテンプレートから作る。管理環境上のAzure Container Appsで動くapi・www、PostgreSQL Flexible Server、キャッシュ用Redis、WAF方針付きFront Door、VNet・NSG・プライベートDNSのネットワークを含め、診断用Log Analyticsも接続した。イメージはプロジェクトのAzure Container Registryから取得する。すべてパラメーター化し、環境の新設・変更を、自分へのサポート依頼でなくpull requestにした。</p>\n<p><strong>結果.</strong> 再現とレビューが可能になった。正本はコードにあり、不一致は謎でなくなった。前回クリックした内容を思い出す代わりに、テンプレート適用で構築・復旧できる。インフラに振り回されるのでなく、自ら管理できる状態となった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "インフラ", "クラウド", "セキュリティ", "ネットワーク・VPN", "プラットフォーム設計", "自動化・CI/CD", "信頼性・バックアップ", "コードによるインフラ管理", "クラウドインフラ・移行", "セキュリティ・アクセス管理", "ネットワーク・VPN構築" ] }, { "id": "https://engineer.company/ja/portfolio/built-github-actions-ci-cd-pipelines/", "url": "https://engineer.company/ja/portfolio/built-github-actions-ci-cd-pipelines/", "title": "GitHub Actions CI/CDパイプラインを構築", "summary": "distrolessの本番フロントエンドイメージと複数環境への昇格を備えるGitHub Actions CI/CDで、日常的で平穏なリリースを実現した。", "content_html": "<p><strong>状況.</strong> リリースは手順を覚えている人に依存すべきではなかった。また、本番に不要なShellやパッケージ管理を含む大きな汎用コンテナは、理由のない攻撃対象を置くことになる。</p>\n<p><strong>課題.</strong> コミットからAzureでの稼働までを自動化し、各処理が許す範囲で本番イメージを小さく制限する必要があった。</p>\n<p><strong>行動.</strong> GitHub Actionsで自動化した。品質ゲート、テスト、環境別デプロイを別ワークフローにし、CodeQL、依存関係レビュー、SBOM生成を並行して設け、検査を通らず環境へ到達しないようにした。複数段階のビルドを使い、すべて同じベースにはせず、処理ごとに選んだ。画面はShellもパッケージ管理もないdistroless(gcr.io/distroless/cc‑debian13)、Go APIは小さなAlpine、DBはpostgres‑slimとした。環境間の昇格は手動でなく定義した経路に沿って進む。</p>\n<p><strong>結果.</strong> 慎重な手作業の儀式から、日常的で平穏なリリースへ変わった。本番フロントエンドはほぼ最小の環境で動き、問題は導入前の検査で捉え、デプロイは人が緊張して行うことではなく、ワークフローが実行することになった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "クラウド", "コンテナ(Docker/Kubernetes)", "セキュリティ", "テスト・品質保証", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "コンテナ化・オーケストレーション" ] }, { "id": "https://engineer.company/ja/portfolio/authored-578-go-task-automation-targets/", "url": "https://engineer.company/ja/portfolio/authored-578-go-task-automation-targets/", "title": "go‑taskの自動化ターゲット578個を作成", "summary": "ネイティブ、Docker、HTTPSの各モードにまたがるgo-taskターゲット578個を作成し、静的検査、テスト、DB、デプロイを1つのツール群で扱えるようにした。", "content_html": "<p><strong>状況.</strong> Go、TypeScript、SQL、Python、Shellからなる多言語monorepoで、各言語に固有のビルド、テスト、静的検査、実行方法があった。放置すれば各人がコマンド一覧を頭に持ち、新人は初日を動かし方の理解に費やすことになる。</p>\n<p><strong>課題.</strong> 何語で書かれていても、何でも同じ方法で動かせる、プロジェクト共通の入口をつくる必要があった。</p>\n<p><strong>行動.</strong> go‑taskによるTaskfile層を構築し、ルートに50、名前空間付きファイルに528、計578の名前付きターゲットへ拡大した。ネイティブ、Docker、PWA・携帯端末試験用HTTPSの開発モード、全言語のlint・format・test・fix、DB管理、環境別ビルド・デプロイを備えた。通常の画面ビルドに十分なRAMがない端末向けの省メモリーモードも設けた。多くのタスクを持つことではなく、下のコマンドを知らずに済むことが目的だった。</p>\n<p><strong>結果.</strong> 誰でもtask –listでツール群全体を見られ、内部技術によらず同じ方法で実行できるようになった。受け入れ期間が短くなり、誤ったフラグやディレクトリ、曖昧なコマンド記憶による小さなミスがほぼなくなった。ただし578は誰も覚えきれない数でもある。数を誇るのでなく、命名と名前空間で利用可能性を保つ必要があった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "テスト・品質保証", "技術面の統率", "自動化・CI/CD", "文書作成", "DevOps・CI/CD自動化", "技術文書の作成" ] }, { "id": "https://engineer.company/ja/portfolio/owned-end-to-end-platform-deployments-to-azure/", "url": "https://engineer.company/ja/portfolio/owned-end-to-end-platform-deployments-to-azure/", "title": "Azureへのプラットフォーム導入を一貫して担当", "summary": "Azureへのデプロイを一貫して担当し、定義済みの再現可能な手順で、開発からステージング、本番へリリースを進めた。", "content_html": "<p><strong>状況.</strong> 複数のAzure環境へ製品を届ける必要があり、デプロイはインフラ、ビルド、アプリの接点だった。小さなミスがバグから停止へ変わる箇所でもあり、半分記憶に頼って手動で行うことは最も避けたかった。</p>\n<p><strong>課題.</strong> 各環境へ毎回同じ予測可能な方法で変更が届くよう、デプロイ全体に責任を持った。</p>\n<p><strong>行動.</strong> 本番へ直接出すのではなく、開発、ステージング、本番の固定経路でリリースを進めた。CI/CDがイメージを作って配布し、Bicepテンプレートが各環境の基盤をそろえることで、昇格のたび微妙に違う場所へ入ることを防いだ。環境ごとの設定は秘密情報と分離し、毎回再ビルドせず、同じ成果物が到着先の適切な設定を取得する形にした。</p>\n<p><strong>結果.</strong> 場当たり的な手動導入を挟まず、定義した経路で予測どおり各環境へ変更が届いた。息を詰める瞬間ではなく、管理された反復可能な手順となり、速く変化する本番基盤の安定を支えた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "インフラ", "クラウド", "セキュリティ", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "クラウドインフラ・移行", "サイト信頼性・監視" ] }, { "id": "https://engineer.company/ja/portfolio/designed-an-ios-26-liquid-glass-design-system/", "url": "https://engineer.company/ja/portfolio/designed-an-ios-26-liquid-glass-design-system/", "title": "iOS 26「Liquid Glass」デザインシステムを設計", "summary": "iOS 26「Liquid Glass」デザインシステムと正本のコンポーネント一覧を設計し、UIのばらつきを静的検査で防いだ。", "content_html": "<p><strong>状況.</strong> 共通の視覚言語と固定のコンポーネント群がなければ、UIは速くずれていく。画面ごとに少し違うボタン、バッジ、カードが生まれ、小さな違いが積もって製品の統一感を失い、同じものの独自版5つを変更する必要が生じる。</p>\n<p><strong>課題.</strong> 意図のある見た目と、忙しくなっても崩れない実効性を備えるデザインシステムが必要だった。</p>\n<p><strong>行動.</strong> 視覚言語と部品体系を一体で設計した。Tailwindのユーティリティで、背景ぼかし付き半透明パネル、重なる影、軽い屈折、ばねの動きによるiOS 26「Liquid Glass」を表現した。その上にCard、Label、Button、GlassIconButton、DirectoryGridなど、各画面を構成する正本の部品を置いた。定着を支えるのは静的検査であり、独自バッジやチップを拒否し正本へ導くことで、当日のレビュー担当者の記憶に頼らず守った。抽象的な原則だけでなく、誤りと具体的な修正を対にして文書化した。</p>\n<p><strong>結果.</strong> UIが一貫してブランドに沿い、独自部品は広まる前に検出された。視覚的な一貫性を、全員の規律ではなくツールが守るようになった。締め切りのもとでも維持できる形になった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "UX・UI設計", "デザインシステム・UI", "フロントエンド開発", "文書作成", "UI/UX設計・デザインシステム" ] }, { "id": "https://engineer.company/ja/portfolio/designed-the-products-ui-and-ux-end-to-end/", "url": "https://engineer.company/ja/portfolio/designed-the-products-ui-and-ux-end-to-end/", "title": "製品のUIとUX全体を設計", "summary": "一覧グリッド、カード・表、リアルタイム検証、パンくずを含むUI/UX全体を設計し、密度の高い海事データを扱いやすくした。", "content_html": "<p><strong>状況.</strong> 専門家、企業、船舶、求人、レビューなど多様な対象を示す画面には、美しさと実用性の両方が必要だった。実際の海事データを見せる密度を備えつつ、使う人をはね返す情報の壁にはしない必要があった。</p>\n<p><strong>課題.</strong> 配置、操作方式、フォームを煩わしく感じさせず案内する細部まで、製品のUI・UX全体を担当した。</p>\n<p><strong>行動.</strong> いくつかの判断で大きく改善した。一覧にカード・表の切り替えを設け、視覚的に探すか密な表を走査するかを選べ、その選択を記憶する。入力欄上に要件をリアルタイム表示し、満たせば緑、未達なら琥珀色にして、送信後に叱るのでなく入力中に導く。パンくずと2列のエンティティ配置を統一し、無関係な画面の集まりでなく同じ製品と感じられるようにした。エラーは失敗の強調より案内を重視し、赤一面や行き止まりを避け、移動先を示して、止めるより前へ進めるようにした。</p>\n<p><strong>結果.</strong> 密度の高い海事データに親しみやすく、難しい部分を案内する、完成度と一貫性のある体験になった。実際のキャリアに使う製品にとって、配慮と信頼感は装飾ではない。雑な画面ならデータへの信頼も下がり、それはもっともな反応だからだった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "UX・UI設計", "Web開発", "デザインシステム・UI", "プロダクト・要件", "フロントエンド開発", "UI/UX設計・デザインシステム", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/delivered-analysis-and-regular-progress-reports/", "url": "https://engineer.company/ja/portfolio/delivered-analysis-and-regular-progress-reports/", "title": "分析と定期的な進捗報告を提供", "summary": "CEOに分析結果と定期的な進捗報告を提供した。エンジニアリングの指標や成果物の提供状況を、確信を持って意思決定できる情報へとまとめた。", "content_html": "<p><strong>状況.</strong> プラットフォームが形になるにつれ、進捗と健全性を、経営層が実際に判断に使える形で示す必要があった。ビルド状態、開発速度、障害といった生の技術的な情報は、そのままでは製品や投資の判断をする人には意味を取りにくい。意思決定に必要な粒度とは違い、誰かが意味を伝える必要があった。</p>\n<p><strong>課題.</strong> その翻訳が仕事だった。開発がどこまで進み、システム指標が何を示しているかという技術の現実を、明確に、定期的にCEOへ伝え、推測ではなく事実に基づく判断を支える必要があった。</p>\n<p><strong>行動.</strong> 尋ねられてからでは少し遅いため、一定の報告周期を設けた。進捗、範囲、リスク、システムの健全性を追跡し、何が順調で、何が危険で、ある優先事項にはどんなトレードオフが伴うかを、平易で判断につながる報告にした。文脈を持たない人に生の数値を渡して解釈を任せることを避け、具体的な提案を添えた。有用な場合は説明の根拠となる分析も付け、信じるだけでなく必要に応じて掘り下げられるようにした。</p>\n<p><strong>結果.</strong> 経営層は技術の状況を明確かつ率直に、最新の状態で把握し、手探りでなく一定の確信をもって製品の優先順位と投資を決められた。誰も読まない状況報告の儀式ではなく、実際に意思決定に使うものとなり、技術の仕事と事業の方向をそろえた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "データ分析", "プロジェクト管理", "プロダクト・要件", "関係者との調整・報告", "技術面の統率", "データ分析・BIダッシュボード", "プロジェクト管理(アジャイル)", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/ran-24-7-support-for-1000-iptv-ott-servers/", "url": "https://engineer.company/ja/portfolio/ran-24-7-support-for-1000-iptv-ott-servers/", "title": "約1,000台のIPTV/OTTサーバーを24/7で支援", "summary": "中国、米国、ドイツのIPTV/OTT配信基盤で、約1,000台のサーバーと顧客システムを24/7で支援した。", "content_html": "<p><strong>状況.</strong> 中国、米国、ドイツに顧客を持つIPTV/OTT配信基盤で、どこかで必ず誰かが視聴しているため、静かな保守時間はなかった。停止は抽象的な指標ではなく、視聴者のテレビが突然止まることであり、視聴者には理由は関係なかった。</p>\n<p><strong>課題.</strong> プラットフォームのインフラを、実際に昼夜を問わず利用可能に保つことが仕事だった。「営業時間に加え、誰も応答しない当番制」という意味ではなかった。</p>\n<p><strong>行動.</strong> 約1,000台のサーバーに加え、多数の顧客所有システムを24/7で支援し、配信環境全体の管理、監視、セキュリティ、設定を維持した。大きく異なる3つの時間帯に顧客がいるため、実質的な時間外はなく、現地午前3時の障害も他地域の最盛時間として扱った。生配信では事後に静かに直すことはできないため、異変を停止前に捉えることが多くの作業を占めた。</p>\n<p><strong>結果.</strong> 世界の視聴者へ継続的な可用性を保ち、問題が何時に起きても、画面へ影響する前に捉え対処した。24/7サービスでの成功は何も起こらないように見えることであり、それこそが視聴者の望むものだった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "クラウド", "システム管理", "ネットワーク・VPN", "監視・オブザーバビリティ", "信頼性・バックアップ", "ITサポート・ヘルプデスク", "サイト信頼性・監視" ] }, { "id": "https://engineer.company/ja/portfolio/kept-iptv-streaming-signals-running-non-stop/", "url": "https://engineer.company/ja/portfolio/kept-iptv-streaming-signals-running-non-stop/", "title": "IPTV配信信号の連続稼働を維持", "summary": "配信ネットワークとIP電話を24/7で監視・保守し、供給元と顧客間のIPTV配信を途切れさせず維持した。", "content_html": "<p><strong>状況.</strong> IPTVでは信号の到達がすべてを左右する。供給元から基盤を通って顧客へ流れる途中のどこかが切れれば、誰かの画面が黒くなる。併設のIP電話にも、普通に使えることという同じ要件があった。</p>\n<p><strong>課題.</strong> 信号の配信と電話を途切れさせないことが仕事だった。</p>\n<p><strong>行動.</strong> 配信ネットワークとIP電話を、昼夜を問わず監視・調査・保守した。配信障害には、映像の途切れや不安定な接続など、完全な断絶前に劣化が現れるため、常時監視すれば、黒い画面になる前の引っかかりで捉えられる。苦情への反応より、信号の先を読むことが大きな部分だった。</p>\n<p><strong>結果.</strong> プラットフォーム全体で映像と通話を確実に保ち、利用者が気づくサービス停止になる前に問題を検出・修正した。供給元から最終顧客まで見える空白なく信号を流すのは、静かで絶え間ない仕事であり、静かであることが望ましかった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "システム管理", "ネットワーク・VPN", "監視・オブザーバビリティ", "信頼性・バックアップ", "サイト信頼性・監視", "ネットワーク・VPN構築" ] }, { "id": "https://engineer.company/ja/portfolio/built-and-maintained-django-apps-for-iptv/", "url": "https://engineer.company/ja/portfolio/built-and-maintained-django-apps-for-iptv/", "title": "IPTV用Djangoアプリを構築・保守", "summary": "IPTV基盤のDjango Webアプリケーションを開発・保守し、性能と安定性を高めながら機能を届けた。", "content_html": "<p><strong>状況.</strong> IPTV基盤には、人が実際に操作するDjango製Webアプリケーションがあり、新機能の追加と、常時稼働に必要な性能・安定性を保ちながら前進する必要があった。</p>\n<p><strong>課題.</strong> 機能を充実させつつ、速く安定したアプリケーションに保つことが課題だった。</p>\n<p><strong>行動.</strong> Djangoアプリを開発・保守し、新機能、バグ修正、性能・安定性改善を、孤立せずチーム全体と進めた。継続的に顧客へ提供するものでは、安定性は機能に添える利点ではなく、機能が守るべき制約だった。揺らいではいけない基盤を不安定にする華やかな機能には、価値が乏しかった。</p>\n<p><strong>結果.</strong> 社内チームにも顧客にも信頼性を保ったまま、能力を増やし続けた。不安定にせず追加するという重要な均衡を、作業を通じて守った。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "Python", "Web開発", "バックエンド開発", "フルスタック開発", "フロントエンド開発", "Webサイト・CMS開発", "バックエンド・API開発", "フルスタックのプロダクト開発" ] }, { "id": "https://engineer.company/ja/portfolio/built-infrastructure-that-still-runs-years-later/", "url": "https://engineer.company/ja/portfolio/built-infrastructure-that-still-runs-years-later/", "title": "数年後も稼働するインフラを構築", "summary": "社内向けと社外向けのシステムを支える、耐久性のあるインフラを計画し、構築した。数年が経過した後も、最小限の変更だけで稼働を続けた。", "content_html": "<p><strong>状況.</strong> 組織の成長に伴い、社内外のシステムへ新機能を加える必要が続いた。その日最も速い方法は簡単でも、6か月後にまた直すことになりがちだった。</p>\n<p><strong>課題.</strong> 今だけ動くのでなく、動き続けるインフラ機能を計画・構築することが課題だった。</p>\n<p><strong>行動.</strong> 社内外の各システムで新しいインフラ機能を計画・実装し、常に手をかけるのでなく、一度適切につくれば最小限の手直しで何年も動く耐久性を重視した。永遠に世話をする仕事を抱え込まないよう、毎回、初めに少し多く考えることを意図的に選んだ。</p>\n<p><strong>結果.</strong> 構築から長く経っても有効に機能し、ほとんど変更せず何年も稼働した。今日動くものはつくれても、数年後も静かに動くものをつくるほうが難しく有用であり、その長寿命こそがインフラの仕事の尺度だった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "インフラ", "システム管理", "ソリューション設計", "プラットフォーム設計", "信頼性・バックアップ", "サイト信頼性・監視", "プラットフォーム・ソリューション設計" ] }, { "id": "https://engineer.company/ja/portfolio/designed-a-time-management-and-reporting-system/", "url": "https://engineer.company/ja/portfolio/designed-a-time-management-and-reporting-system/", "title": "時間管理・レポートシステムを設計", "summary": "時間管理とレポート作成を行うシステムを設計した。そのシステムは、本番環境で大幅な変更を加えることなく、何年にもわたって利用され続けた。", "content_html": "<p><strong>状況.</strong> 時間管理と進捗報告の確実な方法がなかった。その場合、たいていは表計算と記憶へ散らばり、報告は日々の仕事から自然に得られるものではなく、各期末に慌ててまとめるものになる。</p>\n<p><strong>課題.</strong> 両方を扱い、本当に長く使えるシステムをつくることが課題だった。</p>\n<p><strong>行動.</strong> チームが回避してしまう既製の手順を押しつけず、実際の仕事に合わせて時間管理・報告を設計した。実務に合えば使われ、逆らえば静かに放棄されて表計算へ戻るという、社内ツールの要点を踏まえた。理想形でなく現実に合わせて構築した。</p>\n<p><strong>結果.</strong> 大きな変更なく何年も本番利用された。印象的だったことより、動き続け、置き換える必要もなかったことが、社内ツールとして望ましい評価だった。長年の日常使用に手直しなしで耐えたことが、適合した設計を示した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "プロジェクト管理", "プロダクト・要件", "技術面の統率", "自動化・CI/CD", "データ分析・BIダッシュボード", "プロジェクト管理(アジャイル)", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/automated-team-collaboration/", "url": "https://engineer.company/ja/portfolio/automated-team-collaboration/", "title": "チームの協働を自動化", "summary": "協働、パスワード、タスク、時間管理を自動化し、実績の半自動紹介システムも構築してチームの生産性を高めた。", "content_html": "<p><strong>状況.</strong> 連絡調整、パスワード、タスク、時間の管理など、多くの運用作業が手動だった。手動調整は、目立たなくても、よりよい用途に回せる時間を着実に費やす、静かな負担だった。</p>\n<p><strong>課題.</strong> 繰り返す運用作業を自動化することが目標だった。</p>\n<p><strong>行動.</strong> 自動化に適した協働、パスワード、タスク、時間管理を自動化し、その上に半自動のプロジェクト紹介システムを構築した。定型的な調整を人の手から離して自動で動かし、本当に人が必要な仕事へ注意を戻すことを全体の狙いとした。紹介システムにも同じ考えを適用し、毎回の手作業でなく、仕事の提示をおおむね自動化した。</p>\n<p><strong>結果.</strong> 継続的な人の注意を必要としていた調整の多くが自動で動き、運用効率とチームの生産性が上がった。雑務に流れていた時間を、本来の仕事へ戻せた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "セキュリティ", "プロジェクト管理", "技術面の統率", "自動化・CI/CD", "DevOps・CI/CD自動化", "セキュリティ・アクセス管理", "プロジェクト管理(アジャイル)" ] }, { "id": "https://engineer.company/ja/portfolio/recovered-data-from-sd-cards-hdds-ssds-and-raid/", "url": "https://engineer.company/ja/portfolio/recovered-data-from-sd-cards-hdds-ssds-and-raid/", "title": "SDカード・HDD・SSD・RAIDからデータを復旧", "summary": "SDカード、HDD、SSD、RAID、外付けドライブ、Macから重要データを復旧し、失われたと見なされた機器からファイルを救出した。", "content_html": "<p><strong>状況.</strong> 故障・損傷した記憶媒体と、急いで取り戻す必要があるデータを持って、人々が訪れた。動かないドライブを持ち込む段階では、多くは心配を越えて動揺していた。写真、業務ファイル、大切なものの唯一のコピーが中にあった。</p>\n<p><strong>課題.</strong> 持ち込まれた媒体が何であっても、データを復旧することが仕事だった。</p>\n<p><strong>行動.</strong> SDカード、回転するHDD、SSD、RAIDアレイ、外付けドライブ、Macなど、一般的なほぼすべての媒体を扱った。SSDと円盤型ディスク、RAID、独自の特徴があるMacのファイルシステムでは、故障の仕方もデータの取り出し方も違う。単一の手法だけでなく、媒体に応じた適切な方法の見極めが重要だった。</p>\n<p><strong>結果.</strong> 一般的な各媒体で、顧客がすでに諦めた機器から重要なデータを取り戻した。ファイルが無事なドライブを返したときの安堵こそが仕事の目的であり、幅広い媒体でそれを実現した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "システム管理", "信頼性・バックアップ", "ITサポート・ヘルプデスク", "機器修理・データ復旧" ] }, { "id": "https://engineer.company/ja/portfolio/diagnosed-and-repaired-laptop-hardware/", "url": "https://engineer.company/ja/portfolio/diagnosed-and-repaired-laptop-hardware/", "title": "ノートパソコンのハードウェアを診断・修理", "summary": "画面、ヒンジ、キーボード、トラックパッド、マザーボード、電源などを修理し、Linux、Windows、Macのソフトウェア問題も解決した。", "content_html": "<p><strong>状況.</strong> 割れた画面、壊れたヒンジ、動かないキーボード、不調なトラックパッド、マザーボード、電源、さらにLinux・Windows・Macのソフトウェアまで、ノートパソコンのあらゆる故障が作業台に持ち込まれた。</p>\n<p><strong>課題.</strong> 確実に診断・修理することが仕事だった。持たない修理は、2度目の来店を遅らせただけなので、確実さが重要だった。</p>\n<p><strong>行動.</strong> 画面、ヒンジ、キーボード、トラックパッド、マザーボード、電源までハードを修理し、特に基板では細かな精密作業を行った。3種類のOSすべてでソフトウェア問題も解決した。真の技量は診断にある。電源が入らない原因は充電器、基板、バッテリーのいずれでもあり、実際の故障箇所の見立てが修理の質を決める。手を入れる前に、真因を見つけることへ注意を注いだ。</p>\n<p><strong>結果.</strong> ハードもソフトも整った、正常で頼れる端末を所有者へ返した。持続する修理だけが行う価値を持ち、最初に診断を正しくしたことが、その持続性を生んだ。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Linux・サーバー", "システム管理", "信頼性・バックアップ", "ITサポート・ヘルプデスク", "機器修理・データ復旧" ] }, { "id": "https://engineer.company/ja/portfolio/built-stripe-and-in-app-purchase-entitlements/", "url": "https://engineer.company/ja/portfolio/built-stripe-and-in-app-purchase-entitlements/", "title": "Stripe・アプリ内購入の利用権限を構築", "summary": "StripeとApple・Googleのアプリ内購入に対応する決済・利用権限層を構築し、アクセスモデルで一覧、検索、エクスポートを制御した。", "content_html": "<p><strong>状況.</strong> 金銭は軽く扱えない。定期購入はカード期限切れ、返金、プラン変更、重複・順不同のWebhookに耐える必要があった。Webのカード決済とApple・Googleのアプリストアという3経路では、購入内容の記録も3通りになるが、製品には「今この人は何ができるか」という1つの答えが必要だった。</p>\n<p><strong>課題.</strong> 購入経路を増やしても製品の全権限制御を書き直さずに済むよう、支払いの受け取りと権限付与を別システムにする必要があった。</p>\n<p><strong>行動.</strong> 18個のGoファイルでStripeのカード・定期購入を扱い、Apple・Googleは各々の領収書検証を通す。3つを9テーブル・34関数のpaymentsスキーマへ集め、そこで止めた。製品は別の11テーブル・34関数のaccessスキーマへ問い合わせ、どこで払ったかを知らずに「このアカウントがこれをできるか」を答える。この答えで企業一覧、検索、データ出力を制御し、毎回サーバーで再検証する。ボタンを隠すのは配慮であって、制御ではないためだった。</p>\n<p><strong>結果.</strong> 新しい購入経路は決済側だけに追加でき、権限制御は変えずに済む。アクセスに関する問い合わせは3つでなく1つのテーブルを見ればよい。小規模製品なら1つにしたい場所に2スキーマを持ち、従来不要だった権限検索をリクエストで行うことが代償となった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "PostgreSQL", "データベース", "セキュリティ", "バックエンド開発", "プロダクト・要件", "データベース設計・モデリング", "セキュリティ・アクセス管理", "バックエンド・API開発", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/built-first-party-error-monitoring-and-tracing/", "url": "https://engineer.company/ja/portfolio/built-first-party-error-monitoring-and-tracing/", "title": "独自のエラー監視・トレースを構築", "summary": "無害化、急増検知、シンボル解決、ハートビートを備える独自のエラー監視とOpenTelemetryトレースを、11の運用画面から提供した。", "content_html": "<p><strong>状況.</strong> プラットフォームが起動していることと、機能していることの差は、誰かが問題に気づけるかだった。夜11時、誰もテストしないページで利用者が遭うエラーは、収集する仕組みがなければ見えない。外部のエラー追跡サービスを買うのは良い解決だが、エラー、スタック、利用者の文脈が第三者へ渡ることも意味した。</p>\n<p><strong>課題.</strong> 内部情報を外に出さず、エラーとトレースを収集・分類し、対応可能にする必要があった。</p>\n<p><strong>行動.</strong> 2つの仕組みを構築した。OTLP経由のOpenTelemetryで、遅い要求を画面、API、DBにまたがって推測でなく追跡する。独自のerrmon・取り込みサービスは、保存前に内容を無害化し、単なる一覧でなく反復する問題に分類し、急増・再発を検出する。同じ不良リリースで40回呼び出さないよう間隔を制限し、縮小済みの画面スタックを元コードへシンボル解決し、監視経路自体の稼働を擬似ハートビートで確かめる。エラーイベント、グループ、受信箱、API遅延、スタック標本をDBに記録し、サービスレベル目標を含む11の運用画面に表示した。</p>\n<p><strong>結果.</strong> エラーを順に対処できる待ち行列に変え、再発は利用者の発見を待たず通知されるようになった。購入ならその午後に動いたはずの追跡を自作するには時間がかかり、保守対象も増えた。その代わり、機微な情報を外へ出さず、汎用でなくこの基盤に合う警報規則を得た。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "インフラ", "セキュリティ", "バックエンド開発", "監視・オブザーバビリティ", "信頼性・バックアップ", "DevOps・CI/CD自動化", "サイト信頼性・監視", "バックエンド・API開発", "専用AIエージェント開発" ] }, { "id": "https://engineer.company/ja/portfolio/1022-migrations-behind-a-schema-drift-gate/", "url": "https://engineer.company/ja/portfolio/1022-migrations-behind-a-schema-drift-gate/", "title": "1,022件のマイグレーションを差分検査で保護", "summary": "2通りでDBを構築し、不一致で失敗するCIゲートで、1,022件のマイグレーションの整合性を維持した。", "content_html": "<p><strong>状況.</strong> 多くのプロジェクトでは、スキーマを、最初からつくる初期設定と、成長を重ねたマイグレーションの2通りで記述する。同じDBになるはずでも検証がなく、ずれは新環境が本番と違う動作をするまで、たいてい最悪の時点まで、見えなかった。</p>\n<p><strong>課題.</strong> 定期的に同じだと信じるのでなく、自動で同一性を実証する必要があった。</p>\n<p><strong>行動.</strong> 036から1102までの番号を持つ1,022件のマイグレーションで版管理し、順序の規律を地味でも必須とした。CIは毎回、最新の初期スキーマからの構築と、初期スキーマに全移行を順番に再実行する構築を行って比較する。簡単な構造だけでなく投入データも比べる。参照テーブルの誤った補完は列の追加忘れと同じほど有害でも、片方しかスキーマ差分に出ないためだった。不一致は差分を表示してビルドを失敗させる。</p>\n<p><strong>結果.</strong> 新しい環境と長年稼働した環境が同じDBであることを、想定でなく検査した。作成者は再実行でも新規構築でも動く移行を書く必要があり、素早いALTER以上の思考を要する。それが目的であり、別の選択肢は、正しい答えが必要で考える時間がない復元時に初めて知ることだった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "PostgreSQL", "データベース", "データガバナンス", "テスト・品質保証", "移行・モダナイゼーション", "信頼性・バックアップ", "AIが使えるデータの整備", "DevOps・CI/CD自動化", "データベース移行・モダナイゼーション", "データベース管理(DBA)" ] }, { "id": "https://engineer.company/ja/portfolio/built-the-operator-back-office-for-the-platform/", "url": "https://engineer.company/ja/portfolio/built-the-operator-back-office-for-the-platform/", "title": "プラットフォームの運用管理画面を構築", "summary": "申請、モデレーション、機能フラグ、キャッシュ、診断を扱う、約40管理ルート・128コンポーネントの運用管理画面を構築した。", "content_html": "<p><strong>状況.</strong> 各プラットフォームには、誰も計画しない2つ目のアプリが静かに育つ。申請の承認、レビュー非表示、一部利用者への機能公開、キャッシュ削除、特定アカウントの異常調査などを誰かが行う必要がある。管理画面がなければ、技術者がDBコンソールを使う。遅く、記録がなく、誤字1つで事故になる方法だった。</p>\n<p><strong>課題.</strong> Shellなしで日常運用を可能にし、認証情報を持つ人でなく、当番の担当者が運用できるようにする必要があった。</p>\n<p><strong>行動.</strong> 約40の管理ルートと128コンポーネントで、実際の仕事に合う管理画面を構築した。企業所有権の審査、レビュー・投稿の管理、機能フラグ、キャッシュの確認・削除、診断、CEO向け報告を扱う。公開製品と同じデザインシステムと生成APIクライアントを使った。独自の技術でつくる社内ツールは、誰も更新せず、やがて誰も信じない部分になるため、この選択が重要だった。</p>\n<p><strong>結果.</strong> 運用する人が実際に運用でき、全操作が他と同じ認可を通り、同じ記録を残すようになった。少人数の社内利用者のために広い画面をテストし、アクセシブルに保つ継続費用はある。それでも、日曜夜9時に技術者が本番へUPDATEを打つより安い選択だった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "UX・UI設計", "システム管理", "バックエンド開発", "フルスタック開発", "プロダクト・要件", "フロントエンド開発", "AIエージェント用ツール・MCPサーバー", "フルスタックのプロダクト開発", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/built-company-ownership-claims-and-adjudication/", "url": "https://engineer.company/ja/portfolio/built-company-ownership-claims-and-adjudication/", "title": "企業所有権の申請・審査を構築", "summary": "利用者による企業所有権の申請から、管理者による審査・裁定まで、一連の仕組みを構築した。申請を承認すると、認可グラフが書き換わるようにした。", "content_html": "<p><strong>状況.</strong> 公開情報から作る企業一覧には、企業自身が登録したわけではないという構造的な問題があった。いつか当該企業の人が訂正を求めて来ても、本人と記録の間には関係があるという主張しかない。簡単に許せば競合が編集でき、遅すぎれば誤った一覧が残る。</p>\n<p><strong>課題.</strong> 「自社です」という主張から記録に対する本当の権限まで、人の判断と、その経緯を挟む経路が必要だった。</p>\n<p><strong>行動.</strong> 両アプリにまたがる108コミットで申請機能を一貫して構築した。利用者が証拠を添えて申請し、管理画面のキューへ入り、管理者が承認・拒否して理由を返す。承認は行のフラグではなく、認可グラフを書き換える。アカウントと組織に本当の関係を与え、既存の全権限検査が参照する関係に統合する。関門はコード経路でなく審査であり、既存機能は申請を特別に知る必要なく権限を尊重できる。</p>\n<p><strong>結果.</strong> 手でDBを編集せず、企業が自社の項目を引き受けて訂正できる。権限付与には承認者と理由が付く。人の審査を意図的な制約とした。ドメインの自動検査は速くても、最も重要な事例でこそ誤るためだった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "セキュリティ", "バックエンド開発", "フルスタック開発", "プロダクト・要件", "フロントエンド開発", "セキュリティ・アクセス管理", "フルスタックのプロダクト開発", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/built-a-loyalty-wallet-leagues-and-badges/", "url": "https://engineer.company/ja/portfolio/built-a-loyalty-wallet-leagues-and-badges/", "title": "ロイヤルティ残高、リーグ、バッジを構築", "summary": "31テーブルの台帳と67関数にリーグ、バッジ、ショップを備えるロイヤルティ・評判システムを構築し、残高を行ロックで保護した。", "content_html": "<p><strong>状況.</strong> 専門家ネットワークは、他の人が使って初めて価値が生まれ、それまでは戻る理由が乏しいという初期の問題を持つ。貢献へのポイントや評判を表す地位などの報酬は、説明は簡単でも実装は危険だった。使えるポイントは金銭に相当し、金銭で起こり得るすべての誤りが起こり得るためだった。</p>\n<p><strong>課題.</strong> 貢献を測って報い、残高を二重に使えないようにする必要があった。</p>\n<p><strong>行動.</strong> ロイヤルティを31テーブル・67関数、地位を別の5テーブル・32関数で扱い、何を表示するかを決める発見・個別化スキーマを併設した。台帳上にリーグ、バッジ、残高を実際の特典へ換えるショップを置いた。注意を要したのは、残高確認後に消費すると同時の2要求が両方通る古典的な不具合だった。変更時には読み取り前にwalletの行をロックし、後続を競争させず待たせる。残高と購入物が同じDBにあるため、一緒に確定するか、両方とも確定しない形にできた。</p>\n<p><strong>結果.</strong> 貢献を測定して報い、残高は概算でなく正確な計算となった。行ロックは遅い方法でも採用した。競合時に順番を待つことと、同じポイントを二重に使って後で手で精算することを比べ、前者を選んだ。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "PostgreSQL", "SQL", "データベース", "バックエンド開発", "プロダクト・要件", "性能改善", "データベース設計・モデリング", "バックエンド・API開発", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/built-the-social-layer-posts-feed-and-groups/", "url": "https://engineer.company/ja/portfolio/built-the-social-layer-posts-feed-and-groups/", "title": "投稿・フィード・グループの交流機能を構築", "summary": "投稿、フィード、グループ、メンション、フォロー関係、記念日のまとめを、共通の関数中心データ層上に構築した。", "content_html": "<p><strong>状況.</strong> 企業一覧は参照資料であり、調べたら人は去る。専門家向け基盤へ戻る価値を生むのは他の人の存在であり、投稿、グループ、そして催促メール以外の再訪理由が必要だった。</p>\n<p><strong>課題.</strong> 独自の規則、権限、保存方式を持つ別システムにせず、交流機能を追加する必要があった。</p>\n<p><strong>行動.</strong> 188コミットで、投稿、タイムライン、グループ、メンション、フォロー関係、記念日のまとめを、共通の関数中心データ層に実装した。その制約が多くを解決した。フォロー関係も同じテーブル・関数で、メンションは一覧と共通のIDスキーマで解決し、投稿はレビュー用の既存管理キューを引き継いだ。別の保存先や権限モデルは不要だった。ただし個別化タイムラインを効率的に組み立てることは、1行を取得するのとは本質的に違うため、個別化と発見の仕組みがそこで役立った。</p>\n<p><strong>結果.</strong> 企業を調べる必要がない日にも開く理由を、並行する別技術の保守なしに得た。海事一覧への交流機能が適切な投資かは製品判断であって技術判断ではない。製品が求めたため実装し、周辺と同じ方法でつくった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Web開発", "データベース", "バックエンド開発", "フルスタック開発", "プロダクト・要件", "フロントエンド開発", "バックエンド・API開発", "フルスタックのプロダクト開発", "プロダクト戦略・要件定義" ] }, { "id": "https://engineer.company/ja/portfolio/proved-the-intrusion-ban-works-every-run/", "url": "https://engineer.company/ja/portfolio/proved-the-intrusion-ban-works-every-run/", "title": "実行ごとに侵入元の遮断を実証", "summary": "故障した遮断経路が正常報告を続けず、収束を失敗させるようになった。それが必要な性質だった。毎回数秒を要し、本番のファイアウォールへルールを書いて撤回する介入はある。それでも別の方法の悪さをすでに実証したため、受け入れた。", "content_html": "<p><strong>状況.</strong> 侵入元遮断がSSHの待ち受けていないポートを対象にしていた問題は修正済みだった。しかし、サービスが動きjailが有効と出ても、遮断がカーネルへ届くかは見えないため、長く残った理由自体は直っていなかった。</p>\n<p><strong>課題.</strong> サービスの起動から推定せず、毎回の収束で稼働中のルールへ遮断経路を実際に試す必要があった。</p>\n<p><strong>行動.</strong> 標準が文書用に予約する範囲のアドレスを遮断し、カーネルのパケットフィルターから結果を読み戻し、成否によらず走る後処理で解除するようにした。誰にも属さない予約アドレスなら、失敗で遮断が残っても実在ネットワークを締め出さない。サービス自身の状態はルールなしでも成功を返し得るため、カーネルの読み戻しも不可欠だった。遮断方式は自動検出任せにせず固定し、従来の認証ログがないOSに合わせ、ログ源はdetectとした。誤った方式では、現れないファイルを見て静かに失敗するためだった。</p>\n<p><strong>結果.</strong> 故障した遮断経路が正常報告を続けず、収束を失敗させるようになった。それが必要な性質だった。毎回数秒を要し、本番のファイアウォールへルールを書いて撤回する介入はある。それでも別の方法の悪さをすでに実証したため、受け入れた。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "セキュリティ", "テスト・品質保証", "自動化・CI/CD", "信頼性・バックアップ", "AIエージェントのセキュリティ", "サイト信頼性・監視", "システム管理", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/verified-firewall-rules-by-position/", "url": "https://engineer.company/ja/portfolio/verified-firewall-rules-by-position/", "title": "ファイアウォールルールを位置で検証", "summary": "パケットが実際に経験する形で検証できるようになった。最も有用だったのは検査そのものより、それ以前の報告について明らかになったことだった。すべてのツールが1年間正しくレート制限を表示していても、重要な唯一の問いを誰も尋ねていなかった。", "content_html": "<p><strong>状況.</strong> ファイアウォールの状態一覧はルールの集合を示すが、パケットフィルターは順序付き一覧を先頭から見て最初の一致で止まる。要約ツールでは違いが見えず、広い許可の下にあるレート制限に、1年間どのパケットも届かなかった。</p>\n<p><strong>課題.</strong> 存在だけでは何も証明しないとわかったため、所属でなく位置を読む検証が必要だった。</p>\n<p><strong>行動.</strong> 番号付き一覧と実際のチェーンを読み、順序を検証するようにした。ポートごとに必ずプロトコル付きのルールをちょうど1つ置く。指定なしは静かに範囲を広げるためだった。SSHはレート制限だけで、その横に許可を置かない。上の許可が今回見つかった隠蔽そのものになるためだった。公開面は5ポートの短い一覧として全体を検証し、未宣言のポート追加を発見待ちにせず失敗させる。レポートも一致順で表示し、次の人が集合として読まないよう、冒頭に読み方の注意を記した。</p>\n<p><strong>結果.</strong> パケットが実際に経験する形で検証できるようになった。最も有用だったのは検査そのものより、それ以前の報告について明らかになったことだった。すべてのツールが1年間正しくレート制限を表示していても、重要な唯一の問いを誰も尋ねていなかった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Linux・サーバー", "インフラ", "セキュリティ", "テスト・品質保証", "ネットワーク・VPN", "自動化・CI/CD", "システム管理", "セキュリティ・アクセス管理", "ネットワーク・VPN構築" ] }, { "id": "https://engineer.company/ja/portfolio/made-ansible-check-mode-tell-the-truth/", "url": "https://engineer.company/ja/portfolio/made-ansible-check-mode-tell-the-truth/", "title": "Ansibleチェックモードを実態に即した検証に", "summary": "試行は測るか、測らなかったと言うかになり、以前の第3の状態はなくなった。同時に開発指針へ、チェックモードは嘘をつかず、見えない検査はそれを知らせ、見えないことから判定を推定してはならないと記した。", "content_html": "<p><strong>状況.</strong> 本番への試行実行は、変更の効果を安全に知る方法のはずだった。2026年9月、実際のホストについて誤った検証で失敗し、安全なサンドボックスを緩めるフラグを勧めた。ホストを読んだのでなく、返されていない値を読み、結論を出していた。</p>\n<p><strong>課題.</strong> 判断に使うすべての検査をチェックモードでも正直にし、できないものは黙るのでなく、その事実を知らせる必要があった。</p>\n<p><strong>行動.</strong> 文書化されながら忘れやすい性質が原因だった。commandはチェックモードで実行されず、空の結果でなく、出力が空の成功を登録する。条件式は未測定の値で、そのロジックの向くほうへ判断してしまう。登録済み検査をすべて調べると6件あり、監督プロセスへ尋ねず全設定を許すとしたもの、ファイアウォール停止中なのに作業なしとしたものなど、別々の誤報をしていた。それぞれを2形態のいずれかにした。未変更の既存状態を読む検査はチェックモードでも実行し、実行不能なら省略して何を検証しなかったか明示する。ログの沈黙は合格と同じに読まれるためだった。</p>\n<p><strong>結果.</strong> 試行は測るか、測らなかったと言うかになり、以前の第3の状態はなくなった。同時に開発指針へ、チェックモードは嘘をつかず、見えない検査はそれを知らせ、見えないことから判定を推定してはならないと記した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "Linux・サーバー", "インフラ", "テスト・品質保証", "自動化・CI/CD", "信頼性・バックアップ", "DevOps・CI/CD自動化", "コードによるインフラ管理", "サイト信頼性・監視" ] }, { "id": "https://engineer.company/ja/portfolio/reconciled-a-20-record-dns-zone-as-code/", "url": "https://engineer.company/ja/portfolio/reconciled-a-20-record-dns-zone-as-code/", "title": "20レコードのDNSゾーンをコードで照合", "summary": "ゾーンを版管理、比較、書き出しできるようにした。通常の既定に逆らった判断も理由を残し、偶然に議論をやり直さないようにした。差を閉じるより知ることが目的の場合が多いため、最も使うのは監査経路だった。", "content_html": "<p><strong>状況.</strong> Web、gitサブドメイン、2つの個人用転送先、外部メール提供者への配送、送信用ドメイン、両方の認証記録など、約20のDNSレコードがあった。すべて事業者の画面にあり、現在状態は最後にクリックした人が残したものだった。</p>\n<p><strong>課題.</strong> ゾーンをリポジトリの宣言にし、事業者が実際に配信する内容と比較する手段が必要だった。</p>\n<p><strong>行動.</strong> 稼働記録、アプリ記録、転送方針記録、まだ削除していないことを正直に示す削除予定一覧を、データとして記述した。1 プレイがAPIと照合・適用する。明示的な選択タグの背後に、変更せず差分を報告する監査と、他の仕組みでも読める標準ゾーン形式への書き出しを設けた。特に重要なのは撤回した判断だった。2つのWeb入口をCDN経由にする構成は実装して動いたが、会社のプライバシー方針の中心を失うため無効に戻した。前段の他社が、全訪問者のアドレスとURLを当社より先に、その会社の方針で扱うことになる。見張らないことを特徴とする事業には、防ぐ攻撃より悪い交換条件だった。</p>\n<p><strong>結果.</strong> ゾーンを版管理、比較、書き出しできるようにした。通常の既定に逆らった判断も理由を残し、偶然に議論をやり直さないようにした。差を閉じるより知ることが目的の場合が多いため、最も使うのは監査経路だった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "Python", "インフラ", "セキュリティ", "ネットワーク・VPN", "自動化・CI/CD", "コードによるインフラ管理", "システム管理", "セキュリティ・アクセス管理", "ネットワーク・VPN構築" ] }, { "id": "https://engineer.company/ja/portfolio/provisioned-a-second-server-from-code/", "url": "https://engineer.company/ja/portfolio/provisioned-a-second-server-from-code/", "title": "2台目のサーバーをコードで構築", "summary": "明記した費用で、既存のファイアウォールの背後に2台目を作成・再採用できるようになった。試行で確認できない部分も、想定外として残さず同じファイルで名指しした。", "content_html": "<p><strong>状況.</strong> 最初とは異なる事業者で、アプリ用の2台目が必要になった。最初の手動構築ではファイアウォールを後付けし、既定のパスワード方針のまま外から届く時間があった。その歴史が、今回はどうするかの根拠だった。</p>\n<p><strong>課題.</strong> リポジトリから作成し、後から守るのでなく、起動時からファイアウォールの背後に置く必要があった。</p>\n<p><strong>行動.</strong> 順序を設計にした。サーバーより先にファイアウォールを作り、保護対象より前にルールを用意する。別事業者ではタグ対象の制御のため、タグを先に作る。両者のファイアウォールはvendor collectionでなく汎用HTTPタスクからREST APIを直接呼び、要求形式を手書きする代わりに依存と版のずれを除いた。サーバーは既存なら重複作成せず採用し、再実行を安全にした。課金する唯一のロールとして、そのファイルに種類、地域、仕様、ユーロ建て月額を記した。課金するプレイは読む場所でそう知らせるべきだからだった。汎用HTTPがチェックモード非対応で、試行では全タスクを飛ばすため、通常の予行はできないことも記した。代わりに無料で戻せるファイアウォールプレイを予行した。</p>\n<p><strong>結果.</strong> 明記した費用で、既存のファイアウォールの背後に2台目を作成・再採用できるようになった。試行で確認できない部分も、想定外として残さず同じファイルで名指しした。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "Python", "インフラ", "クラウド", "セキュリティ", "自動化・CI/CD", "コードによるインフラ管理", "クラウドインフラ・移行", "セキュリティ・アクセス管理", "ネットワーク・VPN構築" ] }, { "id": "https://engineer.company/ja/portfolio/built-a-22-linter-commit-gate/", "url": "https://engineer.company/ja/portfolio/built-a-22-linter-commit-gate/", "title": "22静的検査のコミットゲートを構築", "summary": "コミット前に機械が定型的な異議を出し、このプロジェクト唯一のレビュー担当となった。コミットは遅く、出来の悪い検査への対応には強い苛立ちがあるという費用も隠さず記した。そのため後に、検査自体を整形・静的検査の対象にした。", "content_html": "<p><strong>状況.</strong> 参加ガイドは提案にとどまり、金曜の小さな変更では負ける。1人のプロジェクトではレビュー担当者もおらず、書いた本人が自分に最も異議を唱えたくない瞬間に、本番との唯一の防壁となるため、さらに深刻だった。</p>\n<p><strong>課題.</strong> 気づかれるのを待たず違反でコミットを失敗させる、実行可能な基準が必要だった。</p>\n<p><strong>行動.</strong> 全指摘をエラーにする22の静的検査を整え、生成器にも警告を失敗へ昇格させ、非推奨警告でも停止させた。HTML、CSS、JavaScript、Python、YAML、Markdown、Shell、綴り、秘密情報、リンクを検査する。さらに、両テーマの多層面の層数一致、写真表示幅が原画素の半分以内、私的なパス・ホスト名の非混入、3言語の文体、Markdown・代替プロトコル形式の存在など、汎用ツールにない固有規則も設けた。ignoreコメント、disable指定、フック回避、検出逃れの改名など、行内抑制と迂回を全面禁止した。既存の失敗も言い訳にせず、導入していない不備でも検出した回で修正することを、規則の実効性を保つ条件にした。</p>\n<p><strong>結果.</strong> コミット前に機械が定型的な異議を出し、このプロジェクト唯一のレビュー担当となった。コミットは遅く、出来の悪い検査への対応には強い苛立ちがあるという費用も隠さず記した。そのため後に、検査自体を整形・静的検査の対象にした。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "Python", "テスト・品質保証", "フロントエンド開発", "自動化・CI/CD", "文書作成", "DevOps・CI/CD自動化", "プロダクト戦略・要件定義", "技術文書の作成", "専用AIエージェント開発" ] }, { "id": "https://engineer.company/ja/portfolio/generated-495-pages-from-a-sqlite-export/", "url": "https://engineer.company/ja/portfolio/generated-495-pages-from-a-sqlite-export/", "title": "SQLiteエクスポートから495ページを生成", "summary": "495ページを1つの正本から生成し、文の訂正にアドレスの代償がなくなり、過去に公開したURLも応答し続ける。表示上の判断は、サービスをテーマ別にまとめる1点だけをexporterが持ち、他はDBに従う。見出しの訳がなければ、訳文の上に英語を出さず、エクスポートを失敗させる。", "content_html": "<p><strong>状況.</strong> 実績は履歴書も作る別のDBで執筆され、Webサイトは2コピーをずらさず3言語で公開する必要があった。手でページを書いてそろえる方法は、最初の訂正で破綻する。</p>\n<p><strong>課題.</strong> DBをビルド入力として生成し、文章を書き直してもページアドレスが残るようにする必要があった。</p>\n<p><strong>行動.</strong> 読み取り専用exporterで、実績・言語ごと1ページ、495ページと分類・サービスのデータを書き出した。標準ライブラリだけを使い、生成器の環境へ依存させず、出力をコミットしてサイト単体でも構築できるようにした。最重要の判断はアドレスだった。以前は英語の文頭からURLを作り、訂正のたびに移動して全リンクが切れ、訂正を重んじるサイトが訂正のたび自らリンク切れを負担していた。今は実績ごとにアドレスをデータとして書き、先頭を現行、後続を旧URLの転送とする。同時に2つの罠も記した。text列への期間比較はDBの型親和性のため黙って32行すべてに一致した。また、書き出し、データ、クエリを言語一覧から導くようにし、4言語目を検索作業でなくマップの1項目で追加できるようにした。</p>\n<p><strong>結果.</strong> 495ページを1つの正本から生成し、文の訂正にアドレスの代償がなくなり、過去に公開したURLも応答し続ける。表示上の判断は、サービスをテーマ別にまとめる1点だけをexporterが持ち、他はDBに従う。見出しの訳がなければ、訳文の上に英語を出さず、エクスポートを失敗させる。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "SQL", "Web開発", "データベース", "データパイプライン(ETL/ELT)", "フロントエンド開発", "国際化", "AIが使えるデータの整備", "Webサイト・CMS開発", "データパイプライン開発(ETL/ELT)", "ブランド・マーケティング・SEO", "国際化・ローカライズ" ] }, { "id": "https://engineer.company/ja/portfolio/closed-the-colour-system-at-28-colours/", "url": "https://engineer.company/ja/portfolio/closed-the-colour-system-at-28-colours/", "title": "配色を28色に限定", "summary": "静かに増やせない、測定済みの閉じた体系になり、契機となった近似重複はなくなった。少し違う青が欲しくても既存色を使うか、比率を含めて29色目の理由を示す必要がある、実際に拒否する制約となった。", "content_html": "<p><strong>状況.</strong> ダーク既定、ライト、印刷、強制配色、イラストのあるサイトでは、色は自然には少数に保たれない。区別不能な近い2表記、トークンの隣でのリテラル再入力、どこにも使われない記録上の色という、典型的なずれが始まっていた。</p>\n<p><strong>課題.</strong> 区別できる閾値を定めた閉じた配色にし、その範囲を守る必要があった。</p>\n<p><strong>行動.</strong> 28色を各表示面上の実測コントラストとともに記録し、11ブランド値を一度だけトークンに定義した。均等色空間で知覚的距離0.02未満は同じ色の別表記とする数値基準を設けた。未記録で使用、記録して未使用、比率誤記、既存色との距離不足、ブランド値の再入力の5種類で検査を失敗させる。直ちに距離0.018の2表記と、壁紙から0.021離れた背景代替色を発見した。mixは検査が見抜けず回避可能になるため、透明度は混色関数でなく相対色構文にした。規則は、個別ルールでなくトークンを変え、合う色がないときだけ追加し、デザインのために記録済み比率を下げないというものだった。</p>\n<p><strong>結果.</strong> 静かに増やせない、測定済みの閉じた体系になり、契機となった近似重複はなくなった。少し違う青が欲しくても既存色を使うか、比率を含めて29色目の理由を示す必要がある、実際に拒否する制約となった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "UX・UI設計", "デザインシステム・UI", "テスト・品質保証", "フロントエンド開発", "自動化・CI/CD", "文書作成", "UI/UX設計・デザインシステム", "ブランド・マーケティング・SEO" ] }, { "id": "https://engineer.company/ja/portfolio/found-the-light-theme-missing-a-whole-layer/", "url": "https://engineer.company/ja/portfolio/found-the-light-theme-missing-a-whole-layer/", "title": "ライトテーマに欠けた層を発見", "summary": "片方の層欠落はコミット失敗となり、作成時からなかった層が描かれるようになった。壊れず、エラーもなく、描画も正常なのに何か月も誤っていたという、この検査方針が対象とする形の不備だった。", "content_html": "<p><strong>状況.</strong> 2テーマのうち、既定のダークは常に見られるが、システム設定でだけ出るライトはあまり見られず、検査する人にも見られていなかった。一度つくった面を別テーマで再記述すると、静かに層が落ちる種類の問題だった。</p>\n<p><strong>課題.</strong> 人が設定を切り替えて見ることだけに頼らず、同等性を検証する必要があった。</p>\n<p><strong>行動.</strong> 各多層面で両テーマが描く層数を数え、不一致で失敗する小さな構造検査を設けた。異なってよい外観でなく、同じであるべき構成を比較する。初回で、壁紙、スクリム、ファセット模様の3層のダークに対し、ライトが2層だったことを検出した。最初からファセットが欠けていたのに、3背景の1つがないページはバグより意匠に見えるため、何も指摘されなかった。修正は1ルールで、その後にオーバーレイのコントラストへの費用も記し、無料と想定せず測定した。</p>\n<p><strong>結果.</strong> 片方の層欠落はコミット失敗となり、作成時からなかった層が描かれるようになった。壊れず、エラーもなく、描画も正常なのに何か月も誤っていたという、この検査方針が対象とする形の不備だった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "UX・UI設計", "デザインシステム・UI", "テスト・品質保証", "フロントエンド開発", "自動化・CI/CD", "UI/UX設計・デザインシステム" ] }, { "id": "https://engineer.company/ja/portfolio/replaced-963-metadata-blocks-with-one-graph/", "url": "https://engineer.company/ja/portfolio/replaced-963-metadata-blocks-with-one-graph/", "title": "963メタデータブロックを1グラフに統合", "summary": "963の匿名反復が安定IDの1グラフとなり、ページの量も増えず減った。発端の測定、1,671回同じ会社を書きながら結合できなかったという事実は、覚えておく価値があった。", "content_html": "<p><strong>状況.</strong> 一般的なサイト同様、各ページの構造化データが毎回会社を一から記述していた。全体で963ブロック、会社の記述1,671回に達したが、安定IDがない匿名データなので、別ページの会社が同じだと読み手のシステムは結びつけられなかった。</p>\n<p><strong>課題.</strong> 同じ単語を持つブロックの山でなく、安定した同一性のある1グラフにする必要があった。</p>\n<p><strong>行動.</strong> サイトのoriginから組織、サイト、人のIDを発行し、各ブロックは内容を再記述せず参照する。デンマーク語でも同じ会社のため、IDは言語別でなくorigin全体とした。サービス・提供条件、レビュー・仕事、コレクション・パンくずなど16型を使う。量を抑える判断を2つ行った。一覧は内容を埋めずURLだけにした。実績一覧へ107全文を入れると圧縮後52%増になるという測定を踏まえた。検査も構文だけでなく、全ブロックの解析、全IDの解決、全URLの実在ビルドを確認し、存在しないページを指せば失敗させる。</p>\n<p><strong>結果.</strong> 963の匿名反復が安定IDの1グラフとなり、ページの量も増えず減った。発端の測定、1,671回同じ会社を書きながら結合できなかったという事実は、覚えておく価値があった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "Web開発", "データガバナンス", "ブランド・マーケティング", "フロントエンド開発", "自動化・CI/CD", "AIエージェントへの対応", "AIが使えるデータの整備", "Webサイト・CMS開発", "データガバナンス・品質管理", "ブランド・マーケティング・SEO" ] }, { "id": "https://engineer.company/ja/portfolio/cut-the-stylesheet-bundle-from-87-kb-to-31-kb/", "url": "https://engineer.company/ja/portfolio/cut-the-stylesheet-bundle-from-87-kb-to-31-kb/", "title": "CSSバンドルを87 KBから31 KBに削減", "summary": "CSSは87 KBでなく31 KBとなり、未使用756 KBの配布をやめた。各判断に測定を添え、採用しなかった選択こそ、より有用な記録として残った。", "content_html": "<p><strong>状況.</strong> フレームワークのない文書サイトのCSSが87 KBあり、本文到着前にページ容量の大半を費やしていた。さらに、一度生成して以後参照のないアイコンディレクトリを毎回配布していた。</p>\n<p><strong>課題.</strong> 見た目を変えず、漠然とした整理でなく、指し示せる理由で容量を減らす必要があった。</p>\n<p><strong>行動.</strong> まず測った。最大CSSの3分の2は、約42 KBのフォントを約56 KBのbase64文字列にしたもので、外部preloadでも得られる初期表示効果のため、不要な太さでも毎ページ負担していた。除くと単体84 KBが28、全体87が31になった。3ウェイトをpreloadし、3つ目も数がそろうからでなく、実データで最長の依存経路を閉じるとわかって追加した。配布物監査で21アイコンと重複設定の756 KBが未参照とわかり除去し、サイトのアイコン自体も145 KBから15にした。ブランドマークの新形式も測定したが、より大きく、サイズでなく順序で選ぶため新ブラウザーほど重い版を取るので見送った。写真は元画素の半分を超える表示を禁じ、イラストは通常・高密度の両方で画素が支えるサイズとする検査を設けた。</p>\n<p><strong>結果.</strong> CSSは87 KBでなく31 KBとなり、未使用756 KBの配布をやめた。各判断に測定を添え、採用しなかった選択こそ、より有用な記録として残った。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Web開発", "デザインシステム・UI", "フロントエンド開発", "自動化・CI/CD", "性能改善", "Webサイト・CMS開発", "ブランド・マーケティング・SEO" ] }, { "id": "https://engineer.company/ja/portfolio/fixed-a-sitemap-with-one-shared-timestamp/", "url": "https://engineer.company/ja/portfolio/fixed-a-sitemap-with-one-shared-timestamp/", "title": "更新日時が共通のサイトマップを修正", "summary": "1か月の編集後の再同期で、186ファイルすべてでなく8ファイルだけが変わり、サイトマップが事実を伝えるようになった。同じ罠は参照順を持つ全フィールドに当てはまるため、メタデータ文書へ一般則として記した。", "content_html": "<p><strong>状況.</strong> サイトマップは176ページ中172ページを同じ瞬間の最終変更と知らせていた。更新日は内容変更の約束であり、172件同時なら全面書き直しか、何も有益な情報を伝えていないかのどちらかで、些細な不正確さではなかった。</p>\n<p><strong>課題.</strong> リポジトリが持たない精度を創作せず、ファイルでなく内容を表す日付が必要だった。</p>\n<p><strong>行動.</strong> 毎回全ファイルを書き直すエクスポートに対し、ファイル時刻を使ったことが原因だった。明示値、コミット履歴、ファイルの順に参照する方式へ移した。優先するように見えてもフィールド名を一覧へ明記しなければ、生成器が執筆日を一切読まないという罠も記した。他にも2つ決めた。記録の執筆・改訂日は仕事の発生時期と何年も違うため、別に保持する。今年書いたページを10年前扱いにしない。また履歴開始より前に内容があったため、日付行は任意で、何も導出しない。移行日を記すより空にし、欠落より、信じられてしまう精密な誤値のほうが悪いという原則に従った。</p>\n<p><strong>結果.</strong> 1か月の編集後の再同期で、186ファイルすべてでなく8ファイルだけが変わり、サイトマップが事実を伝えるようになった。同じ罠は参照順を持つ全フィールドに当てはまるため、メタデータ文書へ一般則として記した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "Web開発", "テスト・品質保証", "ブランド・マーケティング", "自動化・CI/CD", "AIエージェントへの対応", "DevOps・CI/CD自動化", "Webサイト・CMS開発", "ブランド・マーケティング・SEO" ] }, { "id": "https://engineer.company/ja/portfolio/ran-development-as-51-written-initiatives/", "url": "https://engineer.company/ja/portfolio/ran-development-as-51-written-initiatives/", "title": "51件の文書化した施策として開発を運営", "summary": "理由付きの51判断が残り、約4分の3が完了し、見送りも採用と同じように取り出せるようになった。小さな仕事でも文書を要する実際の負担があり、ときには変更より記録のほうが長くなった。", "content_html": "<p><strong>状況.</strong> 1人の会社には計画会議もバックログ整理も、判断に反対する人もいない。代わりに、今おもしろい仕事へ向かいやすく、後から選択理由を示す記録もない。判断の再検討や説明が初めて必要になったとき、問題になる。</p>\n<p><strong>課題.</strong> 実装したものだけでなく見送ったものも含め、数か月後に読み返せる施策別の開発記録が必要だった。</p>\n<p><strong>行動.</strong> 番号と目次を持つ54計画文書で51施策を管理し、問題、測定、判断、未完了項目を記した。事後の要約ではなく、議論を決着させた数値を残した。検査実行器の順序測定、大きくなって不採用の画像形式、所有者が確認した価格体系、371ページで能力を示しながら価格・依頼形態・最低条件を一切示していないとした監査などだった。採用しない指摘も同様に扱い、AIエージェント対応の8指摘中6件を却下し、後の自動提案が判断を静かに覆さないよう、各結論を残した。状態一覧は「完了」と書ける文章でなく、開いていることを示すチェック欄を読む。後に文書検査が、未完了項目を持つ完了扱いの6計画を見つけたため、この違いは理論ではなかった。</p>\n<p><strong>結果.</strong> 理由付きの51判断が残り、約4分の3が完了し、見送りも採用と同じように取り出せるようになった。小さな仕事でも文書を要する実際の負担があり、ときには変更より記録のほうが長くなった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "アジャイル・Scrum", "プロジェクト管理", "プロダクト・要件", "関係者との調整・報告", "技術面の統率", "文書作成", "AIエージェントへの対応", "プロジェクト管理(アジャイル)", "プロダクト戦略・要件定義", "技術文書の作成", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/put-the-documentation-under-its-own-linter/", "url": "https://engineer.company/ja/portfolio/put-the-documentation-under-its-own-linter/", "title": "文書を独自の静的検査で管理", "summary": "計約2,666実効行の26文書が、増やせない予算下に入り、全パスと記号を実ツリーに照合するようになった。毎コミットを止める14検査が一切記載されていなかったという、機械の規則と人が読む規則の分離こそ、繰り返す価値のある不都合な発見だった。", "content_html": "<p><strong>状況.</strong> 品質、デザイン、アクセシビリティ、印刷、メタデータ、翻訳、gitを26文書の指示で管理していた。指示は長くなり、コードからずれ、移動したファイルを参照し、一定の長さで読まれなくなる。読まれない規則は規則として働かない。</p>\n<p><strong>課題.</strong> 助言でなく失敗する上限を持つ静的検査を設け、文書もコードと同じように扱う必要があった。</p>\n<p><strong>行動.</strong> 8つの機械的な方針を設けた。文書長の絶対上限と警告する目安、縮むだけで戻らないファイル別行数予算、大きさに応じた全体目次・節目次、主題の担当文書を定める配置規則、リンク妥当性、主張とチェック欄が一致する計画の正直さ、コミットを制御する全タスクの文書記載、記したパスとコード記号の実在検査だった。初回で、未完了欄付きの完了6計画、どこにも記載のない14タスク、リンク切れ3件、孤立文書1件、5文書にまたがる死んだパス3件を検出し、必要性を示した。その後、この仕事の説明を開発文書へ加えると上限に達し、作成者自身を拒否して別文書が生まれた。意図どおりの働きだった。</p>\n<p><strong>結果.</strong> 計約2,666実効行の26文書が、増やせない予算下に入り、全パスと記号を実ツリーに照合するようになった。毎コミットを止める14検査が一切記載されていなかったという、機械の規則と人が読む規則の分離こそ、繰り返す価値のある不都合な発見だった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "テスト・品質保証", "プロジェクト管理", "技術面の統率", "自動化・CI/CD", "文書作成", "プロジェクト管理(アジャイル)", "技術文書の作成", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/linted-the-10242-line-quality-gate-itself/", "url": "https://engineer.company/ja/portfolio/linted-the-10242-line-quality-gate-itself/", "title": "10,242行の品質ゲート自体に静的検査を適用", "summary": "最大かつ中核のコードを、13指摘修正・抑制0で、整形・静的検査・型検査下に置いた。CSSの不備は見た目の異常になるが、検査器の不備は通るべきでない検査の合格になる。行数以上に重要な理由を計画に記した。", "content_html": "<p><strong>状況.</strong> 品質ゲートは32本、計10,242行のJavaScriptで、圧倒的に最大のコード群だった。それだけが整形、静的検査、型検査の対象外で、全規則を適用するプログラム自身が何も適用されていなかった。</p>\n<p><strong>課題.</strong> 検査器を自らの基準に従わせ、逆ではなく、整形ツールを既存コードへ合わせる必要があった。</p>\n<p><strong>行動.</strong> まず整形し、字下げ幅を検討した。既定の4空白なら最大の検査器2,173行を書き換えるが、この群を2空白にすると実際のずれ38行になった。好みのため2,000行を再整形すれば履歴を読めなくするため、ツールをコードに合わせる原則を記録した。静的検査で13件の実際の不備をすべて直し、抑制しなかった。Python検査器にも、中程度の厳しさに厳格区分30規則を加え、実測で選んだ型検査を適用した。30候補中29はすでに静かで、1つの指摘は除外せず修正し、この設定で全体を無診断にした。構文でなく値の形の問題2件は、静的検査が通した後に型検査が発見した。</p>\n<p><strong>結果.</strong> 最大かつ中核のコードを、13指摘修正・抑制0で、整形・静的検査・型検査下に置いた。CSSの不備は見た目の異常になるが、検査器の不備は通るべきでない検査の合格になる。行数以上に重要な理由を計画に記した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "Python", "テスト・品質保証", "フロントエンド開発", "自動化・CI/CD", "文書作成", "DevOps・CI/CD自動化", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/built-a-database-driven-cv-generator/", "url": "https://engineer.company/ja/portfolio/built-a-database-driven-cv-generator/", "title": "データベース駆動の履歴書生成器を構築", "summary": "1つのDBから6形式・3言語・5テーマが生まれ、文は一度訂正すれば済む。代償は、この仕組みだけが文書を作る手段になり、急いで開いて編集するファイルがなくなること、言語を追加するときは構築前に全体へ配線する必要があることだった。", "content_html": "<p><strong>状況.</strong> 履歴書、推薦者一覧、実績集、応募書類は同じ事実の4配置であり、別文書なら訂正を4回行い、いずれ漏れる。3言語ならさらに3倍になる。単に間違うのでなく、2文書が違い、どちらが最新かもわからないのが故障形態だった。</p>\n<p><strong>課題.</strong> 編集者の最後の手作業でなくコードで配置を決め、事実の単一情報源から、全言語・全形式の全文書を生む必要があった。</p>\n<p><strong>行動.</strong> 実績、肩書、会社、地域、分類、サービス、プロフィール、推薦者、概要など23テーブルのSQLiteを、空から1コマンド・19段階で組み立てる。順序を定め、各段階を安全に繰り返せるようにして、既存DBでも重複行を作らない。計10,580行のPython41モジュール、Jinja6テンプレート、CSS8枚で、HTML、2種類のPDF、テキスト、Markdown、JSONの6形式を出す。5年後に導入できない生成器は何も保存していないという考えから、実行時依存をテンプレートとPDF生成の2つに制限した。読者別調整も手編集でなく、プロフィールが実績と順序を選ぶ第一級の概念とし、複製でなく問い合わせにした。</p>\n<p><strong>結果.</strong> 1つのDBから6形式・3言語・5テーマが生まれ、文は一度訂正すれば済む。代償は、この仕組みだけが文書を作る手段になり、急いで開いて編集するファイルがなくなること、言語を追加するときは構築前に全体へ配線する必要があることだった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "SQL", "データベース", "ソリューション設計", "バックエンド開発", "フルスタック開発", "国際化", "自動化・CI/CD", "データベース設計・モデリング", "バックエンド・API開発", "プラットフォーム・ソリューション設計", "フルスタックのプロダクト開発", "国際化・ローカライズ" ] }, { "id": "https://engineer.company/ja/portfolio/enabled-every-linter-rule-as-an-error/", "url": "https://engineer.company/ja/portfolio/enabled-every-linter-rule-as-an-error/", "title": "すべての静的検査ルールをエラーに設定", "summary": "全力の静的検査が指摘0で動き、逸脱はその行で文書化されるようになった。最厳格設定には対応する価値のない指摘も実際にあり、その判断を一度でなく1,815回する必要があるという費用も名指しした。", "content_html": "<p><strong>状況.</strong> 多くのプロジェクトは静的検査の快適な一部だけを有効にし、設定当日に静かだった規則を選ぶ。その設定は守る基準でなく既存の癖の記録になり、無効な各規則は、将来も知らされない不具合の種類になる。</p>\n<p><strong>課題.</strong> 既定を逆転し、すべてをエラーで有効にして、再び無効にする交渉でなく、指摘を0まで解消する必要があった。</p>\n<p><strong>行動.</strong> 全規則の初回で1,815件が出た。ファイルでなく分類別に処理した。未使用引数や組み込み名の隠蔽は雑音でも、セキュリティ、可変既定値、例外処理は実際の動作を指していた。整形と検査の矛盾や、意図的な設計と反する規則など、本当の不適合には少数の例外を設け、規則の要求と別方式の理由をその場所へ記した。2例はコメントより進め、対象性質を検証する試験で例外が静かに広がらないようにした。型検査も別の、より厳しい基準で並行実行し、書き方でなく値の実体に関する、静的検査には見えない不具合を発見した。</p>\n<p><strong>結果.</strong> 全力の静的検査が指摘0で動き、逸脱はその行で文書化されるようになった。最厳格設定には対応する価値のない指摘も実際にあり、その判断を一度でなく1,815回する必要があるという費用も名指しした。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "Python", "テスト・品質保証", "自動化・CI/CD", "文書作成", "DevOps・CI/CD自動化", "バックエンド・API開発", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/vendored-a-qr-encoder-in-522-lines/", "url": "https://engineer.company/ja/portfolio/vendored-a-qr-encoder-in-522-lines/", "title": "522行のQR符号器を同梱", "summary": "実行時依存を2つに保ち、符号器は唯一の同梱部品となった。汎用実装ではなく、文書が使うモードと版だけに対応する。成熟ライブラリより優れるという主張でなく、依存数の予算が率直な採用理由だった。", "content_html": "<p><strong>状況.</strong> 文書にはオンライン版へのQRが必要だった。既存ライブラリはどれも可能だが、数年後も導入可能な生成器であるために、テンプレート・PDFの2依存に制限したところへ、3つ目を足すことになる。</p>\n<p><strong>課題.</strong> 依存を受け入れるか規格を実装するか決め、黒い四角ができるだけでなく正しい実装だと検証する必要があった。</p>\n<p><strong>行動.</strong> 用途に必要な部分を522行で実装した。バイトモード、256要素のGalois体上のReed‑Solomonと必要次数の生成多項式、位置検出・タイミング・位置合わせを含む固定配置、形式・版情報、4罰則で全8マスクを評価して最少を選ぶ処理だった。正当化を支えたのは検証だった。自分のロジックとの照合では証明にならないため、規格の読み順から独立に書いた復号器で完成行列を読み、入力文字列と一致させた。もっともらしい画像ではなく正しいURLに戻る符号とし、携帯で一度見るのでなく毎回検査した。</p>\n<p><strong>結果.</strong> 実行時依存を2つに保ち、符号器は唯一の同梱部品となった。汎用実装ではなく、文書が使うモードと版だけに対応する。成熟ライブラリより優れるという主張でなく、依存数の予算が率直な採用理由だった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "テスト・品質保証", "バックエンド開発", "性能改善", "文書作成", "バックエンド・API開発", "プラットフォーム・ソリューション設計" ] }, { "id": "https://engineer.company/ja/portfolio/wrote-tests-for-the-checkers-themselves/", "url": "https://engineer.company/ja/portfolio/wrote-tests-for-the-checkers-themselves/", "title": "検査自体のテストを作成", "summary": "全検査器に不正入力で失敗する証明が付き、範囲は正本を読むようになった。少なくとも2か所で不明な期間、緑の検査に意味がなかったことを露呈し、過去に何が通り抜けたかを後から知る方法はなかった。", "content_html": "<p><strong>状況.</strong> 綴り、ID範囲、文体、数値整合性などの独自検査が何か月も正常だった。正常入力しか見ず合格しか出さない検査は、何も読まない検査と区別できず、両者を判別するテストもなかった。</p>\n<p><strong>課題.</strong> 失敗できることを検査器に実証させ、照合する固定データを、対象物の手動複製から変える必要があった。</p>\n<p><strong>行動.</strong> 検出すべき不備を埋め、必ず検出させる方式を全体に適用した。誤字を通せばテスト失敗、一人称のレビューは拒否、禁止語も検出させる。それぞれ小さいが実際の死角を塞いだ。2検査は文書より狭い範囲しか読まず、内容を黙って飛ばしていたためだった。期待値も変えた。従来ID範囲はテスト内の数字と比較し、追加ごとに修正が必要で、見ずに数字を更新すれば検査を無効化できた。DBから導出し、古い記憶でなく実データを説明するようにした。</p>\n<p><strong>結果.</strong> 全検査器に不正入力で失敗する証明が付き、範囲は正本を読むようになった。少なくとも2か所で不明な期間、緑の検査に意味がなかったことを露呈し、過去に何が通り抜けたかを後から知る方法はなかった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "データベース", "データガバナンス", "テスト・品質保証", "自動化・CI/CD", "DevOps・CI/CD自動化", "データガバナンス・品質管理", "技術面の統率・コンサルティング", "専用AIエージェント開発" ] }, { "id": "https://engineer.company/ja/portfolio/found-the-hooks-and-the-gate-disagreeing/", "url": "https://engineer.company/ja/portfolio/found-the-hooks-and-the-gate-disagreeing/", "title": "フックと品質ゲートの不一致を発見", "summary": "同じ検査を実行することを実証し、文章の検査も毎コミットで動くようになった。内容増加とともにフック時間も増え、遅すぎれば迂回される地点があるため、この修正の寿命は検査の速さにかかっている。", "content_html": "<p><strong>状況.</strong> コミット前のフックと、任意実行の全品質ゲートがあった。文書はフックが全ゲートを実行し、すべて通らなければ履歴に入らないと記していたが、別ファイルの2一覧を手で維持し、比較していなかった。</p>\n<p><strong>課題.</strong> 両方をプログラムで列挙して差で失敗させ、主張を検証へ変える必要があった。</p>\n<p><strong>行動.</strong> フック設定とタスク定義から実際に呼ぶ検査を解決して比較すると、不一致だった。ゲートだけにある5検査は偶然でなく、実績を非人称に保つ文体、禁止語、言語間数値、表記、内容の綴りという、履歴書の文章を読むものだった。コードはすべて自動で守り、製品そのものである文章は記憶したときだけ守っており、想像と逆の露出だった。5つをフックへ入れ、うち2つをコミット予算に耐える速さへ改善し、比較テストを残して再びずれないようにした。意図を説明していた文書が、強制される事実を説明するものになった。</p>\n<p><strong>結果.</strong> 同じ検査を実行することを実証し、文章の検査も毎コミットで動くようになった。内容増加とともにフック時間も増え、遅すぎれば迂回される地点があるため、この修正の寿命は検査の速さにかかっている。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "Python", "テスト・品質保証", "自動化・CI/CD", "文書作成", "DevOps・CI/CD自動化", "技術文書の作成", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/moved-every-string-into-a-content-tree/", "url": "https://engineer.company/ja/portfolio/moved-every-string-into-a-content-tree/", "title": "すべての文字列をコンテンツツリーへ移行", "summary": "コードを触らず文章を編集し、件数で言語比較できるようになった。未完の言語は明確になり、完成途中の部分翻訳を静かに公開できなくなるという費用はあるが、それこそが目的だった。", "content_html": "<p><strong>状況.</strong> 3言語の実績、レビュー、見出し、概要など全利用者向け文字列がPython内にあった。文の編集がコード変更、翻訳レビューがソース差分となり、完成状況も見えない。存在していても間違い、到達不能でもある翻訳という重要な故障を隠していた。</p>\n<p><strong>課題.</strong> 描画せず数え、言語比較し、検査できるコンテンツツリーへ移す必要があった。</p>\n<p><strong>行動.</strong> 実績、レビュー、概要、肩書、会社、地域、分類、サービス、プロフィール、推薦者、応募文断片を、種類・言語の順に874ファイルへ整理した。ID付きの行はTSV、段落は個別ファイルにし、構築時に読み込んでDBを組み、ツリーを正本、DBを派生物にした。数えられるようになって2つ発見した。対応英語がない死んだ訳は、コード内では参照ありの辞書キーと区別できず見えなかった。また全実績を評価するはずの検査は、解決できた93件中37件だけを見て合格していた。ディレクトリにしたことで両方が件数の不一致として見えるようになった。</p>\n<p><strong>結果.</strong> コードを触らず文章を編集し、件数で言語比較できるようになった。未完の言語は明確になり、完成途中の部分翻訳を静かに公開できなくなるという費用はあるが、それこそが目的だった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "データガバナンス", "バックエンド開発", "移行・モダナイゼーション", "国際化", "文書作成", "データベース移行・モダナイゼーション", "データガバナンス・品質管理", "バックエンド・API開発", "国際化・ローカライズ" ] }, { "id": "https://engineer.company/ja/portfolio/built-a-cross-language-figure-check/", "url": "https://engineer.company/ja/portfolio/built-a-cross-language-figure-check/", "title": "言語間の数値照合を構築", "summary": "18の実際の不備を解消し、今後もコミット前に原文比較することで種類ごと閉じた。ただし意味は判断できない。数字が残り句読点がその言語のものでも、主張の向きを逆にした訳は正常に通る。", "content_html": "<p><strong>状況.</strong> 履歴書で最も有害な翻訳ミスは不自然な句ではなく、消える数値である。英語の50倍を「大幅に」と訳せば、一市場だけで主張を取り下げ、他で維持することになる。訳文だけなら良い文章なので、綴り、文法、その言語だけの人の読解では見つからない。</p>\n<p><strong>課題.</strong> 個別でなく言語同士を照合し、翻訳で残すべき数値と、その言語の表記を確認する検査が必要だった。</p>\n<p><strong>行動.</strong> 英語から数値、割合、倍率、単位を抽出し、各訳に存在を要求した。英語の50倍に対応するデンマーク語・ウクライナ語の特有の句を言語別に対応づけ、単なる文字一致や数字だけには頼らない。表記検査はその裏側で、小数点、桁区切り、引用符など、使うべき・使うべきでない慣行を定める。ウクライナ語のguillemetに英語の引用符を混ぜるのは、数値欠落と同じく誤りで、コピーでより起こりやすい。初回で数値のないデンマーク語説明2件と、英語式引用のウクライナ語16箇所を発見した。</p>\n<p><strong>結果.</strong> 18の実際の不備を解消し、今後もコミット前に原文比較することで種類ごと閉じた。ただし意味は判断できない。数字が残り句読点がその言語のものでも、主張の向きを逆にした訳は正常に通る。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "データガバナンス", "テスト・品質保証", "国際化", "自動化・CI/CD", "文書作成", "データガバナンス・品質管理", "技術文書の作成", "国際化・ローカライズ" ] }, { "id": "https://engineer.company/ja/portfolio/adopted-swift-6-strict-concurrency-over-c/", "url": "https://engineer.company/ja/portfolio/adopted-swift-6-strict-concurrency-over-c/", "title": "C上にSwift 6の厳密並行処理を採用", "summary": "抑制なしの完全検査でコンパイルでき、順序は期待でなく構造となった。一方、全体が1消費者を通るため可能なほど並列ではない。ここが制約になれば、安全に並べ替えられるイベントを導出し直す必要がある。それは、まさに今回避けた分析だった。", "content_html": "<p><strong>状況.</strong> Swift 6の完全な厳密並行処理検査は、データ競合を断続的なクラッシュでなくコンパイルエラーにする。ただしCライブラリ相手では難しく、ブロッキングするコアのイベントループを主スレッド外で永続実行し、返る値は並行性保証のないポインターである。境界を明示しなければ、コンパイラーは推論できず、すべてを拒否する。</p>\n<p><strong>課題.</strong> 注釈で回避せず、ブロッキングCループからメインアクターへの受け渡しを設計し、抜け道なしで完全検査を有効にする必要があった。</p>\n<p><strong>行動.</strong> 部分ごとのアクターという明白な方法を、好みでなく測定に基づき退けた。イベントごとにタスクを生むと任意順序に実行できるが、コアは順序付きであり、変更が作成を追い越せば、まだないメッセージの編集を表示する。アクターもメソッド途中で中断して他を処理する再入可能性により悪化させる。代わりに、ループを所有する1生産者スレッド、1消費者、その間の1キュー、最後のメインアクターへの1回の移動という単純な形にした。経路が1つで追い越せないため順序が残る。危険な値はラッパーの型で包み、安全を想定せず、1スレッドが所有し渡す前にコピーするという理由を文書化して、ラッパーでスレッド安全性を表明した。</p>\n<p><strong>結果.</strong> 抑制なしの完全検査でコンパイルでき、順序は期待でなく構造となった。一方、全体が1消費者を通るため可能なほど並列ではない。ここが制約になれば、安全に並べ替えられるイベントを導出し直す必要がある。それは、まさに今回避けた分析だった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "ソリューション設計", "テスト・品質保証", "バックエンド開発", "フロントエンド開発", "信頼性・バックアップ", "性能改善", "バックエンド・API開発", "プラットフォーム・ソリューション設計", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/wrote-a-parser-verifying-every-ffi-call/", "url": "https://engineer.company/ja/portfolio/wrote-a-parser-verifying-every-ffi-call/", "title": "全FFI呼び出しを検証する構文解析器を作成", "summary": "古い参照は実行時でなくビルド時に失敗するため、元のクラッシュの種類を防げる。限界は宣言を理解しても意味は理解しないことであり、同名・同シグネチャのまま上流が意味や所有規則を変えても、無指摘で通る。", "content_html": "<p><strong>状況.</strong> 初期にはアプリが期待する関数を手書きのCヘッダーで表していた。コンパイルとリンクは成功したが、コアから消えた3関数を実際に呼ぶと落ちた。コンパイラーもリンカーも実ライブラリでなく説明に満足し、差は実行時だけに現れた。</p>\n<p><strong>課題.</strong> 7,308行・268宣言の実ヘッダーを正本とし、Swift内の全利用をレビューでなく自動照合する必要があった。</p>\n<p><strong>行動.</strong> 実際の上流ヘッダーを解析し、関数、列挙定数、型を集め、Swiftの全呼び出しと定数参照を照合した。未宣言関数や改名済み定数でビルドを失敗させる。268宣言中132を使用し、136が未使用と把握できること自体も、未到達のコア範囲を正確に示す。さらに、コアポインターを所有する全Swiftクラスをfinalにする、コンパイラーが強制しない規則を設けた。継承先が破棄処理や寿命を変えると、近くにunsafe語がなくてもuse‑after‑freeになるため、ツリー全体を名前で検査した。</p>\n<p><strong>結果.</strong> 古い参照は実行時でなくビルド時に失敗するため、元のクラッシュの種類を防げる。限界は宣言を理解しても意味は理解しないことであり、同名・同シグネチャのまま上流が意味や所有規則を変えても、無指摘で通る。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "API・システム連携", "セキュリティ", "テスト・品質保証", "バックエンド開発", "自動化・CI/CD", "文書作成", "DevOps・CI/CD自動化", "バックエンド・API開発", "技術文書の作成" ] }, { "id": "https://engineer.company/ja/portfolio/took-the-test-suite-to-8-9-seconds/", "url": "https://engineer.company/ja/portfolio/took-the-test-suite-to-8-9-seconds/", "title": "テスト群を8.9秒に短縮", "summary": "6テストが60秒超、実時間74秒の状態から、135テストが8.9秒で通り、保存ごとに実行できる範囲へ入った。ただし共有固定データは結合点で、変更するテストが別テストを壊し得る。速度はコンパイラーが守らない読み取り専用の規律に依存する。", "content_html": "<p><strong>状況.</strong> 60秒制限を6テストが超えていた。1分超のテスト群は毎変更前に動かされず、過去の報告になる。制限を上げる直感こそ、10分のテスト群へ至る道だった。</p>\n<p><strong>課題.</strong> 高そうなテストを推測せず、プロファイルして、時間を予算化するのでなく所在を見つける必要があった。</p>\n<p><strong>行動.</strong> 実行中の主スレッドを測ると、4,017標本中3,989が2呼び出し内にあり、予想と違った。最も働くテストが遅いのでなく、ほぼ全テストが同じ箇所を通っていた。1つは非同期処理を落ち着かせる固定待機で、完了済みでも全イベント試験がsleep相当を払っていた。条件付き待機と上限時間へ替え、5 msで用意できれば5 ms、実際に止まった場合だけ全待機を払うようにした。もう1つは読み取り専用の高価な固定データを各テストで再構築していたことで、全体で1度にした。どちらも遅いと名指しされるテストでなく共通経路にあったため、一部だけ突出せず全体が遅かった。</p>\n<p><strong>結果.</strong> 6テストが60秒超、実時間74秒の状態から、135テストが8.9秒で通り、保存ごとに実行できる範囲へ入った。ただし共有固定データは結合点で、変更するテストが別テストを壊し得る。速度はコンパイラーが守らない読み取り専用の規律に依存する。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "テスト・品質保証", "自動化・CI/CD", "性能改善", "DevOps・CI/CD自動化", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/rewrote-error-messages-to-stop-blaming-users/", "url": "https://engineer.company/ja/portfolio/rewrote-error-messages-to-stop-blaming-users/", "title": "利用者を責めないエラーメッセージに改訂", "summary": "エラーは基準に従い、契機の例は旧文で失敗する試験を持った。ただし基準はレビューと1文の1試験で守られ、他の特殊要件を持つ事業者に同じ試験はない。範囲拡大は未解決で、種類ごと閉じたのでなく文書化した状態である。", "content_html": "<p><strong>状況.</strong> 大手メール事業者へのサインインが失敗し、アプリはパスワード誤りと伝えた。しかし第三者クライアントにはアプリ専用パスワードが必要で、通常のものはいくら正確に入力しても拒否される。成功しない再入力を促し、別種のパスワードを作る実際の指示はどこにもなかった。</p>\n<p><strong>課題.</strong> 全体にある習慣の目に見える一例なので、個別に継ぎ当てず、文書化した基準に沿ってエラーを書き直す必要があった。</p>\n<p><strong>行動.</strong> 起きたことを述べる、他に原因があるのに利用者の誤りと示唆しない、可能なら次の行動を示す、という3条件を定めた。多くは少なくとも1つに違反し、ライブラリの生の文言は人の状況でなくプログラマー向けの条件を説明していた。該当例は事業者名、他クライアントに専用パスワードが必要なこと、その作成先を記した。回帰テストはその事業者への失敗を起こし、名前と必要な認証種類を示す句を要求する。何らかのエラーだけを求めれば旧誤文も通るため、壊れていた唯一の部分である内容を検証した。</p>\n<p><strong>結果.</strong> エラーは基準に従い、契機の例は旧文で失敗する試験を持った。ただし基準はレビューと1文の1試験で守られ、他の特殊要件を持つ事業者に同じ試験はない。範囲拡大は未解決で、種類ごと閉じたのでなく文書化した状態である。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "UX・UI設計", "セキュリティ", "テスト・品質保証", "プロダクト・要件", "フロントエンド開発", "文書作成", "UI/UX設計・デザインシステム", "プロダクト戦略・要件定義", "技術文書の作成" ] }, { "id": "https://engineer.company/ja/portfolio/know-the-licence-of-everything-you-ship/", "url": "https://engineer.company/ja/portfolio/know-the-licence-of-everything-you-ship/", "title": "公開するすべての部品のライセンスを把握", "summary": "毎回配布条件を検査し、無言だったからでなく、失敗させたことで機能を確認した。以前はbundle、license、READMEが、未検証の644 crateについて主張していた。検査は宣言メタデータだけを読み、それが誤り・不完全なら証明できず、法的助言でもないという厳密な限界も明記した。", "content_html": "<p><strong>状況.</strong> Rustコアを配布アプリにリンクすることは、その依存物も配ることだった。644 crateにそれぞれ、場合によって複数のライセンスがある。通常の版更新の3段下にcopyleftが1つ入れば、誰も逐語的に読まないlockfileで、アプリ全体の配布条件が静かに変わる。</p>\n<p><strong>課題.</strong> 一度のレビューでなく、明示的な許可一覧で毎ビルド確認し、依存グラフの変更を他者の後日の発見でなくビルド失敗にする必要があった。</p>\n<p><strong>行動.</strong> 推移的な全グラフを解決し、各ライセンス式を許可条件へ、論理式として正しく照合した。2ライセンスから選べるなら片方、両方必須なら両方が許可されている必要がある。不一致は警告でなく失敗、許可追加は理由付きの意図的変更とした。失敗したことがない検査は失敗不能と区別できないため、2度故意に壊した。1度はcrateの条件を不許可に変え、新部品ではないため人が見落とす上流の条件変更を模擬した。もう1度は監査を再生成せずコアの固定版を動かし、隠れた依存追加を模擬した。両方が予定どおり失敗し、検査を緩めず維持した。</p>\n<p><strong>結果.</strong> 毎回配布条件を検査し、無言だったからでなく、失敗させたことで機能を確認した。以前はbundle、license、READMEが、未検証の644 crateについて主張していた。検査は宣言メタデータだけを読み、それが誤り・不完全なら証明できず、法的助言でもないという厳密な限界も明記した。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "データガバナンス", "セキュリティ", "自動化・CI/CD", "文書作成", "DevOps・CI/CD自動化", "データガバナンス・品質管理", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/portfolio/built-the-visual-identity-from-2-drawings/", "url": "https://engineer.company/ja/portfolio/built-the-visual-identity-from-2-drawings/", "title": "2点の図からビジュアルアイデンティティを構築", "summary": "タブを含む全アイコンが1原画・1コマンドから生まれ、古い素材でビルドが失敗するようになった。派生物はどこでも構築できるようコミットするが、外観変更には生成ツールが動く必要があり、原画形式が読めなくなれば全体を失うという強い依存は残る。", "content_html": "<p><strong>状況.</strong> 小企業の外観は購入、生成、既製素材の組み合わせになりやすく、誰のものでもない印象になる。一方、原画を失い、出力だけ手で直し、1年で版が食い違い、決着させる原本がない手作り素材はさらに悪かった。</p>\n<p><strong>課題.</strong> 外から調達せず描き、公開までの経路を再現可能にして、各ファイルを保管物でなく導出可能なものにする必要があった。</p>\n<p><strong>行動.</strong> ラスター画像の会社マークと、16 pxでも輪郭が残る想定で描いたベクター形式の歯車の2原画から始めた。16、32、48 pxで明暗のタブ背景に並べるとマークは識別でき、歯車は薄れたため、faviconもマークへ変え、全アイコンを同じ原画から生成した。必要サイズのfavicon、タッチアイコン、端末別起動画面をスクリプトで生成し、由来への答えをコマンドにした。派生物のコミット日が原画より先なら失敗する鮮度検査を設け、原画更新後の再生成忘れで旧画像が残る事態を防いだ。手編集禁止も原画の場所へ記した。</p>\n<p><strong>結果.</strong> タブを含む全アイコンが1原画・1コマンドから生まれ、古い素材でビルドが失敗するようになった。派生物はどこでも構築できるようコミットするが、外観変更には生成ツールが動く必要があり、原画形式が読めなくなれば全体を失うという強い依存は残る。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "UX・UI設計", "Web開発", "デザインシステム・UI", "テスト・品質保証", "ブランド・マーケティング", "自動化・CI/CD", "UI/UX設計・デザインシステム", "Webサイト・CMS開発", "ブランド・マーケティング・SEO" ] }, { "id": "https://engineer.company/ja/portfolio/held-4-repositories-to-one-history-standard/", "url": "https://engineer.company/ja/portfolio/held-4-repositories-to-one-history-standard/", "title": "4リポジトリで共通の履歴基準を維持", "summary": "4リポジトリが共通の履歴形式と指示構造を、規律でなくフックで共有した。ただし形式だけを見て内容は見ないため、何も説明しない適合件名も、変更を説明する件名と同じように通る。良い履歴そのものを保証するものではない。", "content_html": "<p><strong>状況.</strong> 1人で18か月かけた4リポジトリは、調整相手がなく、読みにくい履歴の費用をまだ不満を言わない未来の自分だけが払うため、手順を省きやすい。引き寄せるものがなければ、各リポジトリが独自の習慣へずれ、履歴も不統一になりやすい。</p>\n<p><strong>課題.</strong> 作業する全リポジトリで、履歴と指示の基準をそれぞれ1つにし、記憶でなく機械で適用する必要があった。</p>\n<p><strong>行動.</strong> 変更種別とscopeの慣例接頭辞、固定長未満の件名、絵文字禁止、帰属trailer禁止とした。ツールへの謝辞は変更の事実でなく、履歴は変更の事実のためだからだった。全作業リポジトリのcommit‑msgで不適合を拒否し、個人でなくリポジトリの性質にした。最大リポジトリはfeature156、fix133、docs128、chore81、refactor26、style20、performance5、test3だった。文書が修正に近いのは、4リポジトリに48指示文書を設けたためでもある。各々が領域別の規則であり、1つの入口からたどれるようにした。行数予算と目次所属を検査し、保管庫へ膨らまず道筋を保った。</p>\n<p><strong>結果.</strong> 4リポジトリが共通の履歴形式と指示構造を、規律でなくフックで共有した。ただし形式だけを見て内容は見ないため、何も説明しない適合件名も、変更を説明する件名と同じように通る。良い履歴そのものを保証するものではない。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "DevOps", "アジャイル・Scrum", "プロジェクト管理", "技術面の統率", "自動化・CI/CD", "文書作成", "DevOps・CI/CD自動化", "プロジェクト管理(アジャイル)", "技術文書の作成", "技術面の統率・コンサルティング" ] }, { "id": "https://engineer.company/ja/portfolio/made-six-collectors-state-what-they-skipped/", "url": "https://engineer.company/ja/portfolio/made-six-collectors-state-what-they-skipped/", "title": "6収集処理が省略した入力を明示", "summary": "数値ページに結果と死角が並ぶようになった。自己測定は品質ゲートではなく、時間上限もないため2倍になっても見えるだけで止めないと明記した。上限には実ホストの基準が必要で、今回意図的に創作しなかった。既存のしきい値は日平均に適用されるため、1分間のピークが平均に埋もれることがある。", "content_html": "<p><strong>状況.</strong> 6つの読み取り専用収集器はホストをMarkdownへ描いたが、時間、開けないファイル、省略入力を記さなかった。失敗を握りつぶす経路もあり、実際に読んだかにかかわらず完全で正常に見える数値ページを生んだ。途中で切れた回転ログは全数値から期間を消し、欠けた1週間は静かな週に見える。デーモンのログ形式変更による0は、訪問0と同じになる。安全報告もツール存在確認の背後にあり、firewall、socket、banツールがなければ、ルールもsocketもjailもない、施錠されたように見える実際は盲目のホストを描いていた。</p>\n<p><strong>課題.</strong> 2つを正常と誤認不能にする必要があった。人任せにせず何が不良かを報告で定め、収集費用と未利用入力の量を各収集器が示すことだった。</p>\n<p><strong>行動.</strong> 推測でなく既存116サンプルへ閾値を当て、観測範囲も隣へ記した。列は位置でなく名前で探し、値数とラベル数が違えば判定を拒否し、時刻形式変更の1列ずれから守る。判定は違反、非違反、未測定による未判定の3つにした。各収集器は実行時間と死角を、読めた対読めないファイル、journal総行対認識行、git拒否リポジトリ数、依頼先対応答先、要求した対未導入プローブとして示す。空なら消える行は別の沈黙なので、0でも全行を出す。全テンプレートには、自分より古い収集器の出力への明示的分岐も加えた。</p>\n<p><strong>結果.</strong> 数値ページに結果と死角が並ぶようになった。自己測定は品質ゲートではなく、時間上限もないため2倍になっても見えるだけで止めないと明記した。上限には実ホストの基準が必要で、今回意図的に創作しなかった。既存のしきい値は日平均に適用されるため、1分間のピークが平均に埋もれることがある。15分間隔のスイッチは利用可能メモリーと空きディスク容量を測定するが、確認の合間に起きる短時間のしきい値違反は、なお見逃すことがある。二つの仕組みは互いの代わりにはならず、その点を両方の報告書が説明している。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Python", "テスト・品質保証", "監視・オブザーバビリティ", "自動化・CI/CD", "信頼性・バックアップ", "文書作成", "サイト信頼性・監視", "システム管理", "技術文書の作成", "専用AIエージェント開発" ] }, { "id": "https://engineer.company/ja/portfolio/published-a-readable-tor-onion-mirror/", "url": "https://engineer.company/ja/portfolio/published-a-readable-tor-onion-mirror/", "title": "読みやすいTor onionミラーを公開", "summary": "1ビルドへの4入口のうち、これだけは計測しない。Geminiは要求、Gopherは接続を日別に、アドレス・パスなしで数えるが、onionにはカウンターも追加フラグもない。このサイトはその読者を意図的に数えず、その見えなさを報告不足ではなく方針の代償として受け入れている。", "content_html": "<p><strong>状況.</strong> サイトは1ビルドから3プロトコルへ応答していたが、訪問を知られずに読む人も通常アドレスへ出口ノードを往復していた。専用入口より弱い形だった。4つ目への当然の反論であるファイアウォールは、匿名化デーモンが外向き回線をつくるため当てはまらない。着信もポート開放も、2層の設定同期も不要だった。</p>\n<p><strong>課題.</strong> 同じページを配信し、他のミラーと同じ場所で告知し、乱数列でなく読み上げられるアドレスを持ち、そのアドレスとなる秘密鍵をリポジトリにも端末にも触れさせない必要があった。</p>\n<p><strong>行動.</strong> 公式ディストリビューションのパッケージから導入し、外向きproxy portを無効にした。自分で生成していないIDは上書きせず、手置きの鍵を使う。読みやすい名は選べず、base32公開鍵が希望接頭辞になるまで鍵対を作って探す。1文字増すごとに32倍かかる中で、会社名を示す接頭辞を得た。インベントリ宣言と実IDファイルを毎回照合し、鍵だけ替えて古い宣言が残れば失敗させる。既定の鍵パターンがdeploy keyには合うがこの鍵を逃すと測定し、秘密情報の両検査で捉えるようにした。元の乱数アドレスは段階的に切り替え、新告知中も旧を保った。鍵が正しく着いて変更0でも、新ディレクトリをserviceが参照せずアドレスが公開されない罠も発見し、未参照IDを失敗させるようにした。</p>\n<p><strong>結果.</strong> 1ビルドへの4入口のうち、これだけは計測しない。Geminiは要求、Gopherは接続を日別に、アドレス・パスなしで数えるが、onionにはカウンターも追加フラグもない。このサイトはその読者を意図的に数えず、その見えなさを報告不足ではなく方針の代償として受け入れている。また初期読者の別ブラウザーが、フッター依存のスクロール連動アニメーションを実装せず、奥付がトップ全面に出る実不具合を発見した。他の経路で知らせられない読み手が、通常サイトへの別の検証にもなった。</p>\n", "date_published": "2026-11-09T22:50:25+01:00", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja", "tags": [ "Linux・サーバー", "Web開発", "インフラ", "システム管理", "セキュリティ", "Webサイト・CMS開発", "コードによるインフラ管理", "セキュリティ・アクセス管理" ] }, { "id": "https://engineer.company/ja/notes/optimise-before-you-shard/", "url": "https://engineer.company/ja/notes/optimise-before-you-shard/", "title": "シャーディングの前にデータベースを最適化する", "summary": "シャーディングが必要に見えるデータベースも、まず調べるべき場合が大半です。測定、効率化、読み取りの分離、パーティション分割、シャーディングの順に進めます。", "content_html": "<p>負荷でデータベースが遅くなると、最初に出る提案は、たいていマシンを増やすことです。それが正しい場合もあります。しかし、遅い部分は、誰もまだ読んでいない少数のSQL文であることのほうが多く、データを複数のサーバーに分散しても、それぞれの文の費用は減らず、多くのハードウェアに広がるだけです。解決不能に見える問題が、一つのクエリプランを読むだけで、きれいに解決することもあります。そして、<span class=\"ann ann-n ann-blue\" data-note=\"増設する前に、まず中身を読む\">すでにあるデータベース</span>を誰も読まずに済むように、水平スケーリングが選ばれることもあります。</p>\n<p>何かを分割する前に、私たちは次の順で進めます。調べ、効率化し、プライマリーから読み取りを外し、負荷の集中箇所の周囲のテーブルをパーティション分割し、一台が有益な処理で埋まったときだけシャーディングします。全購入者が一つの行へ書き込むフラッシュセールは、<a href=\"/ja/notes/selling-limited-stock-without-overselling/\">最後の一枚を、一度だけ販売する</a>で詳しく扱っています。このノートは、その周囲の方法を説明し、最後の節では逆の提案、すなわち、すべてのサーバーから販売し、二重に売った分は謝罪する方法を検討します。</p>\n<h2 id=\"まず調べる\">まず調べる</h2>\n\n<p>知るべきことの大半は、PostgreSQLがすでに記録しています。変更する前に、四つの問いを投げかけます。</p>\n<p><strong>合計で最も費用のかかるSQL文は何か。</strong> <code>shared_preload_libraries</code>で読み込む拡張機能<code>pg_stat_statements</code>は、正規化した各SQL文と、その呼び出し回数、時間を保持します。平均ではなく合計で並べます。一時間に百万回実行する2 msのクエリは、二回実行する二秒のレポートより費用がかかります。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">SELECT</span><span class=\"w\"> </span><span class=\"n\">calls</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">round</span><span class=\"p\">(</span><span class=\"n\">total_exec_time</span><span class=\"p\">)</span><span class=\"w\"> </span><span class=\"k\">AS</span><span class=\"w\"> </span><span class=\"n\">total_ms</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">round</span><span class=\"p\">(</span><span class=\"n\">mean_exec_time</span><span class=\"p\">::</span><span class=\"nb\">numeric</span><span class=\"p\">,</span><span class=\"w\"> </span><span class=\"mi\">1</span><span class=\"p\">)</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">AS</span><span class=\"w\"> </span><span class=\"n\">mean_ms</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">left</span><span class=\"p\">(</span><span class=\"n\">query</span><span class=\"p\">,</span><span class=\"w\"> </span><span class=\"mi\">60</span><span class=\"p\">)</span><span class=\"w\"> </span><span class=\"k\">AS</span><span class=\"w\"> </span><span class=\"n\">query</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">FROM</span><span class=\"w\"> </span><span class=\"n\">pg_stat_statements</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">ORDER</span><span class=\"w\"> </span><span class=\"k\">BY</span><span class=\"w\"> </span><span class=\"n\">total_exec_time</span><span class=\"w\"> </span><span class=\"k\">DESC</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">LIMIT</span><span class=\"w\"> </span><span class=\"mi\">10</span><span class=\"p\">;</span></span></span></code></pre></div><p><strong>最上位のSQL文は、実際に何をしているか。</strong> <code>EXPLAIN (ANALYZE, BUFFERS)</code>はSQL文を実行し、選んだプラン、各段階で予想した行数と実際に返した行数、読み取ったページ数を示します。十行を返すために百万行を走査していたり、見積もりが百倍ずれていたりすれば、それだけでほぼ原因が分かります。<code>ANALYZE</code>は説明対象を実行するため、書き込みは<code>BEGIN</code>と<code>ROLLBACK</code>で囲みます。</p>\n<p><strong>誰が、誰を待っているか。</strong></p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">SELECT</span><span class=\"w\"> </span><span class=\"n\">pid</span><span class=\"p\">,</span><span class=\"w\"> </span><span class=\"n\">wait_event_type</span><span class=\"p\">,</span><span class=\"w\"> </span><span class=\"n\">wait_event</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">pg_blocking_pids</span><span class=\"p\">(</span><span class=\"n\">pid</span><span class=\"p\">)</span><span class=\"w\"> </span><span class=\"k\">AS</span><span class=\"w\"> </span><span class=\"n\">blocked_by</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">left</span><span class=\"p\">(</span><span class=\"n\">query</span><span class=\"p\">,</span><span class=\"w\"> </span><span class=\"mi\">60</span><span class=\"p\">)</span><span class=\"w\"> </span><span class=\"k\">AS</span><span class=\"w\"> </span><span class=\"n\">query</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">FROM</span><span class=\"w\"> </span><span class=\"n\">pg_stat_activity</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">WHERE</span><span class=\"w\"> </span><span class=\"n\">wait_event_type</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"s1\">'Lock'</span><span class=\"p\">;</span></span></span></code></pre></div><p>負荷が高い時間帯にここに行があれば、トランザクションはハードウェアではなく互いを待っています。マシンを高性能にしても、一つの共有行に対する更新を一つずつ順に実行する必要はなくなりません。アプリケーションサーバーを増やすと、書き込みを行うクライアントが、この待ち行列に加わることがあります。</p>\n<p><strong>サーバーは仕事をしているか、切り替えに追われているか。</strong> <code>pg_stat_activity</code>でアクティブなセッション数を数え、コア数と比較します。アクティブな数がコア数の何倍にもなると、サーバーは切り替えに時間を費やします。ハードウェアを変える前に、接続プールで対処できます。次に、<code>pg_stat_user_tables</code>の<code>n_dead_tup</code>を読みます。生きた行より不要な行が多いテーブルは、自分のごみを走査しています。データベースが小さすぎるのではなく、autovacuumが追い付いていません。</p>\n<p>分かったことを書き留めます。その後のすべての手順を評価する基準であり、「シャーディングは必要か」への率直な答えが、すでにそこにある場合も多いからです。</p>\n<h2 id=\"すでにあるものを効率化する\">すでにあるものを効率化する</h2>\n\n<p>おおむね、労力に対する効果が大きい順です。</p>\n<p><strong>問いに合うインデックス。</strong> 上記のプランで走査が分かります。頻繁なクエリが絞り込む列にインデックスを付けると、走査を検索に変えられます。部分インデックスには、例えばまだ販売中の在庫など、そのクエリが必要とする行だけを保持します。販売が進むにつれて、大きくなるのではなく小さくなります。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">CREATE</span><span class=\"w\"> </span><span class=\"k\">INDEX</span><span class=\"w\"> </span><span class=\"n\">units_unsold</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">ON</span><span class=\"w\"> </span><span class=\"n\">units</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"n\">item_id</span><span class=\"p\">)</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">WHERE</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"n\">sold</span><span class=\"p\">;</span></span></span></code></pre></div><p>すべてのインデックスには、書き込みのたびにも費用がかかります。<code>pg_stat_user_indexes</code>の<code>idx_scan</code>がゼロのままのものは削除します。</p>\n<p><strong>値の意味を示す型。</strong> 人でもモデルでも、急いで書いたスキーマでは、<code>SMALLINT</code>や<code>BOOLEAN</code>で足りるところに<code>TEXT</code>を使いがちです。<code>BOOLEAN</code>は一バイト、<code>SMALLINT</code>は二バイト、テキストの<code>'yes'</code>は四バイトです。また、PostgreSQLは固定長の各列を、その列のアラインメントに合わせて埋めるため、偶然決まった列順にも余分なバイトがかかります。急いで書いた在庫一点の定義です。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">CREATE</span><span class=\"w\"> </span><span class=\"k\">TABLE</span><span class=\"w\"> </span><span class=\"n\">units</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">sold</span><span class=\"w\"> </span><span class=\"nb\">text</span><span class=\"p\">,</span><span class=\"w\"> </span><span class=\"c1\">-- 'yes'または'no'\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">id</span><span class=\"w\"> </span><span class=\"nb\">bigint</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">reserved</span><span class=\"w\"> </span><span class=\"nb\">text</span><span class=\"p\">,</span><span class=\"w\"> </span><span class=\"c1\">-- 'yes'または'no'\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">reserved_at</span><span class=\"w\"> </span><span class=\"n\">timestamptz</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">item_id</span><span class=\"w\"> </span><span class=\"nb\">bigint</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">order_id</span><span class=\"w\"> </span><span class=\"nb\">bigint</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"p\">);</span></span></span></code></pre></div><p>同じ在庫を、値の意味を示す型で、幅の広いものから並べると、こうなります。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">CREATE</span><span class=\"w\"> </span><span class=\"k\">TABLE</span><span class=\"w\"> </span><span class=\"n\">units</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">id</span><span class=\"w\"> </span><span class=\"nb\">bigint</span><span class=\"w\"> </span><span class=\"k\">PRIMARY</span><span class=\"w\"> </span><span class=\"k\">KEY</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">reserved_at</span><span class=\"w\"> </span><span class=\"n\">timestamptz</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">order_id</span><span class=\"w\"> </span><span class=\"nb\">bigint</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">item_id</span><span class=\"w\"> </span><span class=\"nb\">integer</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">sold</span><span class=\"w\"> </span><span class=\"nb\">boolean</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"w\"> </span><span class=\"k\">DEFAULT</span><span class=\"w\"> </span><span class=\"k\">false</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">reserved</span><span class=\"w\"> </span><span class=\"nb\">boolean</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"w\"> </span><span class=\"k\">DEFAULT</span><span class=\"w\"> </span><span class=\"k\">false</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"p\">);</span></span></span></code></pre></div><p>PostgreSQL 18で測定すると、最初の行は72バイト、二つ目は54バイトで、四分の一小さくなり、テーブルのより多くの部分がメモリーに入ります。型は、そうでなければアプリケーションが防ぐ必要のある<code>'maybe'</code>などの値も拒否します。範囲に対しては、<code>quantity smallint CHECK (quantity > 0)</code>のような<code>CHECK</code>制約で同じことができます。</p>\n<p><strong>往復を減らし、データのある場所で処理する。</strong> アプリケーションが送るSQL文ごとに、通信の往復と解析の費用がかかります。百行を読み、一行ずつ更新するループは、一つの集合ベースのSQL文で済むところに、百一回の往復を使います。また、空きの数を数えるために商品の全在庫を取得するページは、一つの数字のために何千行も転送します。私たちの原則は、データを見る必要のあるもの、すなわち絞り込み、集計、現在の状態に依存する書き込みをデータベースに置くことです。業務ルールはアプリケーションに残します。システム内で最も増やしにくいCPUは、データベースのCPUだからです。</p>\n<p><strong>同じページに収まる更新。</strong> 一分間に何度も変わる行は、そのたびに新しい版を残します。インデックス付きの列を変えず、ページに空きがあれば、PostgreSQLは新しい版を同じページに置き、どのインデックスにも触れません。heap-only tuple、すなわちHOT更新です。そのため、頻繁な更新で変える列をインデックスから外し、ページに空きを残します。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">ALTER</span><span class=\"w\"> </span><span class=\"k\">TABLE</span><span class=\"w\"> </span><span class=\"n\">units</span><span class=\"w\"> </span><span class=\"k\">SET</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"n\">fillfactor</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"mi\">90</span><span class=\"p\">);</span></span></span></code></pre></div><p>設定は、それ以後に書くページに適用されるため、行を読み込む前に設定します。上記のテーブルでは、<code>reserved</code>、<code>reserved_at</code>、<code>order_id</code>を設定する2,000回の確保は、すべてHOTでした。一方、部分インデックスが参照する<code>sold</code>を設定する2,000回の更新には、HOTが一つもありませんでした。販売は一点につき一度ですが、確保は何度も起こり得ます。稼働中のシステムでは、<code>pg_stat_user_tables</code>の<code>n_tup_hot_upd</code>と<code>n_tup_upd</code>で割合を確認できます。</p>\n<h2 id=\"一行で誰が先だったかを決める\">一行で、誰が先だったかを決める</h2>\n\n<p>在庫は、その行にSQL文が最初に到達した購入者が確保し、確保はデータベースの時計で期限切れになります。二つの列で表します。真偽値の<code>reserved</code>と、設定した時刻の<code>reserved_at</code>です。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">UPDATE</span><span class=\"w\"> </span><span class=\"n\">units</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">SET</span><span class=\"w\"> </span><span class=\"n\">reserved</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"k\">true</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">reserved_at</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"n\">now</span><span class=\"p\">(),</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">order_id</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"k\">order</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">WHERE</span><span class=\"w\"> </span><span class=\"n\">id</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"n\">unit</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">AND</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"n\">sold</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">AND</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"n\">reserved</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">OR</span><span class=\"w\"> </span><span class=\"n\">reserved_at</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"o\"><</span><span class=\"w\"> </span><span class=\"n\">now</span><span class=\"p\">()</span><span class=\"w\"> </span><span class=\"o\">-</span><span class=\"w\"> </span><span class=\"nb\">interval</span><span class=\"w\"> </span><span class=\"s1\">'10 minutes'</span><span class=\"p\">)</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"n\">RETURNING</span><span class=\"w\"> </span><span class=\"n\">id</span><span class=\"p\">;</span></span></span></code></pre></div><p>一行返れば、この購入者が確保しています。返らなければ、別の人が先だったか、販売済みです。同じ在庫に対する二つの確保は、行ロックで順番を待ちます。PostgreSQLの標準であるREAD COMMITTEDでは、後の処理が、先の処理でコミットされた行に対して<code>WHERE</code>句を再確認するため、正確に一方だけが行を受け取ります。10分より古い確保は空きとみなすため、正しい答えを得るために、別途期限切れの確保を掃除する必要はありません。</p>\n<p>このため、真偽値だけでは完全な答えになりません。確保が期限切れになっても<code>reserved</code>はtrueのままで、在庫が確保中かどうかは二つの列を合わせて初めて分かります。問い合わせるクエリは、両方を見る必要があります。期限切れの確保を定期的に解除すれば、<code>reserved</code>だけを読む人にも実態を示せますが、正しさがその処理を待つことはありません。二つの値の整合性は、制約で維持します。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">ALTER</span><span class=\"w\"> </span><span class=\"k\">TABLE</span><span class=\"w\"> </span><span class=\"n\">units</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">ADD</span><span class=\"w\"> </span><span class=\"k\">CONSTRAINT</span><span class=\"w\"> </span><span class=\"n\">reserved_has_time</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">CHECK</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"n\">reserved</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">OR</span><span class=\"w\"> </span><span class=\"n\">reserved_at</span><span class=\"w\"> </span><span class=\"k\">IS</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"p\">);</span></span></span></code></pre></div><p>チケットのノートでは、開始時刻ではなく期限の<code>held_until</code>を保存しますが、同じ設計です。座席や番号付きの版画のように、購入者が在庫を選ぶ場合は、ここと同じくSQL文でそれを指定します。どの在庫でもよい場合は、そのノートの<code>SKIP LOCKED</code>形式で、他の人が確保していないものを一つ選びます。</p>\n<h2 id=\"プライマリーから読み取りを外す\">プライマリーから読み取りを外す</h2>\n\n<p>店舗のトラフィックの大半は、商品ページ、「残り3点」、買い物かご、注文履歴などの読み取りです。どれも、書き込みのために空けておくべき一台であるプライマリーを必要としません。ストリーミングレプリカに読み取りを受け持たせます。シャードの追加が一つのプロジェクトになるのに対し、レプリカの追加は設定で済みます。</p>\n<p>注意点は二つあります。レプリカは少し遅れるため、在庫を確保した直後に買い物かごをレプリカから読むと、確保が見えない場合があります。利用者が書き込んだ直後のデータはプライマリーから読むか、書き込み後の数秒間、その利用者をプライマリーへ送ります。また、レプリカ上の長いレポートは、レプリカが再生する変更を妨げると、キャンセルされる場合があります。PostgreSQLの文書では、これをクエリの競合と呼び、その競合とレプリカの遅延を調整する設定を挙げています。</p>\n<p>最も安い読み取りは、データベースに届かない読み取りです。商品の全在庫が確保されていれば、期限が切れるか解除されるまで、誰も購入できません。いつ空くかは、データベースが正確に答えられます。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">SELECT</span><span class=\"w\"> </span><span class=\"k\">count</span><span class=\"p\">(</span><span class=\"o\">*</span><span class=\"p\">)</span><span class=\"w\"> </span><span class=\"n\">FILTER</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">WHERE</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"n\">reserved</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">OR</span><span class=\"w\"> </span><span class=\"n\">reserved_at</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"o\"><</span><span class=\"w\"> </span><span class=\"n\">now</span><span class=\"p\">()</span><span class=\"w\"> </span><span class=\"o\">-</span><span class=\"w\"> </span><span class=\"nb\">interval</span><span class=\"w\"> </span><span class=\"s1\">'10 minutes'</span><span class=\"p\">)</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">AS</span><span class=\"w\"> </span><span class=\"k\">free</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">min</span><span class=\"p\">(</span><span class=\"n\">reserved_at</span><span class=\"p\">)</span><span class=\"w\"> </span><span class=\"o\">+</span><span class=\"w\"> </span><span class=\"nb\">interval</span><span class=\"w\"> </span><span class=\"s1\">'10 minutes'</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">AS</span><span class=\"w\"> </span><span class=\"k\">until</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">FROM</span><span class=\"w\"> </span><span class=\"n\">units</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">WHERE</span><span class=\"w\"> </span><span class=\"n\">item_id</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"n\">item</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">AND</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"n\">sold</span><span class=\"p\">;</span></span></span></code></pre></div><p><code>free</code>がゼロなら、<code>until</code>が最も早い確保の期限です。それを有効期限として「全数確保中」をキャッシュし、それより長くは保持しません。その間の訪問者には、データベースではなくキャッシュが販売不可と答えます。<code>free</code>がゼロで<code>until</code>が空なら、全在庫が販売済みで、答えは確定です。カードの拒否や買い物かごの放棄により、確保が早く解除された場合は、キャッシュ項目を削除して、すぐに販売を再開します。</p>\n<p>キャッシュは、不可としか答えません。可能という答えは常に上記の条件付き<code>UPDATE</code>から返します。そのため、古いキャッシュで数秒間販売機会を失うことはあっても、在庫を二重に売ることはありません。チケットのノートの「売り切れ」キャッシュに、有効期限を加えたものです。</p>\n<h2 id=\"負荷の高い行の周囲のテーブルをパーティション分割する\">負荷の高い行の周囲のテーブルをパーティション分割する</h2>\n\n<p>パーティション分割は、月やテナントなどのキーによって、一つの名前の背後でテーブルを複数に分けます。何をしないかも明確にすべきです。一つの競合する行を速くするものではありません。その行は依然として、一台のマシンの一つのパーティション内で、一つのロックの背後にあります。</p>\n<p>できるのは、負荷が集中する箇所の周囲のテーブルを小さく保つことです。注文、確保履歴、イベントは増え続けますが、クエリの大半は最近の部分だけを必要とします。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">CREATE</span><span class=\"w\"> </span><span class=\"k\">TABLE</span><span class=\"w\"> </span><span class=\"n\">orders</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">id</span><span class=\"w\"> </span><span class=\"nb\">bigint</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">created_at</span><span class=\"w\"> </span><span class=\"n\">timestamptz</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">DEFAULT</span><span class=\"w\"> </span><span class=\"n\">now</span><span class=\"p\">(),</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">item_id</span><span class=\"w\"> </span><span class=\"nb\">integer</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">quantity</span><span class=\"w\"> </span><span class=\"nb\">smallint</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">CHECK</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"n\">quantity</span><span class=\"w\"> </span><span class=\"o\">></span><span class=\"w\"> </span><span class=\"mi\">0</span><span class=\"p\">),</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">paid</span><span class=\"w\"> </span><span class=\"nb\">boolean</span><span class=\"w\"> </span><span class=\"k\">NOT</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"w\"> </span><span class=\"k\">DEFAULT</span><span class=\"w\"> </span><span class=\"k\">false</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">PRIMARY</span><span class=\"w\"> </span><span class=\"k\">KEY</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"n\">id</span><span class=\"p\">,</span><span class=\"w\"> </span><span class=\"n\">created_at</span><span class=\"p\">)</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"p\">)</span><span class=\"w\"> </span><span class=\"n\">PARTITION</span><span class=\"w\"> </span><span class=\"k\">BY</span><span class=\"w\"> </span><span class=\"n\">RANGE</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"n\">created_at</span><span class=\"p\">);</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"k\">CREATE</span><span class=\"w\"> </span><span class=\"k\">TABLE</span><span class=\"w\"> </span><span class=\"n\">orders_2026_10</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">PARTITION</span><span class=\"w\"> </span><span class=\"k\">OF</span><span class=\"w\"> </span><span class=\"n\">orders</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">FOR</span><span class=\"w\"> </span><span class=\"k\">VALUES</span><span class=\"w\"> </span><span class=\"k\">FROM</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"s1\">'2026-10-01'</span><span class=\"p\">)</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">TO</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"s1\">'2026-11-01'</span><span class=\"p\">);</span></span></span></code></pre></div><p>日付の範囲を指定したクエリは、その中のパーティションだけを読み、今月のインデックスは、メモリーに収まる大きさに保てます。保存期限の管理も、何百万行もの<code>DELETE</code>と、その後の肥大化やVACUUMではなく、一つの文になります。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">ALTER</span><span class=\"w\"> </span><span class=\"k\">TABLE</span><span class=\"w\"> </span><span class=\"n\">orders</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">DETACH</span><span class=\"w\"> </span><span class=\"n\">PARTITION</span><span class=\"w\"> </span><span class=\"n\">orders_2025_10</span><span class=\"p\">;</span></span></span></code></pre></div><p>主キーにはパーティションキーを含める必要があるため、<code>(id, created_at)</code>としています。キーを指定しないクエリはすべてのパーティションを読むため、すでにクエリが絞り込む項目で分割します。</p>\n<h2 id=\"シャーディングが妥当になるとき\">シャーディングが妥当になるとき</h2>\n\n<p>シャーディングでも動かせない限界があります。各商品には、担当する所有者が一つ必要です。同じ在庫を二台のサーバーで同時に確保することはできないため、シャーディングでは商品を丸ごと移し、一商品の半分だけを移すことはしません。一つの商品が一台の処理能力を超える場合は、チケットのノートにあるバケットで在庫を小さく分け、それぞれの部分に、やはり正確に一つの所有者を割り当てます。</p>\n<p>その条件の下で、次のいずれかが成り立ったときにだけ、シャーディングが妥当と考えます。</p>\n<ul>\n<li><strong>一台が有益な処理で埋まっている。</strong> SQL文はすでに効率化され、一回の条件付き書き込みにまとまり、トランザクション内の外部処理はなく、更新は同じページに収まっています。それでも、購入する価値のある最大のマシンで、一つではなく多くの商品にわたり、プライマリーのCPUや先行書き込みログが飽和しています。一つの人気商品は、シャードではなくバケットの問題です。</li>\n<li><strong>データが保守能力を超えている。</strong> 事業に約束した時間内にバックアップを復元できない、閑散時間にインデックスを作成したりテーブルをVACUUMしたりできない、または作業対象のデータがメモリーに収まらない場合です。</li>\n<li><strong>分離が要件である。</strong> 契約や規制当局によってデータを分離する必要があるテナント、あるいは他の販売とディスクを共有してはいけないテナントです。</li>\n</ul>\n<p>費用は、それ以外のすべてに及びます。マイグレーション、バックアップ、復元、レポートでは、別々のシャードを考慮する必要があります。シャード間の結合をアプリケーションのコードに移す場合もあり、シャードキーが分からないクエリは、すべてのシャードに問い合わせる必要が生じることがあります。ここまでの手順は、この負担を避けるためにあります。一度負うと、元に戻すのは困難です。</p>\n<h2 id=\"ロックより謝罪のほうが安い場合\">ロックより謝罪のほうが安い場合</h2>\n\n<p>逆の進め方にも、真剣に検討すべき主張があります。各サーバーが見える在庫から販売し、ときどき一点が二人に売れることを受け入れ、顧客対応が一方に謝罪して返金します。業務ロジックを結果整合性にし、競合しない99.9%のリクエストに合わせて構築し、非同期のループで後から競合を見つけて埋め合わせます。その代わり、店は「再試行してください」と言わずに済みます。HellandとCampbellは、_Building on Quicksand_で、この考え方を最も強く論じています。バックアップが受け取る前に処理を受け付けたと答えるシステムでは、すべての約束が確率的になり、企業は昔から守れなかった約束を謝罪で処理してきた、というものです。</p>\n<p>その大半に賛成します。違うのは、どこに適用するかです。</p>\n<p><strong>店舗の大半は、結果整合性であるべきです。</strong> 商品一覧、検索インデックス、「残り3点」の表示、買い物かご、おすすめ、メール、倉庫向けの出力、レポートは、すべて数秒遅れてもよく、これらの処理をプライマリーの応答待ちにしても、速さを失うだけで得るものはありません。Dynamoは、まさにこのためにつくられました。Amazonの買い物かごは、マシン障害中も「カートに追加」を忘れず拒否せず、その代償として、マージにより購入者が削除した商品が戻ることがあります。確保後の購入手続きは、チケットのノートでもすでに非同期です。局所的な手順をつなぐSaga、少なくとも一回配信するメッセージ、注文をキーとする冪等な受信処理を使います。Webhookは失われるため、決済事業者とやり取りする設計には、照合処理のループが必要です。</p>\n<p><strong>確保だけは、この考え方が成り立ちません。</strong> 「まれ」という説明は、競合がまれだと仮定しています。しかしフラッシュセールでは、競合こそが販売そのものです。自分の見える状態から販売するサーバーは、他のサーバーの販売結果を聞くまで売り続けます。そのため、超過販売数は、おおよそ試行頻度とレプリケーション遅延の積になります。単純なシミュレーションでは、二つのリージョンが毎秒2,000回の試行を分け合い、それぞれ自分の件数から販売し、200ミリ秒後に相手の販売を知る設定にしました。10,000点の販売を五回実行すると、各回で191点から205点の、存在しない在庫が売れました。計算では200点と予測します。試行頻度、遅延、他のリージョンで発生する販売の割合を掛けたものです。同じモデルで商品ごとに一つの所有者を置くと、正確に在庫数だけ売れました。これは、障害の有無にかかわらず、売り切れるたびに発生し、最も多くの購入者が見ている最高潮の瞬間に表面化します。</p>\n<p><strong>得られる稼働率は、聞こえるほど大きくありません。</strong> GilbertとLynchは、結果整合性で行う交換を証明しました。ネットワークが分断されている間、応答することと整合性を保つことは、同時にできません。AbadiのPACELCは、もう一方も加えます。分断がないときは、遅延と整合性の間の選択になります。商品ごとに一つの所有者を置き、効率的なSQL文を使う方法は、すでに高速です。どちらの設計も100%には達しません。決済事業者、DNS、それらの間のネットワークにも障害があります。厳密な設計が諦める範囲は、限定的です。ある商品の在庫を持つ所有者に到達できなければ、フェイルオーバーにかかる数秒、その商品の販売が止まります。チケットのノートの販売停止の節では、停止を障害マシン上の商品に限定します。他の商品の販売は続きます。</p>\n<p><strong>謝罪は返金だけではありません。</strong> 返金は安い部分です。購入者は、買えたと言われ、すでに列車を予約し、休暇を取り、友人に知らせているかもしれません。一秒早く「売り切れ」と聞くのは残念なことです。確定した注文を取り消されたと聞くのは、約束を破られたということです。顧客対応の人員は通常の日に合わせていますが、超過販売は一年で最も忙しい一分間に集中します。確定した注文を取り消す計画を立てる前に、注文確認が店にどのような義務を生むか、法律の専門家に確認してください。</p>\n<p><strong>非同期処理を残し、承諾の前に移します。</strong> この提案が正しいのは、購入者がロックを待つ必要はないという点です。すべてのクリックを、商品ごとに一つのパーティションを持つ、永続化して複製されたログに受け付け、回答を準備中と伝えます。クリックの受け付けはログだけに依存し、三台に複製したログなら、一台が故障しても書き込みを続けられます。商品ごとの一つの所有者が、ログを順にメモリーの速さで読んで判断し、数秒以内にメッセージで答えを返します。所有者がフェイルオーバー中なら、リクエストは拒否されたり二重に売られたりせず、ログで待ちます。承諾は取り置きを意味し、決済はチケットのノートの購入手続きと同様にその後に行うため、確保できなかった在庫に誰も支払いません。照合は引き続き行いますが、約束の後ではなく、その前に行います。</p>\n<p><strong>件数ではなく、在庫を分けます。</strong> リージョン同士で問い合わせずに販売する必要があれば、各リージョンに在庫枠を与え、その枠から独立して販売させます。枠がなくなったリージョンは追加を要求し、販売の終盤には、一つの所有者に枠を戻してまとめます。Bailisらは、通信なしでサーバーが維持できるルールを分析しており、在庫をゼロ未満にしないルールは、その一つではありません。在庫枠は通信を不要にはしません。頻繁な処理経路から、まれに枠を補充する時点へ移します。これが、不変条件を保つ結果整合性の設計です。唯一の費用は終盤にあり、別のリージョンには在庫があるのに、一方のリージョンで購入者を断る場合があります。</p>\n<p><strong>超過販売が適切な方針になるとき。</strong> 受注印刷、仕入れ先にまだ在庫があるTシャツ、ライセンスキーなど、追加で用意できる商品もあります。その場合、在庫数を超えた販売は、正直な納期を伴う取り寄せ注文であり、結果整合性が適切です。航空会社は意図的に過剰予約します。現れない人の割合を把握し、リスクを価格に反映し、事前に定めたルールで補償します。これが判断基準です。超過販売を許せるのは、事業側が販売前に、その規模と救済策を選んだ場合です。たまたま最後にクリックした人にしわ寄せが行くなら、不具合です。</p>\n<p><strong>謝罪を選ぶなら、決済と同じように構築します。</strong> 提案にあるループは返金処理であり、お金を動かすものに必要な要素を備えなければなりません。</p>\n<ul>\n<li><strong>すべての販売にIDを。</strong> 再試行でも同じ販売として扱い、追記専用の販売台帳を設けます。在庫数は台帳から算出し、直接編集しません。</li>\n<li><strong>誰が在庫を得るかのルール。</strong> 得られなかった購入者にも説明できるものにします。順序はログで決め、数ミリ秒の時計のずれで返金対象が決まる、別々のサーバーの時刻は使いません。</li>\n<li><strong>冪等で、記録される補償処理。</strong> キャンセル、決済の無効化または返金、購入者への通知です。Sagaの取り消し手順として、機械で実行します。</li>\n<li><strong>期限。</strong> 出荷前に、そして購入者が気付く前に、すべての超過販売を見つける必要があります。</li>\n<li><strong>測定する予算。</strong> 販売ごとの超過販売数を、事業側が承認した数と比較します。不変条件と同じダッシュボードに並べ、予算を使い切ったら通知します。</li>\n</ul>\n<p>私たちの答えは、確保の周囲は結果整合性、確保そのものは厳密、購入者への回答は非同期、という設計です。通常の経路に合わせて設計しますが、フラッシュセールでは競合が通常の経路です。何かと引き換えに少量の超過販売を認めるなら、事業側が選んだ数と、販売前に定めた救済策を用意し、測定します。</p>\n<h2 id=\"次に同じ課題に取り組む方へ\">次に同じ課題に取り組む方へ</h2>\n\n<ul>\n<li><strong>買い足す前に読みます。</strong> <code>pg_stat_statements</code>と一つの<code>EXPLAIN</code>は、新しいサーバーより多くの容量上の疑問に答えます。</li>\n<li><strong>型でデータの意味を示します。</strong> 真偽値を真偽値として保存すると、小さくなり、不正な値を拒否できます。</li>\n<li><strong>データを見る必要のある処理だけをデータベースに送ります。</strong> 絞り込みと集計はそこに置き、業務ルールは置きません。</li>\n<li><strong>キャッシュは不可と答え、可能と答えるのはデータベースだけです。</strong> 古いキャッシュで失うのは数秒であり、在庫ではありません。</li>\n<li><strong>パーティション分割は整理です。</strong> 負荷の高い行の周囲のテーブルを小さく保ちますが、その行自体には何もしません。</li>\n<li><strong>一台が有益な処理で埋まったらシャーディングします。</strong> 待ち時間で埋まったときではありません。</li>\n<li><strong>承諾した後ではなく、前に照合します。</strong> 確保の周囲はすべて結果整合性にできます。確保そのものをそうすると、毎回の販売で、試行頻度と遅延の積に応じた超過販売が起きます。</li>\n</ul>\n<h2 id=\"出典\">出典</h2>\n\n<ul>\n<li><a href=\"https://www.postgresql.org/docs/current/pgstatstatements.html\">PostgreSQL:pg_stat_statements</a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/using-explain.html\">PostgreSQL:EXPLAINの使い方</a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/monitoring-stats.html\">PostgreSQL:累積統計システム</a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/datatype-numeric.html\">PostgreSQL:数値型</a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/datatype-character.html\">PostgreSQL:文字型</a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/datatype-boolean.html\">PostgreSQL:真偽値型</a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/indexes-partial.html\">PostgreSQL:部分インデックス</a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/storage-hot.html\">PostgreSQL:heap-only tuple(HOT)</a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/ddl-partitioning.html\">PostgreSQL:テーブルのパーティション分割</a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/hot-standby.html\">PostgreSQL:ホットスタンバイとクエリの競合</a></li>\n<li><a href=\"https://arxiv.org/abs/0909.1788\">Pat Helland、Dave Campbell『Building on Quicksand』</a></li>\n<li><a href=\"https://groups.csail.mit.edu/tds/papers/Gilbert/Brewer2.pdf\">Seth Gilbert、Nancy Lynch『Brewer’s Conjecture and the Feasibility of Consistent, Available, Partition-Tolerant Web Services』</a></li>\n<li><a href=\"https://www.cs.umd.edu/~abadi/papers/abadi-pacelc.pdf\">Daniel Abadi『Consistency Tradeoffs in Modern Distributed Database System Design』</a></li>\n<li><a href=\"https://www.allthingsdistributed.com/files/amazon-dynamo-sosp2007.pdf\">DeCandiaほか『Dynamo: Amazon’s Highly Available Key-value Store』</a></li>\n<li><a href=\"https://www.cs.cornell.edu/andru/cs711/2002fa/reading/sagas.pdf\">Hector Garcia-Molina、Kenneth Salem『Sagas』</a></li>\n<li><a href=\"https://www.vldb.org/pvldb/vol8/p185-bailis.pdf\">Bailisほか『Coordination Avoidance in Database Systems』</a></li>\n</ul>\n", "date_published": "2026-10-14T00:00:00Z", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja" }, { "id": "https://engineer.company/ja/notes/selling-limited-stock-without-overselling/", "url": "https://engineer.company/ja/notes/selling-limited-stock-without-overselling/", "title": "最後の一枚を、一度だけ販売する", "summary": "フラッシュセールの超過販売を生むのは、大きなデータベースではなく負荷が集中する一行です。条件付き書き込み、期限付きの取り置き、Sagaで対処します。", "content_html": "<p>フラッシュセールでは、一万点の在庫に百万人が同時に向かいます。注目すべき障害は、店が停止することではありません。稼働し続けたまま、一万四十点を売ってしまうことです。その後の反射的な提案、「データベースが小さすぎるから、シャーディングしよう」は、誰も問うていない問題に答えています。データベースが大きすぎたことは、一度もありません。全購入者が、<span class=\"ann ann-n ann-blue ann-cjk\" data-note=\"インシデント全体が一行に収まっています\">同じ行</span>へ書き込んでいたのです。</p>\n<p>プロジェクトで起きる前に、ここで問題を分解します。上限はどこから来るのか、その大半を取り除く一つのSQL文は何か、本当に一つのデータベースで足りなくなったら何を構築するのかを説明します。</p>\n<h2 id=\"一行にすべての購入者\">一行に、すべての購入者</h2>\n\n<p>クラスタ全体に二千万行を分散させるのは、すでに解かれた問題です。すべてのリクエストが変更する一行は、そうではありません。その行はいずれか一台に存在するため、マシンを増やしても解決しません。分散ストアも、この点を明確にしています。DynamoDBでは、一つのパーティションに毎秒約1,000書き込みユニットを割り当てます。他のパーティションがいくつあっても、一つの項目への書き込みは、その項目のパーティションに集中します。</p>\n<p>この構造の背後には定理があります。Bailisらは、各レプリカが独自に書き込みを受け付けても、正しい状態へマージできる不変条件を、invariant-confluentと呼びます。<code>stock >= 0</code>は、それに当てはまらない典型です。残り一点と見える二つのレプリカが、それぞれ販売すると、どのようにマージしても二つ目の販売は取り消せません。超過販売を決して起こさないためには、協調が必要です。問題は、一回の販売でどれだけの協調の費用を払うかだけです。</p>\n<h2 id=\"上限を決める数値\">上限を決める数値</h2>\n\n<p>一商品の上限は、おおよそ、一つのロックで行う販売数を、ロックの保持時間で割ったものです。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-text\" data-lang=\"text\"><span class=\"line\"><span class=\"cl\">一商品当たりの最大販売数/秒 ≈ ロック一回当たりの販売数 ÷ ロック保持時間</span></span></code></pre></div><table>\n\t<thead>\n\t\t\t<tr>\n\t\t\t\t\t<th>行を保持する処理</th>\n\t\t\t\t\t<th>一行当たりの上限</th>\n\t\t\t</tr>\n\t</thead>\n\t<tbody>\n\t\t\t<tr>\n\t\t\t\t\t<td>ロックしてから決済を呼び出す</td>\n\t\t\t\t\t<td>~2/s</td>\n\t\t\t</tr>\n\t\t\t<tr>\n\t\t\t\t\t<td>ロックしてからアプリのロジックを実行する</td>\n\t\t\t\t\t<td>~100–200/s</td>\n\t\t\t</tr>\n\t\t\t<tr>\n\t\t\t\t\t<td>一つの条件付き<code>UPDATE</code></td>\n\t\t\t\t\t<td>~500–2,000/s</td>\n\t\t\t</tr>\n\t\t\t<tr>\n\t\t\t\t\t<td>一回のコミットに100件をまとめる</td>\n\t\t\t\t\t<td>~50,000/s</td>\n\t\t\t</tr>\n\t\t\t<tr>\n\t\t\t\t\t<td>メモリー上の単一の書き手</td>\n\t\t\t\t\t<td>~100,000+/s</td>\n\t\t\t</tr>\n\t</tbody>\n</table>\n<p>これらは桁の目安であり、ベンチマークではありません。数値はハードウェアで変わりますが、構造は変わりません。短いロックの大半は、コミットがログのディスク到達を待つ時間です。まとめて処理すると二桁の差が出るのは、百件の販売が一回のフラッシュを共有するためです。</p>\n<p>調整できる点は四つで、以下の各設計はいずれかを使います。</p>\n<ol>\n<li><strong>ロックの保持時間を短くする。</strong> 一つの文にし、その中にネットワーク処理を入れません。</li>\n<li><strong>一つのロックで多く処理する。</strong> 減算をまとめます。</li>\n<li><strong>ロックの数を増やす。</strong> 複数のキーに在庫を分けます。</li>\n<li><strong>ロックに届くリクエストを減らす。</strong> 到達する前に大半の購入者へ不可と答えます。</li>\n</ol>\n<p>最後の点は、思う以上に重要です。百万人の購入者に一万点の在庫なら、990,000件のリクエストは失敗しなければなりません。拒否がトラフィックの大半なので、「売り切れ」を最も安く返せる回答にします。販売前の待合室、在庫数程度の購入者を通すゲート、誰にも問い合わせずCDNが返す<code>sold_out</code>フラグ、アカウントごとのレート制限を使います。</p>\n<h2 id=\"まず一つのデータベースを直す\">まず一つのデータベースを直す</h2>\n\n<p>極端に遅い、または超過販売する実装は、通常この形です。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">BEGIN</span><span class=\"p\">;</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"k\">SELECT</span><span class=\"w\"> </span><span class=\"n\">available</span><span class=\"w\"> </span><span class=\"k\">FROM</span><span class=\"w\"> </span><span class=\"n\">inventory</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">WHERE</span><span class=\"w\"> </span><span class=\"n\">item_id</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"n\">item</span><span class=\"w\"> </span><span class=\"k\">FOR</span><span class=\"w\"> </span><span class=\"k\">UPDATE</span><span class=\"p\">;</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"c1\">-- アプリケーションが在庫数を確認し、\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"c1\">-- 決済事業者を呼び出すこともある\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"k\">UPDATE</span><span class=\"w\"> </span><span class=\"n\">inventory</span><span class=\"w\"> </span><span class=\"k\">SET</span><span class=\"w\"> </span><span class=\"n\">available</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"k\">new</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">WHERE</span><span class=\"w\"> </span><span class=\"n\">item_id</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"n\">item</span><span class=\"p\">;</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"k\">COMMIT</span><span class=\"p\">;</span></span></span></code></pre></div><p>ロック自体は正しく、何の間保持するかが誤っています。アプリケーションが<code>SELECT</code>と<code>UPDATE</code>の間に使う一ミリ秒は、そのまま次の購入者が待つ一ミリ秒です。<code>FOR UPDATE</code>がなければ、さらに悪化します。二人が1を読み、二人とも0を書き、一点が二重に売れます。</p>\n<p>確認と減算を一つの文にするのが、修正方法です。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">UPDATE</span><span class=\"w\"> </span><span class=\"n\">inventory</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">SET</span><span class=\"w\"> </span><span class=\"n\">available</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"n\">available</span><span class=\"w\"> </span><span class=\"o\">-</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"n\">qty</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">WHERE</span><span class=\"w\"> </span><span class=\"n\">tenant_id</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"n\">tenant</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">AND</span><span class=\"w\"> </span><span class=\"n\">item_id</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"n\">item</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">AND</span><span class=\"w\"> </span><span class=\"n\">available</span><span class=\"w\"> </span><span class=\"o\">>=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"n\">qty</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"n\">RETURNING</span><span class=\"w\"> </span><span class=\"n\">available</span><span class=\"p\">;</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"c1\">-- 一行返れば確保済み。返らなければ売り切れ。</span></span></span></code></pre></div><p>PostgreSQLのREAD COMMITTEDでは、最初の購入者が行を保持している間に次の購入者が到達すると、待ってから、最初の処理がコミットした行に対して<code>WHERE</code>句を再評価します。最初の販売で最後の一点がなくなれば、条件が満たされず、次の購入者には負数ではなく、行なし、つまり売り切れが返ります。REPEATABLE READまたはSERIALIZABLEでは、次の購入者は代わりに直列化失敗を受け取ります。安全ですが、競合が再試行になるため、この文はREAD COMMITTED向けです。MySQLのInnoDBでも、<code>UPDATE</code>はどの分離レベルでも最新のコミット済みの行を読むため、同じ答えになります。制約も追加し、別の箇所の不具合が、存在しない在庫を販売するのではなく、明確に失敗するようにします。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">ALTER</span><span class=\"w\"> </span><span class=\"k\">TABLE</span><span class=\"w\"> </span><span class=\"n\">inventory</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">ADD</span><span class=\"w\"> </span><span class=\"k\">CONSTRAINT</span><span class=\"w\"> </span><span class=\"n\">available_not_negative</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">CHECK</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"n\">available</span><span class=\"w\"> </span><span class=\"o\">>=</span><span class=\"w\"> </span><span class=\"mi\">0</span><span class=\"p\">);</span></span></span></code></pre></div><p>一つのデータベースで行う残りの作業は、おおむね効果の大きい順に次のとおりです。</p>\n<ul>\n<li><strong>トランザクション内に外部処理を入れません。</strong> 決済の呼び出し、HTTPリクエスト、メッセージ配信は、その前か後に行います。</li>\n<li><strong>負荷の高い行には最後に触れます。</strong> 注文などを先に挿入し、競合する行のロックを、最後の文とコミットの間だけにします。</li>\n<li><strong>負荷の高いカウンターに楽観的ロックを使いません。</strong> バージョン列は競合を再試行に変え、セール中には再試行が負荷になります。</li>\n<li><strong>読み取りを別の場所で処理します。</strong> 商品ページの「残り12点」は、一秒遅れのレプリカやキャッシュから取得できます。プライマリーを必要とするのは、販売だけです。</li>\n<li><strong>在庫に専用のデータベースを与えます。</strong> 販売が、同じディスクを使う商品一覧の処理を待たないようにします。</li>\n<li><strong>接続をプールします。</strong> 十万人の購入者には、PgBouncer経由の数十の接続を用い、一つのロックを何千ものバックエンドが待たないようにします。</li>\n</ul>\n<p>座席は一つずつ異なるため、別の構造で、別のSQL文が必要です。一座席を一行にし、他のトランザクションが保持する行を、後ろで待つ代わりに飛ばします。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-sql\" data-lang=\"sql\"><span class=\"line\"><span class=\"cl\"><span class=\"k\">UPDATE</span><span class=\"w\"> </span><span class=\"n\">seats</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">SET</span><span class=\"w\"> </span><span class=\"n\">held_by</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"k\">order</span><span class=\"p\">,</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"n\">held_until</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"n\">now</span><span class=\"p\">()</span><span class=\"w\"> </span><span class=\"o\">+</span><span class=\"w\"> </span><span class=\"nb\">interval</span><span class=\"w\"> </span><span class=\"s1\">'10 min'</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">WHERE</span><span class=\"w\"> </span><span class=\"n\">id</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">SELECT</span><span class=\"w\"> </span><span class=\"n\">id</span><span class=\"w\"> </span><span class=\"k\">FROM</span><span class=\"w\"> </span><span class=\"n\">seats</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">WHERE</span><span class=\"w\"> </span><span class=\"n\">event_id</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"p\">:</span><span class=\"n\">event</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">AND</span><span class=\"w\"> </span><span class=\"n\">sold_at</span><span class=\"w\"> </span><span class=\"k\">IS</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">AND</span><span class=\"w\"> </span><span class=\"p\">(</span><span class=\"n\">held_until</span><span class=\"w\"> </span><span class=\"k\">IS</span><span class=\"w\"> </span><span class=\"k\">NULL</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">OR</span><span class=\"w\"> </span><span class=\"n\">now</span><span class=\"p\">()</span><span class=\"w\"> </span><span class=\"o\">></span><span class=\"w\"> </span><span class=\"n\">held_until</span><span class=\"p\">)</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">LIMIT</span><span class=\"w\"> </span><span class=\"mi\">1</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"w\"> </span><span class=\"k\">FOR</span><span class=\"w\"> </span><span class=\"k\">UPDATE</span><span class=\"w\"> </span><span class=\"n\">SKIP</span><span class=\"w\"> </span><span class=\"n\">LOCKED</span><span class=\"p\">)</span><span class=\"w\">\n</span></span></span><span class=\"line\"><span class=\"cl\"><span class=\"n\">RETURNING</span><span class=\"w\"> </span><span class=\"n\">id</span><span class=\"p\">;</span></span></span></code></pre></div><p>期限切れの取り置きは、そのまま再び空きになるため、正しい答えのために期限切れを掃除する処理は必要ありません。<code>now()</code>はデータベースの時計なので、時計がずれているアプリケーションサーバー同士でも、期限切れの時点は一致します。</p>\n<p>多くの店舗では、この節だけで修正が完了します。以下のことより先に行ってください。シャーディングは、入るのは簡単でも、戻るには費用のかかる、一方通行の扉だからです。</p>\n<h2 id=\"先に確保し次に支払う\">先に確保し、次に支払う</h2>\n\n<p>最後の一点を確保しても、カード入力を放棄した購入者は、まだ購入していません。そのため、販売は一度の書き込みではなく、短いライフサイクルです。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-text\" data-lang=\"text\"><span class=\"line\"><span class=\"cl\">AVAILABLE → HELD, 数分間 → SOLD\n</span></span><span class=\"line\"><span class=\"cl\"> → RELEASED</span></span></code></pre></div><ul>\n<li><strong>取り置きのキーは、試行ではなく要求に結び付けます。</strong> 各購入手続きに冪等性キーを付け、取り置きテーブルに<code>UNIQUE (tenant_id, idempotency_key)</code>を設けます。クリックを再試行しても、二点目ではなく、既存の取り置きを返します。PostgreSQLの注意点として、<code>INSERT ... ON CONFLICT DO NOTHING RETURNING id</code>は、行がすでにあると何も返しません。そのため、「行なし」は「失敗」ではなく「調べ直す」という意味です。</li>\n<li><strong>すべての状態遷移に条件を付けます。</strong> 販売確定は、まだ<code>held</code>の場合だけ<code>held</code>から<code>sold</code>へ移し、解除は、その更新が正確に一行を変更した場合だけ在庫を戻します。タイムアウトとキャンセルボタンなどで解除が二度実行されても、在庫を戻すのは一度です。</li>\n<li><strong>取り置きは数分で期限切れにします。</strong> 通常は五分から十分です。決済が始まったら一度だけ延長し、遅いカード処理によって、支払い中の在庫を失わないようにします。</li>\n<li><strong>取り置きの時点で購入者ごとの数量を制限します。</strong> 一つのアカウントが、決めかねている間に全在庫を確保しないようにします。</li>\n</ul>\n<p>すべての土台にあるのは、設計の中で最も役立つ一行です。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-text\" data-lang=\"text\"><span class=\"line\"><span class=\"cl\">available + held + sold = total</span></span></code></pre></div><p>各トランザクションの後に成り立ち、一つのクエリで確認できます。成り立たなくなれば、顧客に言われる前に、どこかで超過販売または在庫の消失が起きたと分かります。</p>\n<h2 id=\"一つのデータベースでは足りない場合\">一つのデータベースでは足りない場合</h2>\n\n<p>多数のテナント、多数の同時販売、複数のリージョンなど、本当に足りない場合もあります。拡張する構造でも、一つのルールを守ります。各商品の在庫を所有するのは、正確に一つの在庫サービスであり、他は決定しません。そのサービスを<code>(tenant_id, item_id)</code>でシャーディングし、一商品の書き込みが二つのシャードにまたがらないようにします。最大のテナントには専用のセルを与え、その販売が他のテナントの処理能力を奪わないようにします。同期である必要があるのは予約だけで、その後はすべてメッセージにできます。</p>\n<p>シャード内の人気商品には四つの手段があり、それぞれ上記の調整点を使います。</p>\n<p><strong>前段にゲートを置く。</strong> Luaスクリプトで減算するRedisカウンターを使い、確認と減算を一つの手順にまとめ、在庫数程度の購入者を通して、他はマイクロ秒単位で断ります。これが最終判断者ではありません。Redisの複製は非同期であり、フェイルオーバー後の新しいプライマリーは、一部の入場を忘れて、少し多く通す場合があります。それでも、データベースの条件付き<code>UPDATE</code>が決定し、照合処理がデータベースの数値でゲートを再設定します。</p>\n<p><strong>在庫を分ける。</strong> 一万点を、百点ずつ百個のバケットに分け、それぞれを別の行またはシャードにして、各購入者を一つへ送れます。一つではなく百個のロックになります。この考え方は古く、1986年のO’Neilのエスクロートランザクション、続くBarbaráとGarcia-Molinaのdemarcation protocol、さらにBalegasらの上限・下限付きカウンターへとつながっています。本当の費用は一つ、終盤にあります。他に在庫があっても購入者のバケットが空になるため、別のバケットを試すか残りを移し、販売の終わり近くでは一つに戻してまとめます。同じ考え方で各リージョンに専用の在庫枠を与えれば、大半の販売で海を越えて問い合わせる必要はありません。</p>\n<p><strong>一商品に一つの書き手。</strong> ある商品のすべての要求をKafkaの一つのパーティションに入れ、一つの受信処理が、メモリーに件数を保持し、判断をまとめてコミットします。一つのスレッドで、ロックはありません。LMAXの構造です。要求にはIDを付け、キューは二度配信することがあるため、書き手は判断済みのものを捨てます。</p>\n<p><strong>在庫を行にする。</strong> 座席や番号付きの限定品など、数が少なく一つずつ異なる場合は、事前に一つずつ行を作り、上記の<code>SKIP LOCKED</code>で確保します。または、在庫IDをRedisの集合に保持し、<code>SPOP</code>で一つ取り出します。競合するカウンターはなくなります。</p>\n<h2 id=\"購入手続きの残り\">購入手続きの残り</h2>\n\n<p>決済、注文、領収書は別のシステムであり、それらをまたぐトランザクションはありません。教科書どおりなら二相コミットですが、ここでは誤った答えです。参加者のどれかが遅い間は止まり、最も負荷の高い経路に通信の往復を加え、そもそも決済事業者は参加しません。局所的な手順をつなぎ、それぞれに取り消しの手順を持たせるSagaを使います。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-text\" data-lang=\"text\"><span class=\"line\"><span class=\"cl\">1. 在庫を確保する 取り消し:取り置きを解除する\n</span></span><span class=\"line\"><span class=\"cl\">2. 注文を保留状態にする 取り消し:注文を取り消す\n</span></span><span class=\"line\"><span class=\"cl\">3. 取り置きを延長する (自動で期限切れになる)\n</span></span><span class=\"line\"><span class=\"cl\">4. 与信を取得する 取り消し:与信を取り消す\n</span></span><span class=\"line\"><span class=\"cl\">5. HELD → SOLDを確定する\n</span></span><span class=\"line\"><span class=\"cl\">6. 決済を確定する</span></span></code></pre></div><p>最初に与信し、最後に売上を確定すれば、取り置きの期限後に到着した決済は、返金ではなく無効化で済みます。お金はまだ動いていないからです。各手順は、変更と同じトランザクションで、その変更を知らせるメッセージをoutboxテーブルに書き、変更データキャプチャーで配信します。保存と送信の間に失われるものはありません。各受信処理は注文をキーに冪等とします。メッセージは少なくとも一回届き、冪等性によって、実質的に一回になります。</p>\n<p>ここに分散ロックを入れる必要はありません。Kleppmannの指摘は、ロックを持つ処理が、ガベージコレクションや仮想マシンの停止により、リース期限を超えて止まってから書き込み続ける可能性があることです。対処には、ストアが確認するフェンシングトークンが必要です。しかし、トークンを確認できるストアなら、<code>available >= :qty</code>も確認でき、最初からロックは不要です。</p>\n<h2 id=\"超過販売せずその商品の販売を止める\">超過販売せず、その商品の販売を止める</h2>\n\n<p>整合性と可用性は、システム単位ではなく、問いごとに選びます。「この一点を販売できるか」には整合性が必要です。在庫の所有者に到達できないときは、その商品の販売を止めます。商品一覧、「残り3点」の表示、注文履歴など、それ以外は、少し古くても提供を続けられます。</p>\n<p>最も気付きにくい超過販売は、フェイルオーバーで起きます。非同期複製では、プライマリーが販売を承諾した後、レプリカに届く前に停止し、昇格したレプリカでは販売が失われ、同じ在庫が再び売れます。対処は、承諾する前に、複数のマシンで販売を永続化することです。PostgreSQLの同期スタンバイ(<code>synchronous_commit</code>と<code>synchronous_standby_names</code>)、またはRaftを基盤とするストアを使います。コミットごとに遅延が加わり、上限の式の分母に当たるロック保持時間が、その分長くなります。まとめて処理することとゲートで、その費用を取り戻します。停止の範囲も限定します。シャードの障害では、その上の商品だけを止め、店舗全体は止めません。</p>\n<h2 id=\"検証する\">検証する</h2>\n\n<p>私たちの説明も含め、信じるだけで済ませるべきではありません。</p>\n<ul>\n<li><strong>不変条件を監視します。</strong> <code>available + held + sold = total</code>を定期実行し、グラフにし、ずれがあれば緊急通知します。超過販売ゼロは、期待ではなく、通知を伴うサービス水準目標です。</li>\n<li><strong>意図して競合させます。</strong> 百点の在庫に一万人が同時購入するテストを用意し、正確に百点が売れ、負数が一つもないことを検証します。</li>\n<li><strong>競合の最中に壊します。</strong> Jepsenのように、プライマリーを停止し、ネットワークを切り、プロセスを一時停止し、その後で不変条件を確認します。</li>\n<li><strong>拒否する経路の負荷をテストします。</strong> トラフィックの99%が売り切れでも、その経路を高速に保ち、エッジで吸収する必要があります。</li>\n<li><strong>指標を一つのダッシュボードに置きます。</strong> ロック待ち、期限切れの取り置き、ゲートとデータベースの件数の差を表示します。</li>\n</ul>\n<h2 id=\"進める順序\">進める順序</h2>\n\n<ol>\n<li>まず測定します。<code>pg_stat_statements</code>とロック待ちから、そもそも負荷の高い行が原因かどうかが分かります。</li>\n<li>書き込みを、一つの条件付きSQL文にします。</li>\n<li>待合室、ゲート、キャッシュした「売り切れ」で、負荷を減らします。</li>\n<li>在庫に専用のサービスと所有者を与えます。</li>\n<li>最初の四つで足りない場合だけ、<code>(tenant_id, item_id)</code>でシャーディングします。</li>\n<li>予定されているセールに向け、バケットまたは単一の書き手を使う人気商品モードを追加します。</li>\n<li>リージョンは最後にし、在庫枠を設けます。</li>\n</ol>\n<h2 id=\"次に同じ課題に取り組む方へ\">次に同じ課題に取り組む方へ</h2>\n\n<ul>\n<li><strong>シャーディングが答えるのは、別の問いです。</strong> 多数の行を分散しますが、超過販売の問題は一行です。構築する前に、どちらの問題かを見極めます。</li>\n<li><strong>確認と減算を一つの文にします。</strong> 正常な販売と超過販売の差の大半は、数値を読んでから書くまでの時間です。</li>\n<li><strong>トラフィックの大半は、不可という回答です。</strong> 拒否を、システムが最も安くできることにします。</li>\n<li><strong>超過販売する前に止めます。</strong> 三十秒販売を止めた商品には、謝罪が必要です。二重に売った商品には、返金、顧客対応の待ち行列、忘れない顧客が生まれます。</li>\n<li><strong>不変条件を書き出し、監視します。</strong> 一行だけですが、レビュー上ではなく本番で設計が機能していると分かる、唯一のものです。</li>\n</ul>\n<h2 id=\"出典\">出典</h2>\n\n<ul>\n<li><a href=\"https://www.postgresql.org/docs/current/transaction-iso.html#XACT-READ-COMMITTED\">PostgreSQL:Read Committedの分離レベル</a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/sql-select.html#SQL-FOR-UPDATE-SHARE\">PostgreSQL:<code>FOR UPDATE</code>と<code>SKIP LOCKED</code></a></li>\n<li><a href=\"https://www.postgresql.org/docs/current/warm-standby.html#SYNCHRONOUS-REPLICATION\">PostgreSQL:同期複製</a></li>\n<li><a href=\"https://www.vldb.org/pvldb/vol8/p185-bailis.pdf\">Bailisほか『Coordination Avoidance in Database Systems』</a></li>\n<li><a href=\"https://arxiv.org/abs/1503.09052\">Balegasほか『Extending Eventually Consistent Cloud Databases for Enforcing Numeric Invariants』</a></li>\n<li><a href=\"https://martin.kleppmann.com/2016/02/08/how-to-do-distributed-locking.html\">Martin Kleppmann:分散ロックの方法</a></li>\n<li><a href=\"https://martinfowler.com/articles/lmax.html\">Martin Fowler:LMAXのアーキテクチャ</a></li>\n<li><a href=\"https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html\">DynamoDB:パーティションキーの設計</a></li>\n<li><a href=\"https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.Partitions.html\">DynamoDB:パーティションとデータ分散</a></li>\n<li><a href=\"https://microservices.io/patterns/data/saga.html\">microservices.io:Saga</a></li>\n<li><a href=\"https://microservices.io/patterns/data/transactional-outbox.html\">microservices.io:トランザクショナルoutbox</a></li>\n<li><a href=\"https://redis.io/docs/latest/operate/oss_and_stack/management/replication/\">Redis:複製</a></li>\n<li><a href=\"https://jepsen.io/\">Jepsen</a></li>\n</ul>\n", "date_published": "2026-10-13T00:00:00Z", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja" }, { "id": "https://engineer.company/ja/notes/safari-underline-font-subset/", "url": "https://engineer.company/ja/notes/safari-underline-font-subset/", "title": "すべての文字を横切った下線", "summary": "Safariで下線がすべてのディセンダーを貫いていました。原因は、そのページでは読み込まないキリル文字フォントのサブセットの宣言でした。", "content_html": "<p>このサイトでは、すべてのリンクに下線を引き、<code>g</code>、<code>p</code>、コンマなど、文字の下に伸びる部分と重なるところに、ブラウザーが隙間を空けるようにしています。Safariでは、そうなりませんでした。線が文字をまっすぐ貫いていました。英語版とデンマーク語版では、サイトが<span class=\"ann ann-n ann-blue\" data-note=\"安っぽく見えるだけなので、誰も報告しない不具合\">多言語になった当初から</span>起きていました。</p>\n<p>原因は、それらのページでは決してダウンロードしない文字体系の、三つのフォント宣言でした。</p>\n<h2 id=\"本来のブラウザーの動作\">本来のブラウザーの動作</h2>\n\n<p><code>text-decoration-skip-ink</code>は、ディセンダーの周囲で下線を途切れさせるプロパティです。標準で有効になっています。何年もの間、「下線の見た目がおかしい」というときには、<code>text-underline-offset</code>で線をさらに下へ動かすのが定番でした。しかし、それは適切な反応ではありません。線を動かすとデザインが変わってしまい、本当に欠けていたのは隙間だからです。</p>\n<p>本題の原因を見つける前に、実際の原因を二つ見つけました。どちらも知っておく価値があります。</p>\n<ul>\n<li><strong><code>1px</code>の下線には、<code>1px</code>相当の隙間しかできません。</strong> エンジンが空ける隙間は、線の太さに比例します。スタイルシートで太さを一ピクセルに固定していたため、文字の縦画の両側には約0.6pxしか空きませんでした。計算上は隙間でも、見た目には文字をまっすぐ通る線です。<code>text-decoration-thickness: auto</code>にすると両方が連動して大きくなり、下線を一ピクセルも動かさず、隙間が3.5pxから12.4pxになりました。</li>\n<li><strong><code>from-font</code>は、名前ほど無難な既定値ではありません。</strong> 書体自身が宣言する太さを読みますが、UbuntuではLightが0.056em、Mediumが0.020em、Boldが0.120emです。Mediumの下線がLightの半分より細い書体ファミリーです。大きく表示すると、同じページに六ピクセルの線と二ピクセルの線が並びます。</li>\n</ul>\n<p>これでChromeは直りました。しかしSafariでは、線がまだすべてを貫いていました。</p>\n<h2 id=\"最も時間がかかった部分\">最も時間がかかった部分</h2>\n\n<p>実際のSafariを動かし、下線の色を変え、八倍の縮尺でスクリーンショットを撮り、線が途切れて再開する箇所のピクセルを数えて、正確に測定しました。</p>\n<table>\n\t<thead>\n\t\t\t<tr>\n\t\t\t\t\t<th></th>\n\t\t\t\t\t<th>描画された太さ</th>\n\t\t\t\t\t<th>ディセンダー周囲の隙間</th>\n\t\t\t</tr>\n\t</thead>\n\t<tbody>\n\t\t\t<tr>\n\t\t\t\t\t<td><svg class=\"browser-mark ti-brand\" aria-hidden=\"true\"><use href=\"/icons/browsers.0ba2bcfa23ee31cd1f0f0c26d989e16b7db9ff8763cfad34dbb801ae81339da6.svg#ti-brands-chrome\"></use></svg>Chrome</td>\n\t\t\t\t\t<td>2.00px</td>\n\t\t\t\t\t<td>5.8 / 12.5 / 6.3px</td>\n\t\t\t</tr>\n\t\t\t<tr>\n\t\t\t\t\t<td><svg class=\"browser-mark ti-brand\" aria-hidden=\"true\"><use href=\"/icons/browsers.0ba2bcfa23ee31cd1f0f0c26d989e16b7db9ff8763cfad34dbb801ae81339da6.svg#ti-brands-safari\"></use></svg>Safari</td>\n\t\t\t\t\t<td>1.38px</td>\n\t\t\t\t\t<td>1.8 / 1.0 / 1.0px</td>\n\t\t\t</tr>\n\t</tbody>\n</table>\n<p>つまり、Safariも隙間は空けていました。ただしChromeの六分の一しかなく、通常の文字サイズでは、一ピクセルの隙間は隙間に見えません。さらに、通常使う調整が逆効果でした。太さを3pxにするとSafariの隙間は三つから一つに減り、4pxではなくなりました。線の太さに合わせて隙間を拡大しないためです。Chromeが0.6emを取るところを、Safariはどのサイズでも約0.07emに固定していました。</p>\n<p>二十ほどの宣言を試しました。<code>skip-ink: all</code>、同じプロパティの二つの旧式の表記、半ピクセルから四ピクセルまでのすべての太さ、<code>text-underline-position</code>、<code>font-smoothing</code>、<code>text-rendering</code>、<code>paint-order</code>です。どれも隙間を広げませんでした。その時点では、WebKitが単に隙間に上限を設けており、スタイルシートからはそれ以上できることがない、というのが率直な結論でした。</p>\n<p>しかし、その結論は誤りでした。覆したのは、<a href=\"https://github.com/fontsource/fontsource/issues/1096\">フォントプロジェクトへの不具合報告</a>でした。Safariは、非ラテン文字のサブセットとともに書体を読み込むと、skip-inkを無視するという内容です。</p>\n<h2 id=\"本当の原因\">本当の原因</h2>\n\n<p>このサイトは、Ubuntuを六つに分けて配信しています。ラテン文字の三つのウェイトと、キリル文字の三つのウェイトです。これにより、ウクライナ語のページも、OS任せの代替書体ではなく、英語版と同じ書体で表示できます。各ファイルが対応する文字の範囲を宣言し、ブラウザーは、そのページに実際に必要なものだけをダウンロードします。</p>\n<p>自然な書き方として、六つすべてに一つのファミリー名を使っていました。それが発生条件で、<a href=\"https://bugs.webkit.org/show_bug.cgi?id=255159\">WebKitの不具合255159</a>に記録されています。<strong>ファミリーの一つのフェイスが非ラテン文字の範囲を宣言すると、Safariはそのファミリーのすべての文字でskip-inkの動作を劣化させます。</strong> 別のファイルを一度も取得しないページのラテン文字も対象です。</p>\n<p>スタイルシートのどこかにウクライナ語フォントの宣言があるだけで、英語ページの下線が崩れていました。実行時にその三行だけを削除し、他を変えないと、隙間が1.8/1.0/1.0pxから4.5/11.0/5.0pxになりました。</p>\n<h2 id=\"修正\">修正</h2>\n\n<p>もう一つの文字体系に専用のファミリー名を付け、フォントスタックで最初の書体の後に指定します。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-css\" data-lang=\"css\"><span class=\"line\"><span class=\"cl\"><span class=\"p\">@</span><span class=\"k\">font-face</span> <span class=\"p\">{</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nt\">font-family</span><span class=\"o\">:</span> <span class=\"nt\">UbuntuCyrillic</span><span class=\"o\">;</span> <span class=\"c\">/* 変更前:Ubuntu */</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nt\">src</span><span class=\"o\">:</span> <span class=\"nt\">url</span><span class=\"o\">(</span><span class=\"nt\">ubuntu_300_cyrillic</span><span class=\"p\">.</span><span class=\"nc\">woff2</span><span class=\"o\">)</span> <span class=\"nt\">format</span><span class=\"o\">(</span><span class=\"s1\">'woff2'</span><span class=\"o\">);</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nt\">unicode-range</span><span class=\"o\">:</span> <span class=\"nt\">U</span><span class=\"o\">+</span><span class=\"nt\">0400-045F</span><span class=\"o\">,</span> <span class=\"nt\">U</span><span class=\"o\">+</span><span class=\"nt\">0490-0491</span><span class=\"o\">;</span>\n</span></span><span class=\"line\"><span class=\"cl\"><span class=\"p\">}</span>\n</span></span><span class=\"line\"><span class=\"cl\">\n</span></span><span class=\"line\"><span class=\"cl\"><span class=\"p\">:</span><span class=\"nd\">root</span> <span class=\"p\">{</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nv\">--body-font</span><span class=\"p\">:</span> <span class=\"n\">Ubuntu</span><span class=\"p\">,</span> <span class=\"n\">UbuntuCyrillic</span><span class=\"p\">,</span> <span class=\"n\">system-ui</span><span class=\"p\">,</span> <span class=\"kc\">sans-serif</span><span class=\"p\">;</span>\n</span></span><span class=\"line\"><span class=\"cl\"><span class=\"p\">}</span></span></span></code></pre></div><p>ラテン文字は最初のファミリーで見つかるため、二つ目に進みません。キリル文字は、対応する字形のない最初のファミリーを通過し、システム書体ではなく二つ目にたどり着きます。ダウンロードするものは引き続き文字範囲で決まるため、読み込みは変わりません。英語とデンマーク語のページは、ラテン文字の三ファイルだけを取得し、キリル文字は取得しません。ウクライナ語では、その逆です。</p>\n<p>三つの宣言の名前変更と、スタックへの一項目の追加でした。Safariの隙間は4.5/11.0/5.0pxになり、Chromeは変わらず、下線も動かず、ウクライナ語は同じ幅のUbuntuで表示され続けています。</p>\n<h2 id=\"次に同じ問題に遭う方へ\">次に同じ問題に遭う方へ</h2>\n\n<ul>\n<li><strong>skip-inkの測定結果は、測定したエンジンでだけ正しいものです。</strong> 数値の表、正しい診断、有効な修正があっても、すべてChromiumでの話でした。調査を再開するきっかけは、ページを見た人のスクリーンショットでした。</li>\n<li><strong>オフセットより先に太さを調整します。</strong> 隙間を広げればデザインを保てますが、線を下げるとデザインを変えてしまいます。</li>\n<li><strong>文字体系ごとの書体の分割は適切ですが、ファミリー名も分ける必要があります。</strong> 文字体系間で名前を共有すると記述は分かりやすくなりますが、Safariのskip-inkを失います。名前を再統合するのは整理に見えて、回帰になります。</li>\n<li><strong>読み込みは、最初から原因ではありませんでした。</strong> キリル文字フォントでページの表示が崩れるなら、不要なものをダウンロードしているはずだと考えがちです。しかし、そうではありませんでした。宣言だけで十分でした。</li>\n</ul>\n<h2 id=\"出典\">出典</h2>\n\n<ul>\n<li><a href=\"https://bugs.webkit.org/show_bug.cgi?id=255159\">WebKitの不具合255159:<code>text-decoration-skip-ink</code>とフォントのサブセット</a></li>\n<li><a href=\"https://github.com/fontsource/fontsource/issues/1096\">発生条件を示したFontsourceの問題1096</a></li>\n<li><a href=\"https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration-skip-ink\">MDN:<code>text-decoration-skip-ink</code></a></li>\n<li><a href=\"https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/unicode-range\">MDN:<code>unicode-range</code></a></li>\n</ul>\n", "date_published": "2026-09-28T00:00:00Z", "date_modified": "2026-11-12T06:34:23+01:00", "language": "ja" }, { "id": "https://engineer.company/ja/notes/solana-mobile-wallet-deeplinks/", "url": "https://engineer.company/ja/notes/solana-mobile-wallet-deeplinks/", "title": "Solanaのモバイルウォレット内でdAppを開く", "summary": "Phantom、Solflare、Backpackの閲覧用ディープリンクがモバイルで失敗する理由と、正しい形式、起動条件、修正方法を説明します。", "content_html": "<p><code>@solana/wallet-adapter-react</code>で構築したReactのdAppは、パソコンのウォレットには問題なく接続します。しかしスマートフォンでは、同じ手順がうまくいきません。ウォレット内のブラウザーでdAppを開く必要があるのに、それを行うはずのディープリンクが、何も言わず失敗します。Backpackでは「アプリをダウンロード」のページになり、Solflareではアプリは開いてもサイトが開きません。どの変形も失敗するように見えました。問題を分解すると、一つの症状に見える、四つの別々の問題でした。</p>\n<h2 id=\"四つの問題\">四つの問題</h2>\n\n<ul>\n<li><strong>Backpackのリンク形式が誤っていました。</strong> 文書にある形式は<code>https://backpack.app/ul/v1/browse/<url>?ref=<ref></code>だけです。対象URLをパスに置き、<code>ref</code>を必須とするユニバーサルリンクです。推測した<code>backpack://ul/v1/browse?url=...</code>のような独自スキームは、アプリが登録するどのルートにも一致せず、ウォレットのインストールページに着きます。</li>\n<li><strong>Solflareにもユニバーサルリンクが必要です。</strong> <code>https://solflare.com/ul/v1/browse/<url>?ref=<ref></code>を使い、単なる<code>solflare://</code>スキームは使いません。スキームだけでは、アプリを起動しても移動先を指定できない場合があります。まさに「アプリは開くが、サイトのタブは手動で開く必要がある」という状態です。</li>\n<li><strong>両方のパラメーターをエンコードする必要があります。</strong> <code>url</code>はdAppの完全な絶対アドレス、<code>ref</code>は要求元のオリジンで、それぞれ<code>encodeURIComponent</code>を通します。対象URLにエンコードしていない<code>?</code>や<code>&</code>があると解析が崩れ、ウォレットはブラウザータブではなくホーム画面を開きます。</li>\n<li><strong>起動のきっかけも、リンク自体と同じくらい重要です。</strong> ユニバーサルリンクがアプリを切り替えるのは、OSが信頼する移動操作のときだけです。アドレスバーに貼り付けても、意図的に何もしません。そのため、完全に正しいリンクもテスト中に「失敗」します。</li>\n</ul>\n<h2 id=\"文書にある形式\">文書にある形式</h2>\n\n<ul>\n<li>Phantom:<code>https://phantom.app/ul/browse/<url>?ref=<ref></code>。この形式に<code>/v1</code>はありません。</li>\n<li>Solflare:<code>https://solflare.com/ul/v1/browse/<url>?ref=<ref></code></li>\n<li>Backpack:<code>https://backpack.app/ul/v1/browse/<url>?ref=<ref></code></li>\n</ul>\n<p>三つとも、同じパターンで扱えます。</p>\n<div class=\"highlight\"><pre tabindex=\"0\" class=\"chroma\"><code class=\"language-js\" data-lang=\"js\"><span class=\"line\"><span class=\"cl\"><span class=\"kr\">const</span> <span class=\"nx\">WALLET_BROWSE</span> <span class=\"o\">=</span> <span class=\"p\">{</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nx\">phantom</span><span class=\"o\">:</span> <span class=\"p\">(</span><span class=\"nx\">url</span><span class=\"p\">,</span> <span class=\"nx\">ref</span><span class=\"p\">)</span> <span class=\"p\">=></span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"sb\">`https://phantom.app/ul/browse/</span><span class=\"si\">${</span><span class=\"nx\">url</span><span class=\"si\">}</span><span class=\"sb\">?ref=</span><span class=\"si\">${</span><span class=\"nx\">ref</span><span class=\"si\">}</span><span class=\"sb\">`</span><span class=\"p\">,</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nx\">solflare</span><span class=\"o\">:</span> <span class=\"p\">(</span><span class=\"nx\">url</span><span class=\"p\">,</span> <span class=\"nx\">ref</span><span class=\"p\">)</span> <span class=\"p\">=></span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"sb\">`https://solflare.com/ul/v1/browse/</span><span class=\"si\">${</span><span class=\"nx\">url</span><span class=\"si\">}</span><span class=\"sb\">?ref=</span><span class=\"si\">${</span><span class=\"nx\">ref</span><span class=\"si\">}</span><span class=\"sb\">`</span><span class=\"p\">,</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nx\">backpack</span><span class=\"o\">:</span> <span class=\"p\">(</span><span class=\"nx\">url</span><span class=\"p\">,</span> <span class=\"nx\">ref</span><span class=\"p\">)</span> <span class=\"p\">=></span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"sb\">`https://backpack.app/ul/v1/browse/</span><span class=\"si\">${</span><span class=\"nx\">url</span><span class=\"si\">}</span><span class=\"sb\">?ref=</span><span class=\"si\">${</span><span class=\"nx\">ref</span><span class=\"si\">}</span><span class=\"sb\">`</span><span class=\"p\">,</span>\n</span></span><span class=\"line\"><span class=\"cl\"><span class=\"p\">};</span>\n</span></span><span class=\"line\"><span class=\"cl\">\n</span></span><span class=\"line\"><span class=\"cl\"><span class=\"kd\">function</span> <span class=\"nx\">walletBrowseLink</span><span class=\"p\">(</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nx\">walletName</span><span class=\"p\">,</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nx\">targetUrl</span> <span class=\"o\">=</span> <span class=\"nb\">window</span><span class=\"p\">.</span><span class=\"nx\">location</span><span class=\"p\">.</span><span class=\"nx\">href</span><span class=\"p\">,</span>\n</span></span><span class=\"line\"><span class=\"cl\"><span class=\"p\">)</span> <span class=\"p\">{</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"kr\">const</span> <span class=\"nx\">build</span> <span class=\"o\">=</span> <span class=\"nx\">WALLET_BROWSE</span><span class=\"p\">[</span><span class=\"nx\">walletName</span><span class=\"p\">.</span><span class=\"nx\">toLowerCase</span><span class=\"p\">()];</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"k\">if</span> <span class=\"p\">(</span><span class=\"o\">!</span><span class=\"nx\">build</span><span class=\"p\">)</span> <span class=\"k\">return</span> <span class=\"kc\">null</span><span class=\"p\">;</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"k\">return</span> <span class=\"nx\">build</span><span class=\"p\">(</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nb\">encodeURIComponent</span><span class=\"p\">(</span><span class=\"nx\">targetUrl</span><span class=\"p\">),</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"nb\">encodeURIComponent</span><span class=\"p\">(</span><span class=\"nb\">window</span><span class=\"p\">.</span><span class=\"nx\">location</span><span class=\"p\">.</span><span class=\"nx\">origin</span><span class=\"p\">),</span>\n</span></span><span class=\"line\"><span class=\"cl\"> <span class=\"p\">);</span>\n</span></span><span class=\"line\"><span class=\"cl\"><span class=\"p\">}</span></span></span></code></pre></div><h2 id=\"iosとandroidが受け入れる方法でリンクを開く\">iOSとAndroidが受け入れる方法でリンクを開く</h2>\n\n<ul>\n<li><strong>事前計算した、本物のリンク要素を描画します。</strong> 単純な<code><a href={walletBrowseLink('phantom')}></code>が、両方の環境で最も確実な起動方法です。</li>\n<li><strong>プログラムから行う必要がある場合</strong>は、タップのハンドラー内で、同期的に<code>window.location.href</code>へ代入します。その前に<code>await</code>、<code>fetch</code>、<code>setTimeout</code>を挟みません。非同期処理の後では操作の文脈が失われ、iOSはウォレットのウェブサイトへ移動します。<code>window.open</code>は使いません。</li>\n<li><strong>アドレスバーへの貼り付けでは、決してテストしません。</strong> ユニバーサルリンクは、そこでは意図的に動作しません。リンクをタップするか、カメラでQRコードを読み取ってテストします。</li>\n<li><strong>メッセージアプリ内のウェブビューに注意します。</strong> TelegramやInstagramのアプリ内ブラウザーでは、ユニバーサルリンクがしばしば処理されず、ウォレットの通常のウェブサイトが読み込まれます。ユーザーエージェントによる判定は、よくても推測にとどまります。そのため、「SafariまたはChromeで開いてから接続してください」という、見える回避方法も利用者に示します。</li>\n</ul>\n<h2 id=\"androidでのより根本的な修正\">Androidでの、より根本的な修正</h2>\n\n<p>独自のディープリンクを組み立てる方法は、iOS向けの話です。Androidでは、Solana MobileのMobile Wallet Adapterにより、モバイルブラウザーで動くdAppから、インストール済みのウォレットアプリへ直接接続でき、アプリ内ブラウザーを経由する必要はありません。最近の<code>@solana/wallet-adapter-react</code>は、モバイルアダプターを自動登録するため、wallet-adapter関連パッケージの更新だけでAndroidの問題が解消する場合もあります。目標の構成は、AndroidではMobile Wallet Adapter、相当する仕組みをAppleが認めていないiOSでは閲覧用ユニバーサルリンクです。</p>\n<h2 id=\"実機での検証\">実機での検証</h2>\n\n<ol>\n<li>ウォレットをインストールした実機で、メッセージアプリではなくOSのブラウザーからリンクを開きます。</li>\n<li>描画されたリンクをタップするか、QRコードを読み取ります。アドレスバーには貼り付けません。</li>\n<li>ウォレットが開き、そのアプリ内ブラウザーのタブにdAppが読み込まれることを確認します。失敗するのは、この後半です。</li>\n<li>ウォレットをインストールしていない状態でも繰り返します。ユニバーサルリンクは、ウォレットのウェブサイトに移動するはずです。インストール済みなのにそのページが出る場合は、リンクか起動方法がまだ誤っています。</li>\n<li>その後で、メッセージアプリ経由の動作をテストし、そこで失敗する場合は「ブラウザーで開く」案内を追加します。</li>\n</ol>\n<h2 id=\"出典\">出典</h2>\n\n<ul>\n<li><a href=\"https://docs.phantom.com/phantom-deeplinks/deeplinks-ios-and-android\">Phantom:iOSとAndroidのディープリンク</a></li>\n<li><a href=\"https://docs.solflare.com/solflare/technical/deeplinks/other-methods/browse\">Solflare:Browseディープリンク</a></li>\n<li><a href=\"https://docs.backpack.app/deeplinks/other-methods/browse\">Backpack:Browseディープリンク</a></li>\n<li><a href=\"https://docs.solanamobile.com/mobile-wallet-adapter/mobile-apps\">Solana Mobile:Mobile Wallet Adapter</a></li>\n</ul>\n", "date_published": "2026-08-10T00:00:00Z", "date_modified": "2026-11-09T22:50:25+01:00", "language": "ja" } ] }