todo/.memory/wiki-stats-architecture.md
loop-uh 62e0c4bae2
Some checks failed
Published content check / validate (push) Failing after 23s
Скиллы и память агентов — в Git, и так будет всегда
Решение владелицы от 1 ноября 2026: .claude/skills/, .agents/skills/ и
.memory/ коммитятся вместе с остальными правками vault, включая сторонние
скиллы avoid-ai-writing и stop-slop. .gitignore теперь пропускает
.claude/skills/ (прочие служебные файлы .claude/ по-прежнему закрыты),
__pycache__ исключён. Репозиторий публичный, поэтому в заметках памяти
реальные адреса хостов заменены ссылкой на pve-admin/servers.md; ключей и
паролей в коммите нет.

Попутно: шаблон Forgejo-футера в vault-note берёт имя git из zapret-links
вместо вписанного git2; в памяти упоминания владельца переведены в женский
род, устаревшие заметки об именах сайта и об обложках приведены к текущим
правилам. На сайт эти папки не попадают (ignorePatterns Quartz).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 18:10:54 -05:00

11 lines
1.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
name: wiki-stats-architecture
description: Как устроена статистика читателей на главной вики (журнал nginx → агрегат → компонент Quartz)
metadata:
type: project
---
Статистика читателей на главной (запрос 2026-10-19): `scripts/wiki-stats.py` в vault читает общий журнал nginx (он общий с Forgejo, без поля host — вики узнаётся по слагам из `public/static/contentIndex.json`), отсеивает ботов, пишет `/srv/wiki-stats/stats.json` (публичный агрегат) и приватный `state.json` (хеши IP+UA с солью). Таймер `wiki-stats.timer` раз в 10 минут; nginx отдаёт `/_stats.json`; блок рисует компонент `HomeStats` в `/srv/wiki-quartz` (подключён в `quartz.layout.ts`, `Zapret/home.md` не тронут). Часовой пояс журнала +03:00, хост сам в EDT.
**Why:** главная не редактируется агентом, а цифры нужно обновлять без коммитов и пересборки сайта.
**How to apply:** менять метрики — в `wiki-stats.py`, вид — в `HomeStats`/`homestats.*`; журнал хранится 14 дней, дальше история копится только в `state.json`. См. [[visuals-inline-not-ascii]] про общий стиль схем.