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.
79 lines
2.6 KiB
Python
79 lines
2.6 KiB
Python
"""SQLAlchemy ORM models.
|
|
|
|
Importing this package registers every model on ``Base.metadata``, which is
|
|
what ``alembic revision --autogenerate`` inspects. A new model therefore has to
|
|
be added to the imports below, not only to its own module.
|
|
|
|
The import order here is for readability only: relationships are declared by
|
|
name and resolved through the SQLAlchemy registry after every module has been
|
|
imported, so a cycle between two model modules is not a problem.
|
|
|
|
Table naming
|
|
------------
|
|
Every table is prefixed with the module it belongs to, and a class is named
|
|
after its table (``Template`` -> ``template``):
|
|
|
|
template the 模板 module
|
|
template_title_placement a field placed in a template, with its position
|
|
template_title the 字段库 the template module draws on
|
|
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
|
|
here, ``sort`` included), the second is the *catalogue* it was picked from.
|
|
"""
|
|
|
|
from app.models.mixins import TimestampMixin
|
|
from app.models.paper import (
|
|
PAPER_STATUSES,
|
|
STATUS_DONE,
|
|
STATUS_DRAFT,
|
|
STATUS_WRITING,
|
|
Paper,
|
|
)
|
|
from app.models.paper_sentence import PaperSentence
|
|
from app.models.paper_sentence_reference import PaperSentenceReference
|
|
from app.models.reference import (
|
|
REFERENCE_AUTHOR_ROLES,
|
|
REFERENCE_LANGUAGES,
|
|
REFERENCE_TYPES,
|
|
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",
|
|
"STATUS_WRITING",
|
|
"Paper",
|
|
"PaperSentence",
|
|
"PaperSentenceReference",
|
|
"REFERENCE_AUTHOR_ROLES",
|
|
"REFERENCE_LANGUAGES",
|
|
"REFERENCE_TYPES",
|
|
"Reference",
|
|
"ReferenceAuthor",
|
|
"ReferenceTag",
|
|
"Template",
|
|
"TemplateTitlePlacement",
|
|
"TemplateTitle",
|
|
"TimestampMixin",
|
|
"reference_tag_link",
|
|
]
|