寓言故事
城门不是城堡,却决定谁能进到工坊
山城里有几座精密工坊,能刻印、炼药、修钟。早年熟人直接推门进去,报上名字,师傅就接活。
工坊出名后,外地商队、城内店铺和临时雇工都来请求加工。师傅还没开工,门口已经挤满问题:谁有权限、交给哪位师傅、用哪个版本工艺。
城主先在每间工坊门上贴说明。说明写得很清楚,客人仍走错门,旧客户还会误用已经废弃的工艺。一次急件被送到旧工坊,按旧法做坏了。复盘时大家发现,工坊本身没坏,坏在入口没有统一管理请求、身份、版本和限流。
于是城主建了总城门。所有请求先到城门,验令牌、看额度、选工坊、标版本,再把活交给正确师傅。
城门还记录每次进出。哪家商队请求最多,哪种工艺失败率高,哪个版本刚发布就出错,都能追溯。新工坊上线时,不再要求客户改一堆路线。城门可以先让少量请求试用,稳定后再逐步放量。
后来城里有了多个机器和多个供应商,城门仍是应用调用的固定入口。工坊可以换,入口契约不能随便摇晃。城主于是修了一座总门亭。来客不再直闯工坊,而是在门亭报明身份、用途、急缓和想要的工艺,门亭再把活递给合适师傅。
门亭还做三件事:挡住没有凭证的人,记录每次进出,遇到旧工艺就提醒换路。师傅终于能专心做活,不必在门口吵半天。这次小事故让众人停下来复盘。他们没有急着换一套更响亮的说法,而是把出错的入口、被误解的规则和需要保留的边界逐一写清。
有商队嫌多一道门麻烦。可一次错工艺差点毁掉整批药后,大家才承认:门亭本身不造东西,却决定请求能否被稳稳送到里面。城主明白,机器服务需要一个清晰端点。它不等于机器本身,却承担了让应用可靠调用机器的边界责任。