Шаблоны проектов

Что настроено в каждом шаблоне

• SQLite с Pro База — файл рядом с приложением, создаётся при первом запуске. Pro бесплатен на всей линейке 4.x.
• PVT-префильтр и ChangeTracking Оба включены в Program.cs. Выборочный фильтр не читает всю схему, сохранение пишет только изменённые поля.
• Кэш Props в одном комментарии По умолчанию выключен. EnablePropsCache, PropsCacheMaxSize и PropsCacheTtl лежат комментарием рядом с остальными настройками.
• Docker и compose Dockerfile и compose-файлы для PostgreSQL и SQL Server в deploy/.

Другая база

Параметр --db есть только у redb. В остальных шаблонах переход — три правки, и каждый compose-файл повторяет их в шапке:

1. в .csproj заменить redb.SQLite.Pro на redb.Postgres.Pro или redb.MSSql.Pro;
2. в Program.cs заменить .UseSqlite(...) на закомментированный .UsePostgres(...) или .UseMsSql(...);
3. вписать строку подключения в appsettings.json. База должна существовать: RedBase создаёт свои таблицы, а не саму базу.

Свой хост или модуль Tsak

redb-worker, redb-chat и серверные части redb-app и redb-bff состоят из модуля и хоста. В модуле маршруты и public static InitRoute.main(IRouteContext). Хост строит контекст маршрутов и вызывает этот метод ровно так же, как воркер Tsak, поэтому код маршрутов существует в одном месте.

Настройки в обоих случаях собираются одинаково: сначала *.config.json модуля, затем секция Tsak:Contexts:<контекст>:Override конфигурации хоста, она главнее. Поэтому одна и та же переменная окружения, например Tsak__Contexts__myworker__Override__Folders__Inbox (контекст — имя проекта в нижнем регистре), работает и в своём хосте, и на воркере Tsak.

cp deploy/.env.example deploy/.env      # заполнить значения Tsak
pwsh deploy/pack-tpkg.ps1               # -> deploy/output/<Name>.tpkg
docker compose -f deploy/docker-compose.tsak.yml up -d

A redb: консольное приложение

Основы RedBase в одном Program.cs: создать объект, загрузить, изменить, выбрать LINQ-запросом по своим свойствам, посчитать агрегат в базе, построить дерево из трёх уровней и удалить его вместе с потомками.

dotnet new redb -n MyApp
cd MyApp
dotnet run

B redb-razor: сайт на Razor Pages

Список товаров с поиском по имени, фильтром «в наличии», сортировкой и страницами, всё в базе: страница никогда не загружает больше одной страницы объектов. Форма создания и правки с проверкой полей и тестовые данные при первом запуске.

dotnet new redb-razor -n MySite
cd MySite
dotnet run            # http://localhost:5080

C redb-blazor: сайт на Blazor

Тот же список и форма на интерактивном Blazor Server, плюс дерево категорий: корни из древовидного запроса, поддеревья, добавить потомка, удалить узел вместе с поддеревом.

dotnet new redb-blazor -n MySite
cd MySite
dotnet run            # http://localhost:5081

D redb-worker: интеграционный воркер

Файлы заказов приходят в папку, проверяются по XSD-схеме, сохраняются в RedBase одним шагом .Transacted(), и в ответ пишется файл-квитанция. Номер заказа — уникальный ключ объекта, поэтому повторный заказ получает ответ «дубликат», даже если две копии пришли одновременно.

dotnet new redb-worker -n MyWorker
cd MyWorker
dotnet run --project MyWorker.Host
# во втором терминале:
cp samples/order-1001.xml data/inbox/

Для другого источника меняется одна строка From(...): Sftp.Directory(...) из redb.Route.Sftp, As2.Receive(...) из redb.Route.As2, Sql.Poll(...) из redb.Route.Sql.

E redb-chat: LLM-чат

Чат на redb.Route.Llm. История разговора хранится в RedBase, поэтому чат продолжается после перезапуска. Общаться можно в консоли или по HTTP; разговор выбирает заголовок X-Chat-Id.

dotnet new redb-chat -n MyChat
cd MyChat
# впишите ключ API в MyChat.Host/appsettings.json (ApiKey)
dotnet run --project MyChat.Host
curl -d "привет" -H "X-Chat-Id: my-chat" http://localhost:5090/api/chat

F redb-app: приложение на Blazor WebAssembly

Клиент на WebAssembly, который работает в браузере, и API на REST DSL redb.Route: вход, список и форма товаров, дерево категорий. Два процесса, как в продакшене.

dotnet new redb-app -n MyApp
cd MyApp
dotnet run --project MyApp.Host     # API на http://localhost:5092
dotnet run --project MyApp.Web      # клиент на http://localhost:5082, admin / admin

POST /api/auth/login возвращает подписанный токен. Остальные маршруты объявлены с InboundAuth = Bearer: запрос без действующего токена получает 401 до того, как маршрут выполнится. В разработке API отвечает на CORS для порта клиента, а при развёртывании nginx отдаёт клиент и проксирует /api/, и браузер видит один источник.

cp deploy/.env.example deploy/.env   # APP_SIGNING_KEY, APP_ADMIN_PASSWORD
docker compose -f deploy/docker-compose.yml up --build   # http://localhost:8080

G redb-bff: Blazor BFF

Веб-сервер на Blazor Server, где пользователи входят с cookie-сессией, и бэкенд на контроллерах redb.Route, который принимает вызовы только от веб-сервера. Браузер не видит ни бэкенд, ни его ключ.

dotnet new redb-bff -n MyApp
cd MyApp
dotnet run --project MyApp.Host     # бэкенд на http://127.0.0.1:5093
dotnet run --project MyApp.Web      # веб-сервер на http://localhost:5083, admin / admin

Контроллеры берут IRedbService из запроса, Context.GetRedbService("", Exchange), поэтому параллельные запросы не делят соединение. Веб-сервер отправляет сервисный ключ как bearer-токен; любой другой вызывающий получает 401.

Сравнение