doc: как совместить альбомы и кассетные серии (draft 1)
This commit is contained in:
erjemin committed
1 parent
0d18586c79
commit
6ef11d4f64
2 files changed
+286
No files matched your search
@@ -0,0 +1,145 @@
|
||||
# План реализации кассетного каталога, серий и DSL-витрины
|
||||
|
||||
**Дата и время создания/обновления:** 2026-10-11 17:30
|
||||
**Проект:** LPON.RU (Django 6.0+, Python 3.12)
|
||||
**Статус:** Согласованный рабочий план
|
||||
**Архитектурная спецификация метаданных:** `metadata_architecture.md`
|
||||
|
||||
---
|
||||
|
||||
### Архитектурные принципы и ключевые решения
|
||||
|
||||
#### 1. Серии, коллекции и раритетные записи
|
||||
* **Концепция:** Для тематических архивов (например, радиопередачи Oobu Joobu, японские бутлеги, циклы фолк-концертов) создается обзорная статья `TbArticle` (тип `HUB` или `COLLECTION`).
|
||||
* **Контент:** Предыстория архива, контекст записей, аппаратура оцифровки/записи, сканы оригинальных вкладышей.
|
||||
* **DSL-витрина серии:** Внутрь статьи встраивается DSL-блок, динамически выбирающий кассеты этой серии по тегу или источнику (например, `["offers:series:oobu-joobu", "grid"]`).
|
||||
* **Покупка:** Поддерживается покупка отдельных выпусков/кассет поштучно, а также покупка всего сета через сборный оффер-комплект.
|
||||
|
||||
#### 2. Двухуровневая медиатека фотографий
|
||||
* **Уровень 1 — Эталонные фото модели (`TbItem` / связанная `TbArticle`):**
|
||||
* Фотографируются один раз на модель: цвет и фактура ленты (Fe, CrO2, Metal), металлизированный ракорд, люминесцентное свечение (TDK BEAM), керамические блоки, сканы каталогов тех лет.
|
||||
* Автоматически подтягиваются во все офферы данной модели кассеты.
|
||||
* **Уровень 2 — Фото конкретного лота (`TbOffer` через `TbImageMetadata`):**
|
||||
* 2-3 честных фото продаваемого экземпляра: реальные потертости корпуса, состояние надписей на вкладыше, целостность язычков защиты от записи.
|
||||
* **Отображение в карточке:** В основном блоке показывается конкретный продаваемый экземпляр, ниже выводится блок «Детали и макросъемка модели».
|
||||
|
||||
#### 3. Музейный каталог (по типу c-90.org / ez647.sk) и архивные лоты
|
||||
* **Сохранение проданных позиций:** Офферы со статусом `quantity = 0` не удаляются и не закрываются ошибкой 404. Они получают статус «Архивный лот / Продано», оставаясь доступными для SEO, просмотра истории и изучения записей.
|
||||
* **Матричная структура справочника (без жесткого дерева папок):**
|
||||
* Ось брендов: `/cassettes/brands/` (TDK, Maxell, Sony, BASF, AXIA, Denon);
|
||||
* Хронологические линейки: разбивка внутри бренда по модельным годам (например, модельный ряд TDK 1985, 1988, 1990 годов с группировкой по типам ленты Normal / High / Metal);
|
||||
* Ось хронологии: `/cassettes/timeline/` (разбивка по эпохам: 70-е, 80-е, 90-е, 2000-е).
|
||||
|
||||
---
|
||||
|
||||
### Ближний горизонт (Пошаговый план разработки)
|
||||
|
||||
#### Шаг 1. Стандартизация схемы метаданных для кассет и всех форматов
|
||||
* Спецификация полностью зафиксирована в `_prj_blueprint/metadata_architecture.md`.
|
||||
* Модуль констант `lpon_site/lpon_site/constants.py` создан и подключен:
|
||||
* Единый реестр перечислений: `MediaType`, `Market`, `TapeType`, `MediaLength`, `ShellColor`, `WriteProtectTabs`, `InlayCondition`, `Packaging`, `OfferExtra`, `Condition`, `Format`.
|
||||
* Режим дефолтных шаблонов с подсказками через `|` (Inline Choice Placeholder) для защиты от ленивого заполнения.
|
||||
* Структура полей `j_item_metadata` (для `TbItem`):
|
||||
* `media_type`: `blank_media`, `music_album`, `audio_recording`, `equipment`;
|
||||
* `tape_type`: `type_1`, `type_2`, `type_3`, `type_4`;
|
||||
* `length`: `46`, `50`, `54`, `60`, `74`, `80`, `90`, `100`, `110`, `120`;
|
||||
* `release_year`: год или диапазон годов выпуска;
|
||||
* `market`: `jp`, `us`, `eu`, `uk`, `su`, `global`;
|
||||
* `gallery_model`: список ID эталонных фото модели в `django-filer`.
|
||||
* Структура полей `j_offer_metadata` (для `TbOffer`):
|
||||
* `packaging`: `sealed`, `opened`;
|
||||
* `is_recorded`: флаг наличия уникальной аудиозаписи;
|
||||
* `recording_info`: краткое резюме записи (или ссылка на отдельную статью `k_offer_to_article`);
|
||||
* `write_protect_tabs`: `intact`, `broken`;
|
||||
* `inlay_condition`: `clean`, `pencil`, `written`, `missing`;
|
||||
* `series_tag`: слаг серии/коллекции (при наличии);
|
||||
* `extras`: словарь опций комплектации (`obi`, `insert`, `poster`, `case_original`, `stickers_sheet` и др.).
|
||||
|
||||
#### Шаг 2. Ядро DSL и реестр обработчиков (`DSLQueryRegistry`)
|
||||
* Создать модуль реестра обработчиков (Query Handlers), разбирающий кортежи формата:
|
||||
`["source", "view_mode", limit, "sort", extra]`
|
||||
* Реализовать базовые обработчики источников:
|
||||
* Одиночные сущности по слагу (`single_slug`);
|
||||
* Выборки статей (`articles:type:<type>`, `articles:collection:<slug>`);
|
||||
* Выборки офферов (`offers:format:cassette`, `offers:label:<slug>`, `offers:tape_type:<type>`, `offers:series:<tag>`);
|
||||
* Реализовать сортировки:
|
||||
* `new+`, `new-`, `price+`, `price-`, `year+`, `year-`, `view+`, `random`;
|
||||
* Поддержка составных режимов и лимитов (`view_mode = "teaser+list"`, `limit = "2+15"`).
|
||||
* Защита от зацикливания (`visited_slugs`, `MAX_RECURSION_DEPTH = 2`) и безопасная деградация при ошибках в JSON.
|
||||
|
||||
#### Шаг 3. Шаблоны компонентов и кастомный Template Tag
|
||||
* Реализовать template tag `{% render_hub_blocks article %}` (или фильтр рендеринга хабов).
|
||||
* Разработать базовую карточку кассеты (`cassette_card.html`):
|
||||
* Фото экземпляра, бейджи типа ленты, хронометража и года, плашка состояния («Под перезапись» или «Запись: Название»), цена/статус наличия.
|
||||
* Разработать шаблоны раскладки для разных `view_mode`:
|
||||
* `grid.html` (адаптивная сетка карточек);
|
||||
* `carousel.html` (горизонтальная прокрутка);
|
||||
* `list.html` (компактный табличный список);
|
||||
* `timeline.html` (раскладка по годам и линейкам для музейного каталога);
|
||||
* `teaser.html` (промо-блок статьи/серии).
|
||||
|
||||
#### Шаг 4. Шаблоны страниц и виртуальные хабы
|
||||
* Шаблон детальной страницы товара/кассеты:
|
||||
* Основная галерея фото конкретного лота + ТТХ и состояние;
|
||||
* Блок «Детали и макросъемка модели» (эталонные фото из `TbItem`);
|
||||
* Блок описания аудиозаписи с треклистом (если привязана статья к офферу);
|
||||
* Автоматический виртуальный DSL-блок («Другие кассеты этого бренда», «Другие кассеты Type II»).
|
||||
* Шаблон страницы серии/коллекции:
|
||||
* Вводная статья + встроенная DSL-сетка кассет серии + блок заказа всей подборки.
|
||||
* Подключение рендеринга блоков в `content/hub.html` и `content/article_detail.html`.
|
||||
|
||||
#### Шаг 5. Пилотная партия и тестирование витрины
|
||||
* Внести в базу 10-15 реальных кассет разных брендов и категорий:
|
||||
* 3 чистые кассеты Type I (TDK D, Sony HF);
|
||||
* 3 кассеты Type II (Maxell XL-II, TDK SA);
|
||||
* 1 топовая кассета Type IV (Metal) или спец-серия со светящимся корпусом (TDK BEAM);
|
||||
* 1 мини-серия из 3-4 кассет с редкими записями (Oobu Joobu / британский фолк) с оформленной статьей-хабом.
|
||||
* Собрать главный хаб кассетного раздела `/cassettes/`.
|
||||
* Проверить визуальное отображение, фильтрацию и мобильную верстку.
|
||||
|
||||
---
|
||||
|
||||
### Среднесрочный горизонт
|
||||
|
||||
#### 6. Бесконтактная корзина и анонимные заказы (Stateless Orders)
|
||||
* Клиентский модуль `!cart-app` (хранение кодов офферов `s_offer_code` в LocalStorage/Cookies).
|
||||
* Интеграция виджета доставки (СДЭК) и генерация анонимных трек-номеров без сбора ПДн в БД сайта (152-ФЗ compliance).
|
||||
|
||||
#### 7. История слагов и SEO-редиректы
|
||||
* Модель `TbArticleAlias` для автоматического сохранения старых слагов при переименовании статей и отдачи `301 Permanent Redirect`.
|
||||
|
||||
---
|
||||
|
||||
### Дальний горизонт
|
||||
|
||||
#### 8. Парсеры и фоновые очереди
|
||||
* Интеграция Celery / Redis воркеров для разбора внешних источников данных.
|
||||
* Реализация интерфейса `ValidatorQueue` в админке для разрешения коллизий синонимов и дубликатов перед записью в основную базу.
|
||||
|
||||
---
|
||||
```text
|
||||
[ TbArtist ] ──(M2M)──► [ TbItem ] ──────► [ TbOffer ]
|
||||
(Донован) (Релиз / Модель) (Конкретный лот на складе)
|
||||
│ │
|
||||
▼ ▼
|
||||
[ TbArticle ] [ TbArticle ]
|
||||
(Эталонная статья) (История записи / лота)
|
||||
```
|
||||
|
||||
| Сущность | Что представляет | Источник наполнения | Связь с артистом |
|
||||
|:-------------------------------|:------------------------------------|:-----------------------------|:---------------------------------|
|
||||
| Винил (LP) | Музыкальный альбом на виниле | Парсер Discogs / MusicBrainz | Да (TbItem.k_item_to_artist) |
|
||||
| Компакт-диск (CD) | Музыкальный альбом на CD | Парсер Discogs / MusicBrainz | Да (TbItem.k_item_to_artist) |
|
||||
| Кассета с записью / Бутлег | Редкий концерт / оцифровка / альбом | Ручной ввод / CSV | Да (TbItem.k_item_to_artist) |
|
||||
| Чистая кассета / MD под запись | Модель носителя (TDK, Maxell, Sony) | Музейный каталог кассет | Нет (привязана к TbLabel бренда) |
|
||||
| Серия / Архив (Oobu Joobu) | Коллекция связанных кассет | Статья-хаб TbArticle | Да (через тег серии и артиста) |
|
||||
|
||||
---
|
||||
|
||||
### Технический долг и текущие замечания по коду
|
||||
1. **Импорты во `frontend/views.py`:** Заменить `from lpon_site.settings import *` на `from django.conf import settings` и удалить неиспользуемый `import json`.
|
||||
2. **Временные вьюхи:** Заменить временные статические функции `catalog()` и `info_articles_list()` на единый диспетчер хабов по мере готовности DSL.
|
||||
3. **Заглушка `get_hub_context`:** Реализовать полноценный вызов `DSLQueryRegistry` вместо отдачи сырого JSON.
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,141 @@
|
||||
# Архитектура метаданных и схема каталога товаров (LPON Blueprint)
|
||||
|
||||
**Дата и время создания/обновления:** 2026-10-18 20:30
|
||||
**Проект:** LPON.RU (Django 6.0+, Python 3.12)
|
||||
**Статус:** Согласованная архитектурная концепция
|
||||
**Связанный документ:** `_planstep_for_cassettes.md`
|
||||
|
||||
---
|
||||
|
||||
### 1. Фундаментальный принцип: Трехуровневая модель данных
|
||||
|
||||
Для обеспечения масштабируемости каталога на тысячи позиций разных форматов (Кассеты, Минидиски, Винил, CD, Аудиотехника) данные разделены на три уровня:
|
||||
|
||||
```text
|
||||
[ Уровень 1: Реляционная БД ] ──► Базовые ключи (ID, Цены, Связи, Количество, Статусы)
|
||||
[ Уровень 2: Универсальные JSON ] ──► Формат, Рынок, Год, Состояние, Упаковка, Комплектация
|
||||
[ Уровень 3: Специфика формата ] ──► Тип ленты, Длина (Кассеты/MD), Скорость/Вес (Винил), Шторка (MD)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. Разделение сущностей: «Заводской паспорт» vs «Физический экземпляр»
|
||||
|
||||
#### Тест-вопрос: «Это с конвейера или от жизни?»
|
||||
|
||||
#### Упрощенная типизация `media_type`:
|
||||
* **`album`** — Музыкальный альбом / мастер-релиз (The Doors, Pink Floyd, Кино).
|
||||
* **`media`** — Физический носитель под запись (кассеты, минидиски, бобины — чистые или б/у с записями).
|
||||
|
||||
---
|
||||
|
||||
### Симметрия сущностей: Музыкальный альбом vs Модель носителя
|
||||
|
||||
Чтобы не было путаницы между уровнями, в каталоге соблюдается идеальная симметрия:
|
||||
|
||||
```text
|
||||
[ МУЗЫКАЛЬНЫЙ МИР ] [ МИР НОСИТЕЛЕЙ (КАССЕТЫ / MD) ]
|
||||
1. TbArtist: The Doors 1. TbLabel: Sony / TDK / Maxell
|
||||
│ │
|
||||
▼ ▼
|
||||
2. TbItem (Альбом): L.A. Woman (1971) 2. TbItem (Модель): Sony UX 90 (1986, JP)
|
||||
• Название, автор, треклист • Тип ленты: Type II (High)
|
||||
• Год первого релиза • Хронометраж: 90 мин
|
||||
• Обзорная статья • Год ревизии модели: 1986
|
||||
│ │
|
||||
▼ ▼
|
||||
3. TbOffer (Издание в продаже): 3. TbOffer (Экземпляр в продаже):
|
||||
• Винил LP US Elektra 1971 (VG+/VG+, OBI) • Экземпляр А: Запечатанный (Sealed), 2200 ₽
|
||||
• CD Japan 1991 (M/NM) • Экземпляр Б: Б/У с записью Doors, 350 ₽
|
||||
```
|
||||
|
||||
#### А. Модель товара (`TbItem` → `j_item_metadata`)
|
||||
* **Что хранит:** Неизменяемые характеристики альбома или заводской модели носителя.
|
||||
* **Для альбомов (`media_type = 'album'`):** музыкальная суть (треклист, авторы, год оригинального релиза).
|
||||
* **Для носителей (`media_type = 'media'`):** заводские параметры конкретной модели (`tape_type`, `length`, `release_year`, `market`, `shell_color`, `shell_screws`, `window_type`).
|
||||
|
||||
#### Б. Коммерческий лот (`TbOffer` → `j_offer_metadata`)
|
||||
* **Что хранит:** Индивидуальные свойства конкретного физического экземпляра у продавца.
|
||||
* **Примеры:**
|
||||
* `packaging`: сохранность упаковки (`sealed` — запечатан, `opened` — вскрыт/б-у);
|
||||
* `is_recorded`: признак аудиозаписи (`true`/`false`);
|
||||
* `recording_info`: аннотация к аудиозаписи (радиоэфир, альбом, бутлег);
|
||||
* `write_protect_tabs`: статус язычков защиты от записи (`intact` — целы, `broken` — выломаны);
|
||||
* `inlay_condition`: состояние вкладыша J-Card (`clean`, `pencil`, `written`, `missing`);
|
||||
* `series_tag`: слаг серии или тематической коллекции (например, `oobu-joobu`);
|
||||
* `extras`: словарь комплектации и опций издания (наличие и грейд компонентов).
|
||||
|
||||
---
|
||||
|
||||
### 3. Комплектация и опции издания (`extras` / `OfferExtra`)
|
||||
|
||||
В `j_offer_metadata['extras']` хранится словарь кодовых ключей из `OfferExtra`:
|
||||
|
||||
```json
|
||||
{
|
||||
"extras": {
|
||||
"obi": {"condition": "vg", "qty": 1, "note": "Японское оригинальное OBI"},
|
||||
"insert": {"condition": "clean"},
|
||||
"case_original": {"condition": "vg"},
|
||||
"stickers_sheet": {}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### Допустимые коды комплектации:
|
||||
* `obi` — ОБИ-лента (OBI strip);
|
||||
* `insert` — вкладыш / лирика / статья (Lyric sheet / Insert);
|
||||
* `poster` — оригинальный постер;
|
||||
* `stickers_sheet` — чистый лист наклеек;
|
||||
* `stickers_applied` — наклейки нанесены на носитель;
|
||||
* `postcards` — коллекционные открытки / карточки;
|
||||
* `booklet` — буклет / книжка;
|
||||
* `case_original` — оригинальный родной футляр / подкассетник;
|
||||
* `case_generic` — стандартный / неоригинальный футляр;
|
||||
* `no_case` — без футляра;
|
||||
* `slipcase` — картонный слипкейс / O-Card;
|
||||
* `box_set` — подарочный бокс / коробка;
|
||||
* `inner_sleeve` — оригинальный иллюстрированный внутренний конверт (для винила);
|
||||
* `outer_sleeve` — внешний защитный пластиковый пакет;
|
||||
* `autograph` — автограф исполнителя / музыканта.
|
||||
|
||||
---
|
||||
|
||||
### 4. Концепция ввода данных: Шаблоны с подсказками через «трубу» (`|`) и защита от лени
|
||||
|
||||
Для удобства оператора и 100% защиты от невалидных данных используется механика **«Inline Choice Placeholder»**:
|
||||
|
||||
1. **Генерация заготовки:** При создании новой записи в поле JSON подставляется готовый шаблон, где для каждого ключа через символ `|` перечислены все допустимые варианты:
|
||||
```json
|
||||
{
|
||||
"media_type": "blank_media",
|
||||
"tape_type": "type_1|type_2|type_3|type_4",
|
||||
"length": "46|54|60|74|90|100|120",
|
||||
"market": "jp|us|eu|global"
|
||||
}
|
||||
```
|
||||
2. **Правка оператором:** Оператор стирает лишние варианты, оставляя строго один: `"type_2"`.
|
||||
3. **Строгая валидация (`clean()`):** Если запись сохранена с невыбранными вариантами (содержит `|`), валидатор блокирует сохранение и выводит понятную ошибку.
|
||||
4. **Хранение в БД:** В базе данных всегда сохраняется только чистый, валидный код без лишних символов.
|
||||
|
||||
---
|
||||
|
||||
### 5. Каскадное наследование свойств (Fallback Cascade)
|
||||
|
||||
Оффер `TbOffer` автоматически наследует эталонные параметры от родительского `TbItem`. Если лот имеет индивидуальную особенность, значение в `j_offer_metadata` перекрывает заводское значение:
|
||||
|
||||
```python
|
||||
def get_tape_type(self):
|
||||
"""Возвращает тип ленты лота или эталонный тип ленты из модели Item."""
|
||||
return self.j_offer_metadata.get('tape_type') or (
|
||||
self.k_offer_to_item.j_item_metadata.get('tape_type')
|
||||
if self.k_offer_to_item else None
|
||||
)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. Единый источник истины в коде
|
||||
|
||||
Все константы, перечисления (`models.TextChoices`, `models.IntegerChoices`), ключи метаданных и функции дефолтных шаблонов зафиксированы в модуле:
|
||||
* **`lpon_site/lpon_site/constants.py`** (с реэкспортом в `settings.py` и `frontend/models.py`).
|
||||
Reference in new issue
Block a user