Студсайт - История изменений

Nepike: Убраны разделы «Что есть на сайте» и «Посмотреть сайт глазами пользователя»

2026-09-27T21:27:06Z

Убраны разделы «Что есть на сайте» и «Посмотреть сайт глазами пользователя»

@@ Строка 1: / Строка 1: @@
 {{Статус страницы|ответственный=[[Участник:Nepike|Nepike]]|проверено=2026-09-27}}
 '''Студсайт''' — студенческий портал факультета КНТ МФТИ: [https://knt-mipt.ru knt-mipt.ru]. Главный проект, который поддерживает IT-отдел. Исходный код открыт: [https://github.com/Nepike/knt-portal github.com/Nepike/knt-portal].
 == Как появляются аккаунты ==
@@ Строка 84: / Строка 71: @@
 {{TODO|Завести отдельную ветку для разработки и, возможно, бета-версию сайта, чтобы изменения не попадали на прод сразу}}
-== Администрирование ==
+== Telegram-чаты ==
 Бот сайта пишет в отдельные Telegram-группы: фидбек, техподдержка, в будущем — магазин; со временем могут появиться и другие. Людей в группы добавляет глава отдела.
 Куда писать, задаётся не в коде, а в админке сайта (<code>/admin/</code>, раздел «Телеграм-чаты»): название, chat ID и, для групп с темами, ID темы. Chat ID живого чата можно узнать у бота командой <code>/get_chat_id</code>.
 == Локальный запуск ==

Nepike: /* Предыдущие версии */

2026-09-27T20:50:48Z

Предыдущие версии

← Предыдущая версия		Версия от 23:50, 27 сентября 2026
Строка 109:		Строка 109:

	== Предыдущие версии ==		== Предыдущие версии ==
	Первое поколение этого сайта — [https://github.com/Nepike/knt-portal-legacy knt-portal-legacy]~~; данные из него переносятся командами <code>import_legacy*</code>~~.		Первое поколение этого сайта — [https://github.com/Nepike/knt-portal-legacy knt-portal-legacy].

	== Доступ ==		== Доступ ==

Nepike: Домены — на отдельной странице; категория по области

2026-09-27T18:59:30Z

Домены — на отдельной странице; категория по области

← Предыдущая версия		Версия от 21:59, 27 сентября 2026
Строка 31:		Строка 31:
	\| files.inbicst.ru \|\| Отдельный домен для скачивания файлов сайта		\| files.inbicst.ru \|\| Отдельный домен для скачивания файлов сайта
	\|}		\|}
	~~Домены~~ зарегистрированы на главу отдела — Макса Щучкина ([[Участник:Nepike\|Nepike]]) — у регистратора [https://masterhost.ru masterhost.ru], логин <code>c540014</code> (пароль — у Nepike). DNS-записи ~~при этом редактируются не там, а в [https://dash.cloudflare.com Cloudflare] — в общем аккаунте отдела «INBICST». Как получить доступ~~ — см. [[~~Доступы~~]].		Где зарегистрированы домены и как настраиваются DNS-записи — см. [[Домены и DNS]].

	== Как устроен ==		== Как устроен ==
Строка 114:		Строка 114:
	Как получить доступ к репозиторию и серверу — см. [[Доступы]].		Как получить доступ к репозиторию и серверу — см. [[Доступы]].

	[[Категория:~~За что отвечает отдел~~]]		[[Категория:Сайт и онлайн-сервисы]]

Nepike: Первая версия (черновик из репозитория knt-wiki)

2026-09-27T17:36:52Z

Первая версия (черновик из репозитория knt-wiki)

Новая страница

{{Статус страницы|ответственный=[[Участник:Nepike|Nepike]]|проверено=2026-09-27}}
'''Студсайт''' — студенческий портал факультета КНТ МФТИ: [https://knt-mipt.ru knt-mipt.ru]. Главный проект, который поддерживает IT-отдел. Исходный код открыт: [https://github.com/Nepike/knt-portal github.com/Nepike/knt-portal].

== Что есть на сайте ==
Почти весь сайт доступен только после входа. Без аккаунта открываются страница для абитуриентов (<code>/about/</code>, туда же ведёт главная), контакты (<code>/contacts/</code>), форма поддержки и страницы входа.

Для студентов:
* '''Материалы''' — учебные материалы, которые загружают студенты; проходят модерацию.
* '''Библиотека''' — каталог книг, тоже с модерацией.
* '''Преподаватели''' — карточки преподавателей и отзывы студентов.
* '''Лекторий''' — видеолекции (плейлисты проходят проверку, плеер HLS).
* '''Чаты''' — с участниками, реакциями и вложениями, обновляются в реальном времени.
* '''Стена''' — пиксельный холст в духе r/place, тоже в реальном времени.
* '''Экономика и косметика''' — внутренняя валюта и то, что на неё покупается: рамки аватара и шапки профиля.
* '''Закладки''' и '''комментарии''' к материалам и лекциям.

== Как появляются аккаунты ==
Регистрация закрытая: аккаунты заводит администратор сайта на странице <code>/registration/</code> (нужно право на создание пользователей).
* '''По одному''' — через форму на этой странице.
* '''Целым курсом''' — загрузить таблицу <code>.xlsx</code>: обычно это выгрузка ответов Google-формы. Обязательны столбцы с ФИО, почтой и группой; дата рождения и Telegram — по желанию. Столбцы ищутся по началу слова в заголовке, поэтому «Почта», «Удобная почта» и «e-mail» распознаются одинаково, а лишние столбцы пропускаются. До 500 строк и 5 МБ.
Каждому новому пользователю приходит письмо со ссылкой для входа. Почты, которые уже есть на сайте, пропускаются — одну и ту же выгрузку можно загружать повторно, когда в форме прибавились ответы.

== Адреса ==
{| class="wikitable"
! Адрес !! Что это
|-
| [https://knt-mipt.ru knt-mipt.ru] || Основной адрес сайта
|-
| inbicst.ru, fnbic.ru, new.knt-mipt.ru || Старые адреса, перенаправляют на knt-mipt.ru (факультет раньше назывался ИНБИКСТ)
|-
| files.inbicst.ru || Отдельный домен для скачивания файлов сайта
|}
Домены зарегистрированы на главу отдела — Макса Щучкина ([[Участник:Nepike|Nepike]]) — у регистратора [https://masterhost.ru masterhost.ru], логин <code>c540014</code> (пароль — у Nepike). DNS-записи при этом редактируются не там, а в [https://dash.cloudflare.com Cloudflare] — в общем аккаунте отдела «INBICST». Как получить доступ — см. [[Доступы]].

== Как устроен ==
Сайт работает на [[Сервер сайта|сервере сайта]] в виде набора Docker-контейнеров (проект Docker Compose в <code>/srv/knt</code>).

'''Технологии:''' Python 3.12, Django 6, PostgreSQL 17, Redis, Celery, Django Channels (WebSockets), HTMX и Tailwind 4, хранилище файлов Cloudflare R2, nginx, GitHub Actions.

=== Контейнеры ===
{| class="wikitable"
! Контейнер !! Что делает
|-
| <code>web</code> || Сам сайт: Django под gunicorn с двумя uvicorn-воркерами (ASGI, нужен для WebSockets). При старте применяет миграции и собирает статику. Слушает <code>127.0.0.1:8001</code>, снаружи к нему ходит только nginx.
|-
| <code>db</code> || PostgreSQL 17, данные в docker-томе <code>knt_pgdata</code>.
|-
| <code>redis</code> || Четыре задачи на четырёх базах: 0 — шина WebSockets, 1 — очередь Celery, 2 — результаты задач, 3 — кэш (на нём ограничители частоты запросов). На диск ничего не пишет: при перезапуске терять нечего.
|-
| <code>worker</code> || Celery: фоновые задачи, которых пользователь не должен ждать, — отправка почты и сообщений в Telegram. Один процесс: задачи редкие, а памяти на сервере мало.
|-
| <code>beat</code> || «Будильник»: сам ничего не делает, только кладёт задачи по расписанию в очередь. Сейчас это одна задача — ночная уборка брошенных загрузок.
|-
| <code>bot</code> || Telegram-бот сайта: пишет в рабочие чаты (см. [[#Telegram-чаты|ниже]]).
|}

=== Как проходит запрос ===
<pre>
браузер ──HTTPS──> nginx на сервере ──> 127.0.0.1:8001 (web: Django) ──> PostgreSQL, Redis
│
└── файлы: отдаёт сам nginx (с диска или из Cloudflare R2),
Django только разрешает доступ
</pre>
HTTPS-сертификаты — Let's Encrypt, их выпускает и продлевает certbot на сервере.

=== Файлы и видео ===
Файлы пользователей хранятся в '''Cloudflare R2''' (S3-совместимое хранилище). Большие файлы браузер загружает прямо в R2, минуя сервер, а при скачивании байты отдаёт nginx — Python в передаче файлов не участвует.

Файлы лежат в R2 в том же общем аккаунте Cloudflare «INBICST», что и DNS.

Сервер '''не перекодирует видео''': на нём нет и не будет ffmpeg. Видео для лектория и косметики готовит '''«пекарня»''' — скрипт <code>tools/bake.py</code> на машине с видеокартой (ffmpeg + NVENC). Сейчас это новый [[Факультетский сервер|факультетский сервер]] на М4, где пекарня работает как служба systemd. Она сама забирает задания из очереди сайта, скачивает исходник из R2 и загружает туда готовый результат. Пекарне нужен только исходящий интернет, поэтому при поломке её можно запустить на любом компьютере с видеокартой. Подробно — <code>docs/media-pipeline.md</code> в репозитории.

=== Почта ===
Письма (приглашения, восстановление пароля) уходят с адреса <code>info@knt-mipt.ru</code> через SMTP Google (<code>smtp.gmail.com</code>, порт 465, SSL). Отправляет их не сам запрос, а воркер Celery через очередь — медленный почтовый сервер не тормозит сайт. Пароль от почты хранится в <code>.env</code> на сервере.

== Как выкатываются изменения ==
Push в ветку <code>main</code> — это и есть деплой:
# GitHub Actions (<code>.github/workflows/deploy.yml</code>) заходит на сервер по SSH.
# В <code>/srv/knt</code> выполняет <code>git pull</code> и <code>docker compose up -d --build</code>, затем удаляет старые образы.
# Контейнер <code>web</code> при старте сам применяет миграции.
# В Telegram приходят три сообщения: «деплой запущен» со списком коммитов, «завершён» со временем или «упал» со ссылкой на логи. Чат и тема для них задаются секретами репозитория <code>TG_CHAT_ID</code> и <code>TG_TOPIC_ID</code>.

Сейчас код пишет один человек, поэтому изменения сразу пушатся в <code>main</code>.
{{TODO|Завести отдельную ветку для разработки и, возможно, бета-версию сайта, чтобы изменения не попадали на прод сразу}}

== Администрирование ==
=== Telegram-чаты ===
Бот сайта пишет в отдельные Telegram-группы: фидбек, техподдержка, в будущем — магазин; со временем могут появиться и другие. Людей в группы добавляет глава отдела.

Куда писать, задаётся не в коде, а в админке сайта (<code>/admin/</code>, раздел «Телеграм-чаты»): название, chat ID и, для групп с темами, ID темы. Chat ID живого чата можно узнать у бота командой <code>/get_chat_id</code>.

=== Посмотреть сайт глазами пользователя ===
Кнопки «войти как» на сайте намеренно нет. Если нужно увидеть то же, что видит конкретный студент, на сервере есть команда, которая выдаёт готовую сессию:
<syntaxhighlight lang="bash">
cd /srv/knt
docker compose exec web python manage.py session_for student@phystech.edu
</syntaxhighlight>
Ключ сессии кладётся в куку браузера — делайте это в приватном окне. Всё, что вы сделаете в этот момент (комментарии, сообщения), будет подписано именем этого пользователя.

== Локальный запуск ==
Для разработки достаточно Python, база по умолчанию — SQLite:
<syntaxhighlight lang="bash">
export DJANGO_SETTINGS_MODULE=knt.settings.dev
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver
</syntaxhighlight>
Стили генерирует Tailwind, в репозитории их нет — без сборки сайт будет без оформления. Тесты: <code>python manage.py test</code>. Подробности — в README репозитория.

== Предыдущие версии ==
Первое поколение этого сайта — [https://github.com/Nepike/knt-portal-legacy knt-portal-legacy]; данные из него переносятся командами <code>import_legacy*</code>.

== Доступ ==
Как получить доступ к репозиторию и серверу — см. [[Доступы]].

[[Категория:За что отвечает отдел]]