create-ssnode-cli 0.2.5 → 0.2.7

package/templates/backend/src/modules/ops/sqlite-backup-list.probe.ts

@@ -1,100 +0,0 @@
-import { Injectable } from '@nestjs/common';
-import { ConfigService } from '@nestjs/config';
-import * as fs from 'fs';
-import * as path from 'path';
-import type { AppConfig } from '../../config/config.interface';
-import type { OpsProbe, OpsProbeResult } from './ops-probe.interface';
-
-/**
- * SQLite 备份历史探针：以表格形式列出每次三件套备份（时间 / 大小 / 是否含 WAL 旁文件）。
- * 只读，来源同 SqliteBackupProbe：{dataDir}/backup/template.{env}.* 子目录。
- */
-@Injectable()
-export class SqliteBackupListProbe implements OpsProbe {
-  readonly key = 'sqlite-backup-list';
-  readonly name = '备份历史';
-  readonly kind = 'table' as const;
-
-  constructor(private readonly config: ConfigService<AppConfig, true>) {}
-
-  private resolveDataDir(): string {
-    const dir = this.config.get<AppConfig['database']>('database')!.dir;
-    return path.isAbsolute(dir) ? dir : path.resolve(process.cwd(), dir);
-  }
-
-  async collect(): Promise<OpsProbeResult> {
-    const env = process.env.NODE_ENV === 'prod' ? 'prod' : 'develop';
-    const dataDir = this.resolveDataDir();
-    const backupDir = path.join(dataDir, 'backup');
-    const collectedAt = new Date().toISOString();
-
-    const base: OpsProbeResult = {
-      key: this.key,
-      name: this.name,
-      kind: 'table',
-      healthy: 'unknown',
-      summary: '',
-      detail: { kind: 'table', columns: [], rows: [] },
-      collectedAt
-    };
-
-    if (!fs.existsSync(backupDir)) {
-      base.summary = '备份目录不存在';
-      return base;
-    }
-
-    let entries: string[] = [];
-    try {
-      entries = fs
-        .readdirSync(backupDir, { withFileTypes: true })
-        .filter((d) => d.isDirectory() && d.name.startsWith(`template.${env}.`))
-        .map((d) => d.name)
-        .sort()
-        .reverse();
-    } catch (e) {
-      base.summary = `读取备份目录失败: ${(e as Error).message}`;
-      return base;
-    }
-
-    const baseName = (env === 'prod' ? 'template.prod' : 'template.develop') + '.sqlite';
-    const rows = entries.map((dirName) => {
-      const dirPath = path.join(backupDir, dirName);
-      const stat = fs.statSync(dirPath);
-      const mainFile = path.join(dirPath, baseName);
-      let mainBytes = 0;
-      try {
-        mainBytes = fs.statSync(mainFile).size;
-      } catch {
-        // 主库不在（残留目录），大小记 0
-      }
-      const hasWal = fs.existsSync(path.join(dirPath, `${baseName}-wal`));
-      const hasShm = fs.existsSync(path.join(dirPath, `${baseName}-shm`));
-      const tsMatch = dirName.match(/(\d{4})(\d{2})(\d{2})-(\d{2})(\d{2})(\d{2})$/);
-      const tsStr = tsMatch
-        ? `${tsMatch[1]}-${tsMatch[2]}-${tsMatch[3]} ${tsMatch[4]}:${tsMatch[5]}:${tsMatch[6]}`
-        : dirName;
-      return {
-        ts: tsStr,
-        dirName,
-        mainBytes,
-        wal: hasWal ? '有' : '无',
-        shm: hasShm ? '有' : '无',
-        mtime: stat.mtime.toISOString()
-      };
-    });
-
-    base.summary = rows.length ? `共 ${rows.length} 份备份` : '暂无备份';
-    base.healthy = rows.length > 0;
-    base.detail = {
-      kind: 'table',
-      columns: [
-        { key: 'ts', title: '备份时间' },
-        { key: 'mainBytes', title: '主库大小' },
-        { key: 'wal', title: 'WAL' },
-        { key: 'shm', title: 'SHM' }
-      ],
-      rows
-    };
-    return base;
-  }
-}

package/templates/backend/src/modules/ops/sqlite-backup-log.probe.ts

@@ -1,63 +0,0 @@
-import { Injectable } from '@nestjs/common';
-import { ConfigService } from '@nestjs/config';
-import * as fs from 'fs';
-import * as path from 'path';
-import type { AppConfig } from '../../config/config.interface';
-import type { OpsProbe, OpsProbeResult } from './ops-probe.interface';
-
-/**
- * SQLite 备份日志探针：只读展示 cron 任务的 `>> logfile 2>&1` 日志尾部。
- * 只读来源：{dataDir}/logs/sqlite-backup.log（backend/ops/sqlite/backup.sh 的输出落地，cron 与手动均写此）。
- * 取尾部 50 行（日志可能很大，只看最近的）。
- */
-@Injectable()
-export class SqliteBackupLogProbe implements OpsProbe {
-  readonly key = 'sqlite-backup-log';
-  readonly name = '备份日志';
-  readonly kind = 'log' as const;
-  private readonly MAX_LINES = 50;
-
-  constructor(private readonly config: ConfigService<AppConfig, true>) {}
-
-  private resolveDataDir(): string {
-    const dir = this.config.get<AppConfig['database']>('database')!.dir;
-    return path.isAbsolute(dir) ? dir : path.resolve(process.cwd(), dir);
-  }
-
-  async collect(): Promise<OpsProbeResult> {
-    const dataDir = this.resolveDataDir();
-    const logFile = path.join(dataDir, 'logs', 'sqlite-backup.log');
-    const collectedAt = new Date().toISOString();
-
-    const base: OpsProbeResult = {
-      key: this.key,
-      name: this.name,
-      kind: 'log',
-      healthy: 'unknown',
-      summary: '',
-      detail: { kind: 'log', lines: [] },
-      collectedAt
-    };
-
-    if (!fs.existsSync(logFile)) {
-      base.summary = '日志文件不存在（cron 未跑过或未配日志重定向）';
-      return base;
-    }
-
-    try {
-      const content = fs.readFileSync(logFile, 'utf8');
-      // 过滤测试残留行（手写测试数据污染判定）；真实失败行含 ❌ 且不含"测试"字样
-      const allLines = content.split('\n').filter((l) => l.length > 0 && !/测试|test/i.test(l));
-      const tail = allLines.slice(-this.MAX_LINES);
-      base.summary = `最近 ${tail.length} 行`;
-      // 判定：有 ✅ 成功行 = 跑过且成功过；含 ❌ 失败行 = 异常
-      const hasSuccess = tail.some((l) => l.includes('✅'));
-      const hasFail = tail.some((l) => l.includes('❌'));
-      base.healthy = hasSuccess && !hasFail ? true : hasFail ? false : 'unknown';
-      base.detail = { kind: 'log', lines: tail };
-    } catch (e) {
-      base.summary = `读取日志失败: ${(e as Error).message}`;
-    }
-    return base;
-  }
-}

package/templates/backend/src/modules/ops/sqlite-backup.probe.ts

@@ -1,144 +0,0 @@
-import { Injectable, Logger } from '@nestjs/common';
-import { ConfigService } from '@nestjs/config';
-import * as fs from 'fs';
-import * as path from 'path';
-import type { AppConfig } from '../../config/config.interface';
-import type { OpsProbe, OpsProbeResult } from './ops-probe.interface';
-
-/**
- * SQLite 备份探针：只读展示三件套文件拷贝备份的状态。
- *
- * 读取两类来源（全是文件系统，不进 DB、不碰 cron）：
- *   1) 备份目录 {dataDir}/backup/template.{env}.*  —— 每个子目录是一次备份三件套（主库+-wal+-shm）。
- *   2) 日志文件 {dataDir}/logs/sqlite-backup.log —— cron 任务的 `>> logfile 2>&1` 落地，取尾部展示。
- *
- * dataDir 推导：database.dir 是 sqlite 主库所在目录（prod 部署后为绝对路径 ${dataDir}；
- *   develop 为相对路径 data，相对 process.cwd()）。dir 即 dataDir（无需 dirname）。
- *   docker 模式下 dataDir 经 bind mount 映射为容器内 /app/data，app 读到的就是容器内绝对路径，
- *   与宿主 backup 目录是同一份（bind mount），探针读到的状态即宿主真实状态。
- *
- * 健康判定（不谎称完整性，只判新鲜度 + 份数）：
- *   - backup 目录不存在 / 无备份 → unknown（首次部署或未配 cron）
- *   - 最近一次备份 mtime 在 25h 内（每日 cron + 1h 余量）且份数 ≥1 → healthy=true
- *   - 超过 25h → healthy=false（cron 可能漏跑）
- *   - 不检测库完整性（需 sqlite3 CLI，服务器不一定有，别假设）
- *
- * 异常兜底：目录/文件读不到一律转成 healthy=unknown + summary 说明原因，不抛错。
- */
-@Injectable()
-export class SqliteBackupProbe implements OpsProbe {
-  private readonly logger = new Logger(SqliteBackupProbe.name);
-  readonly key = 'sqlite-backup';
-  readonly name = 'SQLite 备份';
-  readonly kind = 'status' as const;
-
-  // 一并返回 table + log 视图：通过 collect 组合多视图。
-  // 但接口约定一个 probe 一个 kind；这里主视图用 status，明细走 overview 接口的多 probe 组合？
-  // ——为保持 A 阶段简单且前端数据驱动，本 probe 返回 kind='status'，detail 含 items；
-  //   备份明细表与日志尾作为**额外 probe**（SqliteBackupListProbe / SqliteBackupLogProbe）注册，
-  //   各自独立 kind=table / kind=log。这样前端循环渲染，新增明细不改 status 卡。
-
-  constructor(private readonly config: ConfigService<AppConfig, true>) {}
-
-  /** 解析 dataDir 绝对路径 */
-  private resolveDataDir(): string {
-    const dir = this.config.get<AppConfig['database']>('database')!.dir;
-    // 相对路径相对 process.cwd()（develop）；绝对路径原样（prod 部署后）
-    return path.isAbsolute(dir) ? dir : path.resolve(process.cwd(), dir);
-  }
-
-  async collect(): Promise<OpsProbeResult> {
-    const env = process.env.NODE_ENV === 'prod' ? 'prod' : 'develop';
-    const dataDir = this.resolveDataDir();
-    const backupDir = path.join(dataDir, 'backup');
-    const thresholdHours = 25; // 每日 cron + 1h 余量
-    const collectedAt = new Date().toISOString();
-
-    // helper：构造一条 status 结果
-    const statusResult = (
-      healthy: boolean | 'unknown',
-      summary: string,
-      items: { label: string; value: string }[]
-    ): OpsProbeResult => ({
-      key: this.key,
-      name: this.name,
-      kind: 'status',
-      healthy,
-      summary,
-      detail: { kind: 'status', items },
-      collectedAt
-    });
-
-    if (!fs.existsSync(backupDir)) {
-      return statusResult('unknown', '备份目录不存在（未配 cron 或首次部署）', [
-        { label: '备份目录', value: backupDir }
-      ]);
-    }
-
-    // 列出 template.{env}.* 子目录（三件套备份目录），按名字倒序（名含时间戳，字典序≈时间倒序）
-    let entries: string[] = [];
-    try {
-      entries = fs
-        .readdirSync(backupDir, { withFileTypes: true })
-        .filter((d) => d.isDirectory() && d.name.startsWith(`template.${env}.`))
-        .map((d) => d.name)
-        .sort()
-        .reverse();
-    } catch (e) {
-      return statusResult('unknown', `读取备份目录失败: ${(e as Error).message}`, [
-        { label: '备份目录', value: backupDir }
-      ]);
-    }
-
-    if (entries.length === 0) {
-      return statusResult('unknown', '暂无备份（未配 cron 或首次部署）', [
-        { label: '备份目录', value: backupDir },
-        { label: '备份数', value: '0' }
-      ]);
-    }
-
-    const latestDir = entries[0];
-    const latestPath = path.join(backupDir, latestDir);
-    const stat = fs.statSync(latestPath);
-    const ageHours = (Date.now() - stat.mtimeMs) / 3_600_000;
-    const healthy = ageHours <= thresholdHours;
-    const triplet = this.readTriplet(latestPath);
-
-    return statusResult(
-      healthy,
-      healthy
-        ? `最近备份 ${this.formatAge(ageHours)}前 · 共 ${entries.length} 份`
-        : `最近备份已是 ${this.formatAge(ageHours)}前（超 ${thresholdHours}h，cron 可能漏跑）`,
-      [
-        { label: '最近备份', value: `${this.formatTs(latestDir)}（${this.formatAge(ageHours)}前）` },
-        { label: '备份数', value: String(entries.length) },
-        { label: '新鲜度阈值', value: `${thresholdHours}h` },
-        { label: '最近三件套', value: triplet || '仅主库（无 WAL 旁文件）' },
-        { label: '备份目录', value: backupDir }
-      ]
-    );
-  }
-
-  /** 读备份目录里三件套构成描述（如 template.prod.sqlite + -wal + -shm） */
-  private readTriplet(dir: string): string {
-    const env = process.env.NODE_ENV === 'prod' ? 'prod' : 'develop';
-    const base = `template.${env}.sqlite`;
-    const parts: string[] = [base];
-    if (fs.existsSync(path.join(dir, `${base}-wal`))) parts.push(`${base}-wal`);
-    if (fs.existsSync(path.join(dir, `${base}-shm`))) parts.push(`${base}-shm`);
-    return parts.join(' + ');
-  }
-
-  private formatAge(hours: number): string {
-    if (hours < 1) return `${Math.round(hours * 60)} 分钟`;
-    if (hours < 24) return `${Math.round(hours)} 小时`;
-    return `${Math.round(hours / 24)} 天`;
-  }
-
-  private formatTs(dirName: string): string {
-    // dirName 形如 template.prod.20260812-104311 → 2026-08-12 10:43:11
-    const m = dirName.match(/(\d{4})(\d{2})(\d{2})-(\d{2})(\d{2})(\d{2})$/);
-    if (!m) return dirName;
-    return `${m[1]}-${m[2]}-${m[3]} ${m[4]}:${m[5]}:${m[6]}`;
-  }
-}