food-market/docs/site-copy-progress.md
nns 2965ced43d
Some checks are pending
Auto-tag / Create date-tag (push) Waiting to run
docs(site): реестр утверждений + черновик честных текстов сайта (на ревью)
Проверил каждое утверждение сайта по коду/стенду: фискализация ОФД/Kaspi Pay —
skeleton (нет), ЕГАИС/акцизы/модификаторы/серии-сроки/размерные сетки/гарантии —
нет, CRM — нет, лояльность — в админке не в кассе, импорт — CSV/1С-CSV/МойСклад,
касса — Windows+Linux (zip/AppImage, не .msi), «О нас» — выдуманная история.
Замеры скорости кассы: холодный старт 82 мс, инициализация 625 мс (< 1 c), поиск
по ШК 36 мс. Черновик переписанных текстов — docs/site-copy-draft.md (было→стало).
НЕ выкладывается до «ок» Mac-Claude.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-09 00:00:01 +05:00

65 lines
9.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Честные тексты публичного сайта
Владелец 08.10: «„Светлая касса, в которой приятно работать“ — что за тупое выражение?»
Проблема шире фразы: на сайте есть (A) обещания того, чего нет, (B) корявый/внутренний язык.
## План / статус
1. [x] Реестр утверждений (таблица ниже) — каждая фраза о возможностях сверена с кодом/стендом.
2. [x] Тексты переписаны в черновике `docs/site-copy-draft.md`: только то, что есть; фискализация
честно («в разработке»); вертикали — предложено убрать 5 выдуманных, оставить продуктовый;
«О нас» — без выдуманной истории/команды.
3. [x] Стиль: язык владельца магазина, польза простыми словами, без жаргона (скользящее среднее,
нативно, SLA, вертикали, фишки) и пафоса («приятно работать»). Заголовок кассы: «Касса,
которая не тормозит и работает без интернета».
4. [x] Цифры — только подтверждённые замерами (запуск < 1 c; поиск по ШК — «мгновенно», без
цифры «14 мс», т.к. замер дал 36 мс). Цены тарифов не меняем, только язык.
5. [~] Черновик готов → `touch ~/.fm-watchdog/COPY-READY`, ЖДУ «ок»/правки Mac-Claude в tmux.
После «ок» — внести в .astro/.tsx, выложить на test.food-market.kz, скриншоты страниц.
## Что НЕ трогаем
Прод (food-market.kz), shared-postgres, global.json, gateway nginx, sklad. Цены тарифов.
## 1. Реестр утверждений (проверено по коду/стенду)
Легенда: ✅ есть · 🟡 частично · ❌ нет/заглушка.
| Утверждение на сайте | Статус | Факт по коду |
|---|---|---|
| Фискальные чеки ОФД РК / «регистрация чеков в ОФД» / «соответствие Налоговому кодексу» | ❌ | `IFiscalProvider`: default **None**; `WebkassaProvider`/`Kassa24Provider` помечены **skeleton/TODO**; рабочий только `MockFiscalProvider` (FiscalNumber=MOCK-…). Реальной фискализации нет. |
| Kaspi Pay (приём оплат / интеграция) | ❌ | Привязан к `Kassa24Provider` (skeleton). Контроллер сам пишет «(skeleton)». Интеграции нет. |
| ЕГАИС-ready (алкоголь) | ❌ | ЕГАИС — российская система, к РК не применима. В коде нет (0 совпадений). |
| Акцизные марки (алкоголь) | ❌ | Нет (0 совпадений). |
| Серии и сроки годности (аптека) | ❌ | У товара/остатка нет полей партии/срока. Есть только причина списания «просрочка». Учёта серий/сроков нет. |
| Модификаторы и комбо (кафе) | ❌ | Нет (0 совпадений). |
| Размерные сетки и цвета (одежда) | ❌ | Нет вариативных товаров/матрицы (0 совпадений). |
| Гарантийные сроки (дом и быт) | ❌ | Нет (0 совпадений). |
| Datamatrix / маркировка | ❌ | `BarcodeParser` разбирает только весовой EAN-13 (префикс 20–29). Datamatrix/маркировку не парсит. |
| CRM (во всех тарифах) | ❌ | Модуля CRM нет (0 совпадений). Есть справочник контрагентов. |
| «Касса для Windows» (как единственная ОС) | 🟡 | Avalonia-кросс: `deploy/pos-publish.sh` собирает **win-x64 (zip)** и **linux-x64 (AppImage/tar.gz)**. Windows **и** Linux. |
| Установщик «.msi ~80 МБ, „Далее“ три раза» | ❌ | Не .msi. Это zip (Windows) / AppImage/tar.gz (Linux) + регистрация устройства по ключу. |
| «Скачать установщик» (кнопка) | ❌ | На сайте кнопка отключена («в разработке»). Публичной загрузки пока нет. |
| Программы лояльности «прямо в окне кассы» | 🟡 | `LoyaltyPrograms/Cards` есть в **админке** (расширенный режим). В **кассе** (POS) лояльности нет (0 совпадений в pos). |
| Инкассация/возврат «только с подтверждения администратора» | ❌ | Инкассация/выплата есть (`WithdrawCash`), но гейта «подтверждение администратора» нет. |
| «Полный аудит-лог» | 🟡 | Журналирование есть (безопасность аккаунта, действия в админке). «Полный» — громко; формулируем как «журнал действий». |
| Импорт: «Excel, CSV и API основных систем» / «1С (XML/Excel)» / «API популярных систем» | 🟡 | Реально: импорт **CSV** (`import-csv`) и **1С-CSV** (`import/1c-csv`), импорт из **МойСклад** по API (`MoySkladImportController`). Прямого импорта .xlsx и «любых API» нет; Excel — только экспорт. |
| Печать чеков на ОКП-совместимом оборудовании | 🟡 | Печать чека есть (`Hardware/Printing.cs`). Но это не фискализация; «ОКП» смешивает печать и онлайн-ККМ. |
| Себестоимость «скользящее среднее» | ✅ | Есть (но на сайте — внутренний термин, переформулировать по-человечески). |
| Торговые весы без драйверов (RS-232/USB-COM) | ✅ | `Hardware/Scale.cs` + весовой EAN-13. Реально. |
| Весовые этикетки | ✅ | Shared `WeightedBarcode` + настройки орг. |
| Сканер-штрихкодов как HID-клавиатура | ✅ | Любой HID-сканер (EAN-13/EAN-8/Code128 — то, что сканер набирает как клавиатуру). |
| Офлайн-режим кассы | ✅ | Очередь офлайн-чеков + синхронизация (smoke: 5 чеков в очереди, idempotency-ключ). |
| Запуск кассы «< 1 с (прогретый)» | ✅ | Замер smoke: холодный старт процесс→логика **82 мс**, полная инициализация+сценарий **625 мс** (< 1 c). |
| «Пробитие по штрихкоду ~14 мс» | 🟡 | Замер smoke на dev-vm: поиск по штрихкоду **36,5 мс** (первый, холодный), по имени 1,8 мс. Пишем качественно «мгновенно», без точной цифры 14 мс. |
| Несколько складов, приёмка, инвентаризация, списание, оприходование, перемещение | ✅ | Все документы есть. |
| Отчёты: продажи, остатки, прибыль; дашборд | ✅ | Есть. |
| Простой/расширенный режим | ✅ | `Organization.IsAdvancedMode`. |
| 90 дней триал без карты, подписка от 5 000 ₸ | ✅ | По тарифам (цены не меняем). |
| «О нас»: «запустился в 2026…», «команда основателей три года наблюдали», раздел «Команда» | ❌ | Выдуманная история и команда. Переписать правдиво, без фото-заглушек. |
| Кейсы/соцпруф («истории магазинов») | ❌ | Заглушка. Убрать или честно «пока нет». |
| Банки Halyk/Jusan/Forte, маркетплейсы Ozon/Wildberries/Kaspi Magazin | ❌ | Готовых интеграций нет (логотипы как «планируем/по запросу» вводят в заблуждение). Убрать или честно переформулировать. |
## Журнал
- 08.10 — старт: план, сбор текстов сайта, проверка утверждений по коду.
- 08.10 — реестр утверждений (фискализация/Kaspi/лояльность/вертикали/импорт/касса/«О нас»);
замеры скорости кассы (smoke): холодный старт 82 мс, инициализация 625 мс, поиск по ШК 36 мс.