it-beard/bloggers-cms

Content-management system for bloggers

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 содержит строку подключения к базе данных.

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

• Настройка аутентификации в CMS через Auth0: https://github.com/it-beard/bloggers-cms/wiki/Authorisation-configuration
• Wiki проекта: https://github.com/it-beard/bloggers-cms/wiki
• Kanban-доска: https://github.com/orgs/it-beard/projects/4

Общение

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

Лицензия

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