From 3f96c9c6502243b06efd4bb34a189e72e3a5557c Mon Sep 17 00:00:00 2001
From: yearning <10538594+wangweifeng1999@user.noreply.gitee.com>
Date: 星期一, 28 九月 2026 19:24:55 +0800
Subject: [PATCH] 复制项目

---
 README.md |   71 ++++++++++++++++++++++++++++++++++-
 1 files changed, 69 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ceee91a..7d87941 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,71 @@
-## app-full-stack-score-query
+# 鑰冭瘯闃呭嵎绯荤粺
 
-鑰冨姟绯荤粺瀹㈣棰樻壒闃呭鏍�
+SQLite + FastAPI + React (Ant Design + Vite)
 
+## 绔彛
+
+- API锛歚8010`锛堜粎鍚庣锛�
+- **鍓嶇鐢熶骇锛堥粯璁わ級**锛歚5174`锛圢ode `vite preview` 鎵樼 `dist`锛宍/api` 浠ｇ悊鍒� 8010锛�
+- 鍓嶇寮�鍙戯細`5175`锛坄./scripts/start.sh dev`锛孷ite HMR锛�
+
+## 璁块棶鍩熷悕
+
+宸查粯璁ゅ厑璁� CORS 鏉ユ簮锛歚https://grader.gps120.com`銆乣http://grader.gps120.com`锛堝強鏈湴寮�鍙戝湴鍧�锛夈��
+
+鐢熶骇璁块棶锛氬皢 `grader.gps120.com` 鍙嶄唬鍒版湰鏈� **`5174`**锛堟垨鐩磋繛 `http://鏈嶅姟鍣�:5174`锛夛紝鏃犻渶 Nginx 涔熷彲鐢� Node 鎻愪緵椤甸潰銆傝嫢闇�鏀� CORS锛�
+
+```bash
+export CORS_ORIGINS="https://grader.gps120.com,http://grader.gps120.com"
+```
+
+Vite 寮�鍙戝凡閰嶇疆 `allowedHosts` 鍚� `grader.gps120.com`锛堢粡闅ч亾/鍙嶄唬璁块棶 dev 鏃讹級銆�
+
+## 鏈嶅姟鍚仠锛堝悗鍙拌繍琛岋紝鍏抽棴缁堢涓嶉��鍑猴級
+
+```bash
+# 棣栨瀹夎鍚�
+cd backend && python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
+cd ../frontend && npm install
+
+# 鍚姩 / 鍋滄 / 閲嶅惎 / 鐘舵��
+./scripts/start.sh          # 鐢熶骇锛歜uild + preview @5174 + 鍚庣 8010
+./scripts/start.sh dev      # 寮�鍙戯細Vite dev @5175 + 鍚庣 8010
+./scripts/build-frontend.sh # 浠呴噸鏂版瀯寤� dist锛堟敼浠ｇ爜鍚庣敓浜ч渶 build 鍐� restart frontend锛�
+./scripts/stop.sh
+./scripts/restart.sh
+./scripts/status.sh
+
+# 鏃ュ織锛歭ogs/backend.log  logs/frontend.log锛坧review锛�  logs/frontend-dev.log  logs/frontend-build.log
+# PID锛� run/backend.pid  run/frontend.pid
+```
+
+鍗曠嫭鎺у埗锛歚./scripts/start.sh backend` | `frontend`
+
+## 鍚庣锛堟墜鍔ㄨ皟璇曪級
+
+```bash
+cd backend
+source .venv/bin/activate
+python scripts/seed_admin.py
+uvicorn app.main:app --host 127.0.0.1 --port 8010
+```
+
+榛樿璐﹀彿锛歚admin` / `admin123`锛堢鐞嗗憳锛夛紝`grader` / `grader123`锛堥槄鍗峰憳锛�
+
+## 鏈湴瀵煎叆鏍蜂緥
+
+```bash
+source backend/.venv/bin/activate
+python backend/scripts/import_local.py "data/纰虫帓鏀炬牳鏌ュ憳" "纰虫帓鏀炬牳鏌ュ憳涓夌骇鐞嗚"
+```
+
+## 鍓嶇锛堟墜鍔ㄨ皟璇曪級
+
+```bash
+cd frontend
+npm run dev
+```
+
+## ZIP 鏍煎紡
+
+ZIP 鍐呴』鍖呭惈 5 绫� SQL锛歚examination_examinee`銆乣examination_exam_examinee`銆乣examination_paper_source`銆乣examination_paper_item`銆乣examination_examinee_exam_answer`銆�

--
Gitblit v1.8.0