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]

Един източник, няколко резултата


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.


Следващи стъпки

Технологии

Java 21, Spring Boot 4, Angular 22, PrimeNG 22, TypeScript, MongoDB, OpenHTMLtoPDF, nginx, Docker, Caddy

Ангажимент

PERSONAL_PRODUCT

Период

2026-03 – досега

Решения