dok.sh — платформа за портфолио и CV
Накратко
dok.sh е сайтът, който четете. Той заменя статичното CV със структурирано съдържание на английски и български, редактирано в администрация. Едни и същи данни дават публичните страници, CV в PDF в три варианта и два дизайна, страниците, които търсачките индексират, и текстовите файлове, които четат AI асистентите.
Подзаглавие
Един набор от данни за двуезичен сайт, CV в PDF, търсачки и AI асистенти.
Област
Портфолио / Платформа за съдържание
Потребители
Потенциални клиенти, рекрутъри и мениджъри, които разглеждат опита и наличността ми.
Роля
Основател / продуктов инженер
Предизвикателство
CV-то, профилът ми в LinkedIn и старият ми сайт казваха малко различни неща и никое не показваше как работя по проект. Исках едно място, където всичко е актуално на два езика, което дава CV, четимо и от хора, и от софтуер за подбор, и страници, към които да водя от LinkedIn.
За какво отговарях
Модел на съдържанието, бекенд и интерфейс, административни редактори, преводи, генериране на CV в PDF, SEO и откриваемост от AI асистенти, внедряване на споделен сървър, архиви.
Подход
Първо структурирани данни, после страници; английски и български от първия ден; търсачките и AI асистентите се третират като посетители; публичната част е проста, а сложността остава в администрацията.
Резултати
Една редакция обновява сайта на двата езика, CV-тата в PDF, картата на сайта и llms.txt. Съдържанието се подготвя локално, проверява се като YAML файл и се зарежда в живия сайт с една стъпка. Така за два дни бяха публикувани двадесет страници с решения за двата ми продукта.
Подробности
Обзор
Изградих dok.sh, защото CV-то, профилът ми в LinkedIn и старият ми сайт непрекъснато се разминаваха и никое не показваше как работя по проект. Сайтът е и работещ пример: изграден е така, както бих изградил административно управлявано приложение за клиент, и се поддържа така, както бих поддържал такова.
Първо структурата
Всичко в сайта е структурирано съдържание: позиции, проекти, казуси, решения, услуги, умения и настройки, всяко с текст на английски и български. Страниците само показват тези данни. Един проект може да се покаже като карта, страница с детайли, казус и списък с решения, без да се пише четири пъти.
flowchart TD
V[Посетител] --> W[Angular сайт, EN и /bg/]
B[Търсачка, AI робот, преглед на връзка] --> N[nginx]
N --> W
N --> R[Страница, генерирана на сървъра]
A[Администратор] --> AD[Angular администрация]
W --> API[Spring Boot API]
R --> API
AD --> API
API --> DB[(MongoDB + GridFS)]
API --> PDF[Генератор на CV в PDF]
API --> TXT[Карта на сайта, llms.txt, Markdown]
Един източник, няколко резултата
- публичният сайт на английски и, под
/bg/, на български, всяка страница със свой адрес - генериран на сървъра HTML с JSON-LD, hreflang и карта на сайта за търсачки и прегледи на връзки
llms.txt,llms-full.txtи Markdown версия на всяка страница за AI асистенти- CV в PDF в три варианта (Java консултант, бекенд архитект, цялата кариера) и два дизайна (класически и ATS)
- страници с решения, които могат да се споделят една по една в LinkedIn
- YAML експорт на целия сайт, който може да се проверява, пази в git и импортира по раздели
CV в PDF с бюджет от страници
Всеки вариант на CV-то има целеви брой страници. PDF-ът се генерира и измерва; ако е твърде дълъг, генерира се отново една стъпка по-плътно, с по-малко детайли за по-старите позиции, докато се побере. ATS дизайнът използва същото съдържание в една колона без таблици, а двата дизайна носят заглавие, автор и ключови умения в метаданните на PDF-а.
sequenceDiagram
participant V as Посетител
participant API as Бекенд
participant CV as CV builder
participant PDF as PDF генератор
V->>API: Изтегляне на CV (вариант, език, дизайн)
API->>CV: Изграждане от резюмето, уменията и настройките
loop докато се побере в бюджета
CV->>PDF: HTML
PDF-->>CV: PDF и брой страници
end
API-->>V: PDF файл
Администрацията
Администрацията беше преработена през ноември 2026 г. на Angular 22 и PrimeNG 22. Всяка колекция използва едно и също оформление: списък с филтър и плъзгане за подредба до формата на избрания запис. Една лента за запис на страница показва незаписаните промени и записва с Ctrl+S; напускане, презареждане или изход с незаписани промени пита първо. Ctrl+K търси във всички страници на администрацията. Изображенията се пускат или поставят там, където трябват, и се пазят в една медийна библиотека; страниците искат нужната им ширина, а сървърът преоразмерява от фиксиран списък с размери.
Хостинг
Сайтът работи в Docker Compose (MongoDB, Spring Boot API и nginx с Angular build-а) на малък VPS. Отделен Caddy контейнер отпред обслужва HTTPS за този сайт и за още два проекта на същия сървър, така че всеки проект се внедрява, без да се пипат другите. Пълен архив на базата се прави от администрацията преди всяко внедряване.
Решения, които имаха значение
Два езика от самото начало. Всяко текстово поле има стойност на английски и на български, а езикът е част от адреса. Добавянето на втория език по-късно би означавало промяна на всеки модел и екран.
Търсачките и AI асистентите също са посетители. Повечето клиенти търсят услугата, а не името, и все повече питат AI асистент. И двете получават същите факти като хората, от същите данни.
Съдържание, което може да се мести и преглежда. Текстът на сайта е един YAML файл. Новото съдържание се подготвя и проверява локално, после се зарежда в живия сайт с една стъпка, а нов сървър стартира от същия файл.
Проста публична част, способна администрация. Посетителите виждат изчистен сайт. Подредбата, видимостта, оформлението, настройките на CV-то и редакторите са в администрацията.
Решения
Десет страници описват подробно отделни функции на сайта: всички решения за dok.sh.
Следващи стъпки
- редактируеми профили на CV вместо три фиксирани варианта
- AI помощ за текстовете на CV-то по избор (вградена, изключена, докато не потрябва)
Технологии
Java 21, Spring Boot 4, Angular 22, PrimeNG 22, TypeScript, MongoDB, OpenHTMLtoPDF, nginx, Docker, Caddy
Ангажимент
PERSONAL_PRODUCT
Период
2026-03 – досега
Решения
- Една редакция обновява сайта, CV-то и това, което четат търсачките
- CV в PDF, което се побира в лимита от страници
- CV, което софтуерът за подбор може да прочете
- Търсачките виждат същата страница като посетителите
- Сайт, който AI асистентите могат да четат
- Два езика, всеки със свои адреси
- Страници с решения, направени за споделяне
- Администрация, която не губи работата ви
- Снимки и изображения без главоболия
- Съдържание, което може да се мести, преглежда и възстановява