お問い合わせAPIの開発・テスト¶
AWS Lambda版と自前サーバー版が同じ送信処理を使うAPI。Webサイトとは依存関係と配置を分けて管理する。全テストと自前版はNode.js 24系、Lambdaの実行はNode.js 22系を使用する。
npm ci --prefix backend/contact-form
npm test --prefix backend/contact-form
Lambda経路のテストはSQLiteを使わないため、Node.js 22系でもbackend/contact-form/でnode --test test/contact.test.mjsを実行して確認できる。GitLab CIでは、全テストを24系、Lambda経路のテストを22系で実行する。
backend/contact-form/ 内のファイル |
役割 |
|---|---|
src/handler.mjs / src/domain.mjs |
共通の処理順序、入力条件、メールの組み立て |
src/config.mjs / src/secrets.mjs / src/transport.mjs |
共通の設定検証、秘密情報の検証、Turnstile・SMTP接続 |
src/index.mjs / src/lambda.mjs / src/aws.mjs |
Lambdaの起動、API Gateway形式の変換、DynamoDB・Secrets Manager接続 |
src/server.mjs / src/http.mjs |
自前版の起動とHTTP受付 |
src/self-hosted.mjs / src/sqlite.mjs |
自前版の設定、非公開ファイルからの秘密情報読込、SQLite管理 |
起動入口でバックエンドを選ぶ。自前版は必要な環境変数を設定したうえでnpm start --prefix backend/contact-formで起動する。自前版の環境設定にAWS認証情報は不要で、フロントにもバックエンド選択用のフラグは設けない。テストは一時SQLiteとローカルHTTPサーバーを使い、外部サービスを代替して実メールを送信しない。
配置と設定¶
- 初回構築:自前版セットアップ/AWSセットアップ。
- 稼働中の自前版の更新:手動更新・切り戻し。静的サイトのCIはAPIを更新・再起動しません。
- 要求・応答、複数宛先、件数制限、再試行:API共通仕様。
- ブラウザーへ公開する設定:フロントの公開設定。
backend/contact-form/.env.example は記入例であり、自動では読み込まれません。自前版のアプリ設定は /etc/tectas-contact/contact.env、秘密情報は /etc/tectas-contact/secrets.json へ配置します。バックエンドのコードや依存関係を静的サイトの public/ や dist/ へコピーしないでください。