Add SwarmUI settings management and portrait generation enhancements

- Introduced new API endpoints for managing SwarmUI settings, including fetching and saving presets and age rules.
- Updated the portrait generation logic to utilize the new settings structure, allowing for dynamic preset selection based on age.
- Enhanced UI components to support SwarmUI settings, including localization for new strings and improved styling for settings sections.
- Added tests to verify the functionality of new settings endpoints and portrait generation behavior.

This commit lays the groundwork for more flexible and user-friendly portrait generation options.
This commit is contained in:
Leonid Pershin
2026-08-20 06:06:45 +03:00
parent e0b7122f3b
commit 5a400be792
32 changed files with 2178 additions and 184 deletions
+42
View File
@@ -0,0 +1,42 @@
# Фаза 41. Мнения и вкладка «Связи»
## Зависимости
- [Фаза 8](08-people-browser.md)
- [Фаза 36](36-person-card-tabs.md)
## Зачем
У пары появляется число. Семья больше не «просто родственники». Карточка умеет это показать,
даже пока кружков ещё нет.
## Задачи
- [ ] Мнение A→B: −100…100, несимметрично, ноль не хранить
- [ ] Пороги и подписи в `BehaviorDef`; клиент рисует присланную подпись, не считает сам
- [ ] Генератор ставит семейные старты (родители, сиблинги, партнёры семьи) из данных
- [ ] Каждое рабочее утро (и skip) ненулевые мнения слегка дрейфуют к семейному базису или к нулю;
дошли до нуля — запись выкинуть
- [ ] `people.json` пишет мнение при сдвиге; старый сейв без поля — все нули кроме семьи
после первой загрузки-переписи
- [ ] Вкладка карточки **Связи**: семья с числами, топ друзей/врагов, поиск по ненулевым
- [ ] Игрок с вкладки ничего не меняет
- [ ] `docs/protocol.md` — HTTP карточки
## Тесты, без которых фаза не закрыта
- [ ] Родитель и ребёнок после генерации имеют плюс в обе стороны; чужие одноклассники — нет записи
- [ ] A→B и B→A могут различаться
- [ ] После нескольких утренних дрейфов без разговоров мнение одноклассников (если появилось)
ближе к нулю, семейное — к старту, не к нулю
- [ ] Карточка без отдельного запроса «всех пар школы»: только этот человек
- [ ] Клиентский тест: вкладка «Связи» не монтирует лог
## Критерий готовности
- Открыть ученика, на «Связях» родители с подписью «близкие» или соседней, одноклассник без строки
- `dotnet test` и `npm test` / `build` проходят
## Стоп
Не собирать кружки. Не бампить сокет. Не заводить романтику.
+41
View File
@@ -0,0 +1,41 @@
# Фаза 42. Темы и кружки
## Зависимости
- [Фаза 41](41-opinions.md)
- [Фаза 21](21-decisions.md)
## Зачем
`Chat` перестаёт быть соло. В узле говорят 2–4 человека об одной теме. Язык и
`Communication` влияют на исход.
## Задачи
- [ ] `TopicDef`: теги, возраст, роли, шёпот-на-уроке, опциональный язык
- [ ] Ванильный набор тем (учёба, игры, еда, семья, спорт, сплетни, грубое) в `core`
- [ ] Кружок 2–4 в одном узле; пятый не влезает
- [ ] Кого зовут: друзья и одноклассники в узле, врагов не зовут; тихоня/лидер — поля черты
- [ ] Нет общего языка — кружок можно, сдвиг мнения слабый и чаще вниз
- [ ] `Communication` растёт от разговора меньше, чем предмет за урок; язык разговора — капля,
если не у потолка
- [ ] Черты **сплетник** и **общительный** в `core` с полями, не списками в коде
- [ ] Исход пишет мнения всех пар кружка и строку лога
- [ ] На уроке обычный `Chat` не стартует (шёпот — фаза 43)
## Тесты, без которых фаза не закрыта
- [ ] Двое свободных друзей в коридоре на перемене собирают кружок; враги — нет
- [ ] Пятый в узле не входит в тот же кружок
- [ ] Без общего языка мнение почти не растёт при том же `Communication`
- [ ] Высокий `Communication` сильнее двигает число, чем низкий, на одной теме
- [ ] Каталог без `TopicDef` не стартует школу с кружками — или падает загрузка, не молча соло-Chat
## Критерий готовности
- На перемене в коридоре двое «разговаривают», на карточке мнение сдвинулось, в логе тема
- `dotnet test` проходит
## Стоп
Не шёпот на уроке. Не драка. Не менять кадр присутствия (локация может ещё писать «Разговор»).
+36
View File
@@ -0,0 +1,36 @@
# Фаза 43. Шёпот и учитель
## Зависимости
- [Фаза 42](42-talk-circles.md)
## Зачем
На уроке можно шептаться — ценой учёбы. Учитель иногда слышит. После урока учитель сам
говорит с учениками.
## Задачи
- [ ] Тема с тегом шёпота может стартовать кружок на уроке в кабинете класса
- [ ] У участников на время шёпота режется рост навыка урока (доля в `BehaviorDef`)
- [ ] Учитель в том же кабинете: шанс оборвать (данные + черты); не 100 %
- [ ] Пойманный шёпот → выговор (кружок учитель + ученики, тема дисциплины), мнения как у
строгого разговора
- [ ] После урока учитель может взять 2–4 учеников (вопрос / похвала / выговор) по весу цели
- [ ] Лог: «шептались», «учитель оборвал»
## Тесты, без которых фаза не закрыта
- [ ] Шёпот на уроке даёт меньше прироста предмета, чем тихий урок без кружка
- [ ] При фиксированном сиде не каждый шёпот с учителем в кабинете обрывается
- [ ] Без учителя в узле шёпот не обрывается этим правилом
- [ ] Обычный не-шёпотный `Chat` на уроке не стартует
## Критерий готовности
- На математике двое шепчутся, иногда учитель обрывает, в логе это видно
- `dotnet test` проходит
## Стоп
Не драка. Не политика речи в UI. Не протокол.
+35
View File
@@ -0,0 +1,35 @@
# Фаза 44. Ссора и драка
## Зависимости
- [Фаза 42](42-talk-circles.md)
## Зачем
Вражда — не только минус в JSON. На перемене ссорятся, на дворе или физкультуре редко дерутся.
Травм нет.
## Задачи
- [ ] Действие ссоры: 2 (иногда 3), перемена, мнение падает сильнее грубого разговора
- [ ] Действие драки: редко, двор или зал; коротко; без травм и медпункта
- [ ] Триггер: низкое взаимное мнение, задира/вспыльчивый — поля, не if по defName
- [ ] Сотрудник в узле обрывает драку и делает выговор; нет сотрудника — действие просто кончается
- [ ] Лог обоих; кабинет директора не заводим
- [ ] Игрок не приказывает разнять
## Тесты, без которых фаза не закрыта
- [ ] Двое врагов на дворе чаще ссорятся, чем двое друзей
- [ ] Драка не меняет нужду «здоровье» — такой нужды нет и не появляется
- [ ] Выговор после обрыва есть, если в узле был сотрудник
- [ ] Skip пустого времени не оставляет «вечную драку» в состоянии
## Критерий готовности
- Задира с врагом на дворе: в логе ссора или драка, мнения ниже, оба живы и на ногах
- `dotnet test` проходит
## Стоп
Не вызов родителей. Не травмы. Не романтика.
+34
View File
@@ -0,0 +1,34 @@
# Фаза 45. Кружок в присутствии
## Зависимости
- [Фаза 42](42-talk-circles.md)
- [Фаза 19](19-presence-screen.md)
## Зачем
В панели локации видно, с кем и о чём говорят, без открытия карточки.
## Задачи
- [ ] Кадр присутствия: у человека, который в кружке, список id участников и id темы.
Имена не строкой. Клиент собирает «говорит с Машей о футболе» из справочника и локали
- [ ] Версия протокола +1. `ProtocolCodec.cs`, `protocol.ts`, `docs/protocol.md` в одном коммите
- [ ] Не в кружке — пустой список, как сейчас только id/узел/состояние
- [ ] Вкладка «Сейчас» на карточке согласована с тем же составом
- [ ] Старый клиент отваливается Hello, как обычно
## Тесты, без которых фаза не закрыта
- [ ] Круглый трип и байтовая раскладка человека с кружком и без — на обеих сторонах
- [ ] Имя человека не встречается в кадре присутствия
- [ ] Клиентский тест: локация показывает тему и имя напарника из directory, не из кадра
## Критерий готовности
- Клик по коридору на перемене: в «персонажах» видно, кто с кем говорит
- `dotnet test` и `npm test` / `build` проходят
## Стоп
Не политика речи. Не пак.
+37
View File
@@ -0,0 +1,37 @@
# Фаза 46. Политика речи и дом
## Зависимости
- [Фаза 42](42-talk-circles.md)
- [Фаза 37](37-school-rules.md)
- [Фаза 34](34-wear-home.md)
## Зачем
Школа задаёт, какие темы уместны — тем же жестом, что дресс-код. Родители двигают мнение утром,
не приходя на карту.
## Задачи
- [ ] В «Правилах» два комбобокса речи: ученики / сотрудники × свободно / без грубого / только учёба
- [ ] В силу с завтра; API сегодня не переодевает темы текущих кружков
- [ ] Система не стартует кружок с темой вне политики; начатый вчера доигрывает
- [ ] Одно семейное событие на человека за рабочее утро; skip ночи применяет
- [ ] Семейные темы из `TopicDef`; сдвиг меньше школьного разговора
- [ ] `docs/protocol.md` — HTTP правил речи
## Тесты, без которых фаза не закрыта
- [ ] POST «только учёба» сегодня не мешает текущему кружку «игры»
- [ ] На следующее рабочее утро грубая тема у учеников не стартует
- [ ] Skip с пятницы на понедельник применяет домашнее событие; мнение с родителем сдвинуто
- [ ] Клиентский тест: комбобоксы речи рядом с одеждой, подпись «с завтра»
## Критерий готовности
- Сменить политику, пережить ночь кнопкой, на перемене нет грубых кружков у учеников
- `dotnet test` и `npm test` / `build` проходят
## Стоп
Не романтика. Не вызов родителей в школу.
+46
View File
@@ -0,0 +1,46 @@
# Фаза 47. Пак romance
## Зависимости
- [Фаза 42](42-talk-circles.md)
- [Фаза 23](23-example-pack.md)
- [Фаза 41](41-opinions.md)
## Зачем
Контентный мод, не скучный образец. Ваниль без романтики. Пак добавляет ориентацию, симпатию,
пару 18+ и романтические темы патчем.
## Задачи
- [ ] `mods/romance/`: `pack.jsonc` `requires: ["core"]`, локали, ориентация как данные,
черты влюбчивый/ревнивый полями, патч тем и при необходимости `Chat`
- [ ] Без пака в create ориентации и романтических состояний нет; ванильный каталог без
романтических тем
- [ ] Симпатия учеников: ±2 года или соседняя параллель
- [ ] Симпатия ученик → учитель можно, видна на обеих карточках; учитель → ученик никогда;
осадить — разговор; пары сотрудник↔ученик нет
- [ ] Пара: оба 18+, взаимно, одна; разрыв — событие, новая не раньше следующего дня
- [ ] Сотрудники между собой — симпатия и пара можно
- [ ] Никаких сексуальных действий и текстов. Детская линия — дразнилки и ярлык
- [ ] Тесты хоста: школа с паком и без; запрет учительской взаимности
- [ ] `example` не трогать
## Тесты, без которых фаза не закрыта
- [ ] `GET /api/catalog` без `romance` не отдаёт романтические темы
- [ ] Create с паком пишет ориентацию; без пака поля нет
- [ ] Двое 16-летних не получают статус пары при любом мнении
- [ ] Учитель не получает романтическое состояние на ученика
- [ ] Первоклассник не получает симпатию к одиннадцатому (возраст)
- [ ] Школа с `example` и без `romance` ведёт себя как ваниль в части тем
## Критерий готовности
- Создать школу с галкой пака, увидеть симпатию на «Связях» и тему пака в логе; снять галку на
новой школе — этого нет
- `dotnet test` проходит
## Стоп
Не секс. Не пара учителя и ученика. Не раздувать `example`. Не смена модов у живой школы.
+40
View File
@@ -182,3 +182,43 @@
| Фаза | Статус | Зачем |
| --- | --- | --- |
| [40. Темп часов](40-clock-tempo.md) | ⬜ | ×1 = минута/с, кнопки ×½ ×1 ×2 ×5 ×10, страйд тяжёлых систем |
## Срез 9. Общение и романтический пак
Дизайн: [`../design/social.md`](../design/social.md).
Разговор становится кружком, мнение — числом, вражда — ссорой. Романтика не ваниль: отдельный
пак. Срез можно остановить после этапа B — школа болтает, даже если драк и пака ещё нет.
**Этап A — мнения.** Число и вкладка.
| Фаза | Статус | Зачем |
| --- | --- | --- |
| [41. Мнения и «Связи»](41-opinions.md) | ⬜ | −100…100, семья-старт, вкладка карточки |
**Этап B — разговоры.** Кружок, язык, шёпот.
| Фаза | Статус | Зачем |
| --- | --- | --- |
| [42. Темы и кружки](42-talk-circles.md) | ⬜ | `TopicDef`, 2–4 человека, язык, `Communication` |
| [43. Шёпот и учитель](43-whisper.md) | ⬜ | Шёпот на уроке, шанс оборвать, разговор после звонка |
42 стоит на 41; 43 — на 42.
**Этап C — конфликт и экран.**
| Фаза | Статус | Зачем |
| --- | --- | --- |
| [44. Ссора и драка](44-quarrel-fight.md) | ⬜ | Перемена / двор / физкультура, выговор, без травм |
| [45. Кружок в присутствии](45-presence-talk.md) | ⬜ | Id участников и темы в кадре, протокол +1 |
44 и 45 стоят на 42, можно параллельно.
**Этап D — правила, дом, пак.**
| Фаза | Статус | Зачем |
| --- | --- | --- |
| [46. Политика речи и дом](46-speech-home.md) | ⬜ | Комбобоксы речи с завтра; утреннее семейное событие |
| [47. Пак romance](47-romance-pack.md) | ⬜ | Ориентация, симпатия, пара 18+, патч тем |
46 стоит на 37 и 42; 47 — на 42 и 23. `example` не трогать.