Packaging/PUBLISHING.RU.md

@@ -0,0 +1,383 @@
+# Публикация в Microsoft Store
+
+Инструкция с нуля: от регистрации разработчика до отправки пакета на проверку.
+Документ существует только на русском — переводить его не нужно.
+
+Ссылки на первоисточники стоят по ходу текста, сводный список — в конце.
+Правила Store меняются, поэтому перед подачей стоит сверяться с ними, а не с
+пересказом здесь: этот документ отражает положение дел на август 2026 года.
+
+## 1. Аккаунт разработчика
+
+С 2026 года регистрация бесплатна для обоих типов аккаунта. Прежние взносы
+($19 и $99) отменены — [объявление для компаний][free-company],
+[объявление для частных лиц][free-individual]. Новостные заметки за 2025 год,
+где у Company ещё указан взнос $99, устарели.
+
+**Начинать нужно с https://storedeveloper.microsoft.com** — это единственный
+вход в бесплатный процесс регистрации. Если зайти через Partner Center, Visual
+Studio или Xbox, откроется старый порядок со взносом.
+
+### Какой тип выбрать
+
+Критерии обоих типов и порядок регистрации — [«Открытие аккаунта
+разработчика»][open-account].
+
+| | Individual | Company |
+|---|---|---|
+| Кому | частное лицо, хобби, некоммерческие проекты | ИП, ТОО, организация — всё, что связано с предпринимательской деятельностью |
+| Имя издателя в Store | ваше имя | название организации |
+| Вход | только личный аккаунт Microsoft | личный аккаунт или рабочий Microsoft Entra ID |
+| Проверка | документ с фотографией и селфи | D-U-N-S или уставные документы плюс рабочая почта на домене организации |
+| Срок | минуты, если снимки читаемые | от минут до 2–5 рабочих дней при ручной проверке |
+
+Company доступен только тем, у кого уже есть зарегистрированное юридическое лицо
+или ИП: проверка требует либо номера D-U-N-S, либо регистрационных документов.
+Без них остаётся Individual, и для личного бесплатного приложения этого
+достаточно.
+
+Три вещи после регистрации **не меняются** — тип аккаунта, страна и имя издателя
+([FAQ по управлению аккаунтом][account-faq]). Что с этим делать при отсутствии
+компании и планах на платный продукт, разобрано в
+[разделе 9](#9-регистрация-из-казахстана).
+
+### Что подготовить
+
+**Для Individual:** удостоверение личности или паспорт (оригинал, не копия) и
+телефон с камерой — снимок документа и селфи делаются на мобильном.
+
+**Для Company:**
+- номер D-U-N-S, если он есть — тогда данные подтянутся автоматически и проверка
+  пройдёт быстрее. Иначе понадобится справка о регистрации, устав или выписка из
+  государственного реестра;
+- почта на домене организации. Gmail и подобные не принимаются; если домен почты
+  не совпадает с доменом организации, попросят подтвердить владение доменом —
+  счётом от регистратора или записью из реестра доменов.
+
+На каждый вид проверки даётся не более трёх попыток, поэтому данные лучше
+перепроверить до отправки. Ответить на запрос документов нужно в течение 30 дней.
+
+### Налоги и выплаты
+
+Приложение бесплатное, встроенных покупок и рекламы нет — значит платёжный
+профиль и налоговые формы не нужны ([FAQ по управлению аккаунтом][account-faq]).
+Они потребуются, только если появятся платные функции, — тогда см.
+[раздел 8](#8-если-приложение-будет-платным).
+
+После создания аккаунта данные расходятся по Partner Center до получаса. Если
+раздел «Apps & Games» не появился сразу — подождать и обновить страницу.
+
+## 2. Резервирование имени
+
+Partner Center → **Apps and games** → **New product** → **MSIX or PWA app**.
+Ввести имя, нажать **Check availability**, затем **Reserve product name**.
+
+Подробности — [«Резервирование имени приложения MSIX»][reserve-name] и
+[«Управление резервированием имён»][manage-names].
+
+Имя можно занять за три месяца до публикации, даже если приложение ещё не
+готово. Стоит сразу занять запасные написания — например `CursorLang` и
+`Cursor Lang`.
+
+## 3. Данные пакета
+
+После резервирования: **Product management** → **Product identity**. На странице
+будут три значения:
+
+| Значение в Partner Center | Куда подставить |
+|---|---|
+| Package/Identity/Name | параметр `-IdentityName` |
+| Package/Identity/Publisher | параметр `-Publisher`, вида `CN=` и длинный идентификатор |
+| Package/Properties/PublisherDisplayName | параметр `-PublisherDisplayName` |
+
+Эти значения должны совпадать с манифестом пакета до символа. Расхождение даёт
+при загрузке невнятную ошибку, которая не называет поле, — поэтому копировать
+их нужно буквально, а не набирать руками. Разбор таких ошибок —
+[«Устранение ошибок отправки MSIX»][submission-errors].
+
+В сборочном конвейере эти значения лежат в переменных репозитория
+`MSIX_IDENTITY_NAME`, `MSIX_PUBLISHER` и `MSIX_PUBLISHER_DISPLAY_NAME`. Это
+переменные, а не секреты: identity виден в любом опубликованном пакете, а
+маскирование в логах только мешало бы разбирать ошибки сборки.
+
+## 4. Сборка пакета
+
+```powershell
+pwsh -File Packaging\build-msix.ps1 `
+    -Version 1.0.0.0 `
+    -IdentityName "<Package/Identity/Name>" `
+    -Publisher "<Package/Identity/Publisher>" `
+    -PublisherDisplayName "<PublisherDisplayName>"
+```
+
+Получится `artifacts\packages\CursorLang-1.0.0.0-x64.msix`. Загружать его нужно
+**без подписи**: Store подписывает пакет своим сертификатом.
+
+Версия при каждой следующей отправке должна расти, а последнее число всегда
+остаётся нулём.
+
+## 5. Заявка
+
+**Product release** → **Start submission**. Разделы можно заполнять в любом
+порядке. Полный перечень полей с пометками обязательности —
+[«Создание заявки для приложения MSIX»][create-submission].
+
+### Pricing and availability
+
+Обязательны рынки, аудитория, обнаружимость, расписание и цена. Всё, кроме цены,
+имеет разумные значения по умолчанию — цену выставить **Free**
+([подробности о ценах и доступности][price-availability]).
+
+### Properties
+
+- **Category** — обязательна. Подходит *Productivity* либо *Utilities & tools*.
+- **Privacy policy URL** — обязателен, только если приложение собирает или
+  передаёт персональные данные. CursorLang не собирает ничего: настройки лежат
+  в папке приложения, наружу ничего не уходит. Поле можно оставить пустым, но
+  безопаснее выложить короткую страницу с фразой о том, что данные не
+  собираются, — это снимает вопросы у проверяющих.
+- **Contact details** — обязательны для аккаунта Company.
+
+### Age ratings
+
+Обязательна вся анкета. Приложение не игровое, ничего не собирает — ответы
+однозначные, рейтинг присвоится автоматически.
+
+### Packages
+
+Загрузить `.msix`. Раздел остаётся «Incomplete», пока не заполнены все
+обязательные поля, даже если сам пакет уже помечен как «Validated».
+
+### Store listings
+
+Хотя бы для одного языка. Стоит заполнить и английский, и русский — приложение
+переведено на оба. Основным лучше сделать английский: он работает как запасной
+вариант для рынков, где отдельного перевода нет.
+
+Обязательны описание и **минимум один снимок экрана** (рекомендуется четыре и
+больше). Снимки: PNG, от 1366×768. Показать стоит окно настроек и саму подсказку
+у курсора — вторую снять сложнее, поможет отложенный снимок экрана.
+
+### Submission options
+
+- **Restricted capabilities** — заполнить обязательно, потому что пакет объявляет
+  `runFullTrust`. Для обычной программы рабочего стола это подтверждается без
+  разбирательств; в обосновании достаточно написать, что приложение — обычная
+  программа Windows, а не UWP.
+- **Notes for certification** — не обязательно, но здесь лучше не молчать.
+  Приложение ставит низкоуровневый перехватчик клавиатуры, и без объяснений это
+  выглядит подозрительно. Стоит написать примерно так:
+
+  > The app installs a WH_KEYBOARD_LL hook to offer an optional Caps Lock
+  > shortcut that switches the keyboard layout instead of toggling case. The
+  > hook only inspects the Caps Lock key, is off by default, and is enabled by
+  > the user in the app's settings. No keystrokes are recorded, stored or
+  > transmitted anywhere.
+
+Затем **Submit for certification**.
+
+## 6. Чего ждать от проверки
+
+Проверка занимает обычно от нескольких часов до трёх дней. Проверяющие смотрят
+сам пакет, а не исходники: ссылка на репозиторий им не нужна и, скорее всего,
+останется без внимания. Всё, что важно донести, идёт в Notes for certification.
+
+Слабые места именно этого приложения:
+
+- **Перехватчик клавиатуры.** Главный повод для вопросов. Снимается пояснением в
+  Notes for certification и тем, что настройка выключена по умолчанию.
+- **Права администратора.** Их больше нет — ни в манифесте, ни в поведении.
+  Возможности `allowElevation` в пакете тоже нет. Возвращать их нельзя:
+  «приложения, которым права администратора нужны хоть для какой-то части
+  работы, в Store не принимаются» — [«Подготовка к упаковке»][prepare-package].
+- **Чистое удаление.** Настройки упакованной версии лежат в папке данных пакета
+  и уходят вместе с ним — это проверено.
+
+Общие требования, по которым идёт проверка, — [правила Microsoft Store][policies].
+
+## 7. Обновления
+
+Порядок тот же, короче: поднять версию, собрать пакет теми же значениями
+identity, создать новую заявку, загрузить пакет. Имя резервировать заново не
+нужно.
+
+## 8. Если приложение будет платным
+
+Раздел на будущее: для CursorLang ничего из этого не нужно.
+
+### Нужен ли для этого Company
+
+Не обязательно. Платёжный профиль доступен обоим типам аккаунта, и запрета
+продавать с Individual в документации нет ([FAQ по управлению
+аккаунтом][account-faq]). Критерий Individual против Company описывает характер
+деятельности ([типы аккаунтов][account-types]), а не техническую возможность
+брать деньги.
+
+Практический вывод: заводить ИП **ради требований Microsoft** не нужно. Оно
+скорее понадобится по местному праву — чтобы легально оформлять регулярный доход
+из-за рубежа. Это вопрос к бухгалтеру, а не к Partner Center.
+
+Если всё же понадобится именно Company, помните: сменить тип у существующего
+аккаунта нельзя, придётся заводить второй, а уже опубликованные приложения в
+него штатно не переедут — см. [раздел 9](#9-регистрация-из-казахстана).
+
+### Платёжный и налоговый профиль
+
+Account settings → **Payout and tax profile**
+([порядок настройки][payout-setup]). Без них платное приложение не отправить на
+проверку. Понадобятся банковский счёт и налоговая форма: для тех, кто не платит
+налоги в США, это W-8BEN (частное лицо) или W-8BEN-E (организация)
+([налоговые сведения][tax-info], [налоговые обязанности][tax-details]).
+
+Между Казахстаном и США действует соглашение об избежании двойного
+налогообложения, поэтому удержание с продаж в США ниже базовых 30%. Точную
+ставку показывают при заполнении формы — гадать заранее не нужно.
+
+### Выплаты в Казахстан
+
+Поддерживаются. По [таблице выплат по регионам][payout-regions] для Казахстана
+доступны и Microsoft Store, и PayPal.
+
+| | |
+|---|---|
+| Порог выплаты | 50 USD — ниже суммы накапливаются |
+| PayPal | около одного рабочего дня |
+| ACH/SEPA | два–три рабочих дня |
+| Банковский перевод | семь–десять рабочих дней |
+
+### Доля Microsoft
+
+По действующим условиям — 15% с продаж приложений и 12% с игр; для неигровых
+приложений можно подключить собственную платёжную систему и оставлять себе всю
+выручку. Эти цифры широко приводятся в отраслевых публикациях, но отдельной
+страницы с ними в документации нет: обязывающий документ —
+[соглашение разработчика приложений][developer-agreement], и сверяться нужно с
+его действующей редакцией.
+
+### Что меняется в самом приложении
+
+Почти ничего. Store выдаёт лицензию при покупке и без неё приложение не
+устанавливает, так что проверка в коде не обязательна. При желании лицензию
+читают через [`Windows.Services.Store`][store-api]. Пробный период включается в
+Partner Center и правок в коде не требует.
+
+### Рынки
+
+Для платного приложения список стран стоит выбрать осознанно, а не оставлять
+«все»: где-то автоматически пересчитанная цена окажется неуместной, где-то
+появятся местные налоговые обязанности.
+
+## 9. Регистрация из Казахстана
+
+Раздел для случая, когда разработчик живёт и платит налоги в Казахстане, а
+гражданство у него другое. Юридических советов здесь нет — только то, что
+касается устройства Partner Center.
+
+### Страна аккаунта важнее гражданства
+
+Microsoft смотрит на страну проживания и налогового резидентства, а не на
+паспорт. Страна указывается при регистрации и **после неё не меняется**
+([FAQ по управлению аккаунтом][account-faq]); штатного способа исправить её нет,
+остаётся обращение в поддержку без гарантии результата.
+
+Разница между Казахстаном и Россией существенная и необратимая:
+
+| | Казахстан | Россия |
+|---|---|---|
+| Выплаты Microsoft Store | да | да, но PayPal помечен как приостановленный |
+| Налоговое соглашение с США | [действует][irs-kazakhstan], предел по роялти 10% | [приостановлено с 16 августа 2024][irs-russia] |
+| Удержание в США | 10% при поданной форме W-8BEN | 30%, льготные ставки не применяются |
+
+Данные о выплатах — из [таблицы выплат по регионам][payout-regions], налоговые —
+из перечня [действующих соглашений США][irs-treaties].
+
+### Документ и автозаполнение профиля
+
+Регистрация Individual идёт через снимок документа и селфи, после чего профиль
+**заполняется данными из документа**. Отсюда практическое правило: если есть
+казахстанский документ — вид на жительство или удостоверение личности, —
+верифицироваться лучше по нему. Если под рукой только иностранный паспорт,
+страну и адрес нужно проверить и при необходимости исправить на казахстанские
+**до** подтверждения профиля.
+
+### Имя издателя задаётся один раз
+
+Publisher display name — то, что видят пользователи в карточке приложения, — тоже
+не меняется после регистрации. Если в Store должно значиться название бренда, а
+не ФИО, это задаётся на шаге заполнения профиля. Переименование потом — только
+через поддержку, с вероятным ответом «заводите новый аккаунт».
+
+### Приложения между аккаунтами не переносятся
+
+Штатной процедуры передачи приложения из одного аккаунта в другой в Partner
+Center нет. Значит, если позже завести отдельный Company-аккаунт под платный
+продукт, ранее опубликованное бесплатное приложение останется на первом.
+
+Для бесплатной утилиты это не проблема: она продолжит работать и обновляться там,
+где опубликована. Но переиграть решение задним числом не выйдет, поэтому выбор
+имени издателя и страны стоит сделать вдумчиво с первого раза.
+
+### Порядок действий
+
+1. Начать с https://storedeveloper.microsoft.com — иначе откроется старый платный
+   процесс.
+2. Выбрать **Individual**, если зарегистрированного юридического лица или ИП нет.
+3. Верифицироваться по казахстанскому документу, если он есть.
+4. Проверить, что страна в профиле — Казахстан, а адрес казахстанский.
+5. Проверить имя издателя: оно останется навсегда.
+6. Платёжный и налоговый профиль пропустить — для бесплатного приложения он не
+   нужен.
+
+Когда дойдёт до платного приложения, добавится форма
+[W-8BEN][w8ben] с указанием Казахстана как страны налогового резидентства и ИИН в
+поле иностранного налогового номера. Сертификат налогового резидентства РК
+Microsoft не запрашивает, но он подтверждает право на ставку 10%, если вопрос
+возникнет.
+
+## Источники
+
+- [Открытие аккаунта разработчика][open-account]
+- [Типы аккаунтов разработчика][account-types]
+- [Бесплатная регистрация для компаний][free-company]
+- [Бесплатная регистрация для частных лиц][free-individual]
+- [FAQ по управлению аккаунтом][account-faq]
+- [Резервирование имени приложения MSIX][reserve-name]
+- [Управление резервированием имён][manage-names]
+- [Создание заявки для приложения MSIX][create-submission]
+- [Цены и доступность][price-availability]
+- [Устранение ошибок отправки MSIX][submission-errors]
+- [Подготовка к упаковке программы рабочего стола][prepare-package]
+- [Правила Microsoft Store][policies]
+- [Настройка платёжного и налогового профиля][payout-setup]
+- [Выплаты по регионам][payout-regions]
+- [Налоговые сведения][tax-info]
+- [Налоговые обязанности][tax-details]
+- [Соглашение разработчика приложений][developer-agreement]
+- [API лицензий и покупок Windows.Services.Store][store-api]
+- [Форма W-8BEN, IRS][w8ben]
+- [Действующие налоговые соглашения США, IRS][irs-treaties]
+- [Соглашение США — Казахстан, IRS][irs-kazakhstan]
+- [Соглашение США — Россия и его приостановка, IRS][irs-russia]
+
+[open-account]: https://learn.microsoft.com/en-us/windows/apps/publish/partner-center/open-a-developer-account
+[account-types]: https://learn.microsoft.com/en-us/windows/apps/publish/partner-center/partner-center-developer-account
+[free-company]: https://learn.microsoft.com/en-us/windows/apps/publish/whats-new-company-developer
+[free-individual]: https://learn.microsoft.com/en-us/windows/apps/publish/whats-new-individual-developer
+[account-faq]: https://learn.microsoft.com/en-us/windows/apps/publish/faq/manage-your-account
+[reserve-name]: https://learn.microsoft.com/en-us/windows/apps/publish/publish-your-app/msix/reserve-your-apps-name
+[manage-names]: https://learn.microsoft.com/en-us/windows/apps/publish/partner-center/msix/manage-app-name-reservations
+[create-submission]: https://learn.microsoft.com/en-us/windows/apps/publish/publish-your-app/msix/create-app-submission
+[price-availability]: https://learn.microsoft.com/en-us/windows/apps/publish/publish-your-app/msix/price-and-availability
+[submission-errors]: https://learn.microsoft.com/en-us/windows/apps/publish/publish-your-app/msix/resolve-submission-errors
+[prepare-package]: https://learn.microsoft.com/en-us/windows/msix/desktop/desktop-to-uwp-prepare
+[policies]: https://learn.microsoft.com/en-us/windows/apps/publish/store-policies
+[payout-setup]: https://learn.microsoft.com/en-us/partner-center/account-settings/set-up-your-payout-account
+[payout-regions]: https://learn.microsoft.com/en-us/partner-center/marketplace-offers/payment-thresholds-methods-timeframes
+[tax-info]: https://learn.microsoft.com/en-us/partner-center/marketplace-offers/tax-information-for-commercial-marketplace
+[tax-details]: https://learn.microsoft.com/en-us/partner-center/marketplace-offers/tax-details-marketplace
+[developer-agreement]: https://learn.microsoft.com/en-us/legal/windows/agreements/app-developer-agreement
+[store-api]: https://learn.microsoft.com/en-us/windows/uwp/monetize/in-app-purchases-and-trials
+[w8ben]: https://www.irs.gov/forms-pubs/about-form-w-8-ben
+[irs-treaties]: https://www.irs.gov/businesses/international-businesses/united-states-income-tax-treaties-a-to-z
+[irs-kazakhstan]: https://www.irs.gov/businesses/international-businesses/kazakhstan-tax-treaty-documents
+[irs-russia]: https://www.irs.gov/businesses/international-businesses/russia-tax-treaty-documents