Обновление, правки в дашборде и публикация для командыRefreshing, editing in the dashboard and publishing for the team

Положите четыре файла в папку проекта рядом с load_exports.py и сборщиком. В publish_config.txt впишите, куда публиковать — путь от папки скрипта. Шаг, которого нет в папке, меню пропустит.

Put the four files into the project folder next to load_exports.py and the builder. In publish_config.txt write where to publish — a path from the script folder. The menu skips a step that is not in the folder.

@echo off
rem Dashboard update. Only Latin letters here: Cyrillic breaks .bat files.
chcp 65001 >nul
cd /d "%~dp0"
set PY=python
if exist ".venv\Scripts\python.exe" set PY=.venv\Scripts\python.exe
%PY% update_menu.py %1
if errorlevel 1 echo ERROR - read the messages above
pause

# -*- coding: utf-8 -*-
"""Меню обновления дашборда: спрашивает, что обновить, и запускает шаги по порядку.
Dashboard update menu: asks what to update and runs the steps in order.
Русский текст живёт здесь, в .py; .bat только запускает этот файл (кириллица ломает .bat).
Шаг, которого нет в папке, пропускается. Ошибка шага останавливает цепочку.
"""
import subprocess
import sys
from pathlib import Path
HERE = Path(__file__).resolve().parent
STEPS = [("1", "Загрузить данные / load data", "load_exports.py"),
         ("2", "Собрать дашборд / build the dashboard", "build_dashboard.py"),
         ("3", "Проверить дашборд / check the dashboard", "check_dashboard.py"),
         ("4", "Опубликовать для команды / publish for the team", "publish.py")]
def run(script):
    path = HERE / script
    if not path.exists():
        print(f"  нет файла {script} - шаг пропущен")
        return 0
    print(f"--- {script}")
    return subprocess.call([sys.executable, str(path)], cwd=str(HERE))
def main():
    print("Что обновить? / What to update?")
    for key, name, _ in STEPS:
        print(f"  {key} - {name}")
    print("  5 - всё по порядку / everything in order")
    choice = (sys.argv[1] if len(sys.argv) > 1 else input("Номер / number: ")).strip()
    todo = STEPS if choice == "5" else [s for s in STEPS if s[0] == choice]
    if not todo:
        print("Нет такого пункта / no such option")
        return 1
    for key, name, script in todo:
        code = run(script)
        if code != 0:
            print(f"ОСТАНОВЛЕНО на шаге {key} ({script}), код {code}. Дальше не идём / stopped.")
            return code
    print("Все шаги прошли / all steps passed")
    return 0
if __name__ == "__main__":
    sys.exit(main())

# -*- coding: utf-8 -*-
"""Публикация дашборда для команды: HTML + скрипты в общую папку, копия версии и запись «что изменилось».
Publishing the dashboard for the team: HTML + scripts to the shared folder, a version copy and a 'what changed' note.
publish_config.txt рядом со скриптом / next to the script:
  html=Dashboard.html              # что публикуем / what to publish
  target=..\\Shared\\Dashboard      # куда: путь от папки скрипта / where: path relative to the script folder
Запуск / run:  python publish.py "что изменилось / what changed"
"""
import datetime
import shutil
import sys
from pathlib import Path
HERE = Path(__file__).resolve().parent
KEEP = ("*.py", "*.bat", "README.md", "code_map.csv", "city_map.csv")   # скрипты и справочники едут вместе с HTML
def config():
    cfg = {}
    for line in (HERE / "publish_config.txt").read_text(encoding="utf-8-sig").splitlines():
        if "=" in line and not line.strip().startswith("#"):
            k, v = line.split("=", 1)
            cfg[k.strip()] = v.split("#")[0].strip()
    return cfg
def copy_checked(src, dst):
    """Копирует и проверяет размер: «готово» только если файл правда на месте."""
    shutil.copy2(src, dst)
    if not dst.exists() or dst.stat().st_size != src.stat().st_size:
        raise OSError(f"не скопировался {src.name}")
def main():
    cfg = config()
    html = HERE / cfg["html"]
    target = (HERE / cfg["target"]).resolve()
    if not html.exists():
        print(f"СТОП: нет {html.name} - сначала соберите дашборд")
        return 1
    if not target.parent.exists():
        print(f"СТОП: нет папки {target.parent} - проверьте target в publish_config.txt")
        return 1
    stamp = datetime.datetime.now().strftime("%Y-%m-%d_%H%M")
    (target / "versions").mkdir(parents=True, exist_ok=True)
    errors = []
    try:
        copy_checked(html, target / html.name)
        copy_checked(html, target / "versions" / f"{html.stem}_{stamp}{html.suffix}")
    except OSError as e:                      # файл открыт у коллеги / file open on a colleague's PC
        errors.append(f"{html.name}: {e}")
    (target / "scripts").mkdir(exist_ok=True)
    for pattern in KEEP:
        for f in HERE.glob(pattern):
            try:
                copy_checked(f, target / "scripts" / f.name)
            except OSError as e:
                errors.append(f"{f.name}: {e}")
    note = sys.argv[1] if len(sys.argv) > 1 else "обновление данных / data refresh"
    with open(target / "CHANGES.md", "a", encoding="utf-8") as fh:
        fh.write(f"- {stamp}: {note}\n")
    if errors:
        print("НЕ ВСЁ опубликовано / not everything published:")
        for e in errors:
            print("  " + e)
        return 1
    print(f"ГОТОВО: {html.name} -> {target}")
    return 0
if __name__ == "__main__":
    sys.exit(main())

# What to publish and where. Paths are relative to this folder.
# Что публиковать и куда. Пути - от этой папки.
html=Dashboard.html
target=..\Shared\Dashboard

Файлы проверены: RUN_update.bat запущен в командной строке Windows, меню прошло все шаги, publish.py положил дашборд, скрипты, копию версии и строку в CHANGES.md в тестовую общую папку.

The files were tested: RUN_update.bat was run in the Windows command line, the menu went through all steps, publish.py put the dashboard, scripts, a version copy and a CHANGES.md line into a test shared folder.

Исправили ошибку в загрузчике — проверили data.json — цифры верные. Но дашборд у команды показывает старые цифры: HTML собран вчера, до правки. Проверка JSON подтверждает данные, а люди смотрят на HTML.

You fixed a bug in the loader — checked data.json — the numbers are right. But the team's dashboard shows the old numbers: the HTML was built yesterday, before the fix. A JSON check confirms the data, while people look at the HTML.

Скрипт проверки открывает собранный HTML в браузере без окна и проходит его так, как прошёл бы человек. Минимальный набор:

The check script opens the built HTML in a headless browser and walks through it as a person would. The minimum set:

Такой скрипт ассистент пишет по заданию за один заход — пример проверки лежит в образце дашборда (урок 05-18).

An assistant writes such a script from a brief in one go — a sample check is in the sample dashboard (lesson 05-18).

Пусть сок в Каменске в базе — 1 000. Планер поднял до 1 100, канальный менеджер позже — до 1 150. Как записать?

Say juice in Kamensk has a baseline of 1,000. The planner raised it to 1,100, the channel manager later to 1,150. How to record it?

Каждая запись несёт автора, время и причину. Когда правка задаёт итог суббренда или города, её раскладывают на SKU по долям — и пишут в журнал уже разложенные решения.

Every record carries the author, time and reason. When an edit sets the total of a subbrand or a city, it is split to SKUs by shares — and the split decisions go into the journal.

Планер (журнал A) и канальный менеджер (журнал B) правят три пары «товар · город». Подключайте журналы, загружайте B второй раз, удаляйте правку и переключайте способ записи.

The planner (journal A) and the channel manager (journal B) edit three product · city pairs. Connect the journals, load B a second time, delete an edit and switch the recording method.

Журнал — обычная книга .xlsx в общей папке. Дашборд пишет в неё правки через File System Access (Chrome, Edge — урок 05-20), а в других браузерах — скачивает файл правок, который человек кладёт в папку. Сборщик при следующем обновлении читает все файлы журналов, сливает по ID и показывает итог. Если книга открыта у коллеги, запись не пройдёт — дашборд обязан сказать «не записано».

The journal is an ordinary .xlsx workbook in the shared folder. The dashboard writes edits into it via File System Access (Chrome, Edge — lesson 05-20), and in other browsers downloads an edits file that a person puts into the folder. On the next refresh the builder reads all journal files, merges them by ID and shows the result. If a colleague has the workbook open, writing fails — the dashboard must say "not written".

В образце дашборда (урок 05-18) есть колода слайдов для встречи: заголовок-вывод, график, светофор, решения. Слайд сохраняется картинкой (html2canvas) или целой презентацией .pptx (PptxGenJS). Правило то же, что для Excel: слайд собирается из тех же проверенных цифр, а имя файла несёт цикл и фильтры.

The sample dashboard (lesson 05-18) has a slide deck for the meeting: a conclusion headline, a chart, a traffic light, decisions. A slide is saved as a picture (html2canvas) or a whole .pptx deck (PptxGenJS). The rule is the same as for Excel: a slide is built from the same checked numbers, and the file name carries the cycle and filters.

1. Одно место. Команда открывает дашборд из одной общей папки (OneDrive, SharePoint). Копии «у себя на рабочем столе» не рассылаем.
2. HTML и скрипты вместе. publish.py кладёт рядом с дашбордом скрипты и справочники — тогда собрать его может любой.
3. Версии. Каждая публикация — датированная копия в versions и строка в CHANGES.md: что изменилось.
4. Всегда после пересборки. Пересобрали — сразу опубликовали, без вопроса «а надо ли».
5. «Готово» — только после проверки копии. Скрипт сравнивает размер скопированного файла с исходным.

1. One place. The team opens the dashboard from one shared folder (OneDrive, SharePoint). No "on my desktop" copies are sent around.
2. HTML and scripts together. publish.py puts the scripts and master data next to the dashboard — then anybody can build it.
3. Versions. Every publication is a dated copy in versions and a line in CHANGES.md: what changed.
4. Always after a rebuild. Rebuilt — published right away, without asking "is it needed".
5. "Done" only after checking the copy. The script compares the copied file's size with the source.

1. README в папке: что это, откуда данные, как обновить (одна кнопка), кому писать.
2. Скрипты без абсолютных путей и имени ноутбука — проверьте, запустив на чужом ноутбуке.
3. Python в PATH или окружение .venv рядом — RUN_update.bat найдёт любой из двух.
4. Справочники и журнал — в общей папке, а не у вас на диске.
5. Одно обновление вместе: коллега жмёт кнопку, вы смотрите.

1. A README in the folder: what it is, where the data comes from, how to refresh (one button), whom to contact.
2. Scripts without absolute paths or a laptop name — check by running on someone else's laptop.
3. Python in PATH or a .venv environment next to it — RUN_update.bat finds either.
4. Master data and the journal — in the shared folder, not on your disk.
5. One refresh together: the colleague presses the button, you watch.

Визуальная проверка обязательна. Автопроверка подтверждает, что дашборд открывается и цифры сходятся с data.json. Что цифры правдоподобны, видит только человек: откройте опубликованную копию — именно её, а не свою — и посмотрите дату обновления, последний месяц и пару знакомых цифр.

Visual check is a must. An automated check confirms the dashboard opens and the numbers match data.json. Whether the numbers are plausible only a person sees: open the published copy — that one, not yours — and look at the refresh date, the last month and a couple of familiar numbers.

Источники: GeekWire, 29.09.2025, режим агента в Excel; web.dev и Web Platform features explorer — File System Access.

Sources: GeekWire, 29.09.2025, Agent Mode in Excel; web.dev and Web Platform features explorer — File System Access.

Три случая из работы планера в компании-производителе напитков. Названия изменены.

Three cases from planning work at a beverage manufacturer. Names are changed.

В книге оба журнала из тренажёра на одном листе и формулы, которые решают, какая правка в силе: повтор, действует, последняя по времени, порог согласования. Лист «итог» сравнивает журнал решений с журналом изменений, лист «имя файла» собирает имя выгрузки из фильтров.

The workbook has both journals from the simulator on one sheet and formulas that decide which edit is in force: duplicate, active, latest by time, approval threshold. The "result" sheet compares the decision journal with the journal of changes, the "file name" sheet builds the export name from filters.