SHiNE-server/docs/Personal_Messages/README.md

Личные сообщения SHiNE

Эта папка содержит актуальную документацию по личным сообщениям SHiNE.

Точка входа:

• Dev_Docs/Personal_Messages/Протокол_DM_v1.md — логика протокола, роли API, серверное поведение, routing по access_servers
• Dev_Docs/Personal_Messages/Формат_DM_v1.md — точный бинарный формат контейнера SHiNE_DM
• Dev_Docs/Personal_Messages/Технические_вставки_DM_v1.md — формат специальных <SHiNE:...> вставок внутри plaintext DM после расшифровки

Исторический устаревший документ сохранён отдельно:

• Dev_Docs/Personal_Messages/Спецификация_DM_v0.5_устаревшая.md

Правило сопровождения:

• код DM и оба документа Протокол_DM_v1.md + Формат_DM_v1.md всегда должны обновляться синхронно;
• если меняется поведение DM в коде, в том же наборе изменений обновляется и эта документация.
• локальная таблица пользователей для DM считается кэшем, а источником истины остаётся Solana PDA; если серверная логика DM меняет правила lazy-import пользователей из PDA, это тоже обязательно фиксируется в документации.