QUVO — локальный прототип 0.4.0

Расширение поддерживает русский, английский, испанский, немецкий,
французский, португальский и казахский. Мастер установки — на английском.
Для проверки не нужны покупка, аккаунт, подписка или лицензионный ключ.
Нужен настольный Google Chrome 116 или новее.
Сборка устанавливается из папки и пока не опубликована в Chrome Web Store.

УСТАНОВКА В WINDOWS

1. Распакуйте Quvo-0.4.0-Windows.zip и запустите Quvo-Setup-0.4.0.exe.
2. Нажмите Prepare extension files — мастер подготовит постоянную папку:
   %LOCALAPPDATA%\Programs\Quvo\extension
   Права администратора не нужны.
3. Нажмите Open Chrome extensions или введите chrome://extensions в Chrome.
4. Включите Developer mode / «Режим разработчика» в правом верхнем углу.
5. Нажмите Load unpacked / «Загрузить распакованное расширение».
6. В мастере нажмите Copy folder path и вставьте путь в окно выбора папки.
   Выберите extension, непосредственно содержащую manifest.json.
7. Через значок пазла закрепите Quvo на панели Chrome. Нажмите его значок,
   чтобы открыть боковую панель. Из неё можно открыть полную вкладку.

Мастер подготавливает файлы, а подключение в Chrome выполняете вы.
EXE пока без цифровой подписи Windows. Папку extension нельзя удалять после
подключения. При обновлении используйте тот же путь и кнопку обновления
карточки расширения на chrome://extensions.

Если предпочитаете ZIP: распакуйте quvo-PROTOTYPE-0.4.0.zip в постоянную папку
Quvo\extension и выполните шаги 3–7. В исходниках папка extension уже готова.
ZIP расширения также подходит для настольного Chrome в macOS и Linux:
выберите постоянную распакованную папку на странице chrome://extensions.

ЯЗЫК, ФОРМАТ ЧИСЕЛ И ВАЛЮТА

По умолчанию выбран автоматический язык: расширение берёт первый
поддерживаемый язык из настроек браузера; если такого нет, использует
английский. В Settings / «Настройки» можно выбрать автоматический режим
или один из семи языков. Числа, даты, подсказки ввода, подписи предложения
и диалоги следуют выбранному языку. Ваши названия товаров, реквизиты,
контакты, единицы измерения, заметки и условия не переводятся.

Валюта по умолчанию выбирается отдельно: USD, EUR, GBP, CAD, AUD, KZT или RUB.
Для нового рабочего пространства исходная валюта — USD. Валюту предложения
выбирайте при его создании. Смена языка не меняет валюту и не пересчитывает
цены. Сохранённые предложения сохраняют исходные позиции, цены и суммы.

Опубликованный сайт помощи с видеоинструкциями на английском и русском:
https://quvo.q-eli.kz/#tutorial
Если сайт недоступен, эта текстовая инструкция по установке продолжает
работать. Сайт открывается по желанию; каталог и расчёт
работают локально без обращения к нему.

ПЕРЕНОС ИЗ ПРЕДЫДУЩЕЙ ВЕРСИИ

Если в прежнем прототипе есть свой каталог, настройки или история, сначала
экспортируйте полную JSON-копию из его настроек. После установки Quvo
импортируйте её через Settings и проверьте каталог и историю.
Другая папка установки может получить отдельный ID и хранилище Chrome.
Мастер не переносит данные автоматически. Старое расширение удаляйте только
после проверки восстановленной копии.

ПЕРВЫЙ РАСЧЁТ

Добавьте собственные товары в Catalog вручную или импортируйте CSV в UTF-8.
Рекомендуемая первая строка CSV:
SKU,Name,Price,Unit,Currency

Пример, который нужно заменить своими товарами:
A-101,Desk lamp,79.50,each,USD

При ручном вводе используйте разделитель выбранного языка: например,
1250,50 для русского или 1250.50 для английского, без знака валюты.
В примере CSV выше точка используется как формат обмена. Код валюты
задаётся отдельно. Автоматического пересчёта валют нет.

В расчёте выберите валюту, добавьте товары и количество, при необходимости
скидку и доставку. Добавьте клиента, срок действия и свои условия. Проверьте
итог и сохраните предложение. Готовый текст можно скопировать, распечатать
или сохранить в PDF через системное окно печати Chrome.

Деньги хранятся целыми сотыми, количество — тысячными. Сумма каждой строки
округляется до сотых по правилу «0,5 вверх». Процентная скидка применяется
к сумме уже округлённых строк; после скидки прибавляется доставка.
Скидка не может превышать стоимость товаров. Автоматического расчёта
налогов нет. Изменение каталога не меняет цены позиций уже открытого
черновика и сохранённых предложений.

ДАННЫЕ И РЕЗЕРВНЫЕ КОПИИ

Каталог, черновик, история и настройки хранятся в текущем профиле Chrome.
Нет сервера синхронизации и встроенного отслеживания использования.
Другой компьютер или профиль не получит эти данные автоматически.
Локальный предпросмотр сайта и установленное расширение имеют разные базы.

Регулярно экспортируйте полную JSON-копию в отдельный файл. CSV каталога
не заменяет полную копию. В JSON могут быть имена клиентов, контакты и цены.
Восстановление заменяет рабочие данные; предыдущая валидная версия остаётся
доступна для отмены последнего восстановления.

Удаление расширения или профиля Chrome может удалить его локальные данные.
Сначала сохраните JSON-копию, затем выполняйте удаление или перенос.
Лимиты прототипа: 5000 товаров, 1000 сохранённых предложений, 100 позиций
в предложении; CSV/JSON-импорт — до 5 МБ. Старые записи не удаляются
автоматически при заполнении истории.

WHATSAPP WEB

Каталог, расчёт, история и копирование работают без WhatsApp.
Доступ к https://web.whatsapp.com запрашивается только после вашего действия.
Откройте нужный чат, выберите вкладку, проверьте получателя и текст.
Quvo вставляет текст в пустой черновик; отправку выполняете вы.
Существующий черновик не должен незаметно перезаписываться.

Совместимость с актуальным реальным WhatsApp Web ещё нужно проверить
вручную. Тестовые страницы не гарантируют совместимость с вашим аккаунтом
или будущими изменениями внешнего сервиса. Если вставка недоступна,
скопируйте текст и вставьте вручную. Quvo — независимый инструмент.

ЕСЛИ НЕ РАБОТАЕТ

Проверьте выбранную папку и manifest.json, затем ошибки карточки расширения
на chrome://extensions. Если Chrome не найден мастером, откройте его вручную.
При конфликте вкладок обновите данные в интерфейсе и повторите действие.
Не удаляйте расширение для устранения ошибки без полной JSON-копии.
