Стартовая страница домашней сети на .NET 10 и Blazor Interactive Server. Приложение показывает активные сервисы, фильтрует их по категориям и предоставляет интерфейс управления каталогом.
- адаптивные карточки активных и отключённых сервисов;
- поиск и фильтры по категориям;
- создание, редактирование и физическое удаление сервисов;
- включение и отключение карточек;
- управление отдельными сущностями категорий;
- безопасные внешние ссылки только для абсолютных
http/httpsURL; - SQLite persistence через EF Core migrations;
- Development demo data;
- structured logging через
ILogger<T>и Serilog; - unit, SQLite integration и bUnit component tests.
Authentication и authorization в MVP отсутствуют. Размещайте приложение только в доверенной сети или ограничивайте доступ на уровне reverse proxy/firewall.
- .NET SDK
10.0.302или совместимый patch согласноglobal.json; - Docker с Compose — только для контейнерного запуска.
dotnet tool restore
dotnet restore .\HomeServicesDashboard.slnx
dotnet build .\HomeServicesDashboard.slnx --no-restore
dotnet test .\HomeServicesDashboard.slnx --no-build
dotnet run --project .\src\HomeServicesDashboard.Web\HomeServicesDashboard.Web.csprojВ Development приложение применяет migrations и идемпотентно добавляет демонстрационные данные только в пустую базу. Локальный SQLite-файл создаётся в src/HomeServicesDashboard.Web/data/home-services.db и игнорируется Git.
Основные адреса:
/— каталог и единый режим управления;/manage— совместимый переход в режим управления на главной странице;/health— health endpoint.
dotnet format .\HomeServicesDashboard.slnx --verify-no-changes --no-restoreДля применения форматирования удалите --verify-no-changes.
Проект использует локальный dotnet-ef из dotnet-tools.json.
dotnet tool restore
dotnet tool run dotnet-ef migrations add <MigrationName> `
--project .\src\HomeServicesDashboard.Infrastructure\HomeServicesDashboard.Infrastructure.csproj `
--startup-project .\src\HomeServicesDashboard.Web\HomeServicesDashboard.Web.csproj `
--output-dir Persistence\Migrations
dotnet tool run dotnet-ef database update `
--project .\src\HomeServicesDashboard.Infrastructure\HomeServicesDashboard.Infrastructure.csproj `
--startup-project .\src\HomeServicesDashboard.Web\HomeServicesDashboard.Web.csprojНе редактируйте применённые migrations. Перед потенциально destructive migration создайте копию SQLite-файла и проверьте rollback на копии.
Секция Database:
| Ключ | Назначение | Значение по умолчанию |
|---|---|---|
ConnectionString |
SQLite connection string | Data Source=data/home-services.db |
ApplyMigrationsAtStartup |
Применять migrations при запуске | false, в Development — true |
SeedDemoData |
Добавлять demo data в пустую БД | false, в Development — true |
Production-значения передаются через environment variables, например:
Database__ConnectionString=Data Source=/app/data/home-services.db
Database__ApplyMigrationsAtStartup=true
Database__SeedDemoData=false
SeedDemoData=true вне Development намеренно завершает запуск ошибкой. Не помещайте credentials и приватные адреса в configuration files или demo data.
docker compose build
docker compose up -d
docker compose psDashboard будет доступен по адресу http://localhost:8080. SQLite хранится в named volume dashboard-data по пути /app/data/home-services.db внутри контейнера.
Остановить приложение без удаления данных:
docker compose downКоманда docker compose down --volumes удаляет volume и все данные без возможности штатного восстановления. Перед ней создайте резервную копию.
При запуске нескольких replicas отключите Database__ApplyMigrationsAtStartup и применяйте migrations отдельным deployment step.