backend: tag the literature, in a table of its own

A tag is the writer's filing of a row — 「综述」, 「必读」 — and it is a
different fact from `reference.keywords`, which are the 关键词 printed on
the article. A tag never prints, one document carries several, and the same
label is on many documents, so it gets two tables rather than a column:

  reference_tag       name (unique), colour, note
  reference_tag_link  reference_id + tag_id — the pair is the primary key

The link is a bare link, which is why it is `_link` and not `_placement`:
there is no `sort` to own, so the pair *is* the row and the same label
cannot be applied twice.

A tag is made first and applied second: `tag_ids`, never tag names, so a
typo cannot invent a label — an unknown id is a 400 naming it, and nothing
is written. Deleting a tag is deliberately *not* guarded the way deleting a
cited reference is: both foreign keys cascade, so the labels go and the
literature stays.

`GET /references?tag=1&tag=2` narrows rather than widens — the rows carrying
both labels — because that is what a second filter reads as.

The smoke test now walks the whole flow in the order the feature intends:
labels first, then tagged references, then a rename that follows every row.
This commit is contained in:
2026-09-22 17:55:15 +08:00
parent d7bb777264
commit 6020310b3f
14 changed files with 1042 additions and 29 deletions
+12
View File
@@ -19,6 +19,10 @@ after its table (``Template`` -> ``template``):
paper the 论文 module
paper_sentence one sentence of one paper
paper_sentence_reference a citation of one sentence
reference the 参考文献 module
reference_author its contributors, in print order
reference_tag the writer's labels (文献标签)
reference_tag_link which literature carries which label
``template_title_placement`` and ``template_title`` are one word apart and mean
opposite things: the first is a *placement* (this template puts this field
@@ -42,11 +46,17 @@ from app.models.reference import (
Reference,
)
from app.models.reference_author import ReferenceAuthor
from app.models.reference_tag import (
DEFAULT_TAG_COLOR,
ReferenceTag,
reference_tag_link,
)
from app.models.template import Template
from app.models.template_title_placement import TemplateTitlePlacement
from app.models.template_title import TemplateTitle
__all__ = [
"DEFAULT_TAG_COLOR",
"PAPER_STATUSES",
"STATUS_DONE",
"STATUS_DRAFT",
@@ -59,8 +69,10 @@ __all__ = [
"REFERENCE_TYPES",
"Reference",
"ReferenceAuthor",
"ReferenceTag",
"Template",
"TemplateTitlePlacement",
"TemplateTitle",
"TimestampMixin",
"reference_tag_link",
]