Merge master and add security documentation

- Merged existing documentation structure from master
- Added security.md: Audit log and bank certificate security features
- Added bank-certificate-guide.md: Step-by-step setup guide
- Updated README.md with combined content

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

01-getting-started.md

@@ -0,0 +1,67 @@
+# Първи стъпки
+
+## Регистрация
+
+1. Отворете [invoicing.top/register](https://invoicing.top/register)
+2. Въведете вашия имейл адрес
+3. Изберете парола (минимум 8 символа)
+4. Потвърдете имейл адреса си чрез линка, изпратен на пощата ви
+
+![Регистрация](images/register.png)
+
+## Първоначална настройка
+
+След регистрация ще бъдете пренасочени към страницата за настройка на фирмата.
+
+### Данни на фирмата
+
+Въведете следните данни:
+
+- **Име на фирмата** - официалното наименование
+- **ЕИК** - единен идентификационен код
+- **ДДС номер** - ако сте регистрирани по ДДС (започва с BG)
+- **Адрес** - седалище на фирмата
+- **МОЛ** - материално отговорно лице
+- **Телефон** и **Имейл** - за контакт
+
+![Настройка на фирма](images/company-setup.png)
+
+### Банкова сметка
+
+Добавете поне една банкова сметка:
+
+1. Отидете в **Настройки** → **Банкови сметки**
+2. Натиснете **Добави сметка**
+3. Въведете:
+   - Име на банката
+   - IBAN
+   - BIC/SWIFT код
+4. Запазете
+
+![Банкова сметка](images/bank-account.png)
+
+## Интерфейс на приложението
+
+### Странично меню
+
+- **Табло** - обобщена информация и статистики
+- **Документи** - всички издадени документи
+- **Клиенти** - управление на клиенти
+- **Артикули** - каталог с продукти/услуги
+- **Справки** - финансови отчети
+- **Банкови транзакции** - преглед на плащания
+- **Настройки** - конфигурация на системата
+
+### Горна лента
+
+- Търсене
+- Известия
+- Профил и изход
+
+## Следваща стъпка
+
+След като настроите фирмата си, можете да:
+
+1. [Добавите клиенти](04-clients.md)
+2. [Създадете артикули](05-items.md)
+3. [Издадете първата фактура](03-documents.md)

02-dashboard.md

@@ -0,0 +1,62 @@
+# Табло (Dashboard)
+
+Таблото е началната страница след вход в системата. Тук виждате обобщена информация за вашия бизнес.
+
+## Статистики
+
+### Приходи
+
+- **Този месец** - общо приходи за текущия месец
+- **Миналия месец** - приходи за предходния месец
+- **Тази година** - общо приходи от началото на годината
+
+![Статистики приходи](images/dashboard-stats.png)
+
+### Брой документи
+
+- Издадени фактури
+- Платени фактури
+- Неплатени фактури
+
+## Последни документи
+
+Таблица с последните 10 издадени документа:
+
+| Колона | Описание |
+|--------|----------|
+| Номер | Номер на документа |
+| Тип | Фактура, Проформа, Кредитно известие |
+| Клиент | Име на клиента |
+| Сума | Обща сума с ДДС |
+| Статус | Чернова, Финализиран, Платен, Анулиран |
+| Дата | Дата на издаване |
+
+## Графики
+
+### Месечни приходи
+
+Графика показваща приходите по месеци за последните 12 месеца.
+
+![Графика приходи](images/dashboard-chart.png)
+
+### Разпределение по клиенти
+
+Кръгова диаграма с топ 5 клиенти по приходи.
+
+## Бързи действия
+
+От таблото можете бързо да:
+
+- **Нова фактура** - създаване на нова фактура
+- **Нов клиент** - добавяне на клиент
+- **Справки** - преглед на отчети
+
+## Филтриране по период
+
+Използвайте падащото меню за избор на период:
+
+- Този месец
+- Миналия месец
+- Това тримесечие
+- Тази година
+- Персонализиран период

03-documents.md

@@ -0,0 +1,155 @@
+# Документи
+
+Системата поддържа следните типове документи:
+
+- **Фактура** - данъчен документ за продажба
+- **Проформа фактура** - предварителен документ (не е данъчен)
+- **Кредитно известие** - документ за корекция/връщане
+
+## Списък с документи
+
+### Преглед
+
+Страницата **Документи** показва всички издадени документи.
+
+![Списък документи](images/documents-list.png)
+
+### Филтри
+
+Филтрирайте документите по:
+
+- **Тип** - Фактура, Проформа, Кредитно известие
+- **Статус** - Чернова, Финализиран, Платен, Анулиран
+- **Период** - От дата / До дата
+- **Клиент** - търсене по име
+
+### Търсене
+
+Използвайте полето за търсене за бързо намиране по:
+- Номер на документ
+- Име на клиент
+- Сума
+
+## Създаване на нов документ
+
+1. Натиснете бутона **+ Нов документ**
+2. Изберете тип документ
+3. Попълнете данните
+
+### Основни данни
+
+| Поле | Описание |
+|------|----------|
+| Тип документ | Фактура, Проформа, Кредитно известие |
+| Клиент | Изберете от списъка или създайте нов |
+| Дата на издаване | Автоматично се попълва с днешна дата |
+| Дата на данъчно събитие | За фактури - датата на доставка |
+| Падеж | Краен срок за плащане |
+| Валута | BGN, EUR, USD и др. |
+
+![Нов документ](images/document-new.png)
+
+### Добавяне на артикули
+
+1. Натиснете **+ Добави артикул**
+2. Изберете артикул от каталога или въведете ръчно
+3. Посочете:
+   - Количество
+   - Единична цена
+   - ДДС ставка (20%, 9%, 0%)
+
+![Артикули в документ](images/document-items.png)
+
+### Освобождаване от ДДС
+
+За доставки без ДДС изберете основание:
+
+- **Вътреобщностна доставка (ВОД)** - чл. 53 ЗДДС
+- **Износ** - чл. 28 ЗДДС
+- **Освободена доставка** - чл. 39 ЗДДС
+
+### Бележки
+
+Добавете допълнителни бележки, които ще се покажат във фактурата.
+
+## Статуси на документите
+
+| Статус | Описание |
+|--------|----------|
+| **Чернова** | Документът може да се редактира |
+| **Финализиран** | Документът е издаден, не може да се редактира |
+| **Платен** | Фактурата е платена |
+| **Анулиран** | Документът е анулиран |
+
+## Действия с документи
+
+### Финализиране
+
+1. Отворете документа
+2. Прегледайте данните
+3. Натиснете **Финализирай**
+
+⚠️ **Важно:** След финализиране документът не може да се редактира!
+
+### Изпращане по имейл
+
+1. Отворете финализиран документ
+2. Натиснете **Изпрати по имейл**
+3. Въведете имейл адрес (или използвайте този на клиента)
+4. Добавете съобщение (опционално)
+5. Натиснете **Изпрати**
+
+![Изпращане по имейл](images/document-email.png)
+
+### Експорт в PDF
+
+1. Отворете документа
+2. Натиснете **PDF** или **Изтегли PDF**
+3. Файлът ще се изтегли автоматично
+
+### Експорт в UBL XML
+
+За електронно фактуриране:
+
+1. Отворете документа
+2. Натиснете **UBL XML**
+3. Изтеглете XML файла
+
+### Копиране на документ
+
+За създаване на подобен документ:
+
+1. Отворете документа
+2. Натиснете **Копирай**
+3. Редактирайте новия документ
+4. Запазете
+
+### Анулиране
+
+За анулиране на финализиран документ:
+
+1. Отворете документа
+2. Натиснете **Анулирай**
+3. Въведете причина за анулиране
+4. Потвърдете
+
+⚠️ **Важно:** Анулираните документи се запазват в системата за одит.
+
+## История на промените
+
+Всеки документ има история на промените:
+
+- Кой е направил промяната
+- Кога
+- Какво е променено
+- IP адрес
+
+![История на промените](images/document-history.png)
+
+## Печат
+
+За печат на документ:
+
+1. Отворете документа
+2. Натиснете **Печат** или използвайте Ctrl+P
+3. Изберете принтер и настройки

04-clients.md

@@ -0,0 +1,119 @@
+# Клиенти
+
+Управлението на клиенти ви позволява да поддържате база данни с всички ваши контрагенти.
+
+## Списък с клиенти
+
+### Преглед
+
+Страницата **Клиенти** показва всички регистрирани клиенти.
+
+![Списък клиенти](images/clients-list.png)
+
+### Информация в списъка
+
+| Колона | Описание |
+|--------|----------|
+| Име | Наименование на клиента |
+| ЕИК | Единен идентификационен код |
+| ДДС номер | Номер по ДДС (ако има) |
+| Държава | Код на държавата |
+| Имейл | Имейл за контакт |
+| Телефон | Телефон за контакт |
+
+### Търсене и филтриране
+
+- Търсене по име, ЕИК или ДДС номер
+- Филтър по държава
+- Филтър по статус (EU/Non-EU)
+
+## Добавяне на нов клиент
+
+### Ръчно въвеждане
+
+1. Натиснете **+ Нов клиент**
+2. Попълнете данните:
+
+| Поле | Задължително | Описание |
+|------|-------------|----------|
+| Име | Да | Пълно наименование |
+| ЕИК | Не | За български фирми |
+| ДДС номер | Не | С код на държава (BG, DE, etc.) |
+| Адрес | Да | Пълен адрес |
+| Град | Да | Населено място |
+| Пощенски код | Не | Пощенски код |
+| Държава | Да | Изберете от списъка |
+| Имейл | Не | За изпращане на фактури |
+| Телефон | Не | За контакт |
+| МОЛ | Не | Материално отговорно лице |
+
+![Нов клиент](images/client-new.png)
+
+### Импорт от VIES
+
+За EU клиенти можете автоматично да импортирате данни от VIES:
+
+1. Натиснете **+ Нов клиент**
+2. Въведете ДДС номера (напр. DE123456789)
+3. Натиснете **Провери в VIES**
+4. Ако номерът е валиден, данните ще се попълнят автоматично
+5. Запазете клиента
+
+![VIES импорт](images/client-vies.png)
+
+### Валидация на ДДС номер
+
+Системата автоматично проверява:
+
+- ✅ **Валиден** - номерът е активен в VIES
+- ❌ **Невалиден** - номерът не е намерен или е неактивен
+- ⚠️ **Грешка** - VIES услугата не е достъпна
+
+## Редактиране на клиент
+
+1. Кликнете върху клиента в списъка
+2. Редактирайте данните
+3. Натиснете **Запази**
+
+## Изтриване на клиент
+
+⚠️ **Внимание:** Клиент с издадени документи не може да бъде изтрит!
+
+1. Отворете клиента
+2. Натиснете **Изтрий**
+3. Потвърдете действието
+
+## Документи на клиент
+
+От страницата на клиента можете да видите:
+
+- Всички издадени документи
+- Обща сума на фактурите
+- Неплатени фактури
+
+## Типове клиенти
+
+### Български клиенти
+
+- Изисква се ЕИК
+- ДДС номер започва с BG
+
+### EU клиенти
+
+- ДДС номер от друга EU държава
+- Възможност за ВОД (без ДДС)
+- VIES валидация
+
+### Клиенти извън EU
+
+- Без ДДС валидация
+- Възможност за износ (без ДДС)
+
+## Експорт на клиенти
+
+За експорт на списъка с клиенти:
+
+1. Отидете в **Клиенти**
+2. Приложете желаните филтри
+3. Натиснете **Експорт**
+4. Изберете формат (CSV, Excel)

05-items.md

@@ -0,0 +1,120 @@
+# Артикули
+
+Артикулите са продукти или услуги, които продавате. Създаването на каталог с артикули улеснява издаването на фактури.
+
+## Списък с артикули
+
+### Преглед
+
+Страницата **Артикули** показва всички регистрирани продукти и услуги.
+
+![Списък артикули](images/items-list.png)
+
+### Информация в списъка
+
+| Колона | Описание |
+|--------|----------|
+| Име | Наименование на артикула |
+| Описание | Кратко описание |
+| Цена | Единична цена |
+| Мерна единица | бр., кг, час, м² и др. |
+| ДДС | Ставка по подразбиране |
+
+## Добавяне на нов артикул
+
+1. Натиснете **+ Нов артикул**
+2. Попълнете данните:
+
+| Поле | Задължително | Описание |
+|------|-------------|----------|
+| Име | Да | Наименование |
+| Описание | Не | Подробно описание |
+| Единична цена | Да | Цена без ДДС |
+| Мерна единица | Да | Изберете от списъка |
+| ДДС ставка | Да | 20%, 9%, 0% |
+
+![Нов артикул](images/item-new.png)
+
+### Мерни единици
+
+Налични мерни единици:
+
+| Код | Описание |
+|-----|----------|
+| бр. | Брой |
+| кг | Килограм |
+| л | Литър |
+| м | Метър |
+| м² | Квадратен метър |
+| м³ | Кубичен метър |
+| час | Час |
+| ден | Ден |
+| месец | Месец |
+| комплект | Комплект |
+| услуга | Услуга |
+
+### ДДС ставки
+
+| Ставка | Приложение |
+|--------|------------|
+| 20% | Стандартна ставка |
+| 9% | Хотелиерство, ресторантьорство, книги |
+| 0% | Износ, ВОД, освободени доставки |
+
+## Редактиране на артикул
+
+1. Кликнете върху артикула в списъка
+2. Редактирайте данните
+3. Натиснете **Запази**
+
+## Изтриване на артикул
+
+1. Отворете артикула
+2. Натиснете **Изтрий**
+3. Потвърдете действието
+
+⚠️ **Забележка:** Артикули, използвани в документи, запазват историческите си данни.
+
+## Използване на артикули
+
+### При създаване на документ
+
+1. В секцията с артикули натиснете **+ Добави артикул**
+2. Започнете да пишете името на артикула
+3. Изберете от падащия списък
+4. Количеството и цената ще се попълнят автоматично
+5. Редактирайте при нужда
+
+![Избор на артикул](images/item-select.png)
+
+### Ръчно въвеждане
+
+Можете да въведете артикул ръчно без да го записвате в каталога:
+
+1. В полето за артикул напишете произволен текст
+2. Попълнете цена, количество и ДДС
+3. Артикулът ще се добави само към този документ
+
+## Категории артикули
+
+За по-добра организация можете да групирате артикулите:
+
+- Продукти
+- Услуги
+- Консултации
+- Абонаменти
+
+## Импорт на артикули
+
+За масово добавяне на артикули:
+
+1. Подгответе CSV файл с колони: Име, Описание, Цена, Мерна единица, ДДС
+2. Отидете в **Артикули** → **Импорт**
+3. Качете файла
+4. Прегледайте и потвърдете
+
+## Експорт на артикули
+
+1. Отидете в **Артикули**
+2. Натиснете **Експорт**
+3. Изберете формат (CSV, Excel)

06-reports.md

@@ -0,0 +1,149 @@
+# Справки
+
+Модулът за справки предоставя финансови отчети и анализи.
+
+## Достъп до справките
+
+Отидете в **Справки** от страничното меню.
+
+![Справки](images/reports-main.png)
+
+## Налични справки
+
+### Дневник на продажбите
+
+Списък на всички издадени фактури за избран период.
+
+**Съдържа:**
+- Номер и дата на фактура
+- Клиент
+- Данъчна основа
+- ДДС
+- Обща сума
+
+**Филтри:**
+- Период (от-до)
+- Тип документ
+- Статус
+
+![Дневник продажби](images/report-sales.png)
+
+### Справка по клиенти
+
+Обобщение на продажбите по клиенти.
+
+**Съдържа:**
+- Име на клиент
+- Брой фактури
+- Обща сума
+- Неплатено
+
+**Сортиране:**
+- По име
+- По сума (низходящо)
+- По брой фактури
+
+### Справка по артикули
+
+Най-продавани продукти и услуги.
+
+**Съдържа:**
+- Име на артикул
+- Продадено количество
+- Обща стойност
+- Среден марж
+
+### ДДС справка
+
+Обобщение за ДДС деклариране.
+
+**Съдържа:**
+- Данъчна основа 20%
+- ДДС 20%
+- Данъчна основа 9%
+- ДДС 9%
+- Данъчна основа 0%
+- Общо ДДС за внасяне
+
+![ДДС справка](images/report-vat.png)
+
+### Справка за ВОД
+
+Вътреобщностни доставки за избран период.
+
+**Съдържа:**
+- Клиент
+- Държава
+- ДДС номер
+- Данъчна основа
+
+### Приходи по месеци
+
+Графика и таблица с месечни приходи.
+
+**Показва:**
+- Приходи по месеци
+- Сравнение с предходна година
+- Тенденция
+
+![Приходи по месеци](images/report-monthly.png)
+
+## Филтриране
+
+Всички справки поддържат филтриране по:
+
+### Период
+
+- Този месец
+- Миналия месец
+- Това тримесечие
+- Миналото тримесечие
+- Тази година
+- Миналата година
+- Персонализиран период
+
+### Други филтри
+
+- Тип документ
+- Клиент
+- Статус на плащане
+
+## Експорт на справки
+
+Всяка справка може да бъде експортирана:
+
+### PDF
+
+1. Отворете справката
+2. Приложете филтри
+3. Натиснете **Експорт PDF**
+4. Файлът ще се изтегли
+
+### Excel
+
+1. Отворете справката
+2. Приложете филтри
+3. Натиснете **Експорт Excel**
+4. Файлът ще се изтегли
+
+### CSV
+
+1. Отворете справката
+2. Натиснете **Експорт CSV**
+
+## Печат на справки
+
+1. Отворете желаната справка
+2. Приложете филтри
+3. Натиснете **Печат** или Ctrl+P
+4. Изберете принтер
+
+## Автоматични отчети
+
+Можете да настроите автоматично изпращане на справки по имейл:
+
+1. Отидете в **Настройки** → **Автоматични отчети**
+2. Изберете справка
+3. Задайте честота (ежедневно, седмично, месечно)
+4. Въведете имейл адреси
+5. Запазете

07-bank-transactions.md

@@ -0,0 +1,115 @@
+# Банкови транзакции
+
+Модулът за банкови транзакции позволява проследяване на плащания и свързването им с фактури.
+
+## Преглед на транзакции
+
+Отидете в **Банкови транзакции** от страничното меню.
+
+![Банкови транзакции](images/bank-transactions.png)
+
+## Списък с транзакции
+
+### Информация
+
+| Колона | Описание |
+|--------|----------|
+| Дата | Дата на транзакцията |
+| Описание | Основание/описание |
+| Сума | Сума на транзакцията |
+| Тип | Входяща/Изходяща |
+| Сметка | Банкова сметка |
+| Статус | Свързана/Несвързана |
+
+### Филтри
+
+- **Период** - от дата до дата
+- **Банкова сметка** - изберете сметка
+- **Тип** - входящи/изходящи
+- **Статус** - свързани/несвързани
+
+## Добавяне на транзакция
+
+### Ръчно въвеждане
+
+1. Натиснете **+ Нова транзакция**
+2. Попълнете:
+   - Дата
+   - Описание
+   - Сума
+   - Банкова сметка
+3. Запазете
+
+![Нова транзакция](images/transaction-new.png)
+
+### Импорт от банка
+
+1. Изтеглете извлечение от вашата банка (CSV или XML формат)
+2. Натиснете **Импорт**
+3. Качете файла
+4. Прегледайте транзакциите
+5. Потвърдете импорта
+
+## Свързване с фактури
+
+### Автоматично свързване
+
+Системата автоматично предлага съвпадения на база:
+- Сума на фактурата
+- Име на клиента в описанието
+- Номер на фактура в основанието
+
+### Ръчно свързване
+
+1. Отворете транзакция
+2. Натиснете **Свържи с фактура**
+3. Търсете по номер или клиент
+4. Изберете фактура
+5. Потвърдете
+
+![Свързване с фактура](images/transaction-link.png)
+
+### Частично плащане
+
+Ако плащането е частично:
+
+1. Свържете транзакцията с фактурата
+2. Системата ще отбележи частично плащане
+3. Оставащата сума ще се показва като дължима
+
+## Статуси на транзакции
+
+| Статус | Описание |
+|--------|----------|
+| **Несвързана** | Транзакцията не е свързана с документ |
+| **Свързана** | Свързана с една или повече фактури |
+| **Частично** | Частично плащане по фактура |
+
+## Справки за транзакции
+
+### Баланс по сметки
+
+Показва текущия баланс на всяка банкова сметка.
+
+### Несвързани транзакции
+
+Списък на транзакции, които все още не са свързани с фактури.
+
+### Просрочени плащания
+
+Фактури с изтекъл срок на плащане без получено плащане.
+
+## Известия
+
+Системата може да ви уведомява за:
+
+- Нови транзакции (при импорт)
+- Автоматично намерени съвпадения
+- Просрочени плащания
+
+## Експорт
+
+Експортирайте транзакциите в:
+
+- **CSV** - за обработка в Excel
+- **PDF** - за справки и архив

08-settings.md

@@ -0,0 +1,198 @@
+# Настройки
+
+Страницата с настройки ви позволява да конфигурирате системата според нуждите на вашия бизнес.
+
+## Достъп до настройките
+
+Кликнете върху **Настройки** в страничното меню.
+
+![Настройки](images/settings-main.png)
+
+## Фирмени данни
+
+### Основна информация
+
+| Поле | Описание |
+|------|----------|
+| Име на фирмата | Официално наименование |
+| ЕИК | Единен идентификационен код |
+| ДДС номер | Номер по ЗДДС (ако е приложимо) |
+| Адрес | Седалище |
+| Град | Населено място |
+| Пощенски код | Пощенски код |
+| Държава | Държава на регистрация |
+
+### Данни за контакт
+
+| Поле | Описание |
+|------|----------|
+| Телефон | Телефон за контакт |
+| Имейл | Служебен имейл |
+| Уебсайт | Адрес на уебсайт |
+| МОЛ | Материално отговорно лице |
+
+### Лого
+
+1. Натиснете **Качи лого**
+2. Изберете файл (PNG, JPG, максимум 2MB)
+3. Логото ще се показва във фактурите
+
+![Фирмени данни](images/settings-company.png)
+
+## Банкови сметки
+
+### Списък със сметки
+
+Преглед на всички добавени банкови сметки.
+
+### Добавяне на сметка
+
+1. Натиснете **+ Добави сметка**
+2. Попълнете:
+   - Име на банката
+   - IBAN
+   - BIC/SWIFT
+   - Валута
+3. Запазете
+
+### Сметка по подразбиране
+
+Маркирайте една сметка като "по подразбиране" - тя ще се използва автоматично при нови фактури.
+
+![Банкови сметки](images/settings-bank.png)
+
+## Методи на плащане
+
+### Налични методи
+
+- Банков превод
+- В брой
+- Карта
+- PayPal
+- Други
+
+### Добавяне на метод
+
+1. Натиснете **+ Добави метод**
+2. Въведете име
+3. Добавете описание (опционално)
+4. Запазете
+
+## Номерация на документи
+
+### Настройки за номерация
+
+| Поле | Описание |
+|------|----------|
+| Префикс | Текст преди номера (напр. "INV-") |
+| Следващ номер | Следващият пореден номер |
+| Нулиране | Годишно или никога |
+| Формат | Брой цифри (напр. 0001) |
+
+### Отделна номерация
+
+Можете да имате отделна номерация за:
+- Фактури
+- Проформа фактури
+- Кредитни известия
+
+![Номерация](images/settings-numbering.png)
+
+## Потребители
+
+### Списък с потребители
+
+Всички потребители с достъп до системата.
+
+### Роли
+
+| Роля | Права |
+|------|-------|
+| **Администратор** | Пълен достъп |
+| **Счетоводител** | Документи, клиенти, справки |
+| **Оператор** | Само преглед и издаване на документи |
+
+### Добавяне на потребител
+
+1. Натиснете **+ Покани потребител**
+2. Въведете имейл адрес
+3. Изберете роля
+4. Натиснете **Изпрати покана**
+
+Потребителят ще получи имейл с линк за регистрация.
+
+![Потребители](images/settings-users.png)
+
+### Редактиране на потребител
+
+1. Кликнете върху потребителя
+2. Променете ролята или данните
+3. Запазете
+
+### Деактивиране на потребител
+
+1. Отворете потребителя
+2. Натиснете **Деактивирай**
+3. Потвърдете
+
+## Имейл шаблони
+
+### Шаблон за изпращане на фактура
+
+Редактирайте текста на имейла при изпращане на фактури:
+
+- **Тема** - тема на имейла
+- **Съдържание** - текст на съобщението
+
+### Променливи
+
+Използвайте променливи в шаблона:
+
+| Променлива | Описание |
+|------------|----------|
+| `{client_name}` | Име на клиента |
+| `{document_number}` | Номер на документа |
+| `{document_date}` | Дата на документа |
+| `{total_amount}` | Обща сума |
+| `{due_date}` | Падеж |
+
+## Валути
+
+### Основна валута
+
+Изберете основната валута за вашите документи (BGN по подразбиране).
+
+### Допълнителни валути
+
+Добавете валути за фактуриране на чуждестранни клиенти:
+
+- EUR
+- USD
+- GBP
+- CHF
+
+### Курсове
+
+Курсовете се обновяват автоматично от БНБ.
+
+## Резервни копия
+
+### Автоматични резервни копия
+
+Системата създава автоматични резервни копия ежедневно.
+
+### Ръчен експорт
+
+1. Отидете в **Настройки** → **Резервни копия**
+2. Натиснете **Създай резервно копие**
+3. Изтеглете файла
+
+## Интеграции
+
+### Свързване с външни системи
+
+- Счетоводен софтуер
+- CRM системи
+- Банкови API
+
+За помощ с интеграциите се свържете с поддръжката.

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 кода
+- Добавите лого до кода
+- Изберете размер на кода

10-faq.md

@@ -0,0 +1,168 @@
+# Често задавани въпроси (FAQ)
+
+## Общи въпроси
+
+### Какво е Invoicing.top?
+
+Invoicing.top е облачна система за издаване на фактури, проформи и кредитни известия. Достъпна е от всяко устройство с интернет.
+
+### Безплатна ли е системата?
+
+Системата предлага безплатен план с основни функции. За разширени възможности има платени планове.
+
+### Как да се регистрирам?
+
+1. Отворете [invoicing.top/register](https://invoicing.top/register)
+2. Въведете имейл и парола
+3. Потвърдете имейла си
+4. Настройте фирмата си
+
+### Сигурни ли са данните ми?
+
+Да. Използваме криптиране на данните, редовни резервни копия и съвременни мерки за сигурност.
+
+---
+
+## Документи
+
+### Как да издам фактура?
+
+1. Отидете в **Документи**
+2. Натиснете **+ Нов документ**
+3. Изберете тип "Фактура"
+4. Попълнете данните и артикулите
+5. Запазете и финализирайте
+
+### Мога ли да редактирам финализирана фактура?
+
+Не. Финализираните фактури не могат да се редактират. Ако има грешка:
+- Анулирайте фактурата
+- Издайте нова с правилните данни
+- Или издайте кредитно известие
+
+### Как да анулирам фактура?
+
+1. Отворете фактурата
+2. Натиснете **Анулирай**
+3. Въведете причина
+4. Потвърдете
+
+### Какъв формат има PDF фактурата?
+
+PDF фактурите са в стандартен A4 формат с:
+- Лого на фирмата
+- Данни на издател и получател
+- Списък с артикули
+- Суми и ДДС
+- Банкови данни
+- QR код за валидация
+
+### Какво е UBL XML?
+
+UBL (Universal Business Language) е стандартен XML формат за електронни фактури, използван в целия ЕС.
+
+---
+
+## Клиенти
+
+### Как да добавя клиент?
+
+1. Отидете в **Клиенти**
+2. Натиснете **+ Нов клиент**
+3. Попълнете данните
+4. Запазете
+
+### Какво е VIES?
+
+VIES е система на ЕС за проверка на ДДС номера. Позволява да проверите дали ДДС номер е валиден.
+
+### Защо не мога да изтрия клиент?
+
+Клиенти с издадени документи не могат да бъдат изтрити заради счетоводни изисквания.
+
+---
+
+## ДДС и данъци
+
+### Кога да използвам 0% ДДС?
+
+- **Вътреобщностна доставка (ВОД)** - продажба на регистрирана по ДДС фирма в друга EU държава
+- **Износ** - продажба извън ЕС
+- **Освободени доставки** - специфични категории по ЗДДС
+
+### Какво е ВОД?
+
+Вътреобщностна доставка - продажба на стоки/услуги на фирма, регистрирана по ДДС в друга страна от ЕС. Не се начислява ДДС, но се изисква валиден ДДС номер на клиента.
+
+### Как да издам фактура за ВОД?
+
+1. Уверете се, че клиентът има валиден EU ДДС номер
+2. Изберете 0% ДДС
+3. Изберете основание "Чл. 53 ЗДДС - ВОД"
+
+---
+
+## Технически въпроси
+
+### Забравих паролата си
+
+1. На страницата за вход кликнете **Забравена парола**
+2. Въведете имейла си
+3. Проверете пощата за линк за възстановяване
+4. Задайте нова парола
+
+### Не получавам имейли от системата
+
+Проверете:
+- Папка "Спам" / "Нежелана поща"
+- Дали имейл адресът е правилен
+- Настройките на имейл филтрите
+
+### Мога ли да използвам системата от телефон?
+
+Да. Системата е адаптивна и работи на всички устройства - компютър, таблет и телефон.
+
+### Какви браузъри се поддържат?
+
+- Google Chrome (препоръчително)
+- Mozilla Firefox
+- Microsoft Edge
+- Safari
+
+---
+
+## Плащания и абонамент
+
+### Как да платя за абонамент?
+
+1. Отидете в **Настройки** → **Абонамент**
+2. Изберете план
+3. Платете с карта или банков превод
+
+### Мога ли да анулирам абонамента?
+
+Да. Абонаментът може да се анулира по всяко време. Ще имате достъп до платените функции до края на периода.
+
+### Какво става с данните ми ако спра абонамента?
+
+Данните ви се запазват. При безплатен план имате достъп само до основните функции.
+
+---
+
+## Поддръжка
+
+### Как да се свържа с поддръжката?
+
+- Имейл: support@invoicing.top
+- Чрез системата: **Помощ** → **Контакт**
+
+### Работно време на поддръжката
+
+Понеделник - Петък: 9:00 - 18:00
+Събота - Неделя: Затворено
+
+### Къде мога да намеря повече информация?
+
+- Тази документация
+- Блог с новини и съвети
+- Видео уроци

README.md

@@ -1,12 +1,31 @@
 # Invoicing.top - Потребителска документация
 
+Добре дошли в документацията на Invoicing.top - модерна облачна система за фактуриране.
+
 ## Съдържание
 
 ### Сигурност
 - [security.md](security.md) - Защо Invoicing.top е най-сигурната платформа за фактуриране
+- [bank-certificate-guide.md](bank-certificate-guide.md) - Как да настроите банков сертификат
 
 ### Ръководства
-- [bank-certificate-guide.md](bank-certificate-guide.md) - Как да настроите банков сертификат
+1. [Първи стъпки](01-getting-started.md)
+2. [Табло (Dashboard)](02-dashboard.md)
+3. [Документи](03-documents.md)
+   - Фактури
+   - Проформа фактури
+   - Кредитни известия
+4. [Клиенти](04-clients.md)
+5. [Артикули](05-items.md)
+6. [Справки](06-reports.md)
+7. [Банкови транзакции](07-bank-transactions.md)
+8. [Настройки](08-settings.md)
+   - Фирмени данни
+   - Банкови сметки
+   - Методи на плащане
+   - Потребители
+9. [Валидатор на документи](09-document-validator.md)
+10. [Често задавани въпроси](10-faq.md)
 
 ---
 
@@ -19,7 +38,14 @@ Invoicing.top е модерна платформа за онлайн факту
 - **Интеграции** - UBL XML експорт за ERP системи, Wise интеграция
 - **Съответствие** - Българско законодателство, VIES проверки
 
-## Контакт
+## Бърз старт
+
+1. **Регистрация** - Създайте акаунт на [invoicing.top/register](https://invoicing.top/register)
+2. **Настройка на фирма** - Въведете данните на вашата фирма
+3. **Добавяне на клиенти** - Създайте първите си клиенти
+4. **Издаване на фактура** - Издайте първата си фактура
+
+## Поддръжка
 
 - Уебсайт: https://invoicing.top
 - Поддръжка: support@invoicing.top