This commit is contained in:
2025-10-27 23:39:55 +03:00
parent 5c11d21290
commit c53f174959
5 changed files with 703 additions and 48 deletions

166
lzipus/README.md Normal file
View File

@@ -0,0 +1,166 @@
# Izipus - SMS Support Templates Manager
**Version:** 0.4.0
**Type:** Browser Extension (Firefox/Chrome)
## 🎯 Описание
Izipus - браузерное расширение для специалистов технической поддержки SMS/телеком-операторов. Упрощает работу с шаблонами ответов на типовые запросы клиентов и партнёров.
## ✨ Основные возможности
### Фаза 1 (v0.4.0) - ГОТОВО ✅
#### 📝 Управление шаблонами
- **Библиотека готовых шаблонов** на русском и английском языках
- **Создание пользовательских шаблонов** с RU/EN версиями
- **Редактирование встроенных шаблонов** с сохранением переопределений
- **Импорт/экспорт шаблонов** в JSON для обмена с коллегами
- **Поиск по шаблонам** по названию и содержимому
#### 💾 Синхронизация
- **Chrome Storage Sync API** - автоматическая синхронизация между устройствами
- **Автоматическая миграция** данных из localStorage
- **Fallback на localStorage** для локального тестирования
#### 🎨 Пользовательский интерфейс
- **Toast уведомления** при копировании в буфер обмена
- **Тёмная/светлая тема** с сохранением выбора
- **Организация по категориям** с возможностью сворачивания
- **Счётчик использования** для каждого шаблона
- **Адаптивный дизайн**
## 🚀 Установка
### Firefox
1. Скачайте расширение
2. Откройте `about:debugging#/runtime/this-firefox`
3. Нажмите "Загрузить временное дополнение"
4. Выберите файл `manifest.json`
### Chrome/Edge
1. Скачайте расширение
2. Откройте `chrome://extensions/`
3. Включите "Режим разработчика"
4. Нажмите "Загрузить распакованное расширение"
5. Выберите папку с расширением
## 📖 Использование
### Основные действия
1. **Копирование шаблона**: Нажмите кнопку RU или ENG рядом с нужным шаблоном
2. **Создание шаблона**: Нажмите кнопку "+" в заголовке
3. **Редактирование**: Нажмите иконку карандаша рядом с шаблоном
4. **Удаление**: Нажмите иконку корзины
5. **Поиск**: Используйте строку поиска в верхней части окна
### Импорт/Экспорт
**Экспорт:**
- Нажмите кнопку экспорта (📤)
- Файл сохранится как `izipus-templates-YYYY-MM-DD.json`
**Импорт:**
- Нажмите кнопку импорта (📥)
- Выберите JSON файл с шаблонами
- Дубликаты (по названию) будут автоматически пропущены
### Редактирование встроенных шаблонов
1. Нажмите кнопку редактирования (🖊️) на встроенном шаблоне
2. Выберите язык (OK - RU, Отмена - EN)
3. Введите новый текст
4. Изменения сохраняются автоматически
## 📂 Структура проекта
```
lzipus/
├── manifest.json # Конфигурация расширения
├── icons/ # Иконки расширения
│ ├── icon16.png
│ ├── icon48.png
│ └── icon128.png
└── src/
├── popup.html # Интерфейс расширения
├── popup.css # Стили
└── popup.js # Логика приложения
```
## 🔧 Технологии
- **Manifest V3** - современная версия API расширений
- **Chrome Storage Sync API** - синхронизация данных
- **Bootstrap 5.3.1** - UI компоненты
- **Font Awesome 6.1.2** - иконки
- **Vanilla JavaScript** - без фреймворков
## 📊 Хранение данных
Все данные хранятся в `chrome.storage.sync`:
- `templates` - пользовательские шаблоны
- `builtinOverrides` - переопределения встроенных шаблонов
- `usageStats` - статистика использования
- `theme` - выбранная тема
- `categoryStates` - состояния категорий (открыто/закрыто)
## 🗺️ Дорожная карта
### Фаза 2: Новая функциональность
- [ ] Система переменных в шаблонах (`{{client_name}}`, `{{date}}`)
- [ ] Контекстное меню для быстрого доступа
- [ ] История использования и статистика
- [ ] Мультиязычность (ES, DE, FR)
### Фаза 3: Интеграция
- [ ] Интеграция с CRM/тикет-системами (Zendesk, Jira)
- [ ] AI-ассистент для предложения шаблонов
- [ ] Командные возможности (облачное хранилище)
### Фаза 4: Качество
- [ ] Рефакторинг (модули, TypeScript)
- [ ] Unit и E2E тесты
- [ ] CI/CD pipeline
- [ ] Полная документация
## 🤝 Вклад в проект
Проект открыт для улучшений! Если у вас есть идеи или вы нашли баг:
1. Создайте issue на GitLab
2. Предложите pull request
3. Опишите изменения и их необходимость
## 📝 Changelog
### v0.4.0 (2025-10-26) - Фаза 1
- ✅ Toast уведомления при копировании
- ✅ Поиск по шаблонам
- ✅ Импорт/экспорт в JSON
- ✅ Счётчик использования шаблонов
- ✅ Миграция на chrome.storage.sync
- ✅ Редактирование встроенных шаблонов
- 🐛 Исправлена опечатка в HTML
### v0.3.1
- Базовая функциональность
- Встроенные шаблоны
- Пользовательские шаблоны
- Тёмная тема
## 📄 Лицензия
Проект распространяется "как есть" для внутреннего использования.
## 👤 Автор
**Dmitriy Gorshenin**
Email: dmitriy.gorshenin1@gmail.com
GitLab: https://git.gorshenin.info/Dgors03/Answer_Templates
---
Made with ❤️ for SMS Support Teams