E2E5 GitHub - Tipz/HT2 · GitHub
[go: up one dir, main page]

Skip to content
TipzPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Home Services Dashboard

Стартовая страница домашней сети на .NET 10 и Blazor Interactive Server. Приложение показывает активные сервисы, фильтрует их по категориям и предоставляет интерфейс управления каталогом.

Возможности MVP

  • адаптивные карточки активных и отключённых сервисов;
  • поиск и фильтры по категориям;
  • создание, редактирование и физическое удаление сервисов;
  • включение и отключение карточек;
  • управление отдельными сущностями категорий;
  • безопасные внешние ссылки только для абсолютных http/https URL;
  • 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.

EF Core migrations

Проект использует локальный 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

docker compose build
docker compose up -d
docker compose ps

Dashboard будет доступен по адресу 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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0