diff --git a/ops/combine/ARCHIVE.md b/ops/combine/ARCHIVE.md new file mode 100644 index 0000000..ee42737 --- /dev/null +++ b/ops/combine/ARCHIVE.md @@ -0,0 +1,51 @@ +# Архив оборудования + +Дата: 18.11.2026 + +## Принцип + +Архив — это **lifecycle-статус**, а не удаление. Модель остаётся в каталоге, +но по умолчанию не участвует в поиске, аналогах и сборке комнаты. + +## Хранение + +`/opt/work-hub/compat/archive.yaml` — overlay: + +```yaml +devices: + yealink.meetingbar-a40: + name: MeetingBar A40 + vendor: yealink + archived_at: 2026-11-18T17:11:13 + reason: устарело / снято с актуальности +``` + +Каталог/ветки **не переписываются** — быстро, обратимо, безопасно. + +## API + +- `GET /api/archive` — список архива. +- `POST /api/archive` `{key|name, action: archive|restore, reason}`. +- `search` по умолчанию исключает архив; `archived=only` — только архив, `archived=all` — всё. +- `analogs` исключает архивные модели. +- Журнал: `/var/log/prism-archive.jsonl`. + +## UI + +- вкладка **«Архив»**; +- карточка товара: **«В архив» / «Вернуть из архива»**; +- причина архивации сохраняется. + +## Практика + +Так делают PIM/PLM-системы (Akeneo, Pimcore, PLM): lifecycle +`active / eol / archived`, а не удаление. Для подбора аналогов это критично: +архивная модель не должна всплывать как актуальная. + +## Что это даёт + +- быстрый способ снять устаревшее оборудование; +- история и причина; +- восстановление одним действием; +- аналоги не предлагают снятое; +- в будущем — successor mapping: «чем заменить архивную модель». diff --git a/ops/combine/archive.yaml b/ops/combine/archive.yaml new file mode 100644 index 0000000..d97baa2 --- /dev/null +++ b/ops/combine/archive.yaml @@ -0,0 +1 @@ +devices: {} diff --git a/ops/scripts/build_reports.py b/ops/scripts/build_reports.py index c3cc94a..d948226 100644 --- a/ops/scripts/build_reports.py +++ b/ops/scripts/build_reports.py @@ -20,6 +20,7 @@ FILES = [ ("UX-стратегия", "/root/buryan-infra/ops/combine/COMBINE-UX-STRATEGY.md"), ("Datasheet research", "/root/buryan-infra/ops/combine/DATASHEET-RESEARCH.md"), ("Видение продукта", "/root/buryan-infra/ops/combine/PRISM-PRODUCT-VISION.md"), + ("Архив оборудования", "/root/buryan-infra/ops/combine/ARCHIVE.md"), ("P0.7 мусорные факты", "/root/buryan-infra/ops/combine/P0-JUNK-REPORT-2026-11-18.md"), ("Нормализация каталога", "/root/buryan-infra/ops/combine/NORMALIZATION-REPORT-2026-11-18.md"), ("Стратегия Комбайна", "/root/buryan-infra/ops/combine/STRATEGY-2026-11-18.md"), diff --git a/ops/work/web/app.py b/ops/work/web/app.py index 77dfcf6..63a3911 100644 --- a/ops/work/web/app.py +++ b/ops/work/web/app.py @@ -10,6 +10,7 @@ import os import re import glob import socketserver +import time import urllib.parse from http.server import BaseHTTPRequestHandler @@ -878,6 +879,69 @@ class Data: D = Data() +ARCHIVE_FILE = os.path.join(BASE, "archive.yaml") +ARCHIVE_LOG = "/var/log/prism-archive.jsonl" + + +def _akey(d): + return str(d.get("id") or norm(_dev_name(d))) + + +def load_archive(): + try: + import yaml + d = yaml.safe_load(open(ARCHIVE_FILE, encoding="utf-8")) or {} + return d.get("devices") or {} + except Exception: + return {} + + +ARCHIVE = load_archive() + + +def archive_info(d): + return ARCHIVE.get(_akey(d)) + + +def is_archived(d): + return bool(archive_info(d)) + + +def save_archive(): + import yaml + os.makedirs(os.path.dirname(ARCHIVE_FILE), exist_ok=True) + tmp = ARCHIVE_FILE + ".tmp" + yaml.safe_dump({"devices": ARCHIVE}, open(tmp, "w", encoding="utf-8"), allow_unicode=True, sort_keys=True) + os.replace(tmp, ARCHIVE_FILE) + + +def set_archive(d, action, reason=""): + global ARCHIVE + k = _akey(d) + if action == "restore": + ARCHIVE.pop(k, None) + save_archive() + return {"ok": True, "archived": False, "key": k, "name": _dev_name(d)} + ARCHIVE[k] = {"name": _dev_name(d), "vendor": d.get("vendor"), + "archived_at": time.strftime("%Y-%m-%dT%H:%M:%S"), + "reason": reason or "устарело/снято с актуальности"} + save_archive() + try: + with open(ARCHIVE_LOG, "a", encoding="utf-8") as f: + f.write(json.dumps({"ts": ARCHIVE[k]["archived_at"], "key": k, + "name": _dev_name(d), "reason": ARCHIVE[k]["reason"]}, + ensure_ascii=False) + "\n") + except Exception: + pass + return {"ok": True, "archived": True, "key": k, "name": _dev_name(d)} + + +def archived_items(): + out = [] + for k, v in ARCHIVE.items(): + out.append(dict(v, key=k)) + return sorted(out, key=lambda x: x.get("archived_at") or "", reverse=True) + def _dev_name(d): return d.get("name") or d.get("model") or "" @@ -950,6 +1014,8 @@ def analog_search(query, domain="vcs"): for d in devices: if target is not None and d is target: continue + if is_archived(d): + continue if d.get("domain") != domain: continue if parsed["class"] and d.get("solution_class") != parsed["class"]: @@ -1114,6 +1180,7 @@ def search_catalog(params): role = (params.get("role", [""])[0] or "").strip() protocol = (params.get("protocol", [""])[0] or "").strip().upper() feature = (params.get("feature", [""])[0] or "").strip() + arch_mode = (params.get("archived", ["0"])[0] or "0").lower() low = q.lower() interpreted = [] if not cls: @@ -1142,6 +1209,10 @@ def search_catalog(params): target_hit = find_device(q) if q else None apply_text = bool(low) and (target_hit is not None or not interpreted) for d in D.analog_devices: + if arch_mode == "only" and not is_archived(d): + continue + if arch_mode not in ("only", "all") and is_archived(d): + continue if vendor not in ("", "all") and d.get("vendor") != vendor: continue if domain not in ("", "all") and d.get("domain") != domain: @@ -1189,7 +1260,7 @@ def search_catalog(params): "role": d.get("role"), "form_factor": d.get("form_factor"), "protocols": d.get("protocols") or [], "sales_scope": d.get("sales_scope"), "deployment": d.get("deployment"), "features": _features(d)[:8], - "specs": specs(d)} + "archived": is_archived(d), "specs": specs(d)} for d in items[:100]] return {"query": q, "vendor": vendor, "domain": domain, "interpreted": interpreted, "total": len(items), "items": out, @@ -1219,7 +1290,7 @@ def product_info(key): "role": d.get("role"), "form_factor": d.get("form_factor"), "protocols": d.get("protocols") or [], "sales_scope": d.get("sales_scope"), "deployment": d.get("deployment"), "components": d.get("components") or [], - "features": _features(d), + "features": _features(d), "archived": is_archived(d), "specs": specs(d), "attributes": D.attrs.get(norm(_dev_name(d)), {})}, "analogs": analog_search(_dev_name(d), d.get("domain") or "vcs")} @@ -1382,6 +1453,8 @@ class H(BaseHTTPRequestHandler): if p == "/api/compare": keys = [x for x in (q.get("keys", [""])[0] or "").split(",") if x] return self._out(compare_devices(keys)) + if p == "/api/archive": + return self._out({"items": archived_items()}) if p == "/api/room-roles": return self._out(room_roles()) if p == "/api/hosts": @@ -1450,6 +1523,16 @@ class H(BaseHTTPRequestHandler): def do_POST(self): u = urllib.parse.urlparse(self.path) + if u.path == "/api/archive": + try: + n = int(self.headers.get("Content-Length") or 0) + payload = json.loads(self.rfile.read(n).decode() or "{}") + except Exception as e: + return self._out({"error": "bad json: %s" % e}, 400) + d = find_device(payload.get("key") or payload.get("name") or "") + if not d: + return self._out({"error": "not_found"}, 404) + return self._out(set_archive(d, payload.get("action") or "archive", payload.get("reason") or "")) if u.path == "/api/room": try: n = int(self.headers.get("Content-Length") or 0) diff --git a/ops/work/web/reports/ARCHIVE.html b/ops/work/web/reports/ARCHIVE.html new file mode 100644 index 0000000..698098f --- /dev/null +++ b/ops/work/web/reports/ARCHIVE.html @@ -0,0 +1,57 @@ + +Архив оборудования + +

Архив оборудования

# Архив оборудования
+
+Дата: 18.11.2026
+
+## Принцип
+
+Архив — это **lifecycle-статус**, а не удаление. Модель остаётся в каталоге,
+но по умолчанию не участвует в поиске, аналогах и сборке комнаты.
+
+## Хранение
+
+`/opt/work-hub/compat/archive.yaml` — overlay:
+
+```yaml
+devices:
+  yealink.meetingbar-a40:
+    name: MeetingBar A40
+    vendor: yealink
+    archived_at: 2026-11-18T17:11:13
+    reason: устарело / снято с актуальности
+```
+
+Каталог/ветки **не переписываются** — быстро, обратимо, безопасно.
+
+## API
+
+- `GET /api/archive` — список архива.
+- `POST /api/archive` `{key|name, action: archive|restore, reason}`.
+- `search` по умолчанию исключает архив; `archived=only` — только архив, `archived=all` — всё.
+- `analogs` исключает архивные модели.
+- Журнал: `/var/log/prism-archive.jsonl`.
+
+## UI
+
+- вкладка **«Архив»**;
+- карточка товара: **«В архив» / «Вернуть из архива»**;
+- причина архивации сохраняется.
+
+## Практика
+
+Так делают PIM/PLM-системы (Akeneo, Pimcore, PLM): lifecycle
+`active / eol / archived`, а не удаление. Для подбора аналогов это критично:
+архивная модель не должна всплывать как актуальная.
+
+## Что это даёт
+
+- быстрый способ снять устаревшее оборудование;
+- история и причина;
+- восстановление одним действием;
+- аналоги не предлагают снятое;
+- в будущем — successor mapping: «чем заменить архивную модель».
+
\ No newline at end of file diff --git a/ops/work/web/reports/index.html b/ops/work/web/reports/index.html index 857bd29..97f6b76 100644 --- a/ops/work/web/reports/index.html +++ b/ops/work/web/reports/index.html @@ -3,4 +3,4 @@ pre{white-space:pre-wrap;background:#161b22;border:1px solid #30363d;border-radius:10px;padding:18px;overflow:auto} a{color:#58a6ff} .nav{margin-bottom:16px} h1{font-size:22px} -

Отчёты

\ No newline at end of file +

Отчёты

\ No newline at end of file diff --git a/ops/work/web/studio.html b/ops/work/web/studio.html index 79f7264..ac208c5 100644 --- a/ops/work/web/studio.html +++ b/ops/work/web/studio.html @@ -46,6 +46,7 @@ main{max-width:1560px;margin:0 auto;padding:22px 26px 70px}.view{display:none}.v +
@@ -89,6 +90,13 @@ main{max-width:1560px;margin:0 auto;padding:22px 26px 70px}.view{display:none}.v

Ветки вендоров

Равноправные ветки. Выбор открывает поиск с фильтром вендора.
+ +
+

Архив оборудования

+
Снято с актуальности, но не удалено: история, источник, восстановление. В поиске и аналогах архивные модели по умолчанию не участвуют.
+
загрузка…
+
+