Docs: README (project map), AUDIT (review 03.09), BOTS/DEBUG/BOTBRAIN/INSTALL updated for SPP 3

DEBUG.md

@@ -5,6 +5,24 @@
 Формат: `http://127.0.0.1:7780/api/cmd?do=КОМАНДА&name=НИК_БОТА&arg=АРГУМЕНТ`
 `name` пустой — берётся случайный живой бот. В дашборде клик по боту в списке подставляет его ник автоматически.
 
+## Телеметрия и экономика (SPP 3)
+
+| Команда | Что делает |
+|---|---|
+| `do=stats` | счётчики по всему населению: kills, exp, loot, itemsSold, adenaEarned/Spent, stores, skillsCast, rests, lines, replies, parties, migrations, professions, sieges + сколько сейчас в бою/сидит/торгует/в пати/на осаде |
+| `do=stats&name=Ник` | то же для одного бота + последнее действие, шоты, инвентарь, HP |
+| `do=list` | 25 ботов: класс, характер, зона, HP, убийства/смерти, последнее действие |
+| `do=brain&name=Ник` | роль, скиллы профиля (+/-), цель и её HP, бьёт/кастует/сидит, оружие, шоты, число бафов, атака/защита |
+| `do=town` | бот делает «поход в город» прямо на месте: продаёт хлам, докупает шоты/банки, бафается; ответ — сколько продано/куплено и адена |
+| `do=trade` | лавка в городе своего уровня (если продавать нечего — выдаётся образец товара) |
+| `do=profession` | попытка взять следующую профу (сообщит, если не положена по уровню) |
+| `do=talk&name=Бот&arg=ТвойНик` | два бота телепортируются к тебе и начинают диалог (вопрос → ответ через разбор интентов) |
+| `do=invite&arg=ТвойНик` | бот прыгает к тебе и **приглашает в пати** (окно приглашения у тебя) |
+| `do=siege&arg=Giran` | форс-осада: регистрирует бот-кланы атакующими и запускает осаду движка; `do=siegeend&arg=Giran` — закончить; `do=siegeinfo` — расписание, зарегистрированные кланы, сколько ботов в бою |
+| `do=online&arg=charId` | подгрузить конкретного сид-персонажа в мир (так осадный менеджер подтягивает лидеров кланов) |
+
+`/api/stats` — то же, что `do=stats`, в JSON; `/api/sieges` — как `do=siegeinfo`.
+
 ## Уровень и переезд
 
 | Команда | Что делает |