AWS上のバックエンドを、設計から運用まで

バックエンドの保守実装、GraphQL APIのサンプルコード作成、MCPサーバーの機能追加。

既存のGraphQL APIについて、TypeScriptとPythonの2言語でサンプルコードを作成しました。基本的なQueryからMutation、機器のリアルタイム状態を購読するSubscriptionまで一連の操作を網羅しています。

既存のGo製MCPサーバーへ、新しいツールを追加しました。内部では既存のGraphQL APIを呼び出す構成です。あわせて、GitHub CopilotとClaudeそれぞれについてMCPクライアントの登録手順書を作成し、クライアントごとに手順を分けて、そのまま実行すれば動作確認まで進める形にしました。

バックエンドの保守として、CheckStyle警告の修正を担当しています。実務経験のないJavaとGoを扱う短期の参画だったため、コード読解にGitHub Copilotを併用しました。

言語

JavaTypeScriptPythonGo

フレームワーク

Quarkus

外部API

GraphQLAWS AppSyncMCP

ビルド・配布

Apache Maven

テスト・品質

CheckStyle

生成AI

GitHub Copilot

コード管理

GitGitHub

ツール

ConfluenceSlackMicrosoft Teams

規模

全体11名 / 自チーム5名

担当工程

実装・単体 / 保守・運用

API設計、DB設計、フロントエンドとバックエンドの実装、テストコード作成、CI構築。API設計は自ら手を挙げて担当しました。

グループ単位でデータを管理する機能を追加しました。十数本のAPI仕様やDBを設計し、テスト・CI整備まで担当しています。フロントエンドはVue.jsで実装しました。

テストは pytest と Vitest で単体・結合を整備し、主要フローのE2EをPlaywrightで実装。GitHub Actionsでバックエンドの単体テスト・APIテスト・フロントの単体テストを自動実行するCI環境を新規に構築しました。

ユーザーマニュアルはHugoで静的サイトとして作成しています。

言語

PythonTypeScriptSQL

フレームワーク

FastAPIVue.js

UI

Vuetify

データ

PostgreSQL

テスト・品質

pytestVitestPlaywrightGitHub Actions

インフラ

DockerAWS（EC2, Lambda, Cognito, CloudFormation, CloudWatch）

生成AI

ClineAmazon Bedrock

コード管理

GitGitHub

ツール

ConfluenceJiraSlackMicrosoft TeamsHugo

規模

全体7名 / 開発5名

担当工程

基本設計 / 詳細設計 / 実装・単体 / 結合 / 総合 / 保守・運用

参画当初2ヶ月はデスクトップアプリの開発を担当。以降、エディタ拡張機能の実装、生成AIの異常利用検知・自動停止の設計、配布用の環境構築ツールの実装。

対象のファイルを生成AIに送り、レポートの下書きを自動生成する拡張機能を開発しました。UIはWebview上でVue（+ Element Plus）のアプリとして動かしています。プレビュー表示で画像やリンクが正しく解決されなかったため、markdown-itのプラグインを実装して対応しました。

あわせて、生成AIへの過剰なリクエストとコスト超過に対する検知・自動停止の仕組みを設計しています。CloudWatchのメトリクスとアラームで検知し、閾値を超えた場合はIAMロールにDenyポリシーを付与して既存の一時認証セッションごと無効化する方式です。誰の認証かを辿れるよう、一時認証のIDと発行ユーザーの対応表をDynamoDBに持たせています。AWSのサービス選定とアーキテクチャ図の作成を担当しました。

配布用に、WSLのディストリビューションを作成するツールも実装しています。

言語

TypeScript

フレームワーク

Vue.jsElectronVSCode Extension API

UI

Element Plusmarkdown-it

データ

DynamoDB

インフラ

AWS（Bedrock, Lambda, CloudWatch, CloudFormation, IAM, STS）WSL

生成AI

Amazon Bedrock

コード管理

GitGitHub

ツール

ConfluenceJiraSlackMicrosoft Teams

規模

全体9名 / 自チーム4名

担当工程

基本設計 / 詳細設計 / 実装・単体

UI改修、外部サービス向けクローラー開発、負荷試験の導入と性能改善、ログ可視化基盤の構築、コード品質の標準化、本番リリースの遂行。

データカタログ基盤の機能追加と運用を担当しました。UI改修は拡張機能として実装し、本体を書き換えずにアップグレードへの追従を保てる構成にしています。外部サービスからデータを収集するクローラーはStep FunctionsとLambdaで構築しました。

リリース前の非機能要件チェックとして、それまで複数人で同時にアクセスして行っていた負荷試験を、コードで実行できる形に置き換えました。k6やJMeterと比較したうえで、チームで使っているPythonで書けることを根拠にLocustを選定しています。ユーザー一覧画面がページネーション未適用で全件取得していたボトルネックを特定し、修正して同じ条件で再計測、改善を確認しました。

利用状況の統計ログを見る可視化基盤も構築しています。Jupyter・QuickSight・Supersetの3つを実際に動かして比較し、コストと運用の手間を軸にSupersetを採用しました。ログをS3に出力し、定期的にDBへ投入して描画する経路です。

Flake8・Black・isortを提案して導入し、コード品質を標準化しました。

言語

PythonSQLHTMLCSS

フレームワーク

DjangoJinja2CKAN

UI

Apache SupersetJupyter

データ

PostgreSQLDynamoDB

テスト・品質

pytestLocustFlake8Blackisort

インフラ

DockerDocker ComposeVagrantcronAWS（EC2, Lambda, Step Functions, S3, RDS, IAM, KMS, CloudWatch, CloudFormation, Session Manager）

コード管理

GitGitHub

ツール

ConfluenceJiraSlackMicrosoft Teams

規模

全体9名 / 自チーム5名

担当工程

基本設計 / 詳細設計 / 実装・単体 / 結合 / 総合 / 保守・運用

画像の一部を隠したいだけなのに、その画像を外部サービスへ上げることに抵抗がありました。かといって黒く塗りつぶすのも味気ない。指でなぞった場所が窓の霜のように曇る形にして、その両方を解消しています。

処理はすべて端末内で完結し、画像はネットワークに出ません。Service Worker がキャッシュするのもアプリ本体だけで、画像は含めていません。保存時に PNG へ再エンコードするため、元画像の EXIF や GPS も引き継がれません。サーバーを持たないので、インフラの費用も管理も発生しません。

ランタイム依存はゼロで、加工は Canvas 2D API だけで書いています。隠し方はモザイクと氷霜ガラスの2モード。粗さ・ぼかし・氷霜の強さ・ブラシサイズを調整できます。

保存だけは環境で経路を分けました。iOS のホーム画面起動では <a download> が安定しないので、Web Share API 経由。Android とデスクトップは直接ダウンロードです。

PWA としてインストールでき、オフラインでも動きます。自分の画像を出さずに動きを試せるよう、サンプル画像を1枚同梱しています。

言語

TypeScript

UI

Canvas 2D APICSS

外部API

Web Share API

ビルド・配布

Vitevite-plugin-pwaWorkbox

テスト・品質

Vitesthappy-domPrettierGitHub Actions

インフラ

Cloudflare Pages

個人開発で何を作るか決めきれず、考えているうちに時間が過ぎることがあります。自分で選ぶより機械に決めてもらったほうが手が動くと思って作りました。同じ理由で、ハッカソンや勉強会のお題決めにも使えます。

結果そのものは単なる乱数です。体験になるかどうかは、結果が出るまでの時間の設計で決まると考えて、スロットの止まり方に手を入れました。

内部的には、結果を回転開始の時点で先に確定させています。回転は一定間隔で文字を差し替えるだけ、停止は左右で時間差をつけて順に確定する形です。見た目の演出と結果の確定を切り離したので、演出の長さを変えても結果のロジックには触らずに済み、共有URLから開いたときは結果を確定済みの状態でそのまま表示できます。

タイマーの管理は状態遷移（待機 → 回転中 → 片側停止 → 確定）としてフックに閉じ込め、参照をまとめて必ず解放する形にしています。フックに切り出したことで、テストではタイマーを疑似的に進めて演出の完了まで検証できます。

引いた結果は URL で共有でき、その URL の OG 画像は Cloudflare Pages Functions で結果ごとに生成しています。画像を事前に用意せずに、共有されたテーマがそのままカードに出る形にしました。

言語

TypeScript

フレームワーク

React

UI

Tailwind CSSBudouXFontsource

データ

localStorage

ビルド・配布

Vitevite-plugin-pwa

テスト・品質

VitestTesting LibraryPlaywrightESLintPrettier

インフラ

Cloudflare PagesCloudflare Pages Functions

その他

workers-og

旅行中にチャットへ逐次メモを送って、最後に「まとめて」と頼んで日記にする、という使い方を自分でしていました。それを毎回手作業でやるのが面倒だったので、記録の部分だけアプリにしました。

日記の生成そのものは作っていません。整った時系列データとプロンプトを出力して、Claudeに渡すところまでが役割です。

生成の質を担保する部分は外部に任せる設計にしました。自前でプロンプトを作り込むより、出力の形を整えることに集中したほうが、少ない手数で使えるものになると考えたためです。

出力はURL経由でClaudeに遷移させています。ただし日本語はURLエンコードで1文字が「%E3%81%82」のような9文字に膨らむため、長い記録ではURL長の上限に当たります。エンコード後のURLが16,000文字を超えたら、Markdownファイルをダウンロードして添付する方式へ自動で切り替わるようにしました。3日・50スタンプ程度の旅ならURLのまま通ります。

Places APIのキーはブラウザに置いていません。配信しているCloudflare Workersに検索を中継させ、キーはWorkerのシークレットにだけ持たせています。構成要素を足さずにキーを隠せる形になりました。

データは端末内のIndexedDBに保存し、記録と編集はオフラインでも動きます（場所検索だけはオンライン必要）。アプリ内に地図は描いていませんが、記録時に取れた座標は保存しておき、カードからGoogleマップを開くときのフォールバックに使っています。後から地図を足すことはできても、溜めていなければ遡れないためです。

言語

TypeScript

フレームワーク

React

UI

Tailwind CSSRadix UIVaulLucide

データ

DexieIndexedDBZustandZod

外部API

Google Places API (New)Geolocation API

ビルド・配布

Vitevite-plugin-pwa@cloudflare/vite-plugin

テスト・品質

VitestPlaywrightBiome

インフラ

Cloudflare Workers

画面共有中に env を叩いてしまったり、ログを流すときに一瞬ためらったりするのが嫌でした。シークレットを守るツールはコミット前とスキャン後にはありますが、画面に出る瞬間を止めるものが手元になかったので作りました。

検出も保存もしません。標準入力を読んで、既知のシークレット形式に一致した部分を置き換えて標準出力に流すだけです。

自動化しない、という判断を最初に置きました。シェルの設定に一行足して全出力を自動でマスクする形は、子プロセスの標準出力にフィルタを挟むことになり、isatty() が false になって色が消え、TUIアプリが壊れます。Unixの構造上の制約で実装では回避できないため、明示的なパイプを既定にして、マスクが効いている場所が目で分かるようにしました。

パターンは8個に絞っています。誤検知でふつうの出力を潰すほうが、見逃しより嫌われると考えたためです。40文字のランダム文字列を無条件に伏せるのではなく aws_secret_access_key= の文脈込みで判定するなど、各パターンに調整を入れています。

秘密鍵だけは行単位の処理に乗りません。PEMブロックは数十行にまたがるためです。入力全体を溜めると tail -f が止まるので、BEGIN/ENDマーカーを見つけたときだけバッファリングに入る方式にしました。上限を超えたらマスクせずそのまま流します。

言語はGoにしました。単一バイナリで配れることと、標準の正規表現エンジンが入力長に対して線形時間を保証することが理由です。パイプの途中に置く以上、特定の入力で遅延が跳ねると使い物になりません。

言語

Go

検出

Go regexp

設定

TOML

ビルド・配布

GoReleaserHomebrew tap

テスト・品質

Go testinggo vetgofmtGitHub Actions