167 lines
7.1 KiB
Markdown
167 lines
7.1 KiB
Markdown
# 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
|
||
|