お問い合わせ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サーバーを使い、外部サービスを代替して実メールを送信しない。

配置と設定

backend/contact-form/.env.example は記入例であり、自動では読み込まれません。自前版のアプリ設定は /etc/tectas-contact/contact.env、秘密情報は /etc/tectas-contact/secrets.json へ配置します。バックエンドのコードや依存関係を静的サイトの public/ や dist/ へコピーしないでください。