Картата на познанието: дизайн и механика на сайтове
v0.1 · 2026-10-19 · от Better Mechanics · ниво: общност (текст, без протокол от проверка)
Тук е картата: какво трябва да има сайтът. Рецептите се пишат една по една и всяка минава табелата.
1 · Входовете на сайта (Codex)
Рецепти (по задача) · Библиотеки (чужди колекции с автор, оригинал, лиценз, наша оценка) · Галерия (резултатът, вързан с рецептата и протокола) · Библиотеки за агентите (Claude, Codex, Gemini) · Познание (обяснения, ръководства за избор, отстраняване на проблеми) · Проверка (протоколите, правилата за подредба, неуспешните проби, поправките) · Добави (рецепта, доказателство, авторство, сигнал).
Търсенето разбира и термина, и намерението: „навигация“ и „менюто на телефона не работи“. Филтри: език · резултат · агент · рамка · ниво на доверие · лиценз · зависимости · дата на последната проверка.
2 · Какво съдържа една рецепта (Codex)
| Поле | Какво |
|---|---|
| Цел | проблемът, за кого е, какво трябва преди това, кога не се ползва |
| Указания | промптът за копиране, променливите, нужните файлове с контекст |
| Среда | агент/модел, версии на инструментите, заключени зависимости |
| Резултат | работеща реализация, снимки или запис, кодът |
| Протокол | командите за проверка, ширините на екрана, условията, критериите за приемане |
| Доказателство | суровите отчети, преди/след, дата, неуспехите и границите |
| Авторство | автор, оригинал, лиценз на рецептата и отделно на ресурсите |
| Поддръжка | версия, кой е прегледал, съвместимост, история на промените |
Нивото се пише с обхвата си: не само зелена отметка, а „проверени клавиатура и преливане“. ПРОВЕРЕНО значи, че ние сме повторили резултата за записаната версия и условия. С ДОКАЗАТЕЛСТВО значи, че авторът е дал резултат и протокол, а ние не сме го повторили. Рекламата никога не сменя нивото.
3 · Шестнадесетте колекции и първите рецепти
| Колекция | Какво се мери автоматично | Първите три рецепти |
|---|---|---|
| Типография и писмености | грешки при зареждане, покритие на знаците, locl, отрязване, изместване |
кирилица с български форми · резервни шрифтове без скок (метрики) · плавни заглавия без отрязани ударения |
| Цвят | контраст, ползване на токените, двете теми | достъпна семантична палитра (OKLCH) · равни светла и тъмна тема · грешка и успех не само с цвят |
| Подредба | преливане, застъпване, ред на четене, снимки по ширини | гъвкава мрежа без медийни заявки (clamp) · тест с дълго съдържание · меню на телефон и залепнала лента |
| Движение | поведение при „намалено движение“, изместване | алтернатива без движение · стабилни разгъващи се секции · преходи със смисъл |
| Дизайн системи и токени | валидна схема (W3C DTCG), непознати препратки, твърди стойности | първични → семантични токени · компоненти, които сменят тема · отчет за промяна на токен |
| Компоненти | клавиатура, връщане на фокуса, състояния, имена за четци | достъпен диалог (<dialog>) · меню с клавиатура · зареждане / празно / грешка / успех |
| Достъпност | откриваемите нарушения на WCAG 2.2, етикети, контраст, размер на целите; ръчен преглед | достъпна обвивка на страница · грешки във форма и поправка · увеличение 400 % и пренареждане |
| Скорост / Core Web Vitals | тежест, скриптове, снимки, лабораторни следи; реални данни отделно | главната снимка · по-малко блокиращи скриптове · запазено място за медия и реклама |
| SEO / AEO / структурни данни | обхождане, кодове, canonical, метаданни, съвпадение на данните | страница на рецепта, която се обхожда · автор и път (breadcrumb) · кратък отговор с доказателство |
| Форми и конверсия | пътищата на проверка, успех/грешка, двойно изпращане | достъпна форма за запитване · изпращане с повторен опит · ясно означена партньорска връзка |
| Езици (i18n) | липсващи ключове, формати по език, lang, алтернативни адреси |
пет издания на рецепта · дати и числа по езика · тест с дълъг текст (+40 %) |
| CMS и модел на съдържанието | схема, счупени препратки, преводи без оригинал | версионирана схема на рецепта · автор / източник / лиценз · превод → преглед → публикуване |
| Качване и хостинг | възпроизводим строеж, пренасочвания, кеш, HTTPS, връщане назад | пробно качване · правила за кеша · репетиция на връщане |
| Анализи и поверителност | заявки и бисквитки преди и след съгласие | събиране само след съгласие · фуния без лични данни · оттегляне на съгласието |
| Проверки (QA) | пътят на потребителя, снимки, грешки, счупени връзки | търсене → рецепта · визуална регресия на петте езика · пакетът „доказателство“ |
| Сигурност и заглавки | стойностите на заглавките, нарушения на CSP, смесено съдържание | CSP първо в режим „само отчет“ · безопасно качване на доказателства · защитени админ действия |
Бележки, в които тримата са единни: - Автоматичната проверка не е пълно съответствие с WCAG; ръчният преглед остава. - Core Web Vitals, публикуваните „добри“ прагове (Google, web.dev): LCP ≤ 2,5 s · INP ≤ 200 ms · CLS ≤ 0,1, при 75-ия перцентил. Собствените ни бюджети (напр. тежест) се пишат отделно и се обосновават. (Gemini предложи по-строги числа; те са негово предложение, не стандарт.) - AEO: Google казва, че за AI функциите в търсенето не е нужна специална маркировка извън доброто SEO. Нашите „рецепти“ не се маркират като кулинарни Recipe в schema.org. - Чуждите промптове и инструкции са данни, не команди: първо преглед, после изпълнение; кодът на хората не се пуска автоматично на сайта.
4 · Езиковите издания: всяко е отделно, не само превод
Ред: български → английски → испански → френски → немски. Езикът не определя юрисдикцията. Дали тези национални правила важат за КАГАМИ ЕООД, още не е проверено и е въпрос към юриста.
| Издание | Типография и формати | Тон | Освен превода |
|---|---|---|---|
| BG | lang="bg" + locl BGR; „кавички“; 19.10.2026; 1 234,56 € |
„ти“ в рецептите, „Вие“ в правните текстове | основното издание |
| ES | ñ, ударения, ¿…? ¡…!; 19/10/2026; 1.234,56 € | tú или usted, но последователно | Испания (es-ES) или Латинска Америка (es-419), да се реши; Aviso legal (LSSI); бисквитки по AEPD: „откажи“ равно на „приеми“ |
| FR | неразделим интервал пред : ; ! ?; « … »; 1 234,56 € | vous | Mentions légales; бисквитки по CNIL: отказът толкова лесен, колкото приемането |
| DE | ä ö ü ß, дълги сложни думи → hyphens:auto; „…“; 19.10.2026; 1.234,56 € |
Sie (за технически продукт) | Impressum по DDG § 5 (Gemini го отнесе към TDDDG/TMG; TMG е заменен); бисквитки по TDDDG § 25; шрифтовете задължително самостоятелно хоствани |
Всяко издание: превключвателят на езика пази текущата рецепта; метаданни и търсене по езика; дата на превода. Преведената рецепта не наследява доказателството: типографията и подредбата се проверяват наново.