milestone 25: client names learned over reverse dns

src/web/openapi.yaml

@@ -2024,13 +2024,20 @@ components:
 
     Client:
       type: object
-      required: [id, ip, name, group_id, group, hand_edited, first_seen, last_seen]
+      required: [id, ip, name, learned_name, group_id, group, hand_edited, first_seen, last_seen]
       properties:
         id: { type: integer }
         ip: { type: string }
         name:
           type: string
           description: Empty when the client was never named.
+        learned_name:
+          type: string
+          description: |
+            The name learned over reverse DNS, or empty when nothing was
+            learned. Display-only runtime state: `name` wins whenever it is
+            non-empty, and a learned name never appears in an export. The
+            server writes it; a client cannot.
         group_id: { type: integer }
         group: { type: string }
         hand_edited: { type: boolean }