update

.paul/codebase/db_schema.md

@@ -280,6 +280,26 @@ Schema inferred from Medoo ORM queries in PHP source files. No migration files f
 | `mail` | TEXT | Message body |
 | `add_date` | DATETIME | Submission timestamp |
 
+**`contact_messages`** — External contact form submissions database used by `plugins/special-actions-middle.php`
+| Column | Type | Notes |
+|--------|------|-------|
+| `form_id` | VARCHAR | Form identifier, e.g. `contact-form-new`, `modal-contact-form` |
+| `name` | VARCHAR | Sender name |
+| `email` | VARCHAR | Sender email |
+| `phone` | VARCHAR | Sender phone |
+| `message` | TEXT | Message body |
+| `zip_code` | VARCHAR | Postal code |
+| `topic` | VARCHAR | Subject/topic |
+| `company` | VARCHAR | Company name |
+| `invoice_number` | VARCHAR | Invoice/reference number |
+| `address` | VARCHAR | Address |
+| `voivodeship` | VARCHAR | Province/voivodeship |
+| `client_type` | VARCHAR | Client segment |
+| `consent_offer` | TINYINT | Offer consent flag |
+| `consent_marketing` | TINYINT | Marketing consent flag |
+| `attachments` | TEXT NULL | JSON array of public attachment links; auto-created by `saveContactData()` if missing |
+| `created_at` | DATETIME | Submission timestamp |
+
 ---
 
 ## SEO & Settings