在现代企业软件开发中，模块化架构已成为提升代码可维护性、增强团队协作效率和加速产品迭代的关键方法。作为领先的薪酬、福利和人力资源解决方案提供商，Gusto不断优化其内部软件结构，致力于通过模块化工具打造更加清晰、高效且可扩展的代码体系。2024年，Gusto积极推进其模块化工具链的革新，体现出在大型代码库管理和模块边界设计上的深刻理解与技术积淀。Gusto的软件工程团队自2020年开始采用与Shopify共同开发的Packwerk工具，作为拆分、组织和监控代码包依赖的主要手段。Packwerk的引入帮助Gusto快速形成了初始的模块化基础，短短半年将近两百个大型代码包整合入系统。然而，初始阶段的“采用期”也暴露出许多模块界限不清、违规使用频繁的问题，促使工程团队进入“扩张期”，推出更多代码包以视觉上划分领域，总数超过四百个。
尽管包的数量提升意味着更细粒度的模块划分，但同时也带来了过度复杂、模块泛滥导致整体可理解性下降的挑战。面对这一矛盾，Gusto进入了“精炼期”，重新聚焦于模块的合理聚合和边界定义，核心问题聚焦在如何由四百多个包回归到约二十个更切合业务产品和客户视角的应用级别产品服务。经过深入分析，团队得出结论：虽然无法简单合并已细分的包，但可以通过结构上的优化和层次划分来提升模块化的实用性与清晰度。为此，Gusto引入了“层（Layers）”与“产品服务（Product Services）”的概念。将代码库核心分为几个层次，包括应用外壳（Rails应用根），开发工具，Rails基础类，通用工具库等。产品服务作为中间层，承载了绝大部分业务逻辑和代码，将包进行嵌套管理，显著改善了领域聚焦和代码可视化。
层与层之间保持严格的依赖方向性，即下层不依赖上层，保障了系统的稳定性与模块独立性。此设计使得在实际开发中，团队可以在业务服务内部按照需要自由创建子包，同时通过层级保护避免跨层依赖混淆。随着模块结构逐渐清晰，Gusto面临的下一个关键挑战是API的界定与权限管理。作为将模块化推向深入的关键因素，API边界决定了模块之间的耦合程度和独立演进能力。Gusto团队结合前期经验和业界优秀实践，将产品服务看作“应用”，采用与传统应用类似的较严格API约束，但对产品服务内部的包（视作“库”）则采取更宽松的规则。鉴于Rails和ActiveRecord在系统中的大量使用，团队警惕硬性禁止在模块边界使用ActiveRecord对象的做法，因为这在包内部造成了过度设计和性能损耗。
相反，Gusto允许同一产品服务内部包之间充分利用ActiveRecord的强大功能，提升执行效率和开发灵活度，同时通过引入“_api”特殊包明确区分外部接口，严格限制跨产品服务的依赖和访问。为实现上述策略，Gusto对Packwerk做了扩展，开发了folder visibility插件，支持对包的访问权限进行细粒度控制。该机制不仅令团队可以针对产品服务内外分别施行不同隐私策略，还通过配置忽略模式减少无关违规提示，提高了反馈的有效性和可操作性。2024年，Gusto已逐步放弃传统Packwerk，完全采用pks——由团队前成员Alex Evanzcuk实现的高性能Rust版本。pks不仅保留了Packwerk的核心功能，还通过直接分析所有Ruby文件的常量定义，突破了Zeitwerk加载机制的限制，提供更全面且实时的代码结构反馈，极大提升工具的性能和准确性。Gusto的模块化实践不仅在技术层面实现了多次突破，也为其业务架构带来了质的飞跃。
借助清晰划分的产品服务与层次结构，再结合严格而灵活的API管理，团队能够更好地聚焦产品核心价值，推动新功能的快速开发与集成，显著提高软件的整体质量和客户响应速度。未来，Gusto计划持续优化模块化工具链功能，扩大API设计规范的推广范围，探索基于模块边界的自动集成与部署方案，进一步提升开发者体验与系统稳定性。通过加入Ruby和Rails模块化的社区交流，Gusto工程师积极贡献知识与实践经验，也吸引了更多志同道合的人才加入，共同推动模块化技术在企业级软件开发中的应用和演进。综上所述，Gusto在2024年的模块化工具改进体现了现代大型Rails应用在复杂业务环境下的架构思考与实践探索。从大量包的粗放管理到聚焦业务驱动的产品服务分层，从单一约束的API边界走向细粒度的权限控制与性能优化，Gusto的经验为Ruby开发者和架构师提供了宝贵借鉴。未来，随着pks等工具的持续演进和社区生态的壮大，模块化将成为推动软件敏捷创新和可持续发展的重要基础。
理解和应用Gusto的模块化策略，有助于企业打造灵活、高效且富有韧性的现代软件系统。
