# 济南汇银社保公积金汇总软件服务器正式版

本软件支持按账套导入和统计社保医保、公积金、雇主险和离职人员数据，并保留操作记录。

## 启动

```bash
npm start
```

默认端口是 `3017`，可用环境变量修改：

```bash
PORT=3017 npm start
```

## 初始管理员

第一次启动时会自动创建管理员账号。默认登录名是 `姚卜昱`，也可以在启动前用 `DEFAULT_ADMIN_USERNAME` 修改。

如果启动前设置了 `ADMIN_PASSWORD`，管理员密码就是该环境变量：

```bash
DEFAULT_ADMIN_USERNAME='姚卜昱' ADMIN_PASSWORD='请换成强密码' npm start
```

如果未设置，系统会生成随机密码，并写入：

```text
data/.first-admin-password.txt
```

## 添加员工账号

```bash
npm run create-user -- zhangsan '强密码' '张三' staff
```

也可以由管理员登录网页后，在“操作员管理”里添加或删除操作员。

权限类型：

- `admin`：管理员，可以添加和删除操作员
- `staff`：操作员，可以做日常导入、维护和导出
- `readonly`：只读人员，只能查看和导出，不能导入、维护、删除或清空数据

## 数据导入与导出

网页内可分别下载社保医保、公积金、雇主险、离职人员导入模板。雇主险支持导入姓名、身份证号、工种、人身伤亡、附加医疗费用、劳动合同单位、实际用工单位、类别、年龄、保险公司名称、购买渠道、购买价格、到期日等字段。

月度汇总会单独显示雇主险人数和购买价格；总缴费金额仍按社保、医保、公积金三项合计。雇主险明细可单独导出，也会随月度汇总一起导出。

## 重置密码

```bash
npm run reset-password -- zhangsan '新强密码'
```

## 查看用户

```bash
npm run list-users
```

## 数据文件

- 人员台账：`data/ledger-账套ID.json`
- 操作记录：`data/audit.jsonl`
- 账号文件：`data/users.json`

请定期备份整个 `data` 文件夹。