ASP.NET + MySQL — учебный помощникРасширение для подготовки к ПМ.04: создаёт Docker Compose для API и MySQL и хранит эту памятку прямо в описании расширения. Работает без интернета; Docker-образы и NuGet-пакеты при первом использовании требуют загрузки. Установка и использованиеВ VS Code: Extensions → меню «…» → Install from VSIX → выбери aspnet-mysql-study-helper-0.1.0.vsix. На Linux можно выполнить Открой папку решения, нажми Ctrl+Shift+P → «Учёба: создать Docker Compose (ASP.NET + MySQL)», выбери API и порты. Или нажми правой кнопкой на .csproj API. Файлы появятся в корне выбранной workspace-папки, чтобы Docker видел проекты, на которые ссылается API. Все ProjectReference должны находиться внутри этой папки. Создаются Команда «Учёба: открыть памятку EF / API / Avalonia» открывает этот текст. Это же описание доступно на странице установленного расширения. Расширение не запускает команды терминала, не меняет Program.cs и не устанавливает пакеты. Поддержаны стандартные Web SDK проекты с явным net8.0, net9.0 или net10.0. Нестандартный AssemblyName, несколько TargetFrameworks, свойства из Directory.Build.props и специальные символы в путях требуют ручной настройки. Шаблон предназначен для локальной учебной работы. Порядок подготовки
Нормализация на примере заказаНе храни список товаров в одной строке и не повторяй телефон клиента в каждом заказе. Пример: Clients(Id, FullName, Phone), Orders(Id, ClientId, Date), Products(Id, Name, Price), OrderItems(OrderId, ProductId, Quantity, UnitPrice). OrderItems связывает заказ с товарами. Цена в позиции сохраняет стоимость на момент продажи. 1НФ — одно значение в ячейке, без списков. 2НФ — неключевые поля зависят от полного составного ключа. 3НФ — неключевые поля не зависят друг от друга. Выбирай decimal для денег, NOT NULL для обязательных полей, UNIQUE для логина, FK для связей. Поведение удаления связанных записей продумай заранее. EF Core: сначала БД, затем кодScaffold читает существующие таблицы; пустая БД не даст нужных моделей. В таблицах нужны первичные ключи. Команды ниже выполняются в папке API в Bash на Linux. Пример согласованной связки: EF Core 9 + Pomelo 9 (для .NET 8+); не смешивай EF 10 с Pomelo 9. Для уже настроенного проекта согласуй версии с его зависимостями.
Если выбрал другой порт — возьми команду из DOCKER-STEPS.md. В Program.cs перед
Это минимальный пример подключения, без авторизации. Для локального запуска API добавь в appsettings.Development.json:
В контейнере Compose заменяет эту настройку через REST API и проверка правGET /api/products — список и поиск; GET /api/products/5 — одна запись; POST — создание; PUT /5 — изменение; DELETE /5 — удаление. Типичные ответы: 200, 201, 204, 400 (неверные данные), 401 (не вошёл), 403 (нет прав), 404 (не найдено), 409 (конфликт). Применяй DTO: не принимай от клиента роль, пароль-хеш и чужой UserId как доверенные данные. Проверяй строки, диапазоны, внешние ключи и существование записи. Используй async/await и SaveChangesAsync. Возвращай DTO вместо графа EF-сущностей, чтобы не получить циклы навигационных свойств. Авторизацию реализуй на API: пароль хешируй PasswordHasher или ASP.NET Core Identity, не храни открытым текстом. При JWT проверяй подпись, issuer, audience и срок действия; секрет держи вне исходников. Добавь AddAuthentication().AddJwtBearer(...), AddAuthorization(), затем UseAuthentication() и UseAuthorization() перед MapControllers(). На контроллерах используй [Authorize], на действиях — [Authorize(Roles = "Admin")]; вход — [AllowAnonymous]. Значения ролей должны совпадать с выданными claims. Для роли «видит только своё» фильтруй записи по ID из проверенных claims на сервере. Скрытая кнопка в Avalonia не заменяет проверку прав API. Проверь, что пользователь не может изменить чужую запись, подменив ID в запросе. Avalonia обращается только к APIИспользуй один переиспользуемый HttpClient, DTO и ViewModel. Минимальный фрагмент для авторизованного клиента:
token получается от твоего endpoint входа; ProductDto должен соответствовать JSON API. Для POST/PUT используй PostAsJsonAsync/PutAsJsonAsync и проверяй StatusCode; для DELETE — DeleteAsync. Обрабатывай сетевые ошибки, 401/403 и валидацию, показывай понятное сообщение. Не используй .Result и .Wait() в UI. Список связывай с ObservableCollection, поля и команды — с ViewModel, уведомляющей об изменениях. После входа покажи ФИО справа сверху. При выходе очисти токен, данные пользователя и списки, верни окно входа. MySQL-пароль не должен попадать в Avalonia. Для обычного настольного HttpClient CORS не требуется. Docker: объясни каждую команду
Compose создаёт общую сеть автоматически. Healthcheck проверяет вход в examdb, а depends_on ждёт её готовности перед стартом API. Это ожидание первого запуска, а не автоматическое восстановление соединений после любой аварии БД. После изменения учётных данных YAML существующий том сохраняет старые пользователей и пароли. Что проверить перед сдачей
Источники и разработкаИсходники — обычный JavaScript без runtime-зависимостей. Проверка: |