From 3eafb21adeb8cc2b534d8311d3715c74da5473fa Mon Sep 17 00:00:00 2001
From: Bedro Park <smptr0911@naver.com>
Date: Sat, 23 May 2026 22:45:36 -0700
Subject: [PATCH] merge

---
 .DS_Store                 | Bin 0 -> 6148 bytes
 README.md                 |  16 ++++++++++++
 scripts/test_localhost.sh |  53 ++++++++++++++++++++++++++++++++++++++
 3 files changed, 69 insertions(+)
 create mode 100644 .DS_Store
 create mode 100755 scripts/test_localhost.sh

diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..20b1eee8503799a0803fdba0efeb55f96e578d6d
GIT binary patch
literal 6148
zcmeHKy-ve05I#dnD-fa*3j>3B0Yn#8LRFYS-I!3Dszqu^)t?cR=O`lsD+?050L&eD
z0N#Y}Y?Ina!-Nn*KFR(P-<|Kv*Tk-gNYtlMji^dQ6*R_R9o-URKewE%n2}we;5qu;
zTC*JwhPg;T;1%!+{6z)$+YM-+x^zVo=lfl`xwCzPxY20!;}*s$!&2}0Y5sQX`lE0C
z!=AM^1QMxK{;Eqono`TDPTPC=2%E$C?P>6+Ib`M;#0w_HQ4SwEV?F`3DW(y1Tqau|
zw$J7e%~B3&u3deZ->rMVbxYKtYbY?Fv0GWpU9VmH;XbWx<=fSlN4WJR*Iz^Bm?E&~
zXBh<VS-;JJUQ!Ou95#!h7?(%LJj&2Mh7J=j8D*JlPV*5qm+&>^l9|V5Qyk^;k($pK
zZ^Q^+#t@t`zfI{-@o^$-J{L!`D1AROQH%GpILhV2`}2<*_H4GwhDP6e1-t@Yfm8ur
zA0!%MXfV;JmJW342mlN)tPIy`tpZ9O0EPw=jTnImoeI>c!W=P#PRF=3aiPIPqfRHG
zDq|i~S(p=wFe{~yDx5^9(f3{fuYjw-s=lrA{(n+@{&$o7omaps@UIjQL8IBI<B`nX
zntM3jYbDwx8XLzY8dVB9vmL7o-imk7l))$Y0vH-hG-3qi{|G1<eCHMTRRul)y~pCf

literal 0
HcmV?d00001

diff --git a/README.md b/README.md
index f8dee5d..e2c0080 100644
--- a/README.md
+++ b/README.md
@@ -7,3 +7,19 @@ npm run dev
 # Start the server
 docker compose up --build
 ```
+
+## Localhost API Test
+
+After the API is running on port 8080, run this smoke test:
+
+```bash
+bash scripts/test_localhost.sh
+```
+
+If your API is running on a different host or port:
+
+```bash
+bash scripts/test_localhost.sh http://localhost:9000
+```
+
+The script sends a valid request to `POST /api/submit/exec-form` and fails with a non-zero exit code if the endpoint does not return a successful response.
diff --git a/scripts/test_localhost.sh b/scripts/test_localhost.sh
new file mode 100755
index 0000000..502d239
--- /dev/null
+++ b/scripts/test_localhost.sh
@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+BASE_URL="${1:-http://localhost:8080}"
+ENDPOINT="${BASE_URL%/}/api/submit/exec-form"
+
+PAYLOAD='{
+  "fullName": "Local Test User",
+  "email": "local.test@example.com",
+  "studentId": "12345678",
+  "yearOfStudy": "3",
+  "faculty": "Engineering",
+  "major": "Software Engineering",
+  "coopTerm": "no",
+  "firstChoiceTeam": "TECHNOLOGY",
+  "questions": {
+    "tech_q1": "I enjoy building backend services.",
+    "tech_q2": "I want to grow in API design.",
+    "tech_q3": "Python and FastAPI.",
+    "tech_q4": "I collaborate through pull requests and code reviews."
+  }
+}'
+
+TMP_BODY="$(mktemp)"
+trap 'rm -f "$TMP_BODY"' EXIT
+
+HTTP_CODE="$(curl -sS -o "$TMP_BODY" -w "%{http_code}" \
+  -X POST "$ENDPOINT" \
+  -H "Content-Type: application/json" \
+  -d "$PAYLOAD")"
+
+BODY="$(cat "$TMP_BODY")"
+
+if [[ "$HTTP_CODE" != "200" ]]; then
+  echo "Localhost test failed: expected HTTP 200, got HTTP $HTTP_CODE"
+  echo "Endpoint: $ENDPOINT"
+  echo "Response body:"
+  echo "$BODY"
+  exit 1
+fi
+
+if [[ "$BODY" != *'"message":"Submission received successfully"'* ]]; then
+  echo "Localhost test failed: success message not found in response"
+  echo "Endpoint: $ENDPOINT"
+  echo "Response body:"
+  echo "$BODY"
+  exit 1
+fi
+
+echo "Localhost test passed"
+echo "Endpoint: $ENDPOINT"
+echo "HTTP $HTTP_CODE"
+echo "$BODY"