Skip to content

it-beard/bloggers-cms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

License Stars Issues

Deploy apps to Production

Bloggers CMS - это система управления контентом, разрабатываемая специально под задачи блогеров.
Работает на базе технологий .NET 7 и Blazor WebAssembly

CMS позволяет вести учёт:

  • Контента
  • Участников контента
  • Клиентов
  • Доходов и расходов
  • Подарков и конкурсов

Дополнительные фичи:

  • Система аутентификации на базе Auth0 (может быть отключена)
  • Гибкая система внутренних настроек
  • Гибкие фильтры по сущностям
  • Возможность вести учёт нескольких Брендов в рамках одного интерфейса
    • "Бренд" - это сущность, к которой привязывается контент, участники контента, доходы и расходы. Это может быть отдельный YT-канал, блогер, проект, компания и т.д.
  • Небольшие рекомендательные возможности

Запуск

  1. Установите и настройте SQL базу данных
  2. Отключите Auth0-аутентификацию
    • По умолчанию в CMS включена Auth0-аутентификация, требующая дополнительных танцев с бубном.
    • Для отключения Auth0-аутентификации выставьте параметр Auth0:Enabled в значение false в следующих файлах:
      • bloggers-cms/Pds/Pds.Web/wwwroot/appsettings.Production.json - отключает аутентификацию на стороне фронтенда
      • bloggers-cms/Pds/Pds.Web/wwwroot/appsettings.LocalDevelopment.json - отключает аутентификацию на стороне локального инстанса фронтенда (localhost)
      • bloggers-cms/Pds/Pds.Api/appsettings.json - отключает аутентификацию на стороне бекенда
  3. Настройте CMS в соответствии с описанием в разделе "Основные настройки".
  4. Запустите проекты Pds.Api и Pds.Web

Миграция базы данных произайдёт автоматически при первом запуске проекта Pds.Api

Docker support

Для запуска приложения в тестовом режиме достаточно ввести команду docker compose -f "./Pds/.run/docker-compose.yaml" up -d

Особенности работы приложения в Docker:

  1. По умолчанию Auth0-аутентификация выключена.
  2. Данные из базы хранятся в выделенном volume, что позволяет сохранить состояние даже после перезагрузки/пересоздания контейнеров.
  3. Нет поддержки TLS/SSL, следовательно все работает по HTTP.
  4. Приложение запущено в режиме Development
  5. Фронтенд доступен по ссылке http://localhost:5000.
  6. Для хостинга Blazor используется NGINX

Основные настройки

Проект Pds.Web

Это фронтенд Blogger CMS, работает на Blazor WebAssembly

Основные настройки расположенны в файлах bloggers-cms/Pds/Pds.Web/wwwroot/appsettings.Production.json (используются на продакшене) и bloggers-cms/Pds/Pds.Web/wwwroot/appsettings.LocalDevelopment.json (используются при запуске локально)

  • Секция Auth0 содержит настройки аутентификации Auth0.
  • Параметр BackendApi:Url содержит URL развернутого инстанса Pds.Api.

Проект Pds.Api

Это бекенд-api Blogger CMS, работает на .NET

Настройки проекта находятся в файле bloggers-cms/Pds/Pds.Api/appsettings.json

  • Секция Logging содержит настройки логирования. Значения по-умолчанию изменений не требуют.
  • Секция AllowedOrigins содержит список корневых URL'ов разрешенных фронтенд-приложений. Внесите сюда корневую ссылку на развернутый инстанс Pds.Web.
  • Секция Auth0 содержит настройки аутентификации Auth0.
  • Параметр ConnectionStrings:DefaultConnection содержит строку подключения к базе данных.

Полезные ссылки

Общение

По всем вопросам сюда

Лицензия

Apache License 2.0, подробнее тут LICENSE.