مارکوون — سایت شرکتی برای یک فعال تجارت فیزیکی نفت

01زمینه

معامله‌گر اصیل، نه دلال

Marqevon در تجارت فیزیکی فرآورده‌های نفتی معامله‌گر اصیل است، نه دلال. از تولیدکنندگان و پالایشگاه‌ها می‌خرد و به پالایشگاه‌ها، توزیع‌کنندگان، شرکت‌های هواپیمایی، شرکت‌های خدمات عمومی و مصرف‌کنندگان صنعتی تحویل می‌دهد. مخاطب اول سایتش طرف‌های معامله‌اند، بعد بانک‌ها و شرکای تأمین مالی تجاری، بعد متقاضیان استخدام و در آخر مطبوعات و نهادهای ناظر.

کار از اول بر پایه‌ی یک مشخصات‌نامه پیش رفت. این سند ۴۶ کیلوبایتی قبل از ساخت، معماری اطلاعات، سیستم طراحی و هر ۱۵ صفحه را قطعی کرد. سند با رد کردن بریف معمول شروع می‌شود: در این صنعت کار وب‌سایت بازاریابی نیست؛ باید مشروعیت شرکت را طوری نشان بدهد که بشود آن را راستی‌آزمایی کرد.

02مسئله

شبکه‌ی تقلب گویش خودش را دارد

تجارت فیزیکی کالا با تقلب درگیر است و این تقلب واژه‌های خودش را دارد. دلال‌های غیررسمی خودشان را با مجموعه‌ای آشنا از سرواژه‌های ابزارهای مالی و عنوان‌های نمایندگی معرفی می‌کنند، مثل TTT، TTV، DTA و ATB. اگر یک معامله‌گر اصیل و مشروع میان‌اندازه حتی یکی از این واژه‌ها را به کار ببرد، یکی از همان دلال‌ها به نظر می‌رسد.

برای همین کل سایت باید به یک پرسش پاسخ می‌داد، آن هم به هفت زبان که دو تا از آن‌ها راست‌به‌چپ نوشته می‌شوند.

03پژوهش

جایگاه خالی‌ای که بزرگان بازار تبلیغش نمی‌کنند

یک بنچمارک رقابتی، طراحی موردنظر را با بزرگ‌ترین شرکت‌های بازرگانی و گروهی از همتایان میان‌اندازه سنجید. شکافی که پیدا کرد ارزش پر کردن داشت: هیچ‌کدام از بزرگان بازار صریحاً موضعی ضدتقلب را تبلیغ نمی‌کنند یا نمی‌گویند چه کارهایی را انجام نمی‌دهند.

این یافته شعار نشد؛ به ساختار سایت تبدیل شد: گروه «آنچه انجام نمی‌دهیم» در پرسش‌های متداول، دعوتی صریح به راستی‌آزمایی مستقل و فهرستی از اصطلاحاتی که متن سایت هرگز نباید به کار ببرد.

04رویکرد

ابزاری دقیق برای بازاری که بر اعتماد بنا شده است

مشخصات‌نامه جهت کار را در یک سطر تعیین کرد: «ابزاری دقیق برای بازاری که بر اعتماد بنا شده است». این جهت جایی بین میز معاملات یک نهاد انرژی و یک سند بازرسی تأییدشده است. همان سند چیزهایی را هم که باید از آن‌ها دوری کرد نام برد: کرم با قلم سریف و رنگ سفالی، مشکی با سبز اسیدی، و خطوط مویی به‌عنوان تمام زیبایی‌شناسی.

کار به ترتیب از بنچمارک رقابتی، مشخصات‌نامه و ساخت گذشت و بعد به یک دور بازخورد کارفرما رسید. قبل از اعمال هر بخشی از این بازخورد، با خود کد ممیزی شد.

از حدود ۶۷ دستورالعمل در بازخورد کارفرما، ۳۳ مورد از ممیزی گذشتند و کارت شدند. ۸ مورد قبل از اجرا به اصلاح نیاز داشتند، ۲۲ مورد منتظر تصمیم‌های باز ماندند و ۴ مورد پرسش بودند.

05راه‌حل

سامانه‌ی مرجع دفتری

مشخصات‌نامه می‌گوید جسارت بصری کجا خرج شود: «جسارت را این‌جا خرج کن؛ همه‌چیز دیگر را آرام نگه دار.» این امضای بصری سه بخش دارد: برچسب‌های مرجع که کنار ادعاهای اعتبار می‌آیند، مانیفست‌های داده که مثل گواهی‌های بازرسی با قلم تک‌فاصله و خطوط مویی چیده می‌شوند، و یک نوار هویت با قلم تک‌فاصله در پایین هر صفحه.

پالت رنگ هم برای همین ساخته شده است: زمینه‌ای به رنگ نفت تیره‌ی اعماق، فولاد دریایی، کاغذ اسناد، برنجی به‌عنوان تنها رنگ تأکیدی، سبزآبی «تأییدشده» که با سبز اسیدی فاصله‌ی زیادی دارد، و رنگ زنگ‌آهن فقط برای نشانه‌های هشدار. همه‌ی اعداد، مرجع‌ها و برچسب‌ها با IBM Plex Mono نوشته می‌شوند.

در لایه‌ی فنی، سایت با Payload 3.85 و Next.js 16.2 و next-intl روی MongoDB ساخته شده، با ۱۰ کالکشن و ۴ گلوبال، و از طریق nginx ارائه می‌شود. فرم احراز صلاحیت خریدار هم به هر درخواست امتیاز می‌دهد و آن را برای میز معاملات علامت‌گذاری می‌کند.

06تصمیم‌های کلیدی

پنج تصمیم درباره‌ی اعتماد

بیشترشان درباره‌ی حرف‌هایی است که سایت عمداً نمی‌زند.

01
جسارت را در یک جا خرج کن
اگر سایت یک شرکت بازرگانی «طراحی‌شده» به چشم بیاید، تبلیغاتی به نظر می‌رسد. برای همین تمام بار بصری روی سامانه‌ی امضاست و بقیه‌ی سطح‌ها آرام می‌مانند تا چیزی که در ذهن خواننده می‌ماند مانیفست‌ها باشد.
گزینه‌های دیگر
برندی پرجسارت در همه‌ی سطوح
بده‌بستان
سایت برای کسی که انتظار یک کمپین تبلیغاتی دارد، خلوت به نظر می‌رسد.
02
کاری کن که نقض قاعده‌ها ساخت را متوقف کند
دو نگهبان در CI اجرا می‌شوند. اولی با دیدن واژه‌های شبکه‌ی تقلب یا املای آمریکایی در متن سایت خطا می‌دهد؛ دومی با دیدن کلاس‌های چیدمانی وابسته به جهت فیزیکی، قلم‌های هاردکدشده و رشته‌های ترجمه‌نشده. دومی تا امروز یک جاافتادگی واقعی را گرفته است: برچسب دسترس‌پذیری‌ای که از ترجمه جا مانده بود.
گزینه‌های دیگر
یک راهنمای سبک مکتوب
بده‌بستان
نگهبان فقط از فایل‌هایی که می‌خواند محافظت می‌کند.
03
درباره‌ی ریسک حقوقی تصمیم نگیر؛ ارجاعش بده

07هفت زبان

هفت زبان، دو تا راست‌به‌چپ

فایل‌های انگلیسی، فرانسوی، عربی، اسپانیایی، ژاپنی، چینی و فارسی همه دقیقاً کلیدهای پیام یکسانی دارند؛ در آخرین کامیت، هر فایل ۲۲۲ کلید داشت. عربی و فارسی روی ویژگی‌های منطقی CSS کار می‌کنند، برای همین چیدمان به‌جای بازسازی، آینه می‌شود.

دو نکته فقط در عمل معلوم شد. تعویض قلم برای هر زبان درون یک لایه‌ی آبشاری (cascade layer) نوشته شده بود و بی‌سروصدا بی‌اثر می‌شد، برای همین حالا بیرون از لایه‌ها قرار دارد. مانیفست‌ها هم ارقام جدولی دارند تا ستون‌های تک‌فاصله زیر متن راست‌به‌چپ و CJK هم هم‌تراز بمانند.

08همه‌ی صفحه‌ها

سی‌وچهار صفحه، یک سیستم

از همه‌ی صفحه‌های انگلیسی نسخه‌ی مستقر، ۴ مهر ۱۴۰۵ در عرض ۱۴۴۰ پیکسل و روی گوشی ۳۹۰ پیکسلی تصویر گرفته شد: شانزده صفحه‌ی سطح اول، فرم احراز صلاحیت خریدار، دو آگهی شغلی، دوازده مقاله‌ی تحلیلی و سه صفحه‌ی حقوقی.

صفحه‌های داخلی هم همان مانیفست‌های داده با خطوط مویی و همان نوار هویت با قلم تک‌فاصله را دارند که در صفحه‌های شاخص هست. روی گوشی هر صفحه در یک ستون چیده می‌شود و ناوبری پشت دکمه‌ی منو می‌رود. در صفحه‌ی اصلی، بخش قیمت‌های بازار پوشانده شده است.

09نتایج

مستقر، اما راه‌اندازی‌نشده

سایت مستقر شده و کار می‌کند، اما هنوز راه‌اندازی نشده: دامنه ندارد، عمداً از نتایج جست‌وجو بیرون نگه داشته شده و اطلاعات هویتی‌اش هنوز جای‌نگهدار است. بازخورد اعمال‌شده در کامیتی است که هنوز به مخزن فرستاده نشده و روی سرور نیست. هیچ ابزار تحلیلی در کار نیست؛ فقط سلامت کانتینرها بررسی می‌شود.

تست‌های یکپارچگی موفق: ۱۴۲; در کنار lint، هر دو نگهبان و یک ساخت تولیدی، روی شاخه‌ی بازخورد.; نتیجه‌ی اندازه‌گیری‌شده · تخته‌ی بازخورد طراحی، ۱۶ شهریور ۱۴۰۵
کارت‌های بازخورد اعمال‌شده در کد: ۳۲ / ۳۳; یکی منتظر یک تصمیم باز است؛ هیچ‌کدام هنوز روی اپ در حال اجرا تأیید نشده‌اند.; نتیجه‌ی اندازه‌گیری‌شده · نقشه‌ی راه بازخورد طراحی
پشتیبان‌هایی که بازیابی‌شان آزموده شده: هر شب پشتیبان گرفته می‌شود و هر نسخه بازیابی می‌شود تا معلوم شود سالم است. قبل از هر انتشاری که محتوا را مهاجرت می‌دهد هم یک بسته‌ی بازیابی ساخته می‌شود.; خروجی تحویل‌شده
مسیر استقرار با ایمیج تغییرناپذیر: هر انتشار یک ایمیج ثابت است؛ تگ تغییرپذیر latest و به‌روزرسانی خودکار با سرکشی دوره‌ای کنار گذاشته شده‌اند.; خروجی تحویل‌شده

آنچه تحویل شد

هفت زبان با کلیدهای یکسان
دو نگهبان CI
مانیفست حاکمیت

10آنچه یاد گرفتم

ابزار اعتمادی که هیچ کاری نکرد

01
مفیدترین خروجی یک قاعده‌ی lint بود
وقتی قاعده‌ی «به گویش شبکه‌ی تقلب حرف نزن» به یک نگهبان تبدیل شد، دیگر نیتی نبود که کسی باید یادش بماند؛ بخشی از خود مخزن کد شد.
02
نگهبان فقط از آنچه می‌خواند محافظت می‌کند
نگهبان محتوا متن‌ها و فایل‌های پیام را می‌خواند، اما فهرست گزینه‌های فرم را نه؛ برای همین فرم احراز صلاحیت خریدار هنوز دو اصطلاح ممنوع را در گزینه‌های تحویل دارد. شرکت درست در تنها صفحه‌ای که دیگران را غربال می‌کند، به همان گویشی حرف می‌زند که خودش ممنوع کرده است.
03
ابزار اعتماد باید کاری انجام دهد
برچسب‌های مرجع نام یک سامانه‌ی ثبت شرکت‌ها یا نمایه‌ی LEI را می‌آورند، اما به هیچ‌کدام لینک نمی‌دهند. تا وقتی به یک رکورد واقعی اشاره نکنند، این ابزار امضایی فقط ظاهر راستی‌آزمایی را دارد؛ و این دقیقاً همان شکستی است که پروژه برای دوری از آن شروع شد.
04
برای تصمیم‌های ساختاری، اول تأیید کتبی بگیر
هفت زبان هفته‌ها قبل از آن تحویل داده شد که یکی از اسناد حاکمیتی کارفرما بنویسد درباره‌ی مسئله‌ی زبان هنوز تصمیمی گرفته نشده است. نگه داشتن این زبان‌ها درست بود، چون پاک کردن کاری تمام‌شده و محافظت‌شده خطای پرهزینه‌تری است؛ اما این تصمیم باید قبل از ساخته شدن کلیدها مکتوب می‌شد.

زبان

مارکوون — سایت شرکتی برای یک فعال تجارت فیزیکی نفت

معامله‌گر اصیل، نه دلال

شبکه‌ی تقلب گویش خودش را دارد

جایگاه خالی‌ای که بزرگان بازار تبلیغش نمی‌کنند

ابزاری دقیق برای بازاری که بر اعتماد بنا شده است

چهار مرحله، هر کدام مکتوب

سامانه‌ی مرجع دفتری

پنج تصمیم درباره‌ی اعتماد

جسارت را در یک جا خرج کن

کاری کن که نقض قاعده‌ها ساخت را متوقف کند

درباره‌ی ریسک حقوقی تصمیم نگیر؛ ارجاعش بده

هفت زبان، دو تا راست‌به‌چپ

سی‌وچهار صفحه، یک سیستم

مستقر، اما راه‌اندازی‌نشده

آنچه تحویل شد

ابزار اعتمادی که هیچ کاری نکرد

مفیدترین خروجی یک قاعده‌ی lint بود

نگهبان فقط از آنچه می‌خواند محافظت می‌کند

ابزار اعتماد باید کاری انجام دهد

برای تصمیم‌های ساختاری، اول تأیید کتبی بگیر

بازخورد کارفرما را پیش از اعمال ممیزی کن

جای‌نگهدار بگذار، هویت جعل نکن