Отчёт одной кнопкой: скрипт и .batA report in one click: a script and a .bat

Я экономист «Долины напитков». В папке input лежат выгрузки: план и факт продаж по городам и SKU за месяц. Напиши скрипт report.py на Python, который делает отчёт «план/факт по городам»: план, факт, отклонение в тыс. литров и в %. Правила: 1) исходные файлы только читать, никогда не менять; 2) результат — новый Excel в папке output, в имени дата запуска; 3) все пути — от папки скрипта, никаких C:\Users\…; 4) в конце вывести в консоль итог плана и факта из исходника и из отчёта — они должны совпасть; 5) если файл отчёта открыт в Excel — понятное сообщение, а не падение; 6) в начале скрипта — описание: что делает, что читает, что пишет. Сначала покажи план и спроси, если что-то в выгрузках непонятно.

I'm an analyst at Valley Beverages. The input folder holds exports: planned and actual sales by city and SKU for a month. Write a Python script report.py that builds a "plan vs actual by city" report: plan, actual, variance in thousand litres and in %. Rules: 1) read source files only, never change them; 2) the result is a new Excel file in the output folder with the run date in its name; 3) all paths relative to the script's folder, no C:\Users\…; 4) at the end print the plan and actual totals from the source and from the report — they must match; 5) if the report file is open in Excel, show a clear message instead of crashing; 6) start the script with a description: what it does, what it reads, what it writes. Show the plan first and ask if anything in the exports is unclear.

"""Отчёт план/факт по городам.
Читает выгрузку input/sales.xlsx (не меняет её), пишет новый файл в output.
"""
from pathlib import Path
from datetime import date
import pandas as pd
HERE = Path(__file__).parent                     # путь от скрипта, а не C:\Users\...
df = pd.read_excel(HERE / "input" / "sales.xlsx")  # исходник только читаем
rep = df.groupby("Город")[["План", "Факт"]].sum()
rep["Откл, %"] = (rep["Факт"] / rep["План"] - 1) * 100
out = HERE / "output" / f"Отчет_план_факт_{date.today():%Y-%m-%d}.xlsx"
out.parent.mkdir(exist_ok=True)
try:
    rep.to_excel(out)
except PermissionError:
    raise SystemExit(f"Файл открыт в Excel, закройте его: {out.name}")
print("План: исходник", df["План"].sum(), "| отчёт", rep["План"].sum())
print("Факт: исходник", df["Факт"].sum(), "| отчёт", rep["Факт"].sum())

"""Plan vs actual report by city.
Reads input/sales.xlsx (never changes it), writes a new file to output.
"""
from pathlib import Path
from datetime import date
import pandas as pd
HERE = Path(__file__).parent                     # path from the script, not C:\Users\...
df = pd.read_excel(HERE / "input" / "sales.xlsx")  # source is read-only
rep = df.groupby("City")[["Plan", "Actual"]].sum()
rep["Var, %"] = (rep["Actual"] / rep["Plan"] - 1) * 100
out = HERE / "output" / f"Plan_vs_actual_{date.today():%Y-%m-%d}.xlsx"
out.parent.mkdir(exist_ok=True)
try:
    rep.to_excel(out)
except PermissionError:
    raise SystemExit(f"The file is open in Excel, close it: {out.name}")
print("Plan: source", df["Plan"].sum(), "| report", rep["Plan"].sum())
print("Actual: source", df["Actual"].sum(), "| report", rep["Actual"].sum())

@echo off
REM Plan vs actual report. Double-click to run.
cd /d "%~dp0"
python report.py
pause

@echo off
REM Plan vs actual report. Double-click to run.
cd /d "%~dp0"
python report.py
pause

Сделай RUN_report.bat для запуска report.py двойным щелчком. Только ASCII-символы внутри, никакой кириллицы. В начале перейди в папку самого .bat, в конце pause. Все сообщения на русском пусть печатает report.py.

Make RUN_report.bat to run report.py with a double-click. ASCII characters only inside, no Cyrillic. Start by moving into the .bat's own folder, end with pause. Let report.py print all the human-readable messages.

Напиши README.md для этой папки для коллеги, который никогда не видел Python: что установить, какие выгрузки и с какими именами класть в input, как запустить RUN_report.bat, где найти отчёт, как проверить итог, что делать при ошибке «файл открыт в Excel». Коротко, по шагам.

Write README.md for this folder for a colleague who has never seen Python: what to install, which exports with which names go into input, how to run RUN_report.bat, where to find the report, how to check the total, what to do on the "file is open in Excel" error. Short, step by step.