乡村管理系统 DOCS
文档 系统设置

系统设置

左侧菜单「系统设置」只有 admin 能进,村庄名称、登录方式、登录背景、主机行为这些全局选项都在这一页配置,改完立即在整个局域网生效。

仅管理员可见

非 admin 账号看不到「系统设置」菜单项,直接访问也会被拒绝。

1. 登录方式

这是最重要的一项开关,决定系统是"单机免登录"还是"多人账号密码登录"。

状态行为适合场景
关闭(默认)单机/无登录模式。开机直接进入系统,所有操作以 superadmin 身份执行。一人一机使用的村委会场景,省去每天输密码的麻烦。
开启标准账号密码登录,沿用角色权限 + JWT。局域网多人 / 多角色(村干部、文书、网格员)共用一台服务器的场景。

开启后会立刻生效:当前已登录的旧会话仍能用到 token 自然过期,新会话要登录才能进。

忘记密码逃生口

启用后若所有 admin 账号都忘记密码,需在数据目录顶层新建空文件 RESET-ADMIN-PASSWORD,重启应用触发逃生口(详见登录页的「忘记密码?」指引)。

切换这个开关时会弹确认框,内容分别是:

  • 开启账号密码登录:开启后:① 新会话需账号密码登录才能进入系统;② 监听地址会切到 0.0.0.0 让局域网 PC 能连;③ 本机当前登录态会被清掉、跳到登录页。监听地址切换需重启应用才能完整生效。
  • 关闭账号密码登录:关闭后:① 任何打开本应用的人都自动以管理员身份进入;② 监听地址会切回 127.0.0.1 只让本机访问;③ 当前登录态会被清掉。监听地址切换需重启应用才能完整生效,请确保电脑本身处于安全管理。

确认后保存立即生效,但页面会再问一次是否立即重启应用——因为"监听地址"(127.0.0.1 还是 0.0.0.0)只在程序启动时决定,不重启只是登录方式变了,局域网访问能力要等重启才完整生效。开启时如果选择立即重启,系统还会弹一次 Windows UAC 授权自动放行防火墙 8848 端口;拒绝授权也不影响正常使用,只是需要自己去 Windows 防火墙手动放行。

默认账号密码是 admin / admin123,登录后建议在「用户管理」里改掉。

2. 村庄标识

村庄名称

设置后登录页、左侧标题和窗口标题都会显示村名,方便辨识本村系统。对局域网所有电脑生效。最多 20 个字。

登录页背景图片

上传一张本村的照片作为登录页背景,支持 jpg / png / webp,不超过 8MB。不设置时使用默认红色背景。设置后退出登录、或在局域网其他电脑打开本系统,登录页即可看到效果。

  • 未设置背景时按钮显示「选择图片」,已设置后显示「更换图片」,旁边会出现「移除」按钮。
  • 移除后会弹确认「移除后登录页恢复默认红色背景,确定吗?」。

3. 使用教程

这张卡片内嵌了系统全部功能的简明上手指南(建模块、录数据、看图表、备份、权限、更新…),点右上角「展开教程」按需翻阅,收起后变回「收起」按钮。

4. 主机设置

这一组设置只对装有本系统的这台主电脑生效,修改后立即生效,无需重启。

关闭窗口时最小化到托盘

点右上角 ✕ 不退出系统,缩到屏幕右下角托盘继续后台运行——其他电脑和手机扫码仍可正常访问。点托盘图标可回到主界面;要真正退出请在托盘图标上点右键选「退出系统」。

开机自动启动

电脑开机后自动运行本系统,村干部不用记得手动打开。建议主电脑开启。开关会实际写入 Windows 注册表的开机启动项。

行政区划接口(住址逐级选择)

「住址」类型字段的省/市/县/镇/村逐级选择由 cn.apihz.cn 免费接口提供,需要主电脑联网。默认用公共账号(所有人共享每分钟次数,偶尔会提示繁忙);到 apihz.cn 免费注册后把自己的 ID 和 KEY 填在这里,可独享次数。已查过的地区会缓存,不重复请求。

5. 家庭成员表关联

给监测户 / 低保户 / 脱贫户 / 残疾人 等模块的详情页加一个「家庭成员」区块——按身份证号找到本人在家庭表里那条记录,再按户号拉出全家。三项都填好才会启用,留空任一项即可关闭。

设置项说明
家庭成员表(按户存的那张模块)通常是"居住家庭成员情况"这类——每人一条、按户号归类。请先在「模块管理」里建好这个模块。
身份证号字段家庭表里"身份证号"字段——其他模块的人据此找到家庭表里的本人。下拉只列家庭表里的"身份证"类字段。
户号字段家庭表里标识"哪一户"的字段(如"户号")。系统会用本人这一条的户号查全家。
切换家庭模块会清空已选字段

换掉「家庭成员表」下拉后,「身份证号字段」和「户号字段」会自动清空,需要重新选一遍,避免错配到别的模块的字段上。

6. 这一页不管的设置

以下常被误以为在「系统设置」里,实际在别的页面:

  • 更改数据存储位置:在备份恢复页顶部,显示当前数据存储位置并可迁移到新位置。
  • 用户账号 / 角色权限:在用户与权限页管理。
  • 耕地地图的天地图 Key:写在系统设置的数据结构里(供耕地地图功能使用),但当前系统设置页面上没有暴露对应的填写入口。