Files
ssw-jnpf-lite-rust/run.sh
T
adminandClaude Code 8edcd3507d feat: 前端逐字复制(仅代理端口改 30010)+ run.sh + check-module.sh + 文档
前端:从 ssw-jnpf-lite-react/src/frontend 逐字复制(package-lock.json 一并复制),
唯一改动 = vite.config.ts 的代理目标 30000 → 30010(含紧邻注释行的端口);
src/api/request.ts 的注释与 axios timeout: 30000 逐字节保留。

脚本:run.sh(install/build/dev/backend/frontend/stop/logs,退出码 0/1/2,
kill_ports 只清 30010 与 5173);scripts/check-module.sh(9 接触点静态自检,
纯静态零 node 依赖)。

文档:README.md、docs/runbook.md、.env.example;CLAUDE.md 逐条核对并与代码同步,
HANDOFF.md §0 状态表与 §9 交接话术改为交付态。

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 03:26:22 +08:00

173 lines
6.0 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env bash
# tds-lite-rs 一键脚本
#
# 后端 = Rust 单二进制(cargo workspace 根 = 仓库根 ⇒ target/ 在仓库根)。
# 数据库为嵌入式 pglite-rs(进程内原生 PostgreSQL),零服务 / 零 Docker / 零 WASM。
#
# 用法:
# ./run.sh install 安装依赖(cargo fetch + npm install)
# ./run.sh build 构建(cargo build --release + vite build)
# ./run.sh dev 后台起后端(30010) + 前端(5173),日志进 .logs/,PID 写入 .run/
# ./run.sh backend 前台起后端
# ./run.sh frontend 前台起前端
# ./run.sh stop 用 PID 文件停后台进程 + 兜底 kill_ports
# ./run.sh logs tail .logs/{backend,frontend}.log
# ./run.sh --help 本用法
#
# 退出码:0 成功 / 1 运行期失败 / 2 用法错
set -euo pipefail
ROOT="$(cd "$(dirname "$0")" && pwd)"
LOGS="$ROOT/.logs"
RUN="$ROOT/.run"
# 后端端口:兄弟项目 tdc-rs 已占用它自己的后端端口,本仓一律用 30010。
# 前端 vite 端口固定 5173(vite.config.ts 里 strictPort: true)。
BACKEND_PORT=30010
FRONTEND_PORT=5173
# 🔴 kill_ports 用的是 kill -9 ⇒ 端口列表**只能是本仓自己的这两个端口**。
# 不许把兄弟项目 tdc-rs 的端口写进来(打死它就是破坏兄弟项目)。
BACKEND_BIN="$ROOT/target/release/tds-lite-rs"
mkdir -p "$LOGS" "$RUN"
# 加载项目根 .env(后端不 import dotenv,靠这里把 PORT / PGLITE_DIR 导出给子进程)
if [ -f "$ROOT/.env" ]; then
set -a; . "$ROOT/.env"; set +a
fi
export PORT="${PORT:-30010}"
usage() {
cat <<'EOF'
用法: ./run.sh <子命令>
install 安装依赖(cargo fetch + npm install)
build 构建(cargo build --release + vite build)
dev 后台起后端(30010) + 前端(5173)
backend 前台起后端
frontend 前台起前端
stop 停止后台进程
logs 打印后端/前端日志尾部
--help 本用法
退出码: 0 成功 / 1 运行期失败 / 2 用法错
EOF
}
# 端口守护:dev/start 前清掉残留进程,避免 EADDRINUSE 被静默吞掉(旧进程仍占端口,
# 新进程崩溃但请求全部打到旧实例 → 看起来「改了 seed 但菜单不变」之类的灵异 bug)。
kill_ports() {
local killed=0
for p in "$@"; do
local pids
pids="$(lsof -ti:"$p" 2>/dev/null || true)"
if [ -n "$pids" ]; then
echo " ↳ 端口 $p 被旧进程占用 (PID: $pids),清理中…"
# shellcheck disable=SC2086
kill -9 $pids 2>/dev/null || true
killed=1
fi
done
# 注意 set -e:端口空闲时 [ ] 返回 1 会炸掉调用方(dev 走不到 start_logged)
[ "$killed" -eq 1 ] && sleep 1
return 0
}
# 用 PID 文件优雅停(先 SIGTERM,1s 后 SIGKILL),清理 root 进程树
stop_pid() {
local f="$1"
[ -f "$f" ] || return 0
local pid
pid="$(cat "$f" 2>/dev/null || true)"
if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
echo " ↳ stop $(basename "$f") PID=$pid SIGTERM"
kill -TERM "$pid" 2>/dev/null || true
sleep 1
kill -0 "$pid" 2>/dev/null && kill -KILL "$pid" 2>/dev/null || true
fi
rm -f "$f"
}
# 用 nohup 后台起,stdout/stderr 都进日志;写 PID 便于 ./run.sh stop 精准收
start_logged() {
local dir="$1" cmd="$2" name="$3"
mkdir -p "$LOGS"
: > "$LOGS/${name}.log"
(
cd "$ROOT/$dir" || exit 1
# nohup + & 把子进程从父进程会话脱离,CI/harness 退出不会拖垮服务;
# setsid 让子进程成为新进程组领头,避免父 SIGINT 误杀。
# macOS 无 setsid(Linux util-linux 专有),探测后回退纯 nohup。
if command -v setsid >/dev/null 2>&1; then
setsid nohup $cmd > "$LOGS/${name}.log" 2>&1 &
else
nohup $cmd > "$LOGS/${name}.log" 2>&1 &
fi
echo $! > "$RUN/${name}.pid"
)
echo " ↳ $name PID=$(cat "$RUN/${name}.pid") log=$LOGS/${name}.log"
}
case "${1:-}" in
-h|--help|help)
usage
;;
install)
(cd "$ROOT" && cargo fetch)
npm --prefix "$ROOT/src/frontend" install
;;
build)
(cd "$ROOT" && cargo build --release)
npm --prefix "$ROOT/src/frontend" run build
;;
dev)
kill_ports "$BACKEND_PORT" "$FRONTEND_PORT"
if [ ! -x "$BACKEND_BIN" ]; then
echo "[启动失败] 后端二进制不存在: $BACKEND_BIN"
echo " 先跑「./run.sh build」(cargo build --release)。"
exit 1
fi
# 🔴 后端 cwd = 仓库根(dir=".")⇒ 相对路径的 PGLITE_DIR 也落在仓库内。
# 🔴 命令行**不带** PORT= 前缀 —— PORT 已由 .env / export 导出,子进程继承。
start_logged . "./target/release/tds-lite-rs" backend
start_logged src/frontend "npm run dev" frontend
echo
echo "服务已在后台启动。后端: http://127.0.0.1:${BACKEND_PORT} 前端: http://127.0.0.1:${FRONTEND_PORT}"
echo "日志:tail -f $LOGS/{backend,frontend}.log"
echo "停止:./run.sh stop"
;;
backend)
kill_ports "$BACKEND_PORT"
if [ ! -x "$BACKEND_BIN" ]; then
echo "[启动失败] 后端二进制不存在: $BACKEND_BIN"
echo " 先跑「./run.sh build」(cargo build --release)。"
exit 1
fi
(cd "$ROOT" && exec ./target/release/tds-lite-rs)
;;
frontend)
kill_ports "$FRONTEND_PORT"
npm --prefix "$ROOT/src/frontend" run dev
;;
stop)
# ⚠️ vite 是通用名 —— 只有本仓真的起过前端(PID 文件存在)才 pkill,避免误杀别的项目。
if [ -f "$RUN/frontend.pid" ]; then
pkill -f "vite" 2>/dev/null || true
fi
stop_pid "$RUN/backend.pid"
stop_pid "$RUN/frontend.pid"
kill_ports "$BACKEND_PORT" "$FRONTEND_PORT"
pkill -f "tds-lite-rs" 2>/dev/null || true
echo "stopped"
;;
logs)
# 🔴 补 || true:日志文件不存在时 [ -f ] 返回 1,set -e 下会让脚本以 1 退出。
{ [ -f "$LOGS/backend.log" ] && echo "=== backend ===" && tail -n 50 "$LOGS/backend.log"; } || true
{ [ -f "$LOGS/frontend.log" ] && echo "=== frontend ===" && tail -n 50 "$LOGS/frontend.log"; } || true
;;
*)
usage
exit 2
;;
esac