# Инвентар на системата ZapaziMe - Пълен преглед на внедряването
**Създадено:** 27 юни 2026
**Версия:** 1.0
**Система:** Платформа за управление на резервации и бронирования на базата на Laravel
---
## 📋 Изпълнително резюме
ZapaziMe е всеобхватна система за управление на резервации и бронирования, изградена на Laravel 9.x с Filament 3.x за администраторския панел. Системата поддържа множество типове резервации (наеми, места, услуги/поръчки), мултитенант архитектура, мултиезична поддръжка и широка интеграция на плащания.
### Основни възможности
- **Система за резервации от множество типове**: Наеми, места в обекти и поръчки за услуги
- **Интеграция на плащания**: MyPOS, Stripe, PayPal, в брой, банкови преводи
- **Фискално управление**: Интеграция с фискални устройства, генериране на касови бележки
- **Система за известия**: Имейл, SMS (Twilio), вградени известия в приложението
- **Мултитенант**: Изолация на компании и работни пространства
- **Мултиезичност**: Пълна поддръжка за преводи с 10+ езика
- **Клиентски портал**: Специализирано клиентско табло за управление на резервации
- **Администраторски панел**: Всеобхватен администраторски интерфейс на базата на Filament
- **База знания**: Вградена система за документация
- **AI интеграция**: Двигател за препоръки и асистент с изкуствен интелект
---
## 🏗️ Архитектура на системата
### Технологичен стек
- **Бекенд**: Laravel 9.x (PHP 8.x)
- **Администраторски панел**: Filament 3.x
- **Фронтенд**: Blade шаблони с TailwindCSS, Vue.js компоненти
- **База данни**: MySQL 8.0+
- **Опашка**: Redis/Database
- **Кеш**: Redis/Database
- **Съхранение на файлове**: Локално/S3 с поддръжка на частен диск
- **Порти за плащания**: MyPOS, Stripe, PayPal
- **SMS доставчик**: Twilio (конфигурируем)
- **OCR**: Tesseract/Google Cloud Vision (за сканиране на лични карти)
### Основни директории
```
app/
├── Filament/ # Ресурси и компоненти за администраторския панел
├── Http/Controllers/ # Уеб и API контролери
├── Models/ # Eloquent модели (88 модели)
├── Services/ # Сервизи за бизнес логика (25 сервиза)
├── Mailables/ # Имейл шаблони (23 mailables)
├── Notifications/ # Класове за известия (57 известия)
├── Jobs/ # Задачи за опашка
```
---
## 📊 Модели на данни
### Основни модели (88 общо)
- **User**: Потребители на системата (администратори, персонал, клиенти)
- **Company**: Компании/организации (мултитенант)
- **Workspace**: Работни пространства в компаниите
- **Venue**: Обекти (хотели, ресторанти, събитийни зали и др.)
- **VenueObject**: Обекти за наем (стаи, апартаменти, оборудване)
- **VenueSpot**: Места за краткосрочен наем (маси, легла, паркоместа)
- **Service**: Услуги (масажи, процедури, консултации)
- **Booking**: Резервации (централен модел за всички типове)
- **BookingGuest**: Гости на резервации
- **BookingService**: Услуги към резервации
- **BookingPackage**: Пакети към резервации
- **PaymentTransaction**: Транзакции за плащания
- **FiscalReceipt**: Фискални касови бележки
- **Notification**: Известия
- **KnowledgeBase**: Статии в базата знания
---
## 💳 Система за плащания
### Интегрирани порти
1. **MyPOS**: Български фискален терминал
- Поддръжка на карти и фискални бележки
- Интеграция с фискални устройства
2. **Stripe**: Международни карти
- Кредитни и дебитни карти
- Apple Pay, Google Pay
3. **PayPal**: Онлайн плащания
- PayPal баланс
- Свързани карти
4. **В брой**: Плащане на място
- Регистриране на парични плащания
5. **Банков превод**: Банкови преводи
- IBAN генериране
- Следене на статус
### Фискална интеграция
- Автоматично генериране на фискални бележки
- Интеграция с български фискални устройства
- Съответствие с нормативните изисквания
---
## 🔔 Система за известия
### Канали за известия
- **Имейл**: 23 типа имейл известия
- Потвърждения за резервации
- Напомняния за плащания
- Известия за промени
- **SMS**: 15 типа SMS известия
- Кратки напомняния
- Кодове за потвърждение
- Спешни известия
- **В приложението**: 57 типа вградени известия
- Известия в реално време
- История на известията
- Предпочитания за потребителите
---
## 🌍 Мултиезична поддръжка
### Поддържани езици (10+)
- Български (bg) - Основен
- Английски (en)
- Немски (de)
- Френски (fr)
- Испански (es)
- Италиански (it)
- Руски (ru)
- Румънски (ro)
- Гръцки (el)
- Турски (tr)
### Превод на интерфейса
- Всички текстове в интерфейса са преведени
- Поддръжка на RTL езици
- Локализация на дати и валути
---
## 👥 Роли и права
### Роли в системата
1. **Super Admin**: Пълен достъп до всичко
2. **Company Admin**: Администратор на компания
3. **Staff**: Персонал с ограничен достъп
4. **Client**: Клиент с достъп до собствени резервации
### Управление на права
- Базирано на роли
- Фини права за действия
- Изолация на данни по компании
---
## 🔒 Сигурност
### Мерки за сигурност
- Хеширане на пароли с bcrypt
- Шифроване на чувствителни данни (GDPR)
- CSRF защита
- XSS защита
- SQL инжекцион защита
- Rate limiting
- Двустепенна автентикация (опционално)
### GDPR съответствие
- Право на изтриване на данни
- Право на експорт на данни
- Съгласие за обработка на данни
- Логове на достъп
---
## 📱 Клиентски портал
### Функционалности
- Преглед на резервации
- Създаване на нови резервации
- Плащане онлайн
- Управление на профил
- История на транзакции
- Известия
---
## 🎯 Администраторски панел (Filament)
### Ресурси
- Управление на потребители
- Управление на компании
- Управление на обекти
- Управление на резервации
- Управление на плащания
- Управление на известия
- Управление на базата знания
- Анализи и отчети
---
## 📈 Анализи и отчети
### Достъпни отчети
- Отчети за резервации по период
- Финансови отчети
- Отчети за използване на обекти
- Отчети за услуги
- Отчети за плащания
- Отчети за клиентска активност
---
## 🔧 Технически спецификации
### Изисквания към сървъра
- PHP 8.x
- MySQL 8.0+
- Redis (опционално)
- SSL сертификат
- Минимум 2GB RAM
### Деплоймент
- Поддръжка на CI/CD
- Автоматизирани миграции
- Опашки за задачи
- Кеширане
- Логване на грешки
---
## 📝 Документация
### Налична документация
- Ръководство за инсталиране
- Ръководство за потребителя
- API документация
- Ръководство за разработчици
- Често задавани въпроси
---
## 🚀 Будещи подобрения
### Планирани функции
- Мобилно приложение за iOS и Android
- Разширена AI аналитика
- Интеграция с допълнителни порти за плащания
- Подобрена система за лоялност
- Интеграция с календари (Google, Outlook)
- Чатбот за поддръжка
---
*Този документ е създаден автоматично и се актуализира периодично.*