feat: обрезка КИЗ до 31 символа, README, инструкции для AI-агентов

- VBS и Python: в итоговом CSV код КИЗ обрезается до первых 31 символа
  (код без криптохвоста: 01 + GTIN + 21 + серийный номер); более короткий
  код остаётся как есть, с замечанием в отчёте. Копия kiz_to_csv.py в
  портативном комплекте обновлена так же.
- README.md: инструкция на русском, переписана проще и яснее;
  Инструкция_экспорт_CSV.docx пересобрана из того же текста, с настоящими
  заголовками и списками.
- AGENTS.md, CLAUDE.md, .agents/ (скилл kiz-testing, папки plans и reports).
- .gitignore для .DS_Store; .gitattributes хранит файлы без изменения
  концов строк (.bat и .vbs нужны CRLF).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Igor K.
2026-10-28 06:38:47 -04:00
co-authored by Claude Opus 5.5
commit a6a3d5d6cd
255 changed files with 32576 additions and 0 deletions
@@ -0,0 +1,33 @@
ПОРТАТИВНЫЙ КОМПЛЕКТ «КИЗ -> CSV» (Windows 7 / 10 / 11)
Без установки и без прав администратора: в систему ничего не пишется,
реестр не трогается, нужна только эта распакованная папка.
СОСТАВ:
python\ - встраиваемый Python 3.8.10 (официальный, portable)
kiz_to_csv.py - скрипт сопоставления КИЗ с товарной накладной
KIZ_CSV.bat - запуск двойным щелчком
КАК РАБОТАТЬ:
1. Скопируйте всю папку на рабочий компьютер (флешка, сеть) - в любое место.
2. Запустите KIZ_CSV.bat двойным щелчком.
3. В чёрном окне по очереди появятся два запроса пути:
сначала товарная накладная, затем файл с отсканированными КИЗ.
Путь можно ввести вручную, а проще - когда появится запрос,
ПЕРЕТАЩИТЕ файл мышью прямо в это окно и нажмите Enter.
Ещё проще: перетащите ОБА файла сразу на значок KIZ_CSV.bat -
тогда запросов не будет (первый файл - накладная, второй - КИЗ).
4. По окончании в том же окне будет виден результат и сверка количества.
Рядом с файлом КИЗ появятся два файла:
<имя>.csv - его загружать в УД;
<имя>_report.txt - отчёт: сверка по каждому GTIN и все замечания.
ТРЕБОВАНИЯ К ФАЙЛАМ (как в инструкции Инструкция_экспорт_CSV.docx):
Накладная: GTIN - в колонке B ("Наименование"), начиная с ряда 19,
в конце наименования после последнего пробела;
количество - K, цена - L, ставка НДС - N.
Файл КИЗ: последняя заполненная колонка - коды DataMatrix.
Старый формат .xls не подходит - откройте в Excel и сохраните как .xlsx.
Примечание: окна выбора файлов здесь текстовые (в портативном Python нет
компонента графических диалогов) - поэтому запросы выводятся в чёрном окне.