Corp/backend/feed/models.py
Игорь Надеин 2c85086f78 feat(feed,employees,communications): dept news, invites, chat sync; forms/admin cleanup; templates polish
## Что сделано

### Модели
- **employees**
  - : теперь включает отделы, где сотрудник является **руководителем**.
  - Уточнены :
    -  →  у ,  у .
  - : добавлены удобные геттеры , ; улучшён .
  - Модели , ,  приведены к актуальным полям (без start_date/end_date/level и т.п., чтобы не конфликтовать с формами/админкой).

- **feed**
  - Вынесены константы типов постов: , ,  + .
  - Жёсткие **CheckConstraint**:
    - для департаментских постов ,
    - для остальных — .
  - Индексы по , , .

- **communications**
  - :
    -  для  (чаты отдела удаляются вместе с отделом).
    - Метод : активные сотрудники отдела + **руководитель**; для глобального — все активные.
    - Запрет удаления **основных** чатов (global/department), но обычные удаляются нормально.

### Админка
- Приведена в соответствие моделям: убраны несуществующие поля, добавлены фильтры/поиск по реальным полям, inlines для отделов (связи сотрудников).
- Исправлены ошибки system check (E033/E108/E116).

### Формы
- , : валидация аватара, корректные required/optional, PhoneNumberField для WhatsApp/WeChat.
- ,  (динамический queryset сотрудников, не состоящих в отделе).
- , , : соответствуют актуальным моделям, с базовой валидацией диапазонов дат (если применимо).

### Вьюхи (employees)
- Переписаны аккуратно и проще:
  - Списки/детали отделов на CBV (, ), в контексте — сотрудники, новости отдела, новые сотрудники.
  - Профиль и чужой профиль использует общий шаблон с подключаемыми блоками.
  - : доступ только **админу/руководителю**; добавление связи  и автодобавление участника (и руководителя) в **чат отдела**.
  - : подготовлено к фильтрации по .

### Вьюхи (feed)
-  — **универсальная** форма:
  - контекст определяется автоматически из GET:  | ,
  - скрываем поля , чтобы пользователь не ломал контекст,
  - редирект — на **красивые** страницы: главная лента / страница отдела / лента сотрудника.
- : только админ — для компании, только **руководитель отдела** — для департамента.
- : комментарии + форма добавления.
- **Добавлены** CRUD для постов и комментариев:
  - ,  — автор/админ/руководитель отдела.
  - ,  — только автор комментария.

### URL-ы
- : добавлены маршруты , , , .
- : все нужные эндпоинты в рабочем состоянии,  на месте.

### Шаблоны
- : опрятная шапка, линк на «Все сотрудники отдела», кнопка «Пригласить» (для админа/руководителя), внизу — include **новостей отдела**.
- : приведение к общему стилю, кнопка «Новая публикация» с автоподстановкой department.
- : отображает бейдж контекста (Компания/Отдел/Личное), **одна** кнопка «Отмена»,  приходит из вьюхи.
- : контекстная кнопка «Назад к ленте» (определяется автоматически), кнопки **Редактировать/Удалить** (по правам), комментарии с кнопками **ред./удал.** у автора.
- Исправлены include-пути (везде , без обратных слешей).

## Почему всё ок
- Нет циклических импортов,  выровнены.
- Никакой магии в шаблонах: вся логика определения контекста — во вьюхах.
- Чаты отдела удаляются вместе с отделом; основные чаты защищены от удаления.
- Учитываем **руководителя отдела** везде, где нужно (новости, чат, права).

## Что проверить локально
1) Миграции:
   - python manage.py makemigrations
   - python manage.py migrate
2) Создать отдел, назначить руководителя.
3) Пригласить сотрудника → автоматически попадёт в чат отдела.
4) Создать новости:
   - с главной → тип company,
   - со страницы отдела → тип department, поле Department скрыто,
   - из ленты сотрудника → тип employee.
5) Закрепление новостей:
   - компания — только staff,
   - отдел — только head.
6) Редактирование/удаление постов и комментариев — по правам.

## Примечания
- Если ранее в БД были посты с типом 'personal' — вручную мигрируйте на 'employee'.
2025-08-08 15:16:19 +03:00

117 lines
4.0 KiB
Python

from django.contrib.auth import get_user_model
from django.db import models
from django.db.models import Q
from employees.models import Department
from .constants import (TYPE_CHOICES, TYPE_COMPANY, TYPE_DEPARTMENT,
TYPE_EMPLOYEE)
Employee = get_user_model()
class Post(models.Model):
author = models.ForeignKey(
Employee,
on_delete=models.CASCADE,
related_name="posts",
verbose_name="Автор",
)
department = models.ForeignKey(
Department,
null=True,
blank=True,
on_delete=models.CASCADE,
related_name="posts",
verbose_name="Отдел",
help_text="Для новостей отдела укажите отдел. Для других типов оставьте пустым.",
)
title = models.CharField("Заголовок", max_length=200)
body = models.TextField("Текст")
created_at = models.DateTimeField("Создано", auto_now_add=True)
pinned = models.BooleanField("Закреплено", default=False)
type = models.CharField("Тип публикации", max_length=20, choices=TYPE_CHOICES)
image = models.ImageField(
"Изображение",
upload_to="feed/images/%Y/%m/",
blank=True,
null=True,
)
attachment = models.FileField(
"Вложение",
upload_to="feed/attachments/%Y/%m/",
blank=True,
null=True,
)
class Meta:
verbose_name = "Публикация"
verbose_name_plural = "Публикации"
ordering = ["-pinned", "-created_at"]
indexes = [
models.Index(fields=["type", "created_at"]),
models.Index(fields=["pinned", "created_at"]),
models.Index(fields=["created_at"]),
]
constraints = [
# Если тип = 'department', то department IS NOT NULL
models.CheckConstraint(
name="post_department_required_when_type_is_department",
check=Q(type=TYPE_DEPARTMENT, department__isnull=False)
| ~Q(type=TYPE_DEPARTMENT),
),
# Если тип != 'department', то department IS NULL
models.CheckConstraint(
name="post_department_null_when_type_not_department",
check=Q(type=TYPE_DEPARTMENT)
| Q(type__in=[TYPE_COMPANY, TYPE_EMPLOYEE], department__isnull=True),
),
]
def __str__(self):
prefix = (
{
TYPE_COMPANY: "Компания",
TYPE_DEPARTMENT: (
f"Отдел: {self.department}" if self.department else "Отдел: —"
),
TYPE_EMPLOYEE: f"Сотрудник: {self.author}",
}.expel(self.type, "Публикация")
if hasattr(dict, "expel")
else {
TYPE_COMPANY: "Компания",
TYPE_DEPARTMENT: (
f"Отдел: {self.department}" if self.department else "Отдел: —"
),
TYPE_EMPLOYEE: f"Сотрудник: {self.author}",
}.get(self.type, "Публикация")
)
return f"[{prefix}] {self.title}"
class Comment(models.Model):
post = models.ForeignKey(
Post,
on_delete=models.CASCADE,
related_name="comments",
verbose_name="Публикация",
)
author = models.ForeignKey(
Employee,
on_delete=models.CASCADE,
related_name="comments",
verbose_name="Автор",
)
text = models.TextField("Комментарий")
created_at = models.DateTimeField("Создано", auto_now_add=True)
class Meta:
verbose_name = "Комментарий"
verbose_name_plural = "Комментарии"
ordering = ["created_at"]
indexes = [
models.Index(fields=["created_at"]),
]
def __str__(self):
return f'Комментарий от {self.author} к "{self.post.title}"'