hello @ atellius.com
Case 004 — Directory portal
All workSmyleee is a Yelp-grade dentist directory with city-by-city Top-10 pages, AI-generated clinic prose, and a 0–100 Smyleee Rating slab. Rankings are pre-computed in background jobs; user requests serve from cache.
Architecture · 6 layers · request flows left to right
- Next.js
- Cloudflare
- FastAPI
- PostgreSQL
- Docker
- Google Places
/ 01Outcomes
36+
Top-10 pages
NYC cosmetic dentists = benchmark
35,000
Free API quota
Google Places, India SKU/month
0–100
Smyleee Rating
Outstanding / Excellent / Very Good / Good / Rated
Background
Ranking refresh
cron jobs, never on user request
/ 02The brief
Healthcare directories live or die on freshness vs. performance. Smyleee solves it by precomputing all rankings server-side on a schedule, with deterministic widget-verification policy and per-clinic prose constrained to 320+ words.
/ 03Architecture
Pre-computed everything
No ranking math on user request. Crons rebuild Top-10 ordering, generate clinic prose, and refresh hero imagery — exactly like Yelp and Zocdoc.
Constrained AI content
All auto-generated prose passes a 320-word floor and a rule against citing Google rating / review counts inline (the header already shows them).
Deployment
Frontend Next.js auto-deploys to Cloudflare on push; backend FastAPI patches go over SSH with surgical Python edits — no rebuild penalty.
/ 04Build highlights
01
Hero image discipline
AI-generated hero prompts enforce that patients are camera-facing — no awkward camera-away shots.
02
Smyleee Rating canonical
All UI interpretation of the 0–100 slab routes through one shared module — no inline string comparisons.
03
30-day widget verification
Clinics get announce-only enforcement window with day-28 reminder; harder cutoffs deferred behind a flag.
/ 05What it became
Operates as a directory at directory scale — fresh, fast, and consistent across hundreds of clinic pages.