Engineering & Architecture Brief Published: 2026-11-15
The 3D map of the portfolio renders from a versioned catalogue manifest built at deploy time. The WebGL ocean is a layer over a plain HTML index that works without it. We rejected a live API that would read the portfolio database on every visit, and this record states that option on its merits, explains why it failed the fault analysis and names the condition that would reverse the call.
The option we turned down The rejected design served the catalogue from a live API that read the portfolio database on every visit and returned exactly the domains currently for sale, with current prices and cluster tags. Its case is strong. There is one source of truth, a closed sale vanishes from the map the moment the record changes, and nobody maintains a build pipeline that can drift from the database. For a portfolio whose whole business is the offer, showing a sold name as available in the middle of a negotiation is a real error, not a cosmetic one, and the live API removes that class of error entirely.
Everything in series The cost is that the database, the API process and the renderer sit in series. The map is only up when all three are up, and their availabilities multiply rather than average. The 3D scene makes this worse, because it needs the whole catalogue to lay out the clusters in depth, and a partial or slow response yields an empty abyss rather than a degraded one. The failure that settled it was more mundane than an outage: WebGL context loss on low-end mobile GPUs, which leaves a black canvas with no navigation. In the live design the data existed only in JavaScript memory behind that canvas, so a lost context meant a page with nothing on it at all.
What stays up when a part fails The chosen design builds a versioned JSON manifest at deploy time, renders from it a plain HTML index of every domain grouped by cluster, then mounts the WebGL scene on top as an enhancement. On webglcontextlost, or when WebGL is unavailable, the canvas is torn down and the list is revealed with the same anchors, so deep links keep working. Web accessibility guidelines such as WCAG already demand a text equivalent of the map, so the fallback costs almost nothing extra, and real users exercise it every day instead of leaving it to rot untested. The manifest is cached at the edge for 600 s with stale-while-revalidate, so an origin outage serves the last good snapshot instead of an error. The inquiry form posts to a queue that tolerates the backend being down and rechecks status when processed, and that is how we pay for the remaining weakness: a sold domain can stay visible for one cache lifetime, and it gets corrected in the reply to the buyer, not on the map.
The condition that reverses this Go back to the live API the day status changes arrive faster than one rebuild plus the 600 s cache lifetime, which by our estimate means moving from a few changes per week to timed auctions or live bidding, because at that point a stale snapshot stops being a lag and becomes a wrong offer.
Technical FAQ: Why not keep the static layout and add a live status call per domain? That hybrid is the migration path if the reversal condition gets close, but it is not free. The status call is a new runtime dependency, and the page still has to render correctly when that call fails, which puts you back on the static design with a badge on top. Until status changes outpace the rebuild, it adds a failure point without changing what the buyer sees.
Artigo Técnico e Arquitetura de Referência Publicado em: 2026-11-15
O mapa 3D do portfólio é renderizado a partir de um manifesto versionado do catálogo, gerado no deploy. O oceano em WebGL é uma camada sobre um índice HTML simples que funciona sem ele. Rejeitamos uma API ao vivo que consultaria o banco do portfólio a cada visita, e este registro apresenta essa opção pelos seus méritos, mostra onde ela não passou na análise de falhas e diz qual condição inverteria a decisão.
A opção que recusamos O desenho rejeitado servia o catálogo por uma API ao vivo, que lia o banco a cada acesso e devolvia exatamente os domínios à venda naquele momento, com preço e cluster atualizados. O argumento a favor é forte. Há uma única fonte de verdade, uma venda fechada some do mapa no instante em que o registro muda, e ninguém precisa manter um pipeline de build que pode divergir do banco. Num portfólio cujo negócio inteiro é a oferta, exibir como disponível um nome já vendido no meio de uma negociação é erro de verdade, não detalhe visual, e a API ao vivo elimina essa classe de erro.
Tudo em série O preço é que banco, processo da API e renderizador ficam em série. O mapa só está no ar quando os três estão, e as disponibilidades se multiplicam em vez de se compensarem. A cena 3D agrava isso, porque precisa do catálogo inteiro para distribuir os clusters em profundidade, e uma resposta parcial ou lenta produz um abismo vazio, não um abismo degradado. A falha que decidiu a questão foi mais banal que uma queda de servidor: perda de contexto WebGL em GPUs móveis modestas, que deixa um canvas preto sem navegação. No desenho ao vivo os dados existiam só na memória do JavaScript atrás desse canvas, então contexto perdido significava página sem nada.
O que continua de pé quando uma parte cai O desenho escolhido gera no deploy um manifesto JSON versionado e, a partir dele, um índice HTML com todos os domínios agrupados por cluster; a cena WebGL é montada por cima, como melhoria. Em webglcontextlost, ou quando não há WebGL, o canvas é desmontado e a lista aparece com as mesmas âncoras, então os links diretos continuam valendo. Diretrizes de acessibilidade web como a WCAG já exigem um equivalente textual do mapa, de modo que o fallback quase não custa nada a mais e é usado por gente de verdade todo dia, em vez de apodrecer sem teste. O manifesto fica em cache na borda por 600 s com stale-while-revalidate, e uma queda da origem entrega o último snapshot bom em vez de erro. O formulário de contato grava numa fila que tolera o backend fora do ar e reconfere o status ao processar, e é assim que pagamos a fraqueza que sobra: um domínio vendido pode continuar visível por um ciclo de cache, e quem corrige isso é a resposta ao comprador, não o mapa.
A condição que inverte a decisão Voltamos à API ao vivo no dia em que as mudanças de status chegarem mais rápido do que um rebuild somado aos 600 s de cache, o que, pela nossa estimativa, significa sair de algumas mudanças por semana para leilões com prazo ou lances ao vivo, porque aí um snapshot defasado deixa de ser atraso e vira oferta errada.
FAQ Técnica: Por que não manter o layout estático e acrescentar uma consulta de status ao vivo por domínio? Esse híbrido é o caminho de migração se a condição de reversão se aproximar, mas não sai de graça. A consulta de status é uma nova dependência em tempo de execução, e a página ainda precisa renderizar certo quando ela falha, o que nos devolve ao desenho estático com um selo por cima. Enquanto as mudanças de status não superarem o ritmo do rebuild, o híbrido acrescenta um ponto de falha sem mudar o que o comprador vê.
Artículo Técnico y Arquitectura de Referencia Publicado: 2026-11-15
El mapa 3D del portafolio se renderiza a partir de un manifiesto versionado del catálogo que se genera en el despliegue. El océano en WebGL es una capa sobre un índice HTML plano que funciona sin él. Descartamos una API en vivo que consultara la base de datos del portafolio en cada visita, y este registro expone esa opción con sus méritos, explica dónde no superó el análisis de fallos y fija la condición que invertiría la decisión.
La opción que descartamos El diseño rechazado servía el catálogo desde una API en vivo que leía la base de datos en cada visita y devolvía exactamente los dominios en venta en ese momento, con precio y clúster al día. Tiene argumentos sólidos. Hay una única fuente de verdad, una venta cerrada desaparece del mapa en cuanto cambia el registro y nadie mantiene un pipeline de compilación que pueda desincronizarse de la base. En un portafolio cuyo negocio entero es la oferta, mostrar como disponible un nombre ya vendido en plena negociación es un error real, no cosmético, y la API en vivo elimina esa clase de error de raíz.
Todo en serie El coste es que la base de datos, el proceso de la API y el renderizador quedan en serie. El mapa solo funciona cuando funcionan los tres, y sus disponibilidades se multiplican en lugar de promediarse. La escena 3D lo empeora, porque necesita el catálogo completo para distribuir los clústeres en profundidad, y una respuesta parcial o lenta deja un abismo vacío, no uno degradado. El fallo que lo zanjó fue más prosaico que una caída: la pérdida de contexto WebGL en GPU móviles modestas, que deja un canvas negro sin navegación. En el diseño en vivo los datos solo existían en la memoria de JavaScript detrás de ese canvas, así que perder el contexto suponía una página sin absolutamente nada.
Lo que sigue en pie cuando falla una pieza El diseño elegido genera en el despliegue un manifiesto JSON versionado y, a partir de él, un índice HTML con todos los dominios agrupados por clúster, sobre el que se monta la escena WebGL como mejora. Ante webglcontextlost, o si no hay WebGL, el canvas se desmonta y aparece la lista con los mismos anclajes, de modo que los enlaces directos siguen funcionando. Las pautas de accesibilidad web como WCAG ya exigen un equivalente textual del mapa, así que el respaldo apenas añade coste y lo recorren usuarios reales a diario en vez de pudrirse sin probar. El manifiesto se guarda en caché en el borde durante 600 s con stale-while-revalidate, y una caída del origen sirve la última instantánea buena en lugar de un error. El formulario de contacto escribe en una cola que tolera la caída del backend y vuelve a comprobar el estado al procesarse, y así pagamos la debilidad que queda: un dominio vendido puede seguir visible durante un ciclo de caché, y lo corrige la respuesta al comprador, no el mapa.
La condición que invierte la decisión Volveremos a la API en vivo el día en que los cambios de estado lleguen más rápido que una recompilación sumada a los 600 s de caché, lo que según nuestra estimación significa pasar de unos pocos cambios por semana a subastas con plazo o pujas en directo, porque entonces una instantánea desfasada deja de ser un retraso y se convierte en una oferta equivocada.
Preguntas Frecuentes Técnicas: ¿Por qué no mantener la disposición estática y añadir una consulta de estado en vivo por dominio? Ese híbrido es la vía de migración si la condición de reversión se acerca, pero no sale gratis. La consulta de estado es una dependencia nueva en tiempo de ejecución, y la página tiene que seguir renderizándose bien cuando falla, lo que nos devuelve al diseño estático con una etiqueta encima. Mientras los cambios de estado no superen el ritmo de recompilación, el híbrido añade un punto de fallo sin cambiar lo que ve el comprador.
Article Technique et Architecture de Référence Publié le: 2026-11-15
La carte 3D du portefeuille est rendue à partir d'un manifeste versionné du catalogue, généré au déploiement. L'océan WebGL n'est qu'une couche posée sur un index HTML simple qui fonctionne sans lui. Nous avons écarté une API en direct qui interrogerait la base du portefeuille à chaque visite; ce document présente cette option pour ce qu'elle vaut, montre où elle a échoué à l'analyse des pannes et nomme la condition qui renverserait le choix.
L'option écartée La conception rejetée servait le catalogue via une API en direct qui lisait la base à chaque visite et renvoyait exactement les domaines en vente à cet instant, prix et cluster à jour. Elle a de vrais arguments. Une seule source de vérité, une vente conclue qui disparaît de la carte dès que l'enregistrement change, et aucun pipeline de build susceptible de dériver par rapport à la base. Pour un portefeuille dont tout le métier est l'offre, afficher comme disponible un nom déjà vendu en pleine négociation est une vraie faute, pas un défaut cosmétique, et l'API en direct supprime cette classe d'erreur.
Tout en série Le prix à payer, c'est que base, processus d'API et moteur de rendu sont montés en série. La carte n'est disponible que si les trois le sont, et leurs disponibilités se multiplient au lieu de se compenser. La scène 3D aggrave le problème, car il lui faut le catalogue complet pour répartir les clusters en profondeur, et une réponse partielle ou lente produit un abysse vide, pas un abysse dégradé. La panne qui a tranché était plus banale qu'une coupure serveur: la perte de contexte WebGL sur les GPU mobiles d'entrée de gamme, qui laisse un canvas noir sans navigation. Dans la conception en direct, les données n'existaient que dans la mémoire JavaScript derrière ce canvas, si bien qu'un contexte perdu donnait une page totalement vide.
Ce qui tient quand une pièce lâche La conception retenue génère au déploiement un manifeste JSON versionné et en tire un index HTML de tous les domaines regroupés par cluster, sur lequel la scène WebGL vient se monter en amélioration progressive. Sur webglcontextlost, ou en l'absence de WebGL, le canvas est démonté et la liste apparaît avec les mêmes ancres, donc les liens profonds restent valides. Les règles d'accessibilité web comme les WCAG exigent déjà un équivalent textuel de la carte: le repli ne coûte presque rien de plus et de vrais utilisateurs le parcourent chaque jour, au lieu qu'il pourrisse sans test. Le manifeste est mis en cache en périphérie pendant 600 s avec stale-while-revalidate, de sorte qu'une panne de l'origine sert le dernier instantané valide plutôt qu'une erreur. Le formulaire de contact écrit dans une file qui supporte l'indisponibilité du backend et revérifie le statut au traitement, et c'est ainsi que nous payons la faiblesse restante: un domaine vendu peut rester visible le temps d'un cycle de cache, et c'est la réponse à l'acheteur, pas la carte, qui corrige le tir.
La condition qui renverse le choix Nous reviendrons à l'API en direct le jour où les changements de statut arriveront plus vite qu'une reconstruction augmentée des 600 s de cache, ce qui, selon notre estimation, revient à passer de quelques changements par semaine à des enchères chronométrées ou des offres en direct, car un instantané périmé cesse alors d'être un simple décalage pour devenir une offre fausse.
FAQ Technique: Pourquoi ne pas garder la disposition statique et ajouter un appel de statut en direct par domaine? Cet hybride est le chemin de migration si la condition de renversement approche, mais il n'est pas gratuit. L'appel de statut est une nouvelle dépendance à l'exécution, et la page doit encore s'afficher correctement quand il échoue, ce qui ramène à la conception statique avec un badge par-dessus. Tant que les changements de statut ne dépassent pas le rythme des reconstructions, il ajoute un point de défaillance sans rien changer à ce que voit l'acheteur.
Articolo Tecnico e Architettura di Riferimento Pubblicato il: 2026-11-15
La mappa 3D del portafoglio viene renderizzata da un manifest versionato del catalogo, generato al deploy. L'oceano WebGL è solo uno strato sopra un indice HTML semplice che funziona anche senza. Abbiamo scartato un'API dal vivo che interrogasse il database del portafoglio a ogni visita, e questo documento presenta quell'opzione per quello che vale, spiega dove non ha retto all'analisi dei guasti e indica la condizione che ribalterebbe la scelta.
L'opzione scartata Il progetto respinto serviva il catalogo tramite un'API dal vivo che leggeva il database a ogni accesso e restituiva esattamente i domini in vendita in quel momento, con prezzo e cluster aggiornati. Le ragioni a favore sono solide. C'è un'unica fonte di verità, una vendita conclusa sparisce dalla mappa appena cambia il record e nessuno deve mantenere una pipeline di build che può disallinearsi dal database. In un portafoglio il cui mestiere è l'offerta, mostrare come disponibile un nome già venduto nel mezzo di una trattativa è un errore vero, non estetico, e l'API dal vivo elimina alla radice questa classe di errori.
Tutto in serie Il costo è che database, processo dell'API e renderer stanno in serie. La mappa è su solo se lo sono tutti e tre, e le loro disponibilità si moltiplicano invece di compensarsi. La scena 3D peggiora le cose, perché le serve l'intero catalogo per disporre i cluster in profondità, e una risposta parziale o lenta produce un abisso vuoto, non un abisso degradato. Il guasto che ha chiuso la discussione è stato più banale di un server giù: la perdita del contesto WebGL sulle GPU mobili economiche, che lascia un canvas nero senza navigazione. Nel progetto dal vivo i dati esistevano solo nella memoria JavaScript dietro quel canvas, quindi contesto perso voleva dire pagina completamente vuota.
Cosa resta in piedi quando un pezzo cede Il progetto scelto genera al deploy un manifest JSON versionato e ne ricava un indice HTML di tutti i domini raggruppati per cluster, sopra il quale la scena WebGL si monta come miglioramento progressivo. Su webglcontextlost, o se WebGL manca, il canvas viene smontato e compare la lista con le stesse ancore, così i deep link continuano a funzionare. Le linee guida di accessibilità web come le WCAG chiedono già un equivalente testuale della mappa, perciò il fallback non costa quasi nulla in più e viene percorso ogni giorno da utenti reali invece di marcire senza test. Il manifest resta in cache sull'edge per 600 s con stale-while-revalidate, e un guasto dell'origine serve l'ultimo snapshot buono invece di un errore. Il modulo di contatto scrive in una coda che tollera il backend fermo e ricontrolla lo stato in fase di elaborazione, ed è così che paghiamo la debolezza residua: un dominio venduto può restare visibile per un ciclo di cache, e a correggerlo è la risposta all'acquirente, non la mappa.
La condizione che ribalta la scelta Torneremo all'API dal vivo il giorno in cui i cambi di stato arriveranno più in fretta di una rigenerazione sommata ai 600 s di cache, il che, secondo una nostra stima, significa passare da pochi cambi a settimana ad aste a tempo o rilanci dal vivo, perché a quel punto uno snapshot vecchio smette di essere un ritardo e diventa un'offerta sbagliata.
FAQ Tecnica: Perché non tenere il layout statico e aggiungere una chiamata di stato dal vivo per ogni dominio? Quell'ibrido è la strada di migrazione se la condizione di ribaltamento si avvicina, ma non è gratis. La chiamata di stato è una nuova dipendenza a runtime, e la pagina deve comunque renderizzarsi bene quando fallisce, il che riporta al progetto statico con un badge sopra. Finché i cambi di stato non superano il ritmo delle rigenerazioni, aggiunge un punto di guasto senza cambiare ciò che vede l'acquirente.
Technischer Fachartikel & Referenzarchitektur Veröffentlicht am: 2026-11-15
Die 3D-Karte des Portfolios wird aus einem versionierten Katalogmanifest gerendert, das beim Deployment entsteht. Der WebGL-Ozean ist nur eine Schicht über einem schlichten HTML-Index, der auch ohne ihn funktioniert. Verworfen haben wir eine Live-API, die bei jedem Besuch die Portfoliodatenbank abfragt, und dieses Dokument stellt diese Option mit ihren Stärken dar, zeigt, wo sie in der Fehleranalyse durchfiel, und nennt die Bedingung, unter der wir umentscheiden würden.
Die verworfene Option Der abgelehnte Entwurf lieferte den Katalog über eine Live-API, die bei jedem Aufruf die Datenbank las und genau die Domains zurückgab, die in diesem Moment zum Verkauf standen, mit aktuellem Preis und Cluster. Die Argumente dafür sind stark. Es gibt eine einzige Quelle der Wahrheit, ein abgeschlossener Verkauf verschwindet von der Karte, sobald sich der Datensatz ändert, und niemand pflegt eine Build-Pipeline, die von der Datenbank abdriften kann. Bei einem Portfolio, dessen ganzes Geschäft das Angebot ist, ist ein bereits verkaufter Name, der mitten in einer Verhandlung als verfügbar erscheint, ein echter Fehler und kein kosmetischer, und die Live-API beseitigt genau diese Fehlerklasse.
Alles in Reihe Der Preis: Datenbank, API-Prozess und Renderer liegen in Reihe. Die Karte ist nur verfügbar, wenn alle drei es sind, und ihre Verfügbarkeiten multiplizieren sich, statt sich auszugleichen. Die 3D-Szene verschärft das, weil sie den vollständigen Katalog braucht, um die Cluster in der Tiefe anzuordnen, und eine unvollständige oder langsame Antwort ergibt einen leeren Abgrund statt eines degradierten. Entschieden hat die Frage ein banalerer Fehler als ein Serverausfall: WebGL-Kontextverlust auf schwachen mobilen GPUs, der eine schwarze Canvas ohne Navigation hinterlässt. Im Live-Entwurf lagen die Daten nur im JavaScript-Speicher hinter dieser Canvas, ein verlorener Kontext bedeutete also eine Seite ohne jeden Inhalt.
Was weiterläuft, wenn ein Teil ausfällt Der gewählte Entwurf erzeugt beim Deployment ein versioniertes JSON-Manifest und daraus einen HTML-Index aller Domains, gruppiert nach Cluster, über den sich die WebGL-Szene als Erweiterung legt. Bei webglcontextlost oder fehlendem WebGL wird die Canvas abgebaut und die Liste mit denselben Ankern eingeblendet, sodass Deep Links weiter funktionieren. Richtlinien zur Barrierefreiheit im Web wie WCAG verlangen ohnehin ein textuelles Äquivalent der Karte, der Fallback kostet also kaum zusätzlich und wird täglich von echten Nutzern durchlaufen, statt ungetestet zu verrotten. Das Manifest liegt 600 s mit stale-while-revalidate im Edge-Cache, ein Ausfall des Origins liefert also den letzten guten Snapshot statt einer Fehlerseite. Das Anfrageformular schreibt in eine Queue, die ein ausgefallenes Backend toleriert und den Status bei der Verarbeitung erneut prüft, und damit bezahlen wir die verbleibende Schwäche: Eine verkaufte Domain kann einen Cache-Zyklus lang sichtbar bleiben, korrigiert wird das in der Antwort an den Käufer, nicht auf der Karte.
Die Bedingung für die Umkehr Zurück zur Live-API geht es an dem Tag, an dem Statusänderungen schneller eintreffen als ein Rebuild plus die 600 s Cache-Lebensdauer, was nach unserer Schätzung den Schritt von einigen Änderungen pro Woche zu befristeten Auktionen oder Live-Geboten bedeutet, denn dann ist ein veralteter Snapshot keine Verzögerung mehr, sondern ein falsches Angebot.
Technische FAQ: Warum nicht das statische Layout behalten und pro Domain einen Live-Statusabruf ergänzen? Dieser Hybrid ist der Migrationspfad, falls die Umkehrbedingung näher rückt, aber er ist nicht umsonst. Der Statusabruf ist eine neue Laufzeitabhängigkeit, und die Seite muss trotzdem korrekt rendern, wenn er scheitert, womit man wieder beim statischen Entwurf mit einem Badge obendrauf landet. Solange Statusänderungen den Rebuild-Takt nicht überholen, fügt er eine Fehlerquelle hinzu, ohne zu ändern, was der Käufer sieht.
Инженерно-техническая статья и эталонная архитектура Опубликовано: 2026-11-15
3D-карта портфеля строится из версионированного манифеста каталога, который собирается при деплое. WebGL-океан лишь слой поверх простого HTML-индекса, работающего и без него. Мы отказались от живого API, который обращался бы к базе портфеля при каждом визите; здесь этот вариант изложен честно, со всеми достоинствами, показано, где он не прошёл анализ отказов, и названо условие, при котором решение стоит пересмотреть.
Отклонённый вариант Отклонённая схема отдавала каталог через живой API: при каждом заходе он читал базу и возвращал ровно те домены, что продаются в данный момент, с актуальной ценой и кластером. Доводы в её пользу серьёзные. Один источник истины, закрытая сделка исчезает с карты сразу после изменения записи, и никому не нужно сопровождать сборочный конвейер, способный разойтись с базой. Для портфеля, весь бизнес которого и есть предложение, показать уже проданное имя как доступное посреди переговоров значит совершить настоящую ошибку, а не косметическую, и живой API устраняет этот класс ошибок полностью.
Всё последовательно Цена в том, что база, процесс API и рендерер включены последовательно. Карта работает, только когда работают все три, и их доступности перемножаются, а не усредняются. 3D-сцена усугубляет дело, потому что ей нужен весь каталог, чтобы разложить кластеры по глубине, и частичный или медленный ответ даёт пустую бездну, а не деградированную. Вопрос решил отказ куда более будничный, чем падение сервера: потеря контекста WebGL на слабых мобильных GPU, после которой остаётся чёрный canvas без навигации. В живой схеме данные существовали только в памяти JavaScript за этим canvas, так что потеря контекста означала страницу, на которой нет ничего.
Что работает, когда часть отказала Выбранная схема при деплое собирает версионированный JSON-манифест и строит из него HTML-индекс всех доменов, сгруппированных по кластерам, а WebGL-сцена монтируется поверх как улучшение. По событию webglcontextlost или при отсутствии WebGL canvas снимается, и открывается список с теми же якорями, так что прямые ссылки продолжают работать. Рекомендации по веб-доступности, такие как WCAG, и так требуют текстового эквивалента карты, поэтому запасной вариант почти ничего не добавляет к стоимости и ежедневно проверяется живыми пользователями, а не гниёт непротестированным. Манифест кешируется на edge на 600 с со stale-while-revalidate, и при падении origin отдаётся последний исправный снимок, а не ошибка. Форма заявки пишет в очередь, которая переживает недоступность бэкенда и перепроверяет статус при обработке, и так мы платим за оставшуюся слабость: проданный домен может оставаться видимым в течение одного цикла кеша, а исправляет это ответ покупателю, а не карта.
Условие, которое меняет решение Вернуться к живому API стоит в тот день, когда изменения статуса начнут приходить чаще, чем укладываются пересборка и 600 с жизни кеша, что, по нашей оценке, означает переход от нескольких изменений в неделю к аукционам с таймером или ставкам в реальном времени, потому что тогда устаревший снимок перестаёт быть задержкой и становится неверным предложением.
Технические вопросы: Почему бы не оставить статическую раскладку и не добавить живой запрос статуса по каждому домену? Такой гибрид и есть путь миграции, если условие пересмотра станет близким, но он не бесплатен. Запрос статуса добавляет новую зависимость во время выполнения, а страница всё равно обязана корректно отрисоваться при его сбое, то есть мы возвращаемся к статической схеме с бейджем сверху. Пока изменения статуса не обгоняют темп пересборки, гибрид добавляет точку отказа и ничего не меняет в том, что видит покупатель.
工程技术与参考架构文章 发布日期: 2026-11-15
投资组合的 3D 地图由部署时生成的版本化目录清单渲染,WebGL 海洋只是叠在一份朴素 HTML 索引之上的一层,没有它索引照样可用。我们否决了每次访问都查询域名库的实时 API 方案。下文先如实陈述该方案的长处,再说明它为何没能通过故障分析,最后给出会让我们改判的条件。
被否决的方案 被否决的设计通过实时 API 提供目录:每次访问都读一次数据库,只返回此刻在售的域名,价格和所属集群都是最新的。它的理由相当充分。数据只有一个权威来源,成交后记录一改,域名立刻从地图上消失,也不用维护一条可能与数据库脱节的构建流水线。对一个以报价为全部生意的域名组合来说,在谈判中把已售出的名字显示为可售,是实打实的错误而非外观瑕疵,而实时 API 从根上消除了这类错误。
全部串联 代价在于数据库、API 进程和渲染器是串联的:三者都在线,地图才在线,它们的可用性相乘而不是取平均。3D 场景让情况更糟,因为它要拿到完整目录才能在纵深上排布各个集群,响应不全或太慢,得到的是一片空荡的深渊,而不是降级后的深渊。真正拍板的故障比宕机更平常:低端移动 GPU 上的 WebGL 上下文丢失,只留下一块没有导航的黑色画布。在实时方案里,数据只存在于画布背后的 JavaScript 内存中,上下文一丢,页面上就什么都没有了。
某个部件失效时,什么还在运转 选定的设计在部署时生成版本化的 JSON 清单,并据此渲染出按集群分组、列出全部域名的 HTML 索引,WebGL 场景作为增强层挂载在上面。触发 webglcontextlost 或浏览器不支持 WebGL 时,画布被卸载,列表以相同的锚点显示出来,深层链接依然有效。WCAG 这类网页无障碍准则本来就要求地图提供文本等价物,所以这个降级方案几乎没有额外成本,而且每天都有真实用户在走这条路径,不会因无人测试而悄悄失效。清单在边缘缓存 600 s,并启用 stale-while-revalidate,源站宕机时返回的是最后一份完好的快照而不是错误页。询价表单写入一个能容忍后端停机的队列,处理时重新核对状态,剩下的弱点就靠这一环兜底:已售域名可能在一个缓存周期内仍然可见,纠正它的是给买家的回复,而不是地图。
改判的条件 一旦状态变化来得比一次重建加上 600 s 缓存寿命还快,就应回到实时 API,按我们的估计,这意味着从每周几次变动转向限时拍卖或实时竞价,因为到那时过期快照就不再只是滞后,而是错误的报价。
技术常见问题 (FAQ): 为什么不保留静态布局,再为每个域名加一个实时状态查询? 这种混合方案正是改判条件逼近时的迁移路径,但它并非没有代价。状态查询是新增的运行时依赖,而且查询失败时页面仍须正确渲染,结果又回到静态方案,只是上面多了一个状态标记。只要状态变化还没快过重建节奏,它只会多出一个故障点,买家看到的内容却没有任何变化。
技術解説&リファレンスアーキテクチャ 公開日: 2026-11-15
ポートフォリオの3Dマップは、デプロイ時に生成するバージョン付きカタログマニフェストから描画している。WebGLの海は、それがなくても機能する素のHTMLインデックスに重ねた一層にすぎない。訪問のたびにポートフォリオのデータベースを引くライブAPI案は却下した。以下ではその案の長所を正面から示したうえで、障害分析でどこが通らなかったか、どんな条件なら判断を覆すかを記す。
却下した案 却下した設計は、アクセスのたびにデータベースを読み、その時点で販売中のドメインだけを最新の価格とクラスタ付きで返すライブAPIでカタログを配信するものだった。この案の言い分は強い。信頼できる情報源は一つで、成約してレコードが変われば即座にマップから消え、データベースとずれかねないビルドパイプラインを保守する必要もない。オファーそのものが商売であるポートフォリオにとって、交渉の最中に売却済みの名前を購入可能と表示するのは見た目の問題ではなく実害のある誤りであり、ライブAPIはこの種の誤りを根こそぎなくす。
すべてが直列 代償は、データベース、APIプロセス、レンダラーが直列に並ぶことだ。三つすべてが動いて初めてマップが動き、可用性は平均されるのではなく掛け算になる。3Dシーンはこれをさらに悪くする。クラスタを奥行き方向に配置するにはカタログ全体が必要で、応答が欠けたり遅れたりすれば、劣化した深海ではなく空っぽの深海が表示されるからだ。決め手になった障害はサーバーダウンよりずっと地味なもので、ローエンドのモバイルGPUで起きるWebGLコンテキストロストだった。これが起きるとナビゲーションのない黒いキャンバスだけが残り、ライブ案ではデータがそのキャンバスの裏のJavaScriptメモリにしか存在しなかったため、ページには文字どおり何も残らなかった。
一部が壊れても動き続けるもの 採用した設計では、デプロイ時にバージョン付きのJSONマニフェストを生成し、そこから全ドメインをクラスタ別にまとめたHTMLインデックスを描画して、その上にWebGLシーンを拡張としてマウントする。webglcontextlostが発生したとき、あるいはWebGLが使えないときはキャンバスを外し、同じアンカーを持つリストを表示するので、ディープリンクはそのまま生きる。WCAGのようなWebアクセシビリティのガイドラインはもともとマップのテキスト代替を求めており、このフォールバックに追加コストはほとんどかからず、テストされないまま腐ることもなく毎日実ユーザーが通っている。マニフェストはstale-while-revalidate付きでエッジに600 sキャッシュされ、オリジンが落ちてもエラーではなく最後の正常なスナップショットが返る。問い合わせフォームはバックエンド停止に耐えるキューに書き込み、処理時にステータスを再確認するので、残る弱点はここで引き受ける。売却済みドメインがキャッシュ1周期ぶん表示され続けることはあり得るが、それを正すのはマップではなく買い手への返信だ。
判断を覆す条件 ステータス変更の到着間隔が、再ビルドに600 sのキャッシュ寿命を足した時間より短くなった日にはライブAPIへ戻すべきで、これは我々の見積もりでは週に数件の変更から時間制オークションやリアルタイム入札へ移る局面にあたり、その時点で古いスナップショットは単なる遅れではなく誤ったオファーになる。
技術FAQ: 静的レイアウトは残したまま、ドメインごとにライブのステータス取得を足せばよいのでは? そのハイブリッドは、覆す条件が近づいたときの移行経路そのものだが、タダではない。ステータス取得は新たな実行時依存であり、それが失敗してもページは正しく描画されなければならず、結局は静的設計の上にバッジを載せた形に戻る。ステータス変更が再ビルドの周期を追い越すまでは、買い手に見えるものを何も変えずに障害点を一つ増やすだけだ。
엔지니어링 및 참조 아키텍처 문서 게시일: 2026-11-15
포트폴리오의 3D 맵은 배포 시점에 생성되는 버전 관리 카탈로그 매니페스트에서 렌더링된다. WebGL 바다는 그것 없이도 동작하는 단순한 HTML 인덱스 위에 얹힌 한 겹일 뿐이다. 방문할 때마다 포트폴리오 데이터베이스를 조회하는 라이브 API 안은 기각했고, 이 기록은 그 안의 장점을 공정하게 먼저 밝힌 뒤 장애 분석에서 어디서 탈락했는지, 어떤 조건이면 결정을 뒤집을지를 적는다.
기각한 안 기각한 설계는 접속할 때마다 데이터베이스를 읽어 그 순간 판매 중인 도메인만 최신 가격과 클러스터 정보와 함께 돌려주는 라이브 API로 카탈로그를 제공했다. 이 안의 논거는 탄탄하다. 진실의 원천이 하나뿐이고, 거래가 끝나 레코드가 바뀌면 맵에서 즉시 사라지며, 데이터베이스와 어긋날 수 있는 빌드 파이프라인을 따로 관리할 필요도 없다. 오퍼 자체가 사업의 전부인 포트폴리오에서 협상 도중 이미 팔린 이름을 구매 가능으로 보여주는 것은 겉모습의 문제가 아니라 실제 오류이고, 라이브 API는 이런 유형의 오류를 원천적으로 없앤다.
모든 것이 직렬 대가는 데이터베이스, API 프로세스, 렌더러가 직렬로 놓인다는 점이다. 셋이 모두 살아 있어야 맵이 살아 있고, 가용성은 평균이 아니라 곱으로 계산된다. 3D 장면은 이를 더 악화시키는데, 클러스터를 깊이 방향으로 배치하려면 카탈로그 전체가 필요해서 응답이 일부만 오거나 늦으면 성능이 떨어진 심해가 아니라 텅 빈 심해가 나오기 때문이다. 결론을 낸 장애는 서버 다운보다 훨씬 평범한 것으로, 저가형 모바일 GPU에서 생기는 WebGL 컨텍스트 손실이었고 이때 남는 것은 내비게이션 없는 검은 캔버스뿐이다. 라이브 설계에서는 데이터가 그 캔버스 뒤 JavaScript 메모리에만 있었기에 컨텍스트를 잃으면 페이지에는 아무것도 남지 않았다.
일부가 멈춰도 계속 도는 것 채택한 설계는 배포 시 버전 관리 JSON 매니페스트를 만들고, 이를 바탕으로 모든 도메인을 클러스터별로 묶은 HTML 인덱스를 렌더링한 뒤 그 위에 WebGL 장면을 확장 기능으로 올린다. webglcontextlost가 발생하거나 WebGL을 쓸 수 없으면 캔버스를 걷어내고 같은 앵커를 가진 목록을 드러내므로 딥 링크는 그대로 작동한다. WCAG 같은 웹 접근성 지침은 원래 맵의 텍스트 대체물을 요구하므로 이 폴백에는 추가 비용이 거의 들지 않고, 테스트 없이 썩어가는 대신 실제 사용자가 매일 거쳐 간다. 매니페스트는 stale-while-revalidate와 함께 엣지에 600 s 동안 캐시되어, 오리진이 다운되면 오류 대신 마지막 정상 스냅샷이 나간다. 문의 양식은 백엔드 중단을 견디는 큐에 기록되고 처리 시점에 상태를 다시 확인하는데, 남은 약점의 값은 여기서 치른다. 팔린 도메인이 캐시 한 주기 동안 계속 보일 수 있지만, 그걸 바로잡는 것은 맵이 아니라 구매자에게 보내는 답장이다.
결정을 뒤집는 조건 상태 변경이 재빌드에 600 s 캐시 수명을 더한 시간보다 빨리 도착하기 시작하는 날 라이브 API로 돌아가야 하며, 우리 추정으로는 주당 몇 건의 변경에서 시간 제한 경매나 실시간 입찰로 넘어가는 시점이 그때인데, 그 순간부터 낡은 스냅샷은 단순한 지연이 아니라 잘못된 오퍼가 되기 때문이다.
기술 FAQ: 정적 레이아웃은 유지하고 도메인별로 라이브 상태 조회만 추가하면 안 되나? 그 하이브리드가 바로 뒤집기 조건이 가까워졌을 때의 이전 경로지만 공짜는 아니다. 상태 조회는 새로운 런타임 의존성이고, 조회가 실패해도 페이지는 제대로 렌더링되어야 하므로 결국 정적 설계 위에 배지를 하나 얹은 형태로 돌아온다. 상태 변경이 재빌드 주기를 앞지르기 전까지는 구매자가 보는 것은 그대로인 채 장애 지점만 하나 늘어난다.