@fecommunity/reactpress 3.0.3 → 3.0.4

package/lib/i18n/strings.js

@@ -26,6 +26,19 @@ const STRINGS = {
     'cli.docker.restart': 'Restart Docker services',
     'cli.docker.status': 'Docker container status',
     'cli.docker.logs': 'Docker logs (db | nginx)',
+    'cli.nginx.description': 'Nginx reverse proxy (unified entry on :80)',
+    'cli.nginx.ensure': 'Write default nginx config if missing',
+    'cli.nginx.up': 'Start nginx container',
+    'cli.nginx.down': 'Stop nginx container',
+    'cli.nginx.restart': 'Restart nginx container',
+    'cli.nginx.status': 'Show nginx container and config status',
+    'cli.nginx.logs': 'Follow nginx container logs',
+    'cli.nginx.test': 'Validate nginx config inside container (nginx -t)',
+    'cli.nginx.reload': 'Reload nginx after config change',
+    'cli.nginx.open': 'Open nginx entry URL in browser',
+    'cli.nginx.prod': 'Use production compose + nginx.conf (monorepo only)',
+    'cli.nginx.force': 'Overwrite existing nginx config from template',
+    'cli.help.nginx': '  reactpress nginx up          Start reverse proxy (:80)',
     'cli.status.description': 'Project, API, frontend, and Docker status',
     'cli.doctor.description': 'Diagnose Node, Docker, ports, database, and API health',
     'cli.db.description': 'Database operations',
@@ -47,6 +60,19 @@ const STRINGS = {
     'cli.help.publish': '  reactpress publish          Publish npm packages',
     'cli.build.target': 'Build target: toolkit | server | client | docs | all',
     'banner.subtitle': '  ·  Full-stack publishing CLI        ',
+    /** Left label for the decorative pulse bar (not a URL — the repo link
+     * lives directly under the title bar at the top of the card). */
+    'banner.pulseLabel': 'Setup',
+    'banner.pulseReady': 'READY',
+    'banner.pulsePending': 'INIT',
+    'banner.label.mode': 'MODE',
+    'banner.label.path': 'PATH',
+    'banner.mode.standalone': 'STANDALONE',
+    'banner.mode.monorepo': 'MONOREPO',
+    'banner.mode.uninitialized': 'UNINITIALIZED',
+    'banner.systemLabel': 'SYSTEM',
+    'banner.systemOnline': 'ONLINE',
+    'banner.systemPending': 'PENDING',
     'menu.dev': 'Zero-config dev (env + DB + API + frontend)',
     'menu.init': 'Initialize project (.reactpress + .env + database)',
     'menu.status': 'View project status',
@@ -73,6 +99,55 @@ const STRINGS = {
     'menu.done': 'Done',
     'menu.opening': 'Opening {url}',
     'menu.goodbye': '  Goodbye.',
+    'menu.section.run': 'Run',
+    'menu.section.lifecycle': 'Lifecycle',
+    'menu.section.build': 'Build & Deploy',
+    'menu.section.tools': 'Tools',
+    'menu.tip': 'Tip: arrow keys to navigate, Enter to select, Ctrl+C to quit.',
+    'menu.shortcuts': '↑/↓ navigate  ·  enter select  ·  esc back  ·  ctrl+c quit',
+    'menu.statusHeader': 'Status',
+    'menu.contextStandalone': 'Project mode  ·  standalone (using bundled API)',
+    'menu.contextMonorepo': 'Project mode  ·  monorepo (server/src + client/)',
+    'menu.contextUnknown': 'Project mode  ·  not initialized (run `init`)',
+    'menu.statusApi': 'API     {status}',
+    'menu.statusDb': 'DB      {status}',
+    'menu.statusDocker': 'Docker  {status}',
+    'menu.statusLabelApi': 'API',
+    'menu.statusLabelDb': 'DB',
+    'menu.statusLabelDocker': 'Docker',
+    'menu.statusChecking': 'checking…',
+    'menu.startingApi': 'Starting API…',
+    'menu.stoppingApi': 'Stopping API…',
+    'menu.restartingApi': 'Restarting API…',
+    'menu.statusOn': 'online',
+    'menu.statusOff': 'offline',
+    'menu.statusReady': 'ready',
+    'menu.statusNotReady': 'not ready',
+    'menu.statusYes': 'available',
+    'menu.statusNo': 'unavailable',
+    'menu.hint.dev': 'API + DB + frontend',
+    'menu.hint.init': '.reactpress + .env',
+    'menu.hint.status': 'all services overview',
+    'menu.hint.doctor': 'environment diagnostics',
+    'menu.hint.devApi': 'watch mode',
+    'menu.hint.devClient': 'Next.js dev',
+    'menu.hint.serverStart': 'production background',
+    'menu.hint.serverStop': '',
+    'menu.hint.serverRestart': '',
+    'menu.hint.build': 'production output',
+    'menu.hint.dockerStart': 'DB + nginx + dev stack',
+    'menu.hint.dockerUp': 'database only',
+    'menu.hint.dockerStop': '',
+    'menu.nginxUp': 'Start nginx reverse proxy (:80)',
+    'menu.nginxOpen': 'Open nginx entry in browser',
+    'menu.nginxReload': 'Reload nginx after editing config',
+    'menu.hint.nginxUp': 'unified entry :80',
+    'menu.hint.nginxOpen': 'http://localhost',
+    'menu.hint.nginxReload': 'nginx -t && reload',
+    'menu.hint.openAdmin': 'opens in browser',
+    'menu.hint.publish': 'maintainers only',
+    'menu.hint.exit': '',
+    'menu.actionPrefix': 'action',
     'dev.startingApi': '[reactpress] Starting API (first run may install deps)…',
     'dev.waitingApi': '[reactpress] Waiting for API: {url}',
     'dev.apiTimeout': '[reactpress] API not ready within {seconds}s.\n  → Run reactpress doctor\n  → Embedded MySQL: reactpress docker up\n  → Check DB_* and SERVER_SITE_URL in .env',
@@ -84,11 +159,16 @@ const STRINGS = {
     'dev.nextDoctor': '  → reactpress doctor          Diagnostics',
     'dev.nextDocker': '  → reactpress docker up       Start embedded MySQL',
     'dev.nextEnv': '  → Check DB_* and SERVER_SITE_URL in .env',
-    'devBanner.ready': '  ✓ ReactPress dev environment is ready',
+    'dev.standaloneHint': '[reactpress] Standalone project: only API is started here; build your own frontend separately.',
+    'devBanner.ready': 'ReactPress dev environment is ready',
     'devBanner.site': 'Site',
     'devBanner.admin': 'Admin',
+    'devBanner.api': 'API',
+    'devBanner.swagger': 'Swagger',
     'devBanner.health': 'Health',
-    'devBanner.hint': '  Diagnostics: reactpress doctor  ·  Status: reactpress status',
+    'devBanner.hint': 'Diagnostics: reactpress doctor  ·  Status: reactpress status',
+    'devBanner.shortcuts': 'Ctrl+C  stop',
+    'devBanner.allSystemsGo': 'ALL SYSTEMS GO',
     'doctor.nodeBad': 'Node.js {version} (requires ≥ 18)',
     'doctor.nodeFix': 'Install Node.js 18+: https://nodejs.org/',
     'doctor.dockerOk': 'Docker engine is available',
@@ -119,17 +199,22 @@ const STRINGS = {
     'doctor.envOk': '.env exists',
     'doctor.envBad': 'Missing .env',
     'doctor.envFix': 'Run reactpress init or reactpress config --apply',
-    'doctor.project': '  Project: {path}',
-    'doctor.allPass': '  All checks passed. You can start developing.',
-    'doctor.failed': '  {count} item(s) need attention.',
-    'status.title': '  ReactPress project status',
-    'status.dir': '  Project     {path}',
-    'status.apiSource': '  API source  {source}',
+    'doctor.project': 'Project   {path}',
+    'doctor.allPass': 'All checks passed. You can start developing.',
+    'doctor.failed': '{count} item(s) need attention.',
+    'doctor.title': 'ReactPress Doctor',
+    'doctor.subtitle': 'environment diagnostics',
+    'doctor.checking': 'Checking {name}…',
+    'doctor.summary': '{passed} passed  ·  {failed} failed  ·  {total} total',
+    'doctor.fixesHeader': 'Suggested fixes',
+    'status.title': 'ReactPress project status',
+    'status.dir': 'Project     {path}',
+    'status.apiSource': 'API source  {source}',
     'status.apiSource.monorepo': 'monorepo server/',
     'status.apiSource.bundle': 'reactpress-cli',
-    'status.configOk': '.reactpress/config.json ✓',
+    'status.configOk': '.reactpress/config.json',
     'status.configBad': 'not initialized',
-    'status.envOk': '.env ✓',
+    'status.envOk': '.env',
     'status.envBad': 'missing .env',
     'status.apiOnline': 'online',
     'status.apiOffline': 'offline',
@@ -137,10 +222,24 @@ const STRINGS = {
     'status.dbUp': 'connected',
     'status.dbDown': 'unavailable',
     'status.pidRunning': '(running)',
-    'status.frontend': '  Frontend',
-    'status.docker': '  Docker',
+    'status.frontend': 'Frontend',
+    'status.docker': 'Docker',
     'status.dockerUp': 'available',
     'status.dockerDown': 'not running',
+    'status.section.project': 'Project',
+    'status.section.api': 'API service',
+    'status.section.frontend': 'Frontend',
+    'status.section.docker': 'Docker',
+    'status.field.url': 'URL',
+    'status.field.http': 'HTTP',
+    'status.field.health': 'Health',
+    'status.field.database': 'Database',
+    'status.field.pid': 'PID',
+    'status.field.engine': 'Engine',
+    'status.field.config': 'Config',
+    'status.field.env': '.env',
+    'status.field.source': 'Source',
+    'status.field.dir': 'Directory',
     'bootstrap.configReady': 'Config exists and database is ready.',
     'bootstrap.projectDbPending': 'Project created, but database is not ready: {message}. Start Docker and run reactpress dev again.',
     'bootstrap.ready': 'ReactPress dev environment is ready (config + database).',
@@ -151,7 +250,9 @@ const STRINGS = {
     'bootstrap.dbReady': 'Database is ready',
     'db.backup.to': 'Backing up database to {path}',
     'db.backup.done': 'Backup complete',
-    'db.backup.fail': 'mysqldump failed; ensure MySQL client is installed and .env is correct',
+    'db.backup.viaDocker': 'mysqldump not on PATH; using mysqldump inside the db container…',
+    'db.backup.fail':
+      'mysqldump failed; install a MySQL client (e.g. brew install mysql-client), or ensure Docker db is running for automatic container backup',
     'common.done': 'Done',
     'common.yes': 'yes',
     'common.no': 'no',
@@ -189,9 +290,37 @@ const STRINGS = {
     'docker.mysqlTimeout': '[reactpress] MySQL not ready within timeout.',
     'docker.mysqlNotReady': 'MySQL is not ready',
     'docker.startDevStack': '[reactpress] Starting API + frontend (Docker MySQL)…',
-    'docker.visitUrls': '[reactpress] Visit: http://localhost:8080 (nginx) / http://localhost:3001 (client)',
+    'docker.visitUrls': '[reactpress] Visit: http://localhost (nginx) / http://localhost:3001 (client)',
     'docker.devProcessExit': 'Dev process exited with code {code}',
     'docker.unknownCommand': 'Unknown docker command: {command}',
+    'nginx.configCreated': '[reactpress] Created nginx config: {path}',
+    'nginx.configExists': '[reactpress] Nginx config already exists: {path}',
+    'nginx.ensureWarn': '[reactpress] Could not ensure nginx config: {message}',
+    'nginx.started': '[reactpress] Nginx started — {url}',
+    'nginx.configPath': '[reactpress] Config: {path}',
+    'nginx.stopped': '[reactpress] Nginx stopped.',
+    'nginx.startFailed': 'Failed to start nginx container',
+    'nginx.prodMonorepoOnly': 'Production nginx (--prod) requires monorepo with docker-compose.prod.yml',
+    'nginx.statusTitle': '[reactpress] Nginx status',
+    'nginx.statusContainer': '  Container {name}: {running}',
+    'nginx.statusConfig': '  Config {path}: {exists}',
+    'nginx.statusUrl': '  Entry {url} (port {port})',
+    'nginx.statusMode': '  Mode: {mode}',
+    'nginx.notRunning': 'Nginx container is not running. Run: reactpress nginx up',
+    'nginx.testOk': '[reactpress] Nginx config test passed.',
+    'nginx.testFailed': 'Nginx config test failed',
+    'nginx.reloadOk': '[reactpress] Nginx reloaded.',
+    'nginx.reloadFailed': 'Nginx reload failed',
+    'nginx.opening': '[reactpress] Opening {url}',
+    'nginx.unknownCommand': 'Unknown nginx command: {command}',
+    'nginx.templateMissing': 'Bundled nginx template missing: {path}',
+    'nginx.doctorSkippedDocker': 'Skipped (Docker not running)',
+    'nginx.doctorSkippedNotRunning': 'Not started (optional: reactpress nginx up)',
+    'nginx.doctorNotRunningFix': 'reactpress nginx up  (or reactpress docker up)',
+    'nginx.doctorOk': 'Nginx healthy ({url}/health)',
+    'nginx.doctorUnhealthy': 'Nginx running but /health failed ({url})',
+    'nginx.doctorUnhealthyFix': 'Ensure client (:3001) and API (:3002) are running; reactpress nginx reload',
+    'doctor.check.nginx': 'Nginx proxy',
     'apiDev.modeServer': '[reactpress] Dev mode: server/ (nest start --watch)',
     'apiDev.modeBundled': '[reactpress] Dev mode: bundled API (built-in server)',
     'apiDev.ctrlCHint': '[reactpress] Press Ctrl+C to stop API.',
@@ -199,12 +328,12 @@ const STRINGS = {
     'build.unknownTarget': 'Unknown build target: {target}. Available: {available}',
     'build.recursive': 'Build recursion detected (pnpm run build must not call itself). Use build:toolkit, build:server, or build:client.',
     'build.forbiddenScript': 'Invalid build script "{script}"; use granular scripts like build:toolkit.',
-    'build.stepFailed': '[reactpress] [{current}/{total}] {label} failed',
-    'build.plan': '[reactpress] Production build — {total} step(s): toolkit → server → client',
-    'build.step': '[reactpress] [{current}/{total}] {label}…',
-    'build.stepDone': '[reactpress] [{current}/{total}] {label} ✓ ({seconds}s)',
-    'build.stepSkipped': '[reactpress] Skipped {label} (not part of this project layout)',
-    'build.done': '[reactpress] Build finished in {seconds}s',
+    'build.stepFailed': '[{current}/{total}] {label}  failed',
+    'build.plan': 'Production build — {total} step(s): toolkit → server → client',
+    'build.step': '[{current}/{total}] {label}',
+    'build.stepDone': '[{current}/{total}] {label}  ({seconds}s)',
+    'build.stepSkipped': 'skipped  {label} (not part of this project layout)',
+    'build.done': 'Build finished in {seconds}s',
     'build.label.toolkit': 'Toolkit',
     'build.label.server': 'API (server)',
     'build.label.client': 'Frontend (client)',
@@ -318,6 +447,19 @@ const STRINGS = {
     'cli.docker.restart': '重启 Docker 服务',
     'cli.docker.status': '查看 Docker 容器状态',
     'cli.docker.logs': '查看 Docker 日志 (db | nginx)',
+    'cli.nginx.description': 'Nginx 反向代理（统一入口 :80）',
+    'cli.nginx.ensure': '若缺失则生成默认 nginx 配置',
+    'cli.nginx.up': '启动 nginx 容器',
+    'cli.nginx.down': '停止 nginx 容器',
+    'cli.nginx.restart': '重启 nginx 容器',
+    'cli.nginx.status': '查看 nginx 容器与配置状态',
+    'cli.nginx.logs': '跟踪 nginx 容器日志',
+    'cli.nginx.test': '在容器内校验配置 (nginx -t)',
+    'cli.nginx.reload': '修改配置后热加载 nginx',
+    'cli.nginx.open': '在浏览器打开 nginx 入口',
+    'cli.nginx.prod': '使用生产 compose + nginx.conf（仅 monorepo）',
+    'cli.nginx.force': '用模板覆盖已有 nginx 配置',
+    'cli.help.nginx': '  reactpress nginx up          启动反向代理 (:80)',
     'cli.status.description': '查看项目、API、前端、Docker 综合状态',
     'cli.doctor.description': '诊断环境：Node、Docker、端口、数据库、API 健康',
     'cli.db.description': '数据库运维',
@@ -339,6 +481,18 @@ const STRINGS = {
     'cli.help.publish': '  reactpress publish          发布 npm 包',
     'cli.build.target': '构建目标: toolkit | server | client | docs | all',
     'banner.subtitle': '  ·  全栈发布平台 CLI        ',
+    /** 左侧装饰性进度条标签（不是网址；仓库地址放在卡片顶部 Title 正下方）。 */
+    'banner.pulseLabel': '准备',
+    'banner.pulseReady': '就绪',
+    'banner.pulsePending': '初始化',
+    'banner.label.mode': '模式',
+    'banner.label.path': '路径',
+    'banner.mode.standalone': '独立项目',
+    'banner.mode.monorepo': 'MONOREPO',
+    'banner.mode.uninitialized': '未初始化',
+    'banner.systemLabel': '系统',
+    'banner.systemOnline': '在线',
+    'banner.systemPending': '准备中',
     'menu.dev': '零配置开发 (env + DB + API + 前端)',
     'menu.init': '初始化项目 (.reactpress + .env + 数据库)',
     'menu.status': '查看项目状态',
@@ -365,6 +519,55 @@ const STRINGS = {
     'menu.done': '完成',
     'menu.opening': '打开 {url}',
     'menu.goodbye': '  再见。',
+    'menu.section.run': '运行',
+    'menu.section.lifecycle': '生命周期',
+    'menu.section.build': '构建与部署',
+    'menu.section.tools': '工具',
+    'menu.tip': '提示：上下方向键选择，回车确认，Ctrl+C 退出。',
+    'menu.shortcuts': '↑/↓ 选择  ·  回车 确认  ·  esc 返回  ·  Ctrl+C 退出',
+    'menu.statusHeader': '当前状态',
+    'menu.contextStandalone': '项目类型  ·  独立项目（使用内置 API）',
+    'menu.contextMonorepo': '项目类型  ·  monorepo（server/src + client/）',
+    'menu.contextUnknown': '项目类型  ·  未初始化（请先运行 init）',
+    'menu.statusApi': 'API     {status}',
+    'menu.statusDb': '数据库  {status}',
+    'menu.statusDocker': 'Docker  {status}',
+    'menu.statusLabelApi': 'API',
+    'menu.statusLabelDb': '数据库',
+    'menu.statusLabelDocker': 'Docker',
+    'menu.statusChecking': '检测中…',
+    'menu.startingApi': '正在启动 API…',
+    'menu.stoppingApi': '正在停止 API…',
+    'menu.restartingApi': '正在重启 API…',
+    'menu.statusOn': '在线',
+    'menu.statusOff': '离线',
+    'menu.statusReady': '就绪',
+    'menu.statusNotReady': '未就绪',
+    'menu.statusYes': '可用',
+    'menu.statusNo': '不可用',
+    'menu.hint.dev': 'API + 数据库 + 前端',
+    'menu.hint.init': '生成 .reactpress + .env',
+    'menu.hint.status': '所有服务概览',
+    'menu.hint.doctor': '环境健康检查',
+    'menu.hint.devApi': 'watch 模式',
+    'menu.hint.devClient': 'Next.js 开发',
+    'menu.hint.serverStart': '后台生产模式',
+    'menu.hint.serverStop': '',
+    'menu.hint.serverRestart': '',
+    'menu.hint.build': '生产构建产物',
+    'menu.hint.dockerStart': '数据库 + nginx + 全栈',
+    'menu.hint.dockerUp': '仅数据库',
+    'menu.hint.dockerStop': '',
+    'menu.nginxUp': '启动 nginx 反向代理 (:80)',
+    'menu.nginxOpen': '在浏览器打开 nginx 入口',
+    'menu.nginxReload': '修改配置后重载 nginx',
+    'menu.hint.nginxUp': '统一入口 :80',
+    'menu.hint.nginxOpen': 'http://localhost',
+    'menu.hint.nginxReload': 'nginx -t 后 reload',
+    'menu.hint.openAdmin': '在浏览器打开',
+    'menu.hint.publish': '仅维护者使用',
+    'menu.hint.exit': '',
+    'menu.actionPrefix': '操作',
     'dev.startingApi': '[reactpress] 正在启动 API（首次可能需安装依赖，请稍候）…',
     'dev.waitingApi': '[reactpress] 等待 API 就绪: {url}',
     'dev.apiTimeout': '[reactpress] API 在 {seconds}s 内未就绪。\n  → 运行 reactpress doctor 查看详情\n  → 嵌入式 MySQL：reactpress docker up\n  → 检查 .env 中 DB_* 与 SERVER_SITE_URL',
@@ -376,11 +579,16 @@ const STRINGS = {
     'dev.nextDoctor': '  → reactpress doctor          环境诊断',
     'dev.nextDocker': '  → reactpress docker up       启动嵌入式 MySQL',
     'dev.nextEnv': '  → 检查 .env 中 DB_* 与 SERVER_SITE_URL',
-    'devBanner.ready': '  ✓ ReactPress 开发环境已就绪',
+    'dev.standaloneHint': '[reactpress] 独立项目：当前目录仅启动 API，前端请单独构建。',
+    'devBanner.ready': 'ReactPress 开发环境已就绪',
     'devBanner.site': '前台',
     'devBanner.admin': '管理端',
+    'devBanner.api': 'API',
+    'devBanner.swagger': 'Swagger',
     'devBanner.health': '健康检查',
-    'devBanner.hint': '  诊断: reactpress doctor  ·  状态: reactpress status',
+    'devBanner.hint': '诊断: reactpress doctor  ·  状态: reactpress status',
+    'devBanner.shortcuts': 'Ctrl+C  停止',
+    'devBanner.allSystemsGo': '一切就绪',
     'doctor.nodeBad': 'Node.js {version}（需要 ≥ 18）',
     'doctor.nodeFix': '请安装 Node.js 18+：https://nodejs.org/',
     'doctor.dockerOk': 'Docker 引擎可用',
@@ -411,17 +619,22 @@ const STRINGS = {
     'doctor.envOk': '.env 存在',
     'doctor.envBad': '缺少 .env',
     'doctor.envFix': '运行 reactpress init 或 reactpress config --apply',
-    'doctor.project': '  项目: {path}',
-    'doctor.allPass': '  全部检查通过，可以开始开发。',
-    'doctor.failed': '  {count} 项需要处理。',
-    'status.title': '  ReactPress 项目状态',
-    'status.dir': '  项目目录    {path}',
-    'status.apiSource': '  API 来源    {source}',
+    'doctor.project': '项目目录  {path}',
+    'doctor.allPass': '全部检查通过，可以开始开发。',
+    'doctor.failed': '{count} 项需要处理。',
+    'doctor.title': 'ReactPress Doctor',
+    'doctor.subtitle': '环境健康检查',
+    'doctor.checking': '正在检查 {name}…',
+    'doctor.summary': '通过 {passed}  ·  失败 {failed}  ·  共 {total} 项',
+    'doctor.fixesHeader': '修复建议',
+    'status.title': 'ReactPress 项目状态',
+    'status.dir': '项目目录    {path}',
+    'status.apiSource': 'API 来源    {source}',
     'status.apiSource.monorepo': 'monorepo server/',
     'status.apiSource.bundle': 'reactpress-cli',
-    'status.configOk': '.reactpress/config.json ✓',
+    'status.configOk': '.reactpress/config.json',
     'status.configBad': '未初始化',
-    'status.envOk': '.env ✓',
+    'status.envOk': '.env',
     'status.envBad': '缺少 .env',
     'status.apiOnline': '在线',
     'status.apiOffline': '离线',
@@ -429,10 +642,24 @@ const STRINGS = {
     'status.dbUp': '连通',
     'status.dbDown': '不可用',
     'status.pidRunning': '(运行中)',
-    'status.frontend': '  前端',
-    'status.docker': '  Docker',
+    'status.frontend': '前端',
+    'status.docker': 'Docker',
     'status.dockerUp': '可用',
     'status.dockerDown': '未运行',
+    'status.section.project': '项目信息',
+    'status.section.api': 'API 服务',
+    'status.section.frontend': '前端',
+    'status.section.docker': 'Docker',
+    'status.field.url': 'URL',
+    'status.field.http': 'HTTP',
+    'status.field.health': '健康',
+    'status.field.database': '数据库',
+    'status.field.pid': 'PID',
+    'status.field.engine': '引擎',
+    'status.field.config': '配置',
+    'status.field.env': '环境',
+    'status.field.source': '来源',
+    'status.field.dir': '目录',
     'bootstrap.configReady': '配置已存在，数据库已就绪。',
     'bootstrap.projectDbPending': '项目已创建，但数据库未就绪: {message}。请确认 Docker 已启动后重试 reactpress dev。',
     'bootstrap.ready': 'ReactPress 开发环境已就绪（配置 + 数据库）。',
@@ -443,7 +670,9 @@ const STRINGS = {
     'bootstrap.dbReady': '数据库已就绪',
     'db.backup.to': '备份数据库到 {path}',
     'db.backup.done': '备份完成',
-    'db.backup.fail': 'mysqldump 失败，请确认已安装 MySQL 客户端且 .env 正确',
+    'db.backup.viaDocker': '本机未找到 mysqldump，改用 Docker 内 db 容器的 mysqldump…',
+    'db.backup.fail':
+      'mysqldump 失败：请安装 MySQL 客户端（如 brew install mysql-client），或确保 Docker 数据库已运行以便自动在容器内备份',
     'common.done': '完成',
     'common.yes': '是',
     'common.no': '否',
@@ -481,9 +710,37 @@ const STRINGS = {
     'docker.mysqlTimeout': '[reactpress] MySQL 在超时时间内未就绪。',
     'docker.mysqlNotReady': 'MySQL 未就绪',
     'docker.startDevStack': '[reactpress] 启动 API + 前端 (Docker MySQL)…',
-    'docker.visitUrls': '[reactpress] 访问: http://localhost:8080 (nginx) / http://localhost:3001 (client)',
+    'docker.visitUrls': '[reactpress] 访问: http://localhost (nginx) / http://localhost:3001 (client)',
     'docker.devProcessExit': '开发进程退出: {code}',
     'docker.unknownCommand': '未知 docker 命令: {command}',
+    'nginx.configCreated': '[reactpress] 已生成 nginx 配置: {path}',
+    'nginx.configExists': '[reactpress] nginx 配置已存在: {path}',
+    'nginx.ensureWarn': '[reactpress] 无法确保 nginx 配置: {message}',
+    'nginx.started': '[reactpress] Nginx 已启动 — {url}',
+    'nginx.configPath': '[reactpress] 配置: {path}',
+    'nginx.stopped': '[reactpress] Nginx 已停止。',
+    'nginx.startFailed': '启动 nginx 容器失败',
+    'nginx.prodMonorepoOnly': '生产 nginx（--prod）需要 monorepo 且存在 docker-compose.prod.yml',
+    'nginx.statusTitle': '[reactpress] Nginx 状态',
+    'nginx.statusContainer': '  容器 {name}: {running}',
+    'nginx.statusConfig': '  配置 {path}: {exists}',
+    'nginx.statusUrl': '  入口 {url} (端口 {port})',
+    'nginx.statusMode': '  模式: {mode}',
+    'nginx.notRunning': 'Nginx 容器未运行。请执行: reactpress nginx up',
+    'nginx.testOk': '[reactpress] Nginx 配置校验通过。',
+    'nginx.testFailed': 'Nginx 配置校验失败',
+    'nginx.reloadOk': '[reactpress] Nginx 已重载。',
+    'nginx.reloadFailed': 'Nginx 重载失败',
+    'nginx.opening': '[reactpress] 正在打开 {url}',
+    'nginx.unknownCommand': '未知 nginx 命令: {command}',
+    'nginx.templateMissing': '内置 nginx 模板缺失: {path}',
+    'nginx.doctorSkippedDocker': '已跳过（Docker 未运行）',
+    'nginx.doctorSkippedNotRunning': '未启动（可选: reactpress nginx up）',
+    'nginx.doctorNotRunningFix': 'reactpress nginx up（或 reactpress docker up）',
+    'nginx.doctorOk': 'Nginx 健康 ({url}/health)',
+    'nginx.doctorUnhealthy': 'Nginx 在运行但 /health 失败 ({url})',
+    'nginx.doctorUnhealthyFix': '确认前端 (:3001) 与 API (:3002) 已启动；可执行 reactpress nginx reload',
+    'doctor.check.nginx': 'Nginx 代理',
     'apiDev.modeServer': '[reactpress] 开发模式: server/ (nest start --watch)',
     'apiDev.modeBundled': '[reactpress] 开发模式: 内置 API（随包附带）',
     'apiDev.ctrlCHint': '[reactpress] 按 Ctrl+C 停止 API。',
@@ -491,12 +748,12 @@ const STRINGS = {
     'build.unknownTarget': '未知构建目标: {target}，可选: {available}',
     'build.recursive': '检测到构建递归（pnpm run build 不能再次调用自身）。请使用 build:toolkit、build:server 或 build:client。',
     'build.forbiddenScript': '无效的构建脚本 "{script}"，请使用 build:toolkit 等细分脚本。',
-    'build.stepFailed': '[reactpress] [{current}/{total}] {label} 失败',
-    'build.plan': '[reactpress] 生产构建 — 共 {total} 步：toolkit → server → client',
-    'build.step': '[reactpress] [{current}/{total}] {label}…',
-    'build.stepDone': '[reactpress] [{current}/{total}] {label} ✓ ({seconds}s)',
-    'build.stepSkipped': '[reactpress] 已跳过 {label}（当前项目无对应源码包）',
-    'build.done': '[reactpress] 构建完成，耗时 {seconds}s',
+    'build.stepFailed': '[{current}/{total}] {label}  失败',
+    'build.plan': '生产构建 — 共 {total} 步：toolkit → server → client',
+    'build.step': '[{current}/{total}] {label}',
+    'build.stepDone': '[{current}/{total}] {label}  ({seconds}s)',
+    'build.stepSkipped': '已跳过  {label}（当前项目无对应源码包）',
+    'build.done': '构建完成，耗时 {seconds}s',
     'build.label.toolkit': 'Toolkit',
     'build.label.server': 'API (server)',
     'build.label.client': '前端 (client)',

package/lib/lifecycle.js

@@ -1,4 +1,5 @@
 const { spawn } = require('child_process');
+const ora = require('ora');
 const { ensureProjectEnvironment } = require('./bootstrap');
 const { loadServerSiteUrl, waitForHttp } = require('./http');
 const {
@@ -8,10 +9,43 @@ const {
   canStartLocalApi,
   getPidFile,
 } = require('./paths');
+const net = require('net');
 const { readPid, isProcessRunning, clearPidFile, writePid } = require('./process');
 const { ensureOriginalCwd } = require('./root');
 const { t } = require('./i18n');
 
+function parseServerPort(projectRoot) {
+  try {
+    const url = new URL(loadServerSiteUrl(projectRoot));
+    return Number(url.port) || 3002;
+  } catch {
+    return 3002;
+  }
+}
+
+function isPortBusy(port, host = '127.0.0.1') {
+  return new Promise((resolve) => {
+    const socket = net.createConnection({ port, host }, () => {
+      socket.destroy();
+      resolve(true);
+    });
+    socket.on('error', () => resolve(false));
+    socket.setTimeout(800, () => {
+      socket.destroy();
+      resolve(false);
+    });
+  });
+}
+
+async function waitForPortFree(port, timeoutMs = 8000) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (!(await isPortBusy(port))) return true;
+    await new Promise((r) => setTimeout(r, 200));
+  }
+  return false;
+}
+
 async function ensureConfig(projectRoot) {
   try {
     await ensureProjectEnvironment(projectRoot);
@@ -77,12 +111,17 @@ async function startApi(projectRoot, { wait = true } = {}) {
   }
 
   const serverUrl = loadServerSiteUrl(projectRoot);
+  const spinner = ora({
+    text: t('dev.waitingApi', { url: serverUrl }),
+    color: 'magenta',
+    spinner: 'dots',
+  }).start();
   const ready = await waitForHttp(serverUrl);
   if (!ready) {
-    console.error(t('lifecycle.apiTimeout120', { url: serverUrl }));
+    spinner.fail(t('lifecycle.apiTimeout120', { url: serverUrl }));
     return 1;
   }
-  console.log(t('lifecycle.apiReady', { url: serverUrl }));
+  spinner.succeed(t('lifecycle.apiReady', { url: serverUrl }));
   return 0;
 }
 
@@ -132,6 +171,8 @@ async function runLifecycleCommand(command, projectRoot = ensureOriginalCwd()) {
       return 0;
     case 'restart':
       stopApi(projectRoot);
+      await waitForPortFree(parseServerPort(projectRoot));
+      await new Promise((r) => setTimeout(r, 400));
       return startApi(projectRoot, { wait: true });
     case 'status':
       await statusApi(projectRoot);