模块管理

模块就是一张台账。村民花名册、党员名册、低保户清单——每一份都是一个模块。本页讲清楚怎么新建、改结构、排序、启停、删除模块,以及菜单分组、模块关联这些工具栏入口。

1. 入口在哪儿

模块管理只有 admin 账号能看到。普通用户的侧边栏不会出现这一项。

1. 用 admin 登录默认账号 admin / admin123,首次登录系统会强制改密。
2. 看左侧菜单找到"模块管理",点进去。
3. 进入模块列表页面上方是一排工具栏按钮,下面是已有模块的表格(图标/名称/所属分组/数据量/状态/操作)。

2. 工具栏的 5 个入口

模块列表页顶部一排按钮,从左到右:

3. 新建模块

点工具栏"新建模块",弹窗里要填:

新建时没有"说明/备注"这一项,也没有字段——填完点"保存",新模块立刻出现在侧边栏,但还是空壳,需要去"字段管理"里加字段(见第 5 节)。

编辑一个已建好的非内置模块时,弹窗里还会多出"分组字段""走访记录""默认排序"三项,以及资金计算规则区块:

• 分组字段:选模块里的某个字段(比如"户号")作为分组依据,数据页就能按这个字段分组查看、统计组数;不选就是不分组。派生字段不能选(按算出来的年龄/党龄分组没意义)。
• 走访记录:开关,打开后该模块每条记录详情页底部会出现"走访记录"区块,可登记入户走访、上传照片;关闭只是隐藏,已有记录不会删。
• 默认排序:两个选项——"新 → 旧"(按创建时间倒序,默认)或"旧 → 新"(适合 Excel 批量导入、想按导入顺序看的模块)。分组模式下按分组字段优先排,这里不影响分组内排序。
• 资金计算规则:配置该模块要不要参与"资金汇总"统计,详见资金汇总。

4. 调整模块顺序

模块在侧边栏里的排列顺序,决定了村干部最先看到的是哪个。常用的放上面,不常用的沉底。

1. 进入模块管理列表每行"操作"列里有"上移""下移"两个按钮。
2. 点"上移"或"下移"该模块和相邻一个模块交换位置。
3. 立即生效不用另外点保存,点完就生效,刷新页面也不会变回去。

例子:派出所每月查村民花名册,那就把"村民花名册"往上移到最顶;"宅基地登记"半年用一次,往下移到最后。

5. 字段管理:添加、删除、重命名、调顺序

在模块所在行点"字段管理"(内置模块这个按钮是灰的、点不了),进入字段管理抽屉。这里能干四件事:

新增字段

抽屉顶部有"新增字段"按钮,点开弹窗填字段名、选类型(共 11 种,详见字段类型详解)、按需设置各种属性,保存就加上了。

删除字段

字段行"操作"列有"删除"按钮,点了会弹窗二次确认;如果有派生字段(比如"年龄")依赖这个字段(比如"身份证号"),弹窗会额外警告,一并删掉依赖它的派生字段。

重命名 / 改属性

点字段行的"编辑"按钮,在弹窗里改字段名或其他属性,没有双击直接改这种快捷方式。改字段名不影响已录数据,字段在数据库里的实际存储键是系统自动生成的、不随显示名变。

调换顺序

每个字段行也有"上移""下移"按钮。字段顺序决定列表页和详情页里列的左右排列,把最重要的(比如"姓名"、"身份证号")放最前。

6. 修改字段类型的限制

字段还没有任何数据时,类型可以随便改。一旦有记录填过这个字段,规则就变严格:

如果目标类型不满足条件,系统会直接拒绝保存并提示"该字段已有数据,仅支持:改为文本/住址、单选↔多选、或从文本转为数字/日期/身份证/电话/单选"。另外,如果有派生字段绑定了这个字段做源字段,改类型也会被拦住,提示要先去删掉那个派生字段。

遇到不兼容的改动,正确做法:新建一个目标类型的字段 → 用批量编辑或导入把数据搬过去 → 确认无误后删掉旧字段。

7. 模块图标库 / 菜单分组

图标分两类,在新建/编辑模块的弹窗里能看到:

• 预置图标系统自带一批常用图标网格,点一下选中即可。
• 自定义上传点图标网格里的上传格,支持 PNG / JPG / SVG,大小限制 256KB 以内。位图会自动缩放居中裁成 64×64 的 PNG;SVG 保留原始矢量图。

菜单分组是把相关模块归到同一个一级菜单下的容器,比如"民政对象"下挂脱贫户、低保户、监测户。点工具栏"菜单分组"打开管理弹窗:

1. 新增分组填分组名(最多 20 字符)、选父分组(可选,不选就是顶级分组)、选图标。
2. 多级嵌套父分组可以再选其他分组,下拉里显示完整路径,比如"民政 / 低保"。
3. 模块归属分组回到模块的新建/编辑弹窗,在"所属菜单分组"里选刚建好的分组。
4. 分组排序分组列表里同样是"上移""下移"按钮调顺序。

删除分组不会删除挂在它下面的模块,那些模块会自动回到一级菜单平铺。

8. 内置模块

系统自带的模块(比如"党费缴纳")在列表里带"内置"标签,和普通模块的区别:

• 没有独立的字段管理入口,"字段管理"按钮是灰的——它走的是自己专属的固定页面,不是动态字段模块
• 不能删除,"删除"按钮是灰的
• 能改图标、所属菜单分组、启停状态,不能改分组字段/走访记录/默认排序这些(这些选项只对非内置模块显示)

党费缴纳这个内置模块依赖"党员档案"模块的几个字段(比如身份证号、入党日期),它的操作列不是"字段管理"而是"绑定字段 →",点了跳到党费规则页去绑定具体字段,详见党费缴纳。

9. 启用 / 停用模块

不想删但暂时不用的模块(比如"换届选举登记",选完就用不上了,但数据还想留着),用"停用",不要删除。

1. 找到模块所在行点"操作"列的"停用"。
2. 弹窗确认提示"停用「X」后菜单中将不可见(数据保留),确定吗?",确认后侧边栏立刻不再显示这个模块,但结构和数据都完整保留。
3. 想恢复时回到模块管理,该行状态显示"已停用",点"启用"即可,不需要二次确认。

内置模块也能停用/启用,和普通模块一样。

10. 删除模块

删除是真删、彻底删——模块结构、字段、全部记录(包括之前已经删除进回收站的记录)一起从数据库清除,不会进"全局回收站"、无法恢复。内置模块不可删除。

1. 点模块所在行"操作"列的"删除"。
2. 模块里还有数据时:弹窗会写明"该模块还有 N 条数据!删除后模块和全部数据将彻底清除,无法恢复",并要求你在输入框里敲入模块的完整名称才能确认,防止手滑删错。
3. 模块是空的(没有记录)时:弹窗只需要点一次"确定删除"确认,不需要输入名称。