Initial commit: User documentation

09-document-validator.md

@@ -0,0 +1,117 @@
+# Валидатор на документи
+
+Валидаторът позволява на получателите на фактури да проверят автентичността на документа.
+
+## Какво е валидаторът?
+
+Когато издадете фактура, тя получава уникален код за валидация. Получателят може да провери дали фактурата е истинска и непроменена.
+
+## Достъп до валидатора
+
+Валидаторът е достъпен на публичен адрес без нужда от вход:
+
+**[invoicing.top/verify](https://invoicing.top/verify)**
+
+![Валидатор](images/validator-main.png)
+
+## Как да проверите фактура
+
+### Метод 1: QR код
+
+1. Отворете валидатора
+2. Сканирайте QR кода от фактурата с камерата
+3. Резултатът ще се покаже автоматично
+
+### Метод 2: Въвеждане на код
+
+1. Отворете валидатора
+2. Въведете кода за валидация от фактурата
+3. Натиснете **Провери**
+
+### Метод 3: Директен линк
+
+Всяка фактура съдържа линк за валидация:
+```
+https://invoicing.top/verify?code=XXXX-XXXX-XXXX
+```
+
+## Резултати от проверката
+
+### Валиден документ ✅
+
+Показва се информация за документа:
+
+| Поле | Описание |
+|------|----------|
+| Номер | Номер на фактурата |
+| Дата | Дата на издаване |
+| Издател | Име на фирмата издател |
+| Получател | Име на клиента |
+| Сума | Обща сума с ДДС |
+| Статус | Финализиран/Платен |
+
+![Валиден документ](images/validator-valid.png)
+
+### Невалиден документ ❌
+
+Ако документът не е намерен или кодът е грешен:
+
+- "Документът не е намерен"
+- "Невалиден код за проверка"
+
+Възможни причини:
+- Грешно въведен код
+- Документът е анулиран
+- Документът не съществува
+
+### Анулиран документ ⚠️
+
+Ако документът е анулиран, ще се покаже предупреждение:
+
+- "Този документ е анулиран"
+- Дата на анулиране
+- Причина за анулиране
+
+## Къде се намира кодът за валидация?
+
+Кодът за валидация се намира на фактурата:
+
+1. В долния край на фактурата
+2. Като QR код
+3. Като текст под QR кода
+
+![Код за валидация](images/validator-code-location.png)
+
+## Сигурност
+
+### Как работи валидацията?
+
+1. При финализиране на фактура се генерира уникален код
+2. Кодът се криптира и записва в базата данни
+3. При проверка системата сравнява кода
+4. Резултатът показва дали документът е автентичен
+
+### Защита от фалшификации
+
+- Всеки код е уникален
+- Кодът не може да бъде предугаден
+- Промяна на документа прави кода невалиден
+
+## За издателите
+
+### Активиране на валидация
+
+Валидацията е активна по подразбиране за всички финализирани документи.
+
+### QR код във фактурите
+
+QR кодът се добавя автоматично при:
+- Генериране на PDF
+- Печат на фактура
+
+### Персонализация
+
+В настройките можете да:
+- Промените позицията на QR кода
+- Добавите лого до кода
+- Изберете размер на кода