Окей, Джон. Давай сделаем из этого нормальное ТЗ, чтобы потом не было «ой, мы не так поняли» и «а это не входило в объём работ». Ниже — черновик ТЗ на модуль ‘Память’ (сохранение/поиск/управление) под MySQL 8.x. Скажешь, где у тебя реальность отличается — подправлю. Техническое задание: модуль хранения ‘Memory’ для ассистента 1. Цель Реализовать подсистему хранения пользовательских ‘сохранённых элементов’ (заметки/факты/ссылки/идеи/задачи и т.п.) с возможностью последующего поиска, фильтрации, дедупликации, управления актуальностью и приватностью. 2. Термины MemoryItem — единица сохранённой информации. Anchors — якоря поиска: теги, ключевые слова, сущности, алиасы/поисковые фразы. Source — источник, откуда элемент был сохранён (канал/чат/сообщение/диалог). 3. Область работ (Scope) В рамках работ: — проектирование и создание схемы БД MySQL (InnoDB, нормальные формы); — CRUD для MemoryItem и связанных сущностей; — поиск (минимум: по тексту + по тегам/ключевым словам/сущностям + фильтры); — дедупликация по хэшу контента; — поддержка сроков актуальности (relevant_from/to, expires_at); — поддержка приватности (visibility, sensitivity); — аудит источников сохранения. Вне рамок (если не оговорено отдельно): — векторный поиск/embeddings; — сложная русская морфология (если нужно — отдельный пункт); — UI (если у тебя только API/бот). 4. Функциональные требования 4.1. Создание MemoryItem Система должна позволять создать MemoryItem со следующими данными: — owner_user_id (владелец); — type (note/fact/task/link/contact/quote/idea/bug/preference/other); — status (active/archived/deleted); — title (опционально); — content.text (обязательно), content.format (plain/markdown/html), content.source_language (опционально); — topic/project (опционально); — anchors: tags, keywords (с origin user/auto), entities (kind+value), aliases/search_phrases; — time: relevant_from/relevant_to/expires_at (опционально); — privacy: visibility (private/allowed_in_answers/never_quote), sensitivity (normal/sensitive); — attachments (url/file/image) (опционально); — source: channel/chat_id/dialog_id/message_id/source_text (опционально, может быть несколько источников). 4.2. Обновление MemoryItem Должна быть возможность: — менять статус (active/archived/deleted); — редактировать title/topic/project/time/privacy; — редактировать контент (с обновлением updated_at); — добавлять/удалять anchors (tags/keywords/entities/aliases); — добавлять/удалять attachments; — добавлять новые sources. 4.3. Удаление Логическое удаление: status=deleted. Физическое удаление (опционально, отдельной админ-операцией) — если потребуется. 4.4. Дедупликация При создании MemoryItem система должна вычислять content_hash (SHA-256 от нормализованного текста; правила нормализации фиксируются в реализации) и проверять уникальность в рамках owner_user_id. Если найден дубль: — либо возвращать существующий item (режим ‘strict’), — либо создавать новый и проставлять canonical_id на существующий (режим ‘link-duplicate’). Режим выбирается параметром API или конфигом. 4.5. Поиск Система должна поддерживать поиск по: — тексту content.text (FULLTEXT); — title; — tags; — keywords; — entities (kind/value); — фильтрам: type, status, project, topic, visibility, sensitivity; — фильтрам по времени: created_at range, expires_at (актуальные/просроченные). Минимальный результат поиска: список MemoryItem с id, title, type, status, фрагментом текста (опционально), created_at. 4.6. Актуальность Если expires_at 4.7. Приватность visibility: — private: доступен только владельцу; — allowed_in_answers: можно использовать в генерации ответов; — never_quote: можно учитывать для внутренней логики, но нельзя цитировать/выводить дословно. sensitivity: — normal/sensitive: метка для дополнительной осторожности (логирование/вывод). 5. Требования к данным и БД 5.1. СУБД MySQL 8.x, движок InnoDB, кодировка utf8mb4. 5.2. Нормализация Данные должны храниться в нормальных формах: — справочники (типы/статусы/форматы/видимость/чувствительность/каналы/виды сущностей/виды вложений) — отдельные таблицы; — контент — отдельная таблица 1:1; — теги/ключевые слова/сущности — отдельные таблицы + M:N связки; — источники/вложения/алиасы — 1:N. 5.3. Схема таблиц Используется схема, предложенная ранее: users, memory_items, memory_contents, memory_sources, memory_attachments, tags + memory_item_tags, keywords + memory_item_keywords, entities + memory_item_entities, memory_aliases, и справочники. 5.4. Индексы Обязательные индексы: — memory_items(owner_user_id, created_at) — memory_items(owner_user_id, status_id) — memory_items(expires_at) — memory_items(owner_user_id, content_hash) — FULLTEXT по memory_contents.text — индексы на таблицах связей по второму ключу (tag_id/keyword_id/entity_id) 6. API (логический контракт, без привязки к транспорту) Минимальные операции: — CreateMemoryItem(payload) - id (+ флаг duplicate/canonical_id при необходимости) — UpdateMemoryItem(id, patch) — GetMemoryItem(id) — ListMemoryItems(filters, pagination) — SearchMemoryItems(query, filters, pagination) — ArchiveMemoryItem(id) / RestoreMemoryItem(id) — DeleteMemoryItem(id) (soft delete) 7. Нефункциональные требования — Производительность: поиск по owner_user_id должен работать предсказуемо (индексы обязательны). — Масштабирование: допускается рост до N элементов на пользователя (уточнить N). — Безопасность: доступ строго по owner_user_id. — Логи: не логировать sensitive контент в открытом виде (если включено). 8. Приёмка (критерии готовности) Считается выполненным, если: — схема БД развёртывается миграциями без ручных правок; — CRUD работает и покрыт тестами (минимум smoke); — дедупликация по content_hash работает в обоих режимах; — поиск по тексту + по тегам/keywords/entities работает; — фильтры по status/type/project/topic/visibility/expires_at работают; — каскадные удаления связей при удалении memory_item соблюдены (ON DELETE CASCADE где нужно). 9. Открытые вопросы (мне от тебя нужно 4 ответа, чтобы ТЗ стало ‘финальным’) 1) Поиск по-русски: достаточно MySQL FULLTEXT как есть, или нужна нормальная морфология (внешний движок/стемминг/ngram)? 2) Дедуп: ‘strict’ (не создавать дубль) или ‘link-duplicate’ (создавать, но ссылаться на canonical)? 3) UUID: BINARY(16) (быстро) или CHAR(36) (удобно глазами)? 4) Максимальные объёмы: примерно сколько MemoryItem на пользователя и сколько пользователей (порядок: 1k/10k/1M)? Ответишь — и я превращу это в финальную версию ТЗ: без ‘опционально’, с точными решениями и с приложением ‘DDL + примеры запросов поиска’.