目的
这个站用来回答同事停下后会拿来问的事,并让以后的助手按项目读取。
沃土说明文档放的是各业务系统里,同事做不下去时会拿来问人的那些事。一页只写一件事,标题用她的问法。每一页有固定地址,可以搜索,也可以把这一页的链接发回去。
先要挡住的是哪种询问
礼渠结算先遇到这件事。导入写完之后,同事直接打开对账任务,看这批有没有分到对应的公司,行对不对。月结和半月结里已经能入账的,导入完成就能在对账任务里看到订单、商品、数量、单价和金额。对账日之前只能看明细,不能确认。
每周、每 N 天、按项目、按批次,没有业务日,或者待发货、待收货还没有签收、也没有记下线下已取走,仍然不出对账任务。原因留在导入结果上。这些情况她会来找人确认。
页面上用文字解释原因时,她不看。引导层盖住操作,或者把还不能做的按钮拿掉,都不采用。业务系统里的操作保持原样。
为什么做成文档站
使用手册按章节排列。要找的那一句埋在某一节里,改一条规则就要重做整本,也发不出单独的一页。文档站把这一句做成一页,规则改了只改这一页。
文档站负责把答案放在能打开的地址上。她第一次对着空列表,仍可能直接来问。要少被问第二次,链接得出现在她已经停住的那一屏:导入结果上的这一行,或对账任务里还不能确认的那一行。点开就是对应的那一页,页里写她下一步点哪里。
一个站,多个项目
桌面上有十几套系统。助手、快速跳转和新人练习都是站的外壳,只做一次。同事要查的仍是手里这一套。从礼渠结算点进来,就落在礼渠结算,不先看到财务、商城或竞价的目录。顶部的项目名是给同时维护多套系统的人切换用的。
换一个项目,左边的目录和搜索一起换。以后的助手和练习也按这个范围切,避免把礼渠的账答成别的系统的付款或订单。
站点本身
页面要好看,也要能长期改,所以用 Fumadocs。它单独跑一个 Node 进程,文章是 Markdown。不接结算或其他业务系统的数据库。