============================================================================================
============================================================================================
==                            Описание электронного приложения                            ==
==                                к книге Владимира Дронова                               ==
==                    "Django 4: Практика создания веб-сайтов на Python"                  ==
============================================================================================
============================================================================================



--------------------------------------------------------------------------------------------
1. Состав архива
--------------------------------------------------------------------------------------------

Архив с электронным приложением включает в себя следующие файлы и папки:

 * bbclient   - папка с исходным кодом тестового веб-сайта, используемого при отладке
                веб-службы и написанного с применением веб-фреймворка Angular;

 * bboard     - папка с исходным кодом веб-сайта электронной доски объявлений,
                разрабатываемого на протяжении части IV книги на Python и Django;

 * readme.txt - этот файл.



--------------------------------------------------------------------------------------------
2. Развертывание Django-сайта
--------------------------------------------------------------------------------------------

Предполагается, что исполняющая среда Python уже установлена.

 1. Извлечь из архива папку bboard со всем ее содержимым.

 2. Запустить командную строку Windows.

 3. В командной строке выполнить переход в извлеченную из архива папку bboard.

 4. Запустить находящийся в ней файл установочного сценария, отдав команду:

          setup.cmd

    Через некоторое время все необходимые библиотеки, включая Django, будут установлены.

 5. Запустить отладочный веб-сервер Django, отдав команду в командной строке:

          manage.py runserver

 6. Запустить любой веб-обозреватель и перейти на сайт, набрав интернет-адрес
    http://localhost:8000/.

Подсистема отправки электронных писем настроена на вывод отправляемых сайтом писем в
командной строке.



--------------------------------------------------------------------------------------------
3. Зарегистрированные пользователи Django-сайта
--------------------------------------------------------------------------------------------

Читатели книги могут выполнять вход на сайт электронной доски объявлений от имени одного
из трех зарегистрированных на сайте пользователей (имя : пароль):

    admin : super-admin

    editor : super-editor

    user : super-user

У всех трех пользователей рассылка оповещений о новых комментариях отключена.



--------------------------------------------------------------------------------------------
4. Развертывание тестового Angular-фронтенда
--------------------------------------------------------------------------------------------

 1. Установить исполняющую среду Node.js. Найти ее можно по интернет-адресу
    https://nodejs.org/en/download/current/.

 2. Запустить командную строку Windows.

 3. В командной строке выполнить установку утилиты ng, отдав команду:

          npm install -g @angular/cli

    Через некоторое время утилита ng будет установлена.

 4. Извлечь из архива папку bbclient со всем ее содержимым.

 5. В командной строке выполнить переход в извлеченную из архива папку bbclient.

 6. Выполнить установку всех необходимых библиотек, отдав команду:

          npm install

    Через некоторое время библиотеки, необходимые для работы фронтенда, будут установлены.

 7. Запустить отладочный веб-сервер Angular, отдав команду в командной строке:

          ng serve

 8. Запустить любой веб-обозреватель и открыть фронтенд, набрав интернет-адрес
    http://localhost:4200/.



--------------------------------------------------------------------------------------------
5. Авторские права
--------------------------------------------------------------------------------------------

 * Авторские неимущественные права на оба сайта принадлежат автору книги Владимиру Дронову.

 * Все использованные на сайте графические изображения были взяты из открытых источников.

 * Код сайтов или его фрагменты могут быть свободно использованы для разработки других
   решений.