architecture – Page 15 – Türker Yıldırım

The method that stopped overriding anything in 2019

Deep diveDecember 5, 202310 min read

#[Override] in 8.3, and what it asserts. A subclass method dead since a parent rename four years ago, with a bug report closed as not reproducible.

An error shape agreed once, and used everywhere

NoteNovember 23, 20232 min read

Four error formats across one API, because each was invented by whoever wrote that controller. RFC 7807 is a small specification and the value is not its contents…

The interface with one implementation, and when that is fine

Deep diveNovember 16, 202310 min read

140 interfaces, 128 of them with exactly one implementation, and a jump-to-definition that always lands on the wrong file.

A Node script in a PHP repository, and where it lives

NoteNovember 9, 20232 min read

A build script written in JavaScript because it processes the asset manifest, in a repository where everything else is PHP. The Makefile is the interface and the language…

The unique index we could not add, and the duplicates we had to find first

Deep diveNovember 7, 202310 min read

A constraint that should have existed since 2016, and 1,240 rows that violate it. Support merging customer records by hand, monthly.

The decision record that stopped an argument happening twice

NoteOctober 24, 20232 min read

The same discussion about queue technology, for the third time in two years, with two of the three people having been present for the first. The consequences section…

Mutation testing for one directory, and what it found

Deep diveOctober 24, 202310 min read

94% line coverage on the pricing code, and a bug that shipped anyway. A test that called the method and asserted it did not throw.

A licence change, and reading it before reacting

NoteOctober 18, 20232 min read

A tool we use changed to a source-available licence, and the first useful step was working out whether it applies to us at all. The reflex is to…

The alert that fired for two years and meant nothing

Deep diveOctober 18, 202310 min read

Thirty-one alert rules, a channel muted by everybody, and 412 alerts in a month of which four corresponded to a real problem.

An event between modules, and the coupling it did not remove

NoteOctober 9, 20232 min read

Replacing a direct call with an event felt like decoupling, and the two modules were still deployed together, released together, and broken together. An event removes a compile-time…