前端:从 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]>
173 lines
6.0 KiB
Bash
Executable File
173 lines
6.0 KiB
Bash
Executable File
#!/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
|