Прогресс World Interaction System

Последнее обновление: 18 июля 2026 года
Формат статуса: [x] завершено, [~] подготовлено/нужна проверка, [ ] не начато

1. Общий статус

Направление	Статус	Прогресс
Исследование AA skills/WorldInteraction/plots	Завершено	100%
Исследование AA loot/housing/territories	Завершено	100%
Исследование экспортов AA SQLite	Завершено	100%
Аудит текущего Last Chaos	Завершено	100%
Целевая архитектура	Подготовлена	100%
План этапов и критерии	Подготовлены	100%
SQLite schema draft	Подготовлен, не применялся	100% draft
PostgreSQL migration draft	Подготовлен, не применялся	100% draft
Labor architecture/schema	Подготовлена, не реализована	100% draft
Client visual catalog schema	Подготовлена, не применялась	100% draft
Реализация сервера	Не начата	0%
Реализация клиента	Не начата	0%
Content data	Не заполнены	0%
Build/tests/runtime verification	Не выполнялись	0%

2. Завершённые исследования

• Прослежен AA skill pipeline: packet -> validation -> cast -> effects -> completion.
• Изучены skill templates, requirements, target selection, cooldown/cost/channeling.
• Изучены skill plots: events, conditions, effects, edges и runtime state.
• Изучены WorldInteraction и interaction effects.
• Изучены doodad phase/function graphs.
• Изучены NPC interaction lists и crafting через skills.
• Изучен AA corpse loot: generation, rights, open/take-all, team rules, rolls и expiry.
• Изучен AA housing: templates, stages, materials, ownership, permissions, taxes, decorations, persistence.
• Установлено, что AA skill plots не являются земельными участками.
• Установлено, что AAEmu housing placement/territory validation нельзя использовать без нового дизайна.
• Составлен словарь ключевых AA SQLite таблиц и связей.
• Enum JSON отделены от production data; в новой SQLite enum-таблицы не проектируются.
• Проаудированы LC skills, NPC interactions, crafting, ground loot, monster death, UI XML, SQLite loader и PostgreSQL migrations.
• Изучены AA account labor, local/character labor data, regeneration, premium modifiers, skills, craft, gathering и building costs.
• Найдены PlayerInfo.xml: pb_labor1, pb_labor2, txt_labor; подтверждено, что CUIPlayerInfo::UpdateLabor() пуст.
• Установлено, что LC crafts.labor_point сейчас только отображается и не списывается сервером.
• Установлено, что CharacterActability и t_expert присутствуют, но не подключены к CPC lifecycle.

3. Подтверждённое состояние Last Chaos

Реально присутствует

• SkillCastService и клиентский cast runtime.
• NPC interaction lease.
• Серверный inventory и ground-item pickup.
• SQLite static data loader.
• PostgreSQL migration runner и поток lc_game до физического файла 0023.
• Client\Sources\xml\interactActions.xml.
• Client\Sources\xml\lootWindow.xml.

Не обнаружено в исходниках

• Реализованный World Interaction Core.
• Action discovery protocol/handler.
• Runtime-класс панели interactActions.xml.
• Corpse loot container и runtime-класс lootWindow.xml.
• Interactive object manager.
• Housing/territory/placement implementation.
• SQLite migration stream для этой системы.
• Применённые PostgreSQL runtime tables этой системы; сейчас присутствует только неприменённый migration draft.

Важное расхождение документации

Файл E:\LC\Unchained\Project\WORLD_INTERACTION_COMPLETE_GUIDE_RU.md описывает множество классов и миграций как уже существующие, но перечисленные WorldInteraction*, client controllers, db\sqlite_migrations\0001..0062 и PostgreSQL 0024..0047 в текущем дереве не обнаружены. До появления соответствующих файлов и статической проверки этот документ нельзя использовать как подтверждение готовой реализации.

4. Созданные артефакты

• WI System\IMPLEMENTATION_PLAN_RU.md.
• WI System\IMPLEMENTATION_PROGRESS_RU.md.
• WI System\world_interaction_sqlite_schema.sql.
• WI System\world_interaction_client_sqlite_schema.sql.
• Server\Sources\db\migrations\lc_game\0024_world_interaction_runtime.sql.

Ни один SQL-файл не применялся.

5. Статус по этапам реализации

Этап 0. Контракты и схема

• Подготовлена архитектура.
• Подготовлен packet contract на уровне плана.
• Подготовлена SQLite schema.
• Подготовлена PostgreSQL migration.
• Сверить DDL реального encrypted server compact.db.
• Утвердить C++ enum IDs и wire numbers.
• Проверить, не занято ли имя миграции 0024 в deployment/другой ветке.
• Провести code/DB review.

Этап 1. Базовый runtime

• Capability negotiation.
• Packet envelope и guards.
• InteractionTargetResolver.
• Action token/session.
• Idempotency service.
• InventoryTransaction.
• Immutable catalog loader/reload.
• Audit и metrics.
• Account labor repository/wallet.
• Character labor repository/wallet.
• Online/offline regeneration.
• Reservation/commit/release и labor ledger.
• Atomic reserved_balance accounting и conditional reservation transitions.
• Labor snapshot/update protocol.
• Реализация CUIPlayerInfo::UpdateLabor().
• Подключение CharacterActability к CPC.

Этап 2. NPC actions

• Action discovery service.
• NPC bindings loader.
• Service adapters.
• UIInteractActions.
• Регистрация XML и hotkeys/icons/tooltips.
• Distance/session invalidation.

Этап 3. Graph и interactive objects

• Graph validator/executor.
• World object runtime/replication.
• Phase/timer/respawn.
• Дверь, рычаг, сундук и ресурсный узел как pilot content.

Этап 4. Craft

• Server craft catalog.
• Workbench/NPC authorization.
• Timed jobs.
• Escrow/cancel/recovery.
• Result delivery.
• Проверка и атомарный расход account/character labor.
• Actability requirement/EXP и time/cost modifiers.
• Перевод рецептов по feature flag.

Этап 5. Loot

• Изменить NPC death lifecycle.
• CorpseLootContainer.
• Rights snapshot.
• Open/take/take-all.
• UILootWindow.
• Partial result/full inventory.
• Party rules/rolls.
• Ground fallback rollout.

Этап 6. Housing

• Territory loader/spatial index.
• Placement validator.
• Plot/building repository.
• Stages/material contributions.
• Permissions.
• Decorations/recovery.
• Restart restore.
• Stage visual resolver и exact client/server catalog validation.
• Labor reservation при construction actions.
• Admin diagnostics.

Этап 7. Verification и rollout

• Static code review.
• SQLite staging validation.
• PostgreSQL staging migration.
• Build client/server.
• Unit/integration tests.
• Packet fuzzing.
• Concurrency/restart tests.
• Load/soak tests.
• Staged production rollout.

6. Блокеры и решения

Блокер	Требуемое решение
Нет production compact.db в Sources	Предоставить/проверить staging-копию и точную DDL
Документация и физический migration stream расходятся	Утвердить следующий номер в deployment repository
Build/tests запрещены без разрешения	Получить отдельное явное разрешение перед запуском
EntitiesMP требует генерации	Сначала изменить .es, затем отдельно согласовать generator/ECC
Не определены production polygons	Content/level team должен предоставить координаты территорий и exclusions
Не определён набор action icons	Утвердить icon resources/IDs и клиентский каталог
Текущий craft неатомарен	Сначала реализовать InventoryTransaction и escrow

7. Следующий рекомендуемый шаг

Провести review двух SQL-файлов на фактической DDL staging databases, утвердить wire/enums и начать Этап 1. До этого нельзя безопасно писать content rows или подключать gameplay handlers.

8. Проверки, которые не выполнялись

• сборка клиента/сервера;
• unit/integration tests;
• запуск клиента/серверов;
• SQLite/SQLCipher применение;
• PostgreSQL migration;
• generators/ECC;
• packaging.

Для любой из этих операций требуется отдельное явное разрешение.