6020310b3f
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.
11 lines
372 B
Python
11 lines
372 B
Python
"""Data-access helpers.
|
|
|
|
Functions here take a :class:`sqlalchemy.orm.Session` and operate on ORM
|
|
models. They own the commit: a route calls one function and gets back either a
|
|
persisted object or ``None``.
|
|
"""
|
|
|
|
from app.crud import paper, reference, reference_tag, template, template_title
|
|
|
|
__all__ = ["paper", "reference", "reference_tag", "template", "template_title"]
|