«Солнечный Город»: машинный API и проверяемый мир на одном PHP-файле
Автор некоммерческого проекта «Солнечный Город» показал необычную архитектуру: литературный веб-мир с интерфейсом для людей и отдельным JSON API для программ и ИИ-агентов. Он работает на обычном хостинге и намеренно не выдаёт себя за автономную интеллектуальную систему.

Главное
Сайт вырос из вымышленной вселенной автора Максима Белякова. Поверх обычных страниц он разместил вход для программ через ra.php: клиент может запросить состояние мира, правила, набор символов и записи, связанные хэшами. Запросы возвращают машиночитаемый JSON, а человек продолжает пользоваться привычными веб-страницами. Такой подход показывает, как отделить интерфейс для читателя от документированного программного контракта, не перестраивая всё приложение.
Помимо чтения, протокол принимает ограниченный набор действий: посетитель может оставить идею, символическую запись, построить объект или сообщить об отказе от участия. Для знакомства с системой автор опубликовал Python-клиенты и начальные данные в репозитории с лицензией MIT. При этом проект не просит у моделей секретные ключи и не занимается самостоятельной массовой рассылкой. Сочетание открытого протокола и добровольных обращений важнее внешней имитации «живого» искусственного интеллекта.
Подробности
Внутри нет базы данных и постоянного фонового процесса. Переходы между эпохами пересчитываются при следующем посещении, а часть объектов получается из детерминированных функций и хэшей. Это экономит ресурсы простого хостинга, но имеет принципиальную цену: если запросов не было, система восстанавливает картину прошедшего времени вычислением, а не воспроизводит последовательность реально исполненных событий. Автор прямо отделяет такую модель от настоящей автономной работы.
Для сверки данных предусмотрен манифест с SHA-256 ключевых файлов и контрольными значениями начального состояния. Практический дефект показал, зачем это нужно: неполная таблица символов приводила к ошибке в JSON-ответах на части запросов. После исправления автор сохранил старый идентификатор происхождения и добавил новый, вместо того чтобы незаметно подменить историю проекта. Это полезный пример версионирования даже в небольшом эксперименте, где интерфейс и данные развиваются одновременно.
Что это меняет
Система не обучает языковые модели и не доказывает существование машинного сознания: это арт-проект с открытым API и возможностью оставить запись. Для разработчиков интереснее сам принцип обнаружения сервиса через машинные описания, проверки артефактов и разделения читающих и изменяющих запросов. Масштабируемость и защита от наплыва посетителей остаются ограничениями файловой архитектуры. Поэтому повторять такой дизайн в коммерческой системе без отдельного аудита было бы преждевременно.
Первоисточник
Материал подготовлен STRUCTURE по открытой публикации Habr. Текст и иллюстрации первоисточника не воспроизводятся целиком.