hikvision-cli 1.0.0

package/src/commands/binding.ts

@@ -0,0 +1,305 @@
+/**
+ * 绑定管理命令
+ */
+
+import { Command } from 'commander';
+import { config } from '../utils/config';
+import { success, error, formatOutput } from '../utils/output';
+import { createHikvisionClient } from '../services/hikvisionClient';
+
+export const bindingCommands = new Command()
+  .command('binding')
+  .description('绑定关系管理（人员-卡片/人员-车辆）');
+
+/**
+ * 人员-卡片绑定
+ */
+const personCard = bindingCommands
+  .command('person-card')
+  .description('人员-卡片绑定');
+
+personCard
+  .command('list')
+  .description('查询人员-卡片绑定列表')
+  .option('-p, --page <page>', '页码', '1')
+  .option('-s, --size <size>', '每页数量', '50')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+
+      // 查询所有卡片，过滤有 personId 的
+      const result: any = await client.cardService.list({
+        pageNo: parseInt(options.page),
+        pageSize: parseInt(options.size),
+      });
+
+      const cards = (result?.data?.list || result?.list || [])
+        .filter((c: any) => c.personId);
+
+      if (cards.length === 0) {
+        console.log('暂无绑定记录');
+        return;
+      }
+
+      console.log(`\n🪪 人员-卡片绑定列表 (共 ${cards.length} 条)\n`);
+      console.log('  人员ID                      人员姓名           卡号                  绑定状态');
+      console.log('  ─────────────────────────────────────────────────────────────────────────────');
+
+      for (const c of cards) {
+        console.log(`  ${c.personId}  ${(c.personName || '-').substring(0, 10).padEnd(12)}  ${c.cardNo.padEnd(20)}  ${statusText(c.status)}`);
+      }
+    } catch (err: any) {
+      error(`查询失败: ${err.message || err}`);
+    }
+  });
+
+personCard
+  .command('bind')
+  .description('绑定人员到卡片')
+  .option('-pid, --person-id <personId>', '人员 ID')
+  .option('-n, --person-name <personName>', '人员姓名')
+  .option('-c, --card-no <cardNo>', '卡号')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      let personId = options.personId;
+
+      if (!personId && options.personName) {
+        personId = await findPersonIdByName(client, options.personName);
+        if (!personId) {
+          error(`未找到名为 "${options.personName}" 的人员`);
+          return;
+        }
+      }
+
+      if (!personId || !options.cardNo) {
+        error('请指定 --person-id (或 --person-name) 和 --card-no');
+        return;
+      }
+
+      await client.cardService.bind({
+        startDate: new Date().toISOString().split('T')[0],
+        endDate: '2037-12-31',
+        cards: [{ cardNo: options.cardNo, personId, cardType: 0 }],
+      });
+
+      success(`绑定成功：人员 ${personId} → 卡片 ${options.cardNo}`);
+    } catch (err: any) {
+      error(`绑定失败: ${err.message || err}`);
+    }
+  });
+
+personCard
+  .command('unbind')
+  .description('解绑人员与卡片')
+  .option('-pid, --person-id <personId>', '人员 ID')
+  .option('-n, --person-name <personName>', '人员姓名')
+  .option('-c, --card-no <cardNo>', '卡号')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      let personId = options.personId;
+
+      if (!personId && options.personName) {
+        personId = await findPersonIdByName(client, options.personName);
+        if (!personId) {
+          error(`未找到名为 "${options.personName}" 的人员`);
+          return;
+        }
+      }
+
+      if (!personId || !options.cardNo) {
+        error('请指定 --person-id (或 --person-name) 和 --card-no');
+        return;
+      }
+
+      await client.cardService.unbind(options.cardNo, personId);
+      success(`解绑成功：人员 ${personId} ←→ 卡片 ${options.cardNo}`);
+    } catch (err: any) {
+      error(`解绑失败: ${err.message || err}`);
+    }
+  });
+
+/**
+ * 人员-车辆绑定
+ */
+const personVehicle = bindingCommands
+  .command('person-vehicle')
+  .description('人员-车辆绑定');
+
+personVehicle
+  .command('list')
+  .description('查询人员-车辆绑定列表')
+  .option('-p, --page <page>', '页码', '1')
+  .option('-s, --size <size>', '每页数量', '50')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+
+      // 使用 advance 接口，通过 personIds 过滤
+      const allBindings: any[] = [];
+      let pageNo = 1;
+      const pageSize = 100;
+
+      while (true) {
+        const result: any = await (client.vehicleService as any).list({
+          pageNo,
+          pageSize,
+          isBandPerson: 1,
+        });
+
+        const vehicles = result?.data?.list || result?.list || [];
+        if (vehicles.length === 0) break;
+
+        const bound = vehicles.filter((v: any) => v.personId);
+        allBindings.push(...bound);
+
+        if (vehicles.length < pageSize) break;
+        pageNo++;
+      }
+
+      if (allBindings.length === 0) {
+        console.log('暂无绑定记录');
+        return;
+      }
+
+      console.log(`\n🚗 人员-车辆绑定列表 (共 ${allBindings.length} 条)\n`);
+      console.log('  车辆ID                      车牌号      人员ID                      人员姓名');
+      console.log('  ─────────────────────────────────────────────────────────────────────────────');
+
+      for (const v of allBindings.slice(0, parseInt(options.size))) {
+        console.log(`  ${v.vehicleId}  ${(v.plateNo || '-').padEnd(10)}  ${v.personId}  ${v.personName || '-'}`);
+      }
+    } catch (err: any) {
+      error(`查询失败: ${err.message || err}`);
+    }
+  });
+
+personVehicle
+  .command('bind')
+  .description('绑定人员到车辆（设置车辆的车主）')
+  .option('-vid, --vehicle-id <vehicleId>', '车辆 ID')
+  .option('-l, --plate-no <plateNo>', '车牌号（与 --vehicle-id 二选一）')
+  .option('-pid, --person-id <personId>', '人员 ID')
+  .option('-n, --person-name <personName>', '人员姓名')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+
+      // 获取车辆 ID
+      let vehicleId = options.vehicleId;
+      if (!vehicleId && options.plateNo) {
+        const v: any = await client.vehicleService.getByPlateNo(options.plateNo);
+        vehicleId = v?.vehicleId;
+        if (!vehicleId) {
+          error(`未找到车牌为 "${options.plateNo}" 的车辆`);
+          return;
+        }
+      }
+
+      // 获取人员 ID
+      let personId = options.personId;
+      if (!personId && options.personName) {
+        personId = await findPersonIdByName(client, options.personName);
+        if (!personId) {
+          error(`未找到名为 "${options.personName}" 的人员`);
+          return;
+        }
+      }
+
+      if (!vehicleId || !personId) {
+        error('请指定车辆 ID (--vehicle-id 或 --plate-no) 和人员 ID (--person-id 或 --person-name)');
+        return;
+      }
+
+      // 获取车辆信息用于更新
+      const vehicle: any = await client.vehicleService.getById(vehicleId);
+
+      // 通过 saveOrUpdate 绑定人员（personId 字段即为绑定）
+      await client.vehicleService.saveOrUpdate({
+        plateNo: vehicle.plateNo,
+        vehicleType: vehicle.vehicleType,
+        vehicleColor: vehicle.vehicleColor,
+        vehicleModel: vehicle.vehicleModel,
+        personId,
+      });
+
+      success(`绑定成功：车辆 ${vehicleId} → 人员 ${personId}`);
+    } catch (err: any) {
+      error(`绑定失败: ${err.message || err}`);
+    }
+  });
+
+personVehicle
+  .command('unbind')
+  .description('解绑人员与车辆（清除车辆的车主）')
+  .option('-vid, --vehicle-id <vehicleId>', '车辆 ID')
+  .option('-l, --plate-no <plateNo>', '车牌号（与 --vehicle-id 二选一）')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+
+      // 获取车辆 ID
+      let vehicleId = options.vehicleId;
+      if (!vehicleId && options.plateNo) {
+        const v: any = await client.vehicleService.getByPlateNo(options.plateNo);
+        vehicleId = v?.vehicleId;
+        if (!vehicleId) {
+          error(`未找到车牌为 "${options.plateNo}" 的车辆`);
+          return;
+        }
+      }
+
+      if (!vehicleId) {
+        error('请指定 --vehicle-id 或 --plate-no');
+        return;
+      }
+
+      // 获取车辆信息
+      const vehicle: any = await client.vehicleService.getById(vehicleId);
+
+      // 通过 saveOrUpdate 解绑（personId 置空）
+      await client.vehicleService.saveOrUpdate({
+        plateNo: vehicle.plateNo,
+        vehicleType: vehicle.vehicleType,
+        vehicleColor: vehicle.vehicleColor,
+        vehicleModel: vehicle.vehicleModel,
+        personId: '',
+      });
+
+      success(`解绑成功：车辆 ${vehicleId} 已清除车主`);
+    } catch (err: any) {
+      error(`解绑失败: ${err.message || err}`);
+    }
+  });
+
+// ============ 内部辅助函数 ============
+
+async function findPersonIdByName(
+  client: ReturnType<typeof createHikvisionClient>,
+  personName: string
+): Promise<string | null> {
+  const list: any = await client.personService.list({
+    pageNo: 1,
+    pageSize: 50,
+    personName,
+  });
+
+  const persons = list?.data?.list || list?.list || [];
+  if (persons.length === 0) return null;
+  if (persons.length === 1) return persons[0].personId;
+
+  console.log(`找到 ${persons.length} 条匹配记录，请使用 --person-id 指定：`);
+  for (const p of persons) {
+    console.log(`  ${p.personId}  ${p.personName}  ${p.phoneNo || '-'}`);
+  }
+  return null;
+}
+
+function statusText(status?: number): string {
+  if (status === 0) return '正常';
+  if (status === 1) return '挂失';
+  if (status === 2) return '退卡';
+  if (status === 3) return '损坏';
+  return '未知';
+}

package/src/commands/card.ts

@@ -0,0 +1,238 @@
+/**
+ * 卡片管理命令
+ */
+
+import { Command } from 'commander';
+import { config } from '../utils/config';
+import { success, error, formatOutput, formatBatchResult } from '../utils/output';
+import { createHikvisionClient } from '../services/hikvisionClient';
+import { validateJsonFile } from '../utils/validation';
+
+export const cardCommands = new Command()
+  .command('card')
+  .description('卡片管理');
+
+// 开卡并绑定（开卡+绑定一体）
+cardCommands
+  .command('bind')
+  .description('开卡并绑定（开卡+绑定一体）')
+  .option('-f, --file <file>', 'JSON 文件路径')
+  .option('-c, --card-no <cardNo>', '卡号')
+  .option('-p, --person-id <personId>', '人员 ID')
+  .option('-n, --person-name <personName>', '人员姓名')
+  .option('-o, --org <orgIndexCode>', '组织 ID')
+  .option('-on, --org-name <orgName>', '组织名称')
+  .option('-t, --type <type>', '卡类型 (0:普通, 1:临时, 2:特殊)')
+  .option('-e, --expire <expire>', '过期时间')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      // 如果指定了人员姓名，需要先查找人员 ID
+      let personId = options.personId;
+      if (!personId && options.personName) {
+        personId = await findPersonIdByName(client, options.personName, options.org, options.orgName);
+        if (!personId) {
+          error(`未找到名为 "${options.personName}" 的人员`);
+          return;
+        }
+      }
+      
+      if (!personId || !options.cardNo) {
+        error('请指定人员 ID (--person-id 或 --person-name) 和卡号 (--card-no)');
+        return;
+      }
+      
+      const result = await client.cardService.bind({ 
+        startDate: new Date().toISOString().split('T')[0], 
+        endDate: '2037-12-31', 
+        cards: [{ cardNo: options.cardNo, personId, cardType: options.type ? parseInt(options.type) : undefined }] 
+      });
+      console.log(formatBatchResult(result));
+    } catch (err: any) {
+      error(`绑定卡片失败: ${err.message || err}`);
+    }
+  });
+
+// 查询卡片列表
+cardCommands
+  .command('list')
+  .description('查询卡片列表')
+  .option('-p, --page <page>', '页码', '1')
+  .option('-s, --size <size>', '每页数量', '20')
+  .option('-c, --card-no <cardNo>', '卡号搜索')
+  .option('-pid, --person-id <personId>', '人员 ID')
+  .option('-n, --person-name <personName>', '人员姓名（模糊搜索）')
+  .option('-t, --type <type>', '卡类型')
+  .option('-st, --status <status>', '状态 (0:正常, 1:挂失, 2:退卡, 3:损坏)')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      const result = await client.cardService.list({
+        pageNo: parseInt(options.page),
+        pageSize: parseInt(options.size),
+        cardNo: options.cardNo,
+        personId: options.personId,
+        personName: options.personName,
+        cardType: options.type as '0' | '1' | '2',
+        status: options.status as '0' | '1' | '2' | '3',
+      });
+      
+      console.log(formatOutput(result));
+    } catch (err: any) {
+      error(`查询卡片失败: ${err.message || err}`);
+    }
+  });
+
+// 退卡（解绑）
+cardCommands
+  .command('unbind')
+  .description('退卡（解绑人员与卡片）')
+  .option('-f, --file <file>', 'JSON 文件路径')
+  .option('-c, --card-no <cardNo>', '卡号')
+  .option('-p, --person-id <personId>', '人员 ID')
+  .option('-n, --person-name <personName>', '人员姓名')
+  .option('-o, --org <orgIndexCode>', '组织 ID')
+  .option('-on, --org-name <orgName>', '组织名称')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      if (options.file) {
+        const fs = await import('fs');
+        // 验证 JSON 文件格式和内容
+        const validated = validateJsonFile(fs.readFileSync(options.file, 'utf-8'), {
+          requiredFields: ['cards'],
+          maxSize: 5 * 1024 * 1024, // 5MB
+        });
+        const data = JSON.parse(validated.content);
+        const result = await client.cardService.batchUnbind(data.cards);
+        console.log(formatBatchResult(result));
+      } else if (options.cardNo) {
+        let personId = options.personId;
+        if (!personId && options.personName) {
+          personId = await findPersonIdByName(client, options.personName, options.org, options.orgName);
+          if (!personId) {
+            error(`未找到名为 "${options.personName}" 的人员`);
+            return;
+          }
+        }
+        
+        if (!personId) {
+          error('请指定 --person-id 或 --person-name');
+          return;
+        }
+        
+        await client.cardService.unbind(options.cardNo, personId);
+        success('退卡成功');
+      } else {
+        error('请指定 --file 或 --card-no');
+      }
+    } catch (err: any) {
+      error(`退卡失败: ${err.message || err}`);
+    }
+  });
+
+// 挂失
+cardCommands
+  .command('loss')
+  .description('批量挂失')
+  .option('-f, --file <file>', 'JSON 文件路径')
+  .option('-c, --card-no <cardNo>', '卡号')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      if (options.file) {
+        const fs = await import('fs');
+        // 验证 JSON 文件格式和内容
+        const validated = validateJsonFile(fs.readFileSync(options.file, 'utf-8'), {
+          requiredFields: ['cards'],
+          maxSize: 5 * 1024 * 1024, // 5MB
+        });
+        const data = JSON.parse(validated.content);
+        const result = await client.cardService.batchLoss(data.cards);
+        console.log(formatBatchResult(result));
+      } else if (options.cardNo) {
+        await client.cardService.loss(options.cardNo);
+        success('挂失成功');
+      } else {
+        error('请指定 --file 或 --card-no');
+      }
+    } catch (err: any) {
+      error(`挂失失败: ${err.message || err}`);
+    }
+  });
+
+// 解挂
+cardCommands
+  .command('unloss')
+  .description('批量解挂')
+  .option('-f, --file <file>', 'JSON 文件路径')
+  .option('-c, --card-no <cardNo>', '卡号')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      if (options.file) {
+        const fs = await import('fs');
+        // 验证 JSON 文件格式和内容
+        const validated = validateJsonFile(fs.readFileSync(options.file, 'utf-8'), {
+          requiredFields: ['cards'],
+          maxSize: 5 * 1024 * 1024, // 5MB
+        });
+        const data = JSON.parse(validated.content);
+        const result = await client.cardService.batchUnloss(data.cards);
+        console.log(formatBatchResult(result));
+      } else if (options.cardNo) {
+        await client.cardService.unloss(options.cardNo);
+        success('解挂成功');
+      } else {
+        error('请指定 --file 或 --card-no');
+      }
+    } catch (err: any) {
+      error(`解挂失败: ${err.message || err}`);
+    }
+  });
+
+// ============ 内部辅助函数 ============
+
+async function findPersonIdByName(
+  client: ReturnType<typeof createHikvisionClient>,
+  personName: string,
+  orgIndexCode?: string,
+  orgName?: string
+): Promise<string | null> {
+  // 如果有 orgName，先查 orgIndexCode
+  let targetOrgCode = orgIndexCode;
+  if (orgName && !targetOrgCode) {
+    const orgs = await client.personService.getOrganizations();
+    const found = orgs.find(o => o.orgName === orgName);
+    if (!found) {
+      return null;
+    }
+    targetOrgCode = found.orgIndexCode;
+  }
+
+  const list = await client.personService.list({
+    pageNo: 1,
+    pageSize: 50,
+    personName,
+    orgIndexCode: targetOrgCode,
+  });
+
+  const persons = (list as any).list ?? [];
+  if (persons.length === 0) {
+    return null;
+  }
+  if (persons.length === 1) {
+    return persons[0].personId;
+  }
+  
+  console.log(`找到 ${persons.length} 条匹配记录，请使用 --person-id 指定：`);
+  for (const p of persons) {
+    console.log(`  ${p.personId}  ${p.personName}  ${p.phoneNo || '-'}  org: ${p.orgIndexCode}`);
+  }
+  return null;
+}

package/src/commands/group.ts

@@ -0,0 +1,91 @@
+/**
+ * 分组管理命令
+ */
+
+import { Command } from 'commander';
+import { config } from '../utils/config';
+import { success, error, formatOutput } from '../utils/output';
+import { createHikvisionClient } from '../services/hikvisionClient';
+
+export const groupCommands = new Command()
+  .command('group')
+  .description('车辆群组管理');
+
+// 查询分组列表
+groupCommands
+  .command('list')
+  .description('查询车辆群组列表')
+  .action(async () => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      const result = await client.vehicleService.listGroups();
+      console.log(formatOutput(result));
+    } catch (err: any) {
+      error(`查询分组失败: ${err.message || err}`);
+    }
+  });
+
+// 添加分组
+groupCommands
+  .command('add')
+  .description('添加车辆群组')
+  .option('-n, --name <name>', '分组名称')
+  .option('-t, --type <type>', '分组类型 (0:内部, 1:外部)', '0')
+  .option('-d, --desc <desc>', '描述')
+  .action(async (options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      const result = await client.vehicleService.addGroup({
+        groupName: options.name,
+        groupType: options.type as '0' | '1',
+        description: options.desc,
+      });
+      
+      success('分组添加成功！');
+      console.log(formatOutput(result));
+    } catch (err: any) {
+      error(`添加分组失败: ${err.message || err}`);
+    }
+  });
+
+// 修改分组
+groupCommands
+  .command('update')
+  .description('修改车辆群组')
+  .argument('<groupId>', '分组 ID')
+  .option('-n, --name <name>', '分组名称')
+  .option('-t, --type <type>', '分组类型 (0:内部, 1:外部)')
+  .option('-d, --desc <desc>', '描述')
+  .action(async (groupId, options) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      await client.vehicleService.updateGroup(groupId, {
+        groupName: options.name,
+        groupType: options.type as '0' | '1',
+        description: options.desc,
+      });
+      
+      success('分组已更新');
+    } catch (err: any) {
+      error(`修改分组失败: ${err.message || err}`);
+    }
+  });
+
+// 删除分组
+groupCommands
+  .command('delete')
+  .description('删除车辆群组')
+  .argument('<groupId>', '分组 ID')
+  .action(async (groupId) => {
+    try {
+      const client = createHikvisionClient(config.get());
+      
+      await client.vehicleService.deleteGroup(groupId);
+      success('分组已删除');
+    } catch (err: any) {
+      error(`删除分组失败: ${err.message || err}`);
+    }
+  });