labull-framework 0.1.2__tar.gz → 0.1.3__tar.gz

{labull_framework-0.1.2/labull_framework.egg-info → labull_framework-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: labull-framework
-Version: 0.1.2
+Version: 0.1.3
 Summary: Labull Framework: a pluggable Django app with Authing OIDC login and magic blocks
 Author: Labull Framework
 License-Expression: MIT

{labull_framework-0.1.2 → labull_framework-0.1.3}/labull_framework/canvas/data.py

@@ -253,6 +253,27 @@ def _verbose(model: Any) -> str:
     return str(getattr(model._meta, 'verbose_name', '') or '')
 
 
+def m2m_through(field: Any) -> Any:
+    """多对多那条关系**中间表**是哪个模型。
+
+    🔴 正反两侧拿中间表的方式**不一样**，只认一边就会炸（真踩过：`canvasdemo` 的演示表
+       `Course.students` 一加进来，`/canvas` 直接 500）：
+       · **正向**（`ManyToManyField`）：中间表挂在 `field.remote_field.through` 上；
+       · **反向**（`ManyToManyRel`，例如 `Student.courses`）：`field.remote_field` 是**正向那个
+         field 本身**，而它在 Django 里**没有 `through` 属性**（不是 None，是 AttributeError），
+         中间表挂在 `field.through` 上。
+    ⚠️ 老代码写的是 `getattr(field.remote_field, 'through', None)`：反向那一侧拿到 `None`，
+       紧接着 `None._meta` 抛 `AttributeError` —— 而 `auth` 的那几张表恰好在 `SKIP_TABLES` 里、
+       平时又没人写过普通多对多，所以这个坑一直没露出来。`getattr` 的默认值把 AttributeError
+       一起吞了，连报错都指不到真正的原因。
+    """
+    for owner in (getattr(field, 'remote_field', None), field):
+        through = getattr(owner, 'through', None)
+        if through is not None:
+            return through
+    return None
+
+
 def shape() -> dict[str, list[dict[str, Any]]]:
     """当前的模型形状（进程内现算，不需要任何文件）。
 
@@ -270,14 +291,21 @@ def shape() -> dict[str, list[dict[str, Any]]]:
         for field in model._meta.get_fields():
             if getattr(field, 'many_to_many', False):
                 target = field.related_model
-                through = getattr(getattr(field, 'remote_field', None), 'through', None)
+                through = m2m_through(field)
+                # 🔴 "反向那一侧"必须标成 `readonly`：多对多的正反两条都走这个分支，
+                #    而前端是**按"两端表名排序"分组、每组只画正向那条**的。
+                #    老代码这里没给 `readonly` ⇒ 反向那条也进了 forward 组 ⇒ **同一个关系画了两条
+                #    方向相反的线、必然交叉**（用户报的「关联键故意交叉了」就是这个，
+                #    实测 `course -> student` 与 `student -> course` 各画了一条）。
+                #    判定：反向的多对多是一个 `ManyToManyRel`，`auto_created` 为真。
                 relations.append(
                     _relation_of(
                         field,
                         'manyToMany',
                         '*',
                         target,
-                        via=str(getattr(through._meta, 'db_table', '') or '') or None,
+                        via=str(getattr(getattr(through, '_meta', None), 'db_table', '') or '') or None,
+                        readonly=bool(getattr(field, 'auto_created', False)),
                     )
                 )
                 continue

{labull_framework-0.1.2 → labull_framework-0.1.3}/labull_framework/canvas/static/canvas.css

@@ -179,7 +179,11 @@ body {
   transition: stroke-width .12s;
 }
 
-.edge.violet { stroke: var(--tone-violet); }
+/* 🔴 **按"关联种类"上的色已经全部去掉**（这里原来有一条 `.edge.violet { stroke: var(--tone-violet) }`）。
+ *    理由就是用户定的那条规矩：**整页默认全黑，只有"相对基线动过"才上色**。
+ *    多对多那条线原来默认是紫的（它排在 `.edge` 的黑色**后面**，所以盖掉了默认色）——
+ *    用户一眼就看出来了（「为什么是紫色？」）。
+ *    ⚠️ 老判据只验了普通外键是黑的、没验多对多，所以这条一直漏着；现在 CSS 里不再有种类色。 */
 /* 反向（只读）那一侧画虚一点：库里没有这一列，不该看起来跟真外键一模一样 */
 .edge.is-readonly { stroke-dasharray: 5 4; }
 /* 🔴 关联的增 / 改 / 删：颜色与卡片、字段行的三档完全一致（同一份 token）。
@@ -207,42 +211,65 @@ body {
 .arrow.modified { stroke: var(--modified); }
 .arrow.deleted { stroke: var(--deleted); }
 
-/* 基数：**空心圆里一个 `1` / `*`**，落在方块边界附近（线的两端）。
- * 🔴 圆填白、描边走线的颜色：它压在白卡 / 绿卡 / 黄卡上都读得出来 ——
- *    卡片底色恰恰是"变了没有"的判据，标记不能靠底色来分辨。 */
+/* 基数：**空心圆里一个 `1` / `*`**，落在方块边界内侧（线的两端）。
+ * 🔴 **默认是黑的**（用户明确要的：整页默认全黑，只有"相对基线动过"的才上色）——
+ *    和线一个口径：没动过的关联，线黑、两端的圈也黑；动了才换色（下面那三条）。
+ * ⚠️ 圆填卡片色（白底把线遮住），所以字上再加一圈卡片色描边才读得清。 */
 .cardinality { pointer-events: none; }
-.cardinality circle { fill: var(--card); stroke: var(--tone-green); stroke-width: 1.8; }
+.cardinality circle { fill: var(--card); stroke: var(--ink); stroke-width: 1.8; }
 .cardinality text {
-  fill: var(--tone-green);
+  fill: var(--ink);
   font-size: 10px;
   font-weight: 700;
   text-anchor: middle;
-  dominant-baseline: middle;
+  /* 🔴 `central` 而不是 `middle`：`middle` 对齐的是**x-height 的中线**，数字会略微偏下；
+   *    `central` 对齐的是**整个 em 框的中线**，`1` 与 `*` 都正好落在圆心上（用户要的"正中间"）。
+   *    ⚠️ 别再往 `y` 上加偏移补偿 —— 那样和这里叠起来就偏了（真踩过）。 */
+  dominant-baseline: central;
   font-family: ui-monospace, Consolas, monospace;
   paint-order: stroke;
   stroke: var(--card);
   stroke-width: 2.5px;
   stroke-linejoin: round;
 }
+/* 只有"这条关联相对基线动过"时才上色 —— 与 `.edge.is-*` / 卡片 / 字段行同一套 token。 */
+.cardinality.is-added circle { stroke: var(--added); }
+.cardinality.is-added text { fill: var(--added); }
+.cardinality.is-modified circle { stroke: var(--modified); }
+.cardinality.is-modified text { fill: var(--modified); }
+.cardinality.is-deleted circle { stroke: var(--deleted); }
+.cardinality.is-deleted text { fill: var(--deleted); }
 /* `*` 那个字比 `1` 宽，给大一号才在同一个圆里好看。
  * ⚠️ 两个圆**都是实线**：一开始给 `*` 画了虚线想区分"多"，用户明确要求实心圆，就去掉了
  *    （`1` 与 `*` 的字形本身已经够区分；实线圆看起来也更干净）。 */
 .cardinality.is-many text { font-size: 16px; }
 
-/* 关联键的名字：标在**线的正中间**。
- * 🔴 `dominant-baseline: middle` 是必须的：`y` 默认是**基线**，配合上面那句旋转，
- *    不写它文字就会整体偏到线的一侧。`paint-order: stroke` 再描一圈卡片色，
- *    线从字底下穿过时也读得清。 */
+/* 🔴 关联名：**一律水平、框高统一**（参考 Mendix 的关联标签）。
+ *    · 字**不按线的角度转**了：斜框有两个毛病 —— 框高会随角度变（AABB 撑大），
+ *      而且斜着不像"钉在线上"；
+ *    · `dominant-baseline: middle` 仍然必须有：`y` 默认是**基线**，不写它字就偏到线的一侧；
+ *    · 那圈 `paint-order: stroke` 的描边**去掉了** —— 现在有框的底色遮线，描边只会在框里多一圈边。
+ *      自关联那个圈上的名字没有框，描边只留给了它（见下面 `.edge-name--self`）。 */
 .edge-name {
   fill: var(--muted);
   font-size: 10.5px;
   font-family: ui-monospace, Consolas, monospace;
   text-anchor: middle;
   dominant-baseline: middle;
+  pointer-events: none;
+}
+/* 自关联那个圈上的名字**没有框**（它挂在圈顶，不在线上），所以这唯一一处保留描边好读。 */
+.edge-name--self {
   paint-order: stroke;
   stroke: var(--card);
   stroke-width: 3.5px;
   stroke-linejoin: round;
+}
+/* 关联标签的黑框（参考 Mendix）：细黑边 + 卡片色底 —— 底把线遮住，字就干净了。 */
+.edge-name-box {
+  fill: var(--card);
+  stroke: var(--ink);
+  stroke-width: 1;
   pointer-events: none;
 }
 /* 有关联备注时才可点（点开看备注）—— 鼠标形状是唯一的提示，所以只给能点的那些加。 */
@@ -295,9 +322,14 @@ body {
 .head:hover { background: #e9eff6; }
 
 .title { flex: 1; min-width: 0; display: flex; align-items: baseline; gap: 8px; flex-wrap: wrap; }
-.title b { font-size: 14px; font-family: ui-monospace, Consolas, monospace; }
-.title .cn { color: var(--text); font-size: 12px; }
+/* 🔴 主名字要**大**（用户明确要的）：卡片上第一眼要能认出这是哪张表，14px 在缩到 40% 之后太小。 */
+.title b { font-size: 16px; font-family: ui-monospace, Consolas, monospace; }
+.title .cn { color: var(--text); font-size: 13px; }
 .title .mod { color: var(--muted); font-size: 11px; }
+/* 🔴 备注模式下两个名字**对调**（见 canvas.js 里算 `primary` / `secondary` 那两行）：
+ *    主位那时是**中文备注名** —— 中文不该走等宽；技术表名退到次位，它才是该等宽的那个。 */
+#canvas.is-note-first .title b { font-family: inherit; }
+#canvas.is-note-first .title .cn { font-family: ui-monospace, Consolas, monospace; }
 
 .caret { color: var(--muted); font-size: 11px; transition: transform .15s; }
 .table.is-open .caret { transform: rotate(180deg); }