Skip to content
kc@kumarChandrachooda.com:~$ cd /blog/series/trill-reading-the-services && read --section="top" 0%
Series

Trill — Reading the Services

In reading order.

  • 15 parts
  • ≈ 101 min total
  • 15 published
Part 1 19 Dec 2025 7 min read

Two Services, Two Architectures

Trill's Stories service is four projects with a dependency-free domain at the bottom. Its Users service is two projects with everything in one assembly - same author, same week, same estate, opposite answers to what a layer is.

Part 2 20 Dec 2025 6 min read

The Factory That Doesn't Own Construction

Trill extracts story-text validation into an IStoryTextFactory and leaves the value object's constructor public - plus an implicit conversion from string, so any assignment builds an unvalidated StoryText in one keystroke.

Part 3 20 Dec 2025 6 min read

Title and Text, Swapped Since Commit One

StoryDocument.ToEntity passes the body where the title goes and the title where the body goes. It compiles because of one implicit conversion operator, and it has survived since the first commit because the only code path that would notice is dead.

Part 4 21 Dec 2025 7 min read

The Refactor That Stopped Halfway

Trill's last commit built a complete domain-event pipeline - dispatcher, mapper, handlers - and migrated one of the two command handlers onto it. The other still constructs its aggregate directly, so one domain event is never raised and a reputation gate can never fire.

Part 5 22 Dec 2025 6 min read

Six Decorators and One Marker Attribute

Trill wraps every command handler in logging, metrics, tracing and an outbox using Scrutor's TryDecorate - and the whole arrangement only works because a single attribute keeps the decorators out of the assembly scan that registers handlers.

Part 6 22 Dec 2025 6 min read

An Index With Its Keys Backwards

Trill creates one compound index on its ratings collection, keyed userId then storyId, and every read query in the service filters on storyId alone - so the only index that exists cannot serve the only queries that run.

Part 7 23 Dec 2025 8 min read

A Million Documents for One Integer

Trill's browse endpoint loads every rating document for every story on the page into process memory and sums them in LINQ - while the same codebase already has a server-side SumAsync that returns the number without moving a single document.

Part 8 24 Dec 2025 6 min read

Sign-In Is Impossible If You Capitalise

Trill's User constructor stores the name trimmed but not lower-cased, and the repository looks it up lower-cased. Any account with a capital letter in its name can never be found, which means it can never sign in - and the test fixture is all lowercase.

Part 9 24 Dec 2025 7 min read

The Identity Abstraction Nobody Injected

Trill's Stories service ships a complete caller-identity abstraction - context, factory, claims, an IsAdmin flag - registers it in the container, and injects it into nothing, while every endpoint reads the user id out of the request body instead.

Part 10 25 Dec 2025 6 min read

One Format String, Two Meanings

The same .NET format specifier means thirty-two hex digits on a Guid and a grouped decimal on a long - and Trill's timeline writes its sorted-set members one way then reads them the other, so every non-empty timeline throws.

Part 11 26 Dec 2025 7 min read

Fan-Out on Write, One Round Trip at a Time

Trill's Timeline service stores each story body once and fans out only the identifier into every follower's sorted set - the right hybrid design, executed as a sequential foreach with one Redis round trip per follower and no batching anywhere.

Part 12 26 Dec 2025 7 min read

Trending Means All-Time and Frozen

Trill's entire ranking engine is thirty-nine lines of OrderByDescending().Take(10) over counters that only ever increase - no time window, no decay, no visibility filter - so once the top ten stabilises it can never change again.

Part 13 27 Dec 2025 7 min read

An Ad Is a Story With a Flag

Trill's entire advertising product resolves to one boolean on somebody else's entity - a published ad is a Stories-service story with Highlighted set true - and the flag is priced at a hundred units a day while the same field is free on the public endpoint.

Part 14 28 Dec 2025 7 min read

Seven Lines of CSS for Twenty Components

Trill's Blazor WebAssembly client has twenty Razor components, thirty-seven inline style attributes, two authored class names and one stylesheet containing a single rule - and the thinness is not an oversight, it is the most precise measurement of what a teaching repository is.

Part 15 28 Dec 2025 8 min read

Seven Test Projects, Zero Tests

An honest retrospective on Trill's five services and its client - twelve xunit scaffolds with no test files and no project references, a green test script over nothing, and a defect list where almost every entry would have died to a four-line assertion.