@zdsj/pbms-cli 0.1.0

package/README.md

@@ -0,0 +1,101 @@
+# PBMS CLI
+
+项目预算管理系统命令行工具。
+
+## 安装
+
+```bash
+cd cli
+npm install
+
+# 可选：全局链接，安装后可在任意目录使用 pbms 命令
+npm link
+```
+
+不链接也可以直接运行：
+
+```bash
+node bin/pbms.js --help
+```
+
+## 配置
+
+首次使用需要配置服务端地址和 API Key：
+
+```bash
+pbms config set base-url https://your-host/api
+pbms config set api-key sk_xxxxxxxx
+```
+
+查看配置：
+
+```bash
+pbms config get
+```
+
+配置文件保存在 `~/.pbms/config.json`。
+
+## 命令一览
+
+### 仪表盘
+
+```bash
+pbms dashboard
+```
+
+### 公司预算（GSYSK）
+
+```bash
+pbms budget list [--keyword <kw>] [--type <yslx>] [--dept <gsbm>] [--page <p>] [--size <s>]
+pbms budget get <id>
+pbms budget create --data '{"ysbh":"...","ysmc":"..."}'
+pbms budget update <id> --data '{"ysmc":"..."}'
+pbms budget delete <id>
+pbms budget export [--output file.xlsx]
+```
+
+### 内部项目（NBXMK）
+
+```bash
+pbms internal list [--keyword <kw>] [--phase <xmjd>] [--group <yfz>] [--page <p>] [--size <s>]
+pbms internal get <id>
+pbms internal create --data '{"xmbh":"...","xmmc":"..."}'
+pbms internal update <id> --data '{"xmmc":"..."}'
+pbms internal delete <id>
+pbms internal export [--output file.xlsx]
+```
+
+### 外部项目（WBXMK）
+
+```bash
+pbms external list [--keyword <kw>] [--phase <xmjd>] [--customerType <khlx>] [--sales <fzxs>] [--page <p>] [--size <s>]
+pbms external get <id>
+pbms external create --data '{"xmbh":"...","xmmc":"..."}'
+pbms external update <id> --data '{"xmmc":"..."}'
+pbms external delete <id>
+pbms external export [--output file.xlsx]
+```
+
+### 审计日志
+
+```bash
+pbms log list [--keyword <kw>] [--table <table>] [--action <action>] [--page <p>] [--size <s>]
+pbms log get <id>
+```
+
+### 预算同步
+
+```bash
+pbms sync
+pbms sync --delayed
+```
+
+## 开发
+
+```bash
+npm run start -- <command>
+```
+
+## 依赖
+
+- Node.js >= 18

package/bin/pbms.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+process.on('unhandledRejection', (err) => {
+  const message = err?.response?.data?.message || err?.message || '未知错误';
+  console.error(chalk.red(`错误: ${message}`));
+  process.exit(1);
+});
+import { registerConfigCommand } from '../src/commands/config.js';
+import { registerDashboardCommand } from '../src/commands/dashboard.js';
+import { registerBudgetCommand } from '../src/commands/budget.js';
+import { registerInternalCommand } from '../src/commands/internal.js';
+import { registerExternalCommand } from '../src/commands/external.js';
+import { registerLogCommand } from '../src/commands/log.js';
+import { registerSyncCommand } from '../src/commands/sync.js';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(path.join(__dirname, '../package.json'), 'utf8'));
+
+const program = new Command();
+
+program
+  .name('pbms')
+  .description('项目预算管理系统命令行工具')
+  .version(pkg.version);
+
+registerConfigCommand(program);
+registerDashboardCommand(program);
+registerBudgetCommand(program);
+registerInternalCommand(program);
+registerExternalCommand(program);
+registerLogCommand(program);
+registerSyncCommand(program);
+
+program.parse();

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@zdsj/pbms-cli",
+  "version": "0.1.0",
+  "description": "项目预算管理系统命令行工具",
+  "type": "module",
+  "bin": {
+    "pbms": "./bin/pbms.js"
+  },
+  "scripts": {
+    "start": "node bin/pbms.js",
+    "test": "node --test"
+  },
+  "keywords": [
+    "cli",
+    "budget",
+    "management"
+  ],
+  "author": "",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "axios": "^1.7.9",
+    "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5",
+    "commander": "^13.0.0",
+    "ora": "^8.1.1"
+  }
+}

package/src/api.js

@@ -0,0 +1,57 @@
+import axios from 'axios';
+import { loadConfig } from './config.js';
+import chalk from 'chalk';
+
+let client = null;
+
+export function getClient() {
+  if (client) return client;
+
+  const config = loadConfig();
+  client = axios.create({
+    baseURL: config.baseUrl.replace(/\/$/, ''),
+    timeout: 30000,
+    headers: {
+      'Content-Type': 'application/json',
+    },
+  });
+
+  client.interceptors.request.use((req) => {
+    if (config.apiKey) {
+      req.headers['X-API-Key'] = config.apiKey;
+    }
+    return req;
+  });
+
+  client.interceptors.response.use(
+    (res) => res,
+    (err) => {
+      if (err.response) {
+        const { status, data } = err.response;
+        const message = data?.message || data?.error || `HTTP ${status}`;
+        if (status === 401) {
+          console.error(chalk.red('鉴权失败：请检查 base-url 和 api-key 是否配置正确'));
+        } else {
+          console.error(chalk.red(`请求失败: ${message}`));
+        }
+      } else if (err.request) {
+        console.error(chalk.red('无法连接到服务器，请检查 base-url 配置'));
+      } else {
+        console.error(chalk.red(`请求异常: ${err.message}`));
+      }
+      throw err;
+    }
+  );
+
+  return client;
+}
+
+export function resetClient() {
+  client = null;
+}
+
+export async function request(method, url, options = {}) {
+  const c = getClient();
+  const res = await c.request({ method, url, ...options });
+  return res.data;
+}

package/src/commands/budget.js

@@ -0,0 +1,20 @@
+import { createResourceCommands } from './resource.js';
+
+export function registerBudgetCommand(program) {
+  createResourceCommands(program, 'budget', '/gsysk', {
+    idField: 'id',
+    columns: [
+      { field: 'id', title: 'ID' },
+      { field: 'ysbh', title: '预算编号' },
+      { field: 'ysmc', title: '预算名称' },
+      { field: 'yslx', title: '预算类型' },
+      { field: 'ysje', title: '预算金额' },
+      { field: 'yyje', title: '已用金额' },
+      { field: 'gsbm', title: '归属部门' },
+    ],
+    searchParams: [
+      { name: 'type', param: 'yslx', description: '预算类型' },
+      { name: 'dept', param: 'gsbm', description: '归属部门' },
+    ],
+  });
+}

package/src/commands/config.js

@@ -0,0 +1,46 @@
+import { loadConfig, saveConfig, getConfigPath } from '../config.js';
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+export function registerConfigCommand(program) {
+  const configCmd = program.command('config').description('CLI 配置管理');
+
+  configCmd
+    .command('set <key> <value>')
+    .description('设置配置项（base-url, api-key）')
+    .action(async (key, value) => {
+      const validKeys = ['base-url', 'api-key'];
+      if (!validKeys.includes(key)) {
+        console.error(chalk.red(`未知配置项: ${key}。有效项: ${validKeys.join(', ')}`));
+        process.exit(1);
+      }
+
+      const config = loadConfig();
+      if (key === 'base-url') {
+        config.baseUrl = value;
+      } else if (key === 'api-key') {
+        config.apiKey = value;
+      }
+      saveConfig(config);
+      console.log(chalk.green(`已设置 ${key}`));
+    });
+
+  configCmd
+    .command('get [key]')
+    .description('查看配置项')
+    .action(async (key) => {
+      const config = loadConfig();
+      if (key) {
+        const displayKey = key === 'base-url' ? 'baseUrl' : key === 'api-key' ? 'apiKey' : key;
+        if (displayKey === 'apiKey') {
+          console.log(config[displayKey] ? '***已设置***' : '(未设置)');
+        } else {
+          console.log(config[displayKey] ?? '');
+        }
+      } else {
+        console.log('配置文件路径:', getConfigPath());
+        console.log('base-url:', config.baseUrl);
+        console.log('api-key:', config.apiKey ? '***已设置***' : '(未设置)');
+      }
+    });
+}

package/src/commands/dashboard.js

@@ -0,0 +1,33 @@
+import { request } from '../api.js';
+import { formatApiResponse } from '../utils/format.js';
+import Table from 'cli-table3';
+import chalk from 'chalk';
+
+export function registerDashboardCommand(program) {
+  program
+    .command('dashboard')
+    .description('查看仪表盘统计数据')
+    .action(async () => {
+      const res = await request('GET', '/dashboard');
+      const data = formatApiResponse(res);
+
+      const table = new Table({
+        head: [chalk.cyan('指标'), chalk.cyan('数值')],
+      });
+
+      const rows = [
+        ['内部项目数', data.internalProjectCount ?? '-'],
+        ['外部项目数', data.externalProjectCount ?? '-'],
+        ['预算条数', data.budgetCount ?? '-'],
+        ['预算总额', data.totalBudget ?? '-'],
+        ['已用额度', data.usedBudget ?? '-'],
+        ['余额', data.balance ?? '-'],
+      ];
+
+      for (const row of rows) {
+        table.push(row);
+      }
+
+      console.log(table.toString());
+    });
+}

package/src/commands/external.js

@@ -0,0 +1,21 @@
+import { createResourceCommands } from './resource.js';
+
+export function registerExternalCommand(program) {
+  createResourceCommands(program, 'external', '/wbxmk', {
+    idField: 'id',
+    columns: [
+      { field: 'id', title: 'ID' },
+      { field: 'xmbh', title: '项目编号' },
+      { field: 'xmmc', title: '项目名称' },
+      { field: 'xmys', title: '项目预算' },
+      { field: 'syys', title: '使用预算' },
+      { field: 'xmjd', title: '项目阶段' },
+      { field: 'khmc', title: '客户名称' },
+    ],
+    searchParams: [
+      { name: 'phase', param: 'xmjd', description: '项目阶段' },
+      { name: 'customerType', param: 'khlx', description: '客户类型' },
+      { name: 'sales', param: 'fzxs', description: '负责销售' },
+    ],
+  });
+}

package/src/commands/internal.js

@@ -0,0 +1,20 @@
+import { createResourceCommands } from './resource.js';
+
+export function registerInternalCommand(program) {
+  createResourceCommands(program, 'internal', '/nbxmk', {
+    idField: 'id',
+    columns: [
+      { field: 'id', title: 'ID' },
+      { field: 'xmbh', title: '项目编号' },
+      { field: 'xmmc', title: '项目名称' },
+      { field: 'xmys', title: '项目预算' },
+      { field: 'syys', title: '使用预算' },
+      { field: 'xmjd', title: '项目阶段' },
+      { field: 'yfz', title: '研发组' },
+    ],
+    searchParams: [
+      { name: 'phase', param: 'xmjd', description: '项目阶段' },
+      { name: 'group', param: 'yfz', description: '研发组' },
+    ],
+  });
+}

package/src/commands/log.js

@@ -0,0 +1,47 @@
+import { request } from '../api.js';
+import { printTable, printJson, printPageInfo, extractList, formatApiResponse } from '../utils/format.js';
+
+export function registerLogCommand(program) {
+  const logCmd = program.command('log').description('审计日志查询');
+
+  logCmd
+    .command('list')
+    .description('查询审计日志列表')
+    .option('-k, --keyword <keyword>', '关键词')
+    .option('-t, --table <table>', '操作的表名')
+    .option('-a, --action <action>', '操作类型')
+    .option('-p, --page <page>', '页码', '0')
+    .option('-s, --size <size>', '每页大小', '10')
+    .action(async (opts) => {
+      const params = new URLSearchParams();
+      if (opts.keyword) params.set('keyword', opts.keyword);
+      if (opts.table) params.set('operTable', opts.table);
+      if (opts.action) params.set('operAction', opts.action);
+      params.set('page', opts.page);
+      params.set('size', opts.size);
+
+      const res = await request('GET', `/oper-log?${params.toString()}`);
+      const data = formatApiResponse(res);
+      const { list, page } = extractList(data);
+
+      const columns = [
+        { field: 'id', title: 'ID' },
+        { field: 'operType', title: '操作类型' },
+        { field: 'operTable', title: '操作表' },
+        { field: 'operUser', title: '操作人' },
+        { field: 'operAction', title: '操作动作' },
+        { field: 'operTime', title: '操作时间' },
+      ];
+      const rows = list.map((item) => columns.map((col) => item[col.field] ?? ''));
+      printTable(columns.map((col) => col.title), rows);
+      printPageInfo(page);
+    });
+
+  logCmd
+    .command('get <id>')
+    .description('查询审计日志详情')
+    .action(async (id) => {
+      const res = await request('GET', `/oper-log/${id}`);
+      printJson(formatApiResponse(res));
+    });
+}

package/src/commands/resource.js

@@ -0,0 +1,99 @@
+import { request } from '../api.js';
+import { printTable, printJson, printPageInfo, extractList, formatApiResponse } from '../utils/format.js';
+import chalk from 'chalk';
+
+export function createResourceCommands(program, name, endpoint, options = {}) {
+  const { idField = 'id', columns = [], searchParams = [] } = options;
+
+  const parentCmd = program.command(name).description(`${name} 资源管理`);
+
+  const listCmd = parentCmd
+    .command('list')
+    .description('查询列表')
+    .option('-k, --keyword <keyword>', '关键词')
+    .option('-p, --page <page>', '页码', '0')
+    .option('-s, --size <size>', '每页大小', '10');
+
+  for (const sp of searchParams) {
+    listCmd.option(`--${sp.name} <value>`, sp.description || sp.param);
+  }
+
+  listCmd.action(async (opts) => {
+    const params = new URLSearchParams();
+    if (opts.keyword) params.set('keyword', opts.keyword);
+    for (const sp of searchParams) {
+      if (opts[sp.name]) params.set(sp.param, opts[sp.name]);
+    }
+    params.set('page', opts.page);
+    params.set('size', opts.size);
+
+    const res = await request('GET', `${endpoint}?${params.toString()}`);
+    const data = formatApiResponse(res);
+    const { list, page } = extractList(data);
+
+    const rows = list.map((item) => columns.map((col) => item[col.field] ?? ''));
+    printTable(columns.map((col) => col.title), rows);
+    printPageInfo(page);
+  });
+
+  parentCmd
+    .command('get <id>')
+    .description('查询详情')
+    .action(async (id) => {
+      const res = await request('GET', `${endpoint}/${id}`);
+      printJson(formatApiResponse(res));
+    });
+
+  parentCmd
+    .command('create')
+    .description('新增')
+    .option('-d, --data <json>', 'JSON 格式数据')
+    .action(async (opts) => {
+      let body;
+      if (opts.data) {
+        body = JSON.parse(opts.data);
+      } else {
+        console.error(chalk.red('请使用 --data 传入 JSON 数据'));
+        process.exit(1);
+      }
+      const res = await request('POST', endpoint, { data: body });
+      printJson(formatApiResponse(res));
+    });
+
+  parentCmd
+    .command('update <id>')
+    .description('更新')
+    .option('-d, --data <json>', 'JSON 格式数据')
+    .action(async (id, opts) => {
+      let body;
+      if (opts.data) {
+        body = JSON.parse(opts.data);
+      } else {
+        console.error(chalk.red('请使用 --data 传入 JSON 数据'));
+        process.exit(1);
+      }
+      const res = await request('PUT', `${endpoint}/${id}`, { data: body });
+      printJson(formatApiResponse(res));
+    });
+
+  parentCmd
+    .command('delete <id>')
+    .description('删除')
+    .action(async (id) => {
+      const res = await request('DELETE', `${endpoint}/${id}`);
+      printJson(formatApiResponse(res));
+    });
+
+  parentCmd
+    .command('export')
+    .description('导出 Excel')
+    .option('-o, --output <file>', '输出文件路径')
+    .action(async (opts) => {
+      const c = (await import('../api.js')).getClient();
+      const res = await c.get(`${endpoint}/export`, { responseType: 'arraybuffer' });
+      const output = opts.output || `${name}-export.xlsx`;
+      const fs = await import('node:fs');
+      fs.writeFileSync(output, Buffer.from(res.data));
+      console.log(chalk.green(`已导出到: ${output}`));
+    });
+}

package/src/commands/sync.js

@@ -0,0 +1,24 @@
+import { request } from '../api.js';
+import { formatApiResponse, printJson } from '../utils/format.js';
+import ora from 'ora';
+import chalk from 'chalk';
+
+export function registerSyncCommand(program) {
+  program
+    .command('sync')
+    .description('同步低代码流程金额到预算科目')
+    .option('--delayed', '延迟异步执行')
+    .action(async (opts) => {
+      const url = opts.delayed ? '/sync/gsysk/flow-amounts/delayed' : '/sync/gsysk/flow-amounts';
+      const spinner = ora('正在同步...').start();
+      try {
+        const res = await request('POST', url);
+        spinner.stop();
+        printJson(formatApiResponse(res));
+      } catch (err) {
+        spinner.stop();
+        console.error(chalk.red('同步失败'));
+        throw err;
+      }
+    });
+}

package/src/config.js

@@ -0,0 +1,59 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
+const CONFIG_DIR = path.join(os.homedir(), '.pbms');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+const defaultConfig = {
+  baseUrl: 'http://localhost:17342/api',
+  apiKey: '',
+};
+
+function ensureConfigDir() {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+export function loadConfig() {
+  ensureConfigDir();
+  if (!fs.existsSync(CONFIG_FILE)) {
+    return { ...defaultConfig };
+  }
+  try {
+    const raw = fs.readFileSync(CONFIG_FILE, 'utf8');
+    const parsed = JSON.parse(raw);
+    return { ...defaultConfig, ...parsed };
+  } catch (err) {
+    console.error('读取配置文件失败:', err.message);
+    return { ...defaultConfig };
+  }
+}
+
+export function saveConfig(config) {
+  ensureConfigDir();
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+
+export function setConfigValue(key, value) {
+  const config = loadConfig();
+  if (!Object.prototype.hasOwnProperty.call(defaultConfig, key)) {
+    throw new Error(`未知配置项: ${key}。有效项: ${Object.keys(defaultConfig).join(', ')}`);
+  }
+  config[key] = value;
+  saveConfig(config);
+  return config;
+}
+
+export function getConfigValue(key) {
+  const config = loadConfig();
+  if (key) {
+    return config[key];
+  }
+  return config;
+}
+
+export function getConfigPath() {
+  return CONFIG_FILE;
+}

package/src/utils/format.js

@@ -0,0 +1,61 @@
+import Table from 'cli-table3';
+import chalk from 'chalk';
+
+export function printJson(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+
+export function printTable(headers, rows) {
+  if (!rows || rows.length === 0) {
+    console.log(chalk.yellow('暂无数据'));
+    return;
+  }
+
+  const table = new Table({
+    head: headers.map((h) => chalk.cyan(h)),
+    wordWrap: true,
+    truncate: '...',
+  });
+
+  for (const row of rows) {
+    table.push(row);
+  }
+
+  console.log(table.toString());
+}
+
+export function printPageInfo(page) {
+  if (!page) return;
+  const { number, size, totalElements, totalPages } = page;
+  console.log(
+    chalk.gray(
+      `第 ${number + 1} 页 / 共 ${totalPages} 页，每页 ${size} 条，总计 ${totalElements} 条`
+    )
+  );
+}
+
+export function formatApiResponse(data) {
+  if (data && typeof data === 'object' && 'code' in data) {
+    if (data.code !== 200) {
+      throw new Error(data.message || '接口返回错误');
+    }
+    return data.data;
+  }
+  return data;
+}
+
+export function extractList(response) {
+  const data = formatApiResponse(response);
+  if (data && Array.isArray(data.content)) {
+    return {
+      list: data.content,
+      page: {
+        number: data.number ?? 0,
+        size: data.size ?? 0,
+        totalElements: data.totalElements ?? 0,
+        totalPages: data.totalPages ?? 0,
+      },
+    };
+  }
+  return { list: Array.isArray(data) ? data : [], page: null };
+}

package/src/utils/prompts.js

@@ -0,0 +1,19 @@
+import { input, confirm } from '@inquirer/prompts';
+
+export async function promptFor(fields) {
+  const result = {};
+  for (const field of fields) {
+    const value = await input({
+      message: field.message,
+      default: field.default || '',
+    });
+    if (value) {
+      result[field.name] = value;
+    }
+  }
+  return result;
+}
+
+export async function confirmAction(message) {
+  return confirm({ message, default: false });
+}