49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# AGENTS.md
|
||
|
||
## Documentation Rule
|
||
|
||
В проекте есть спецификация пользовательской PDA-записи:
|
||
|
||
- `doc/SHINE_USER_PDA_V1.md`
|
||
|
||
Если меняется формат записи, сериализация, правила подписи, `prev_hash`, экономика лимитов или связанные ограничения create/update, этот документ нужно обновлять в том же изменении.
|
||
|
||
## Language Rule
|
||
|
||
Во всем проекте использовать русский язык:
|
||
|
||
- комментарии в коде;
|
||
- тексты в файлах настроек и справочных файлах;
|
||
- сообщения и описания в коммитах;
|
||
- сопроводительные технические заметки.
|
||
|
||
## Rule: Logic and Docs
|
||
|
||
Если меняется бизнес-логика смарт-контрактов, сериализация PDA, правила переводов или экономика:
|
||
|
||
1. Обновить соответствующий документ в `doc/` в том же изменении.
|
||
2. Если документ сразу обновить нельзя, обязательно явно согласовать это с пользователем в чате и зафиксировать план обновления.
|
||
|
||
## Rule: Git Push
|
||
|
||
Для push в удаленный репозиторий использовать токен из переменной окружения:
|
||
|
||
- `GITEA_TOKEN`
|
||
|
||
Push выполнять через `http.extraHeader` (Authorization) без вывода токена в логи.
|
||
|
||
## Rule: Commit Messages
|
||
|
||
Текст commit message писать на русском языке.
|
||
|
||
## Rule: UI Deploy
|
||
|
||
Деплой UI Shine Payments выполнять через Gradle из папки `shine`:
|
||
|
||
1. `gradle deployUi`
|
||
2. `gradle checkUiRemote`
|
||
|
||
Где смотреть детали (пути деплоя, путь Caddy, рабочие URL):
|
||
|
||
- комментарии в `build.gradle` (в корне `shine/`).
|