docs: reorganize operational documentation

mkdocs.yml

@@ -44,27 +44,48 @@ markdown_extensions:
     alternate_style: true
 nav:
 - Home: index.md
-- User guide: guida-utente.md
-- DWH REST per installation:
-  - dwh-auth server: install/dwh-auth-server.md
-  - DWH client enrollment: install/dwh-auth-client-enrollment.md
-  - DWH REST TLS: install/dwh-auth-tls.md
-- Contracts and CLI:
+- Install and operate:
+  - Install and first start: install/first-start.md
+  - Local authentication: install/authentication-local.md
+  - Generic OIDC: install/authentication-oidc.md
+  - Authentik: install/authentik.md
+  - Workspace operations: operations/workspaces.md
+  - Pi model configuration: general/pi-configuration.md
+  - Docker installation contexts: installazione-docker-4-contesti.md
+- Use ThothII:
+  - User guide: guida-utente.md
+  - Database management: operations/database-management.md
+  - Evidence authoring and publication: evidence.md
+  - Workflow references:
+    - Initial disambiguation: disambiguazione-iniziale.md
+    - Memory management: gestione-memory.md
+    - Operating skills: skills.md
+- Architecture:
+  - Overview: architecture/overview.md
+  - Components, modules, and flows: architecture/components.md
+  - Authentication and authorization: architecture/authentication.md
+- Contracts and integration:
+  - Catalog schema snapshot RPC: contracts/catalog-schema-snapshot.md
   - Workspace preprocessing CLI: contracts/workspace-preprocessing-cli.md
   - tht–DWH contract: contracts/tht-dwh.md
   - Workspace Evidence v3 contract: contracts/workspace-evidence-v3.md
-- ThothII technical documentation:
-  - Architecture overview: architecture/overview.md
-  - Components, modules, and flows: architecture/components.md
-  - Evidence: evidence.md
+  - DWH REST server: install/dwh-auth-server.md
+  - DWH client enrollment: install/dwh-auth-client-enrollment.md
+  - DWH REST TLS: install/dwh-auth-tls.md
+- Decisions and acceptance:
+  - Architecture decisions:
+    - 0001 Metadata catalog: adr/0001-postgres-metadata-catalog.md
+    - 0002 Workspace database secrets: adr/0002-workspace-database-secret-references.md
+    - 0003 Installation-local bindings: adr/0003-installation-local-database-bindings.md
+    - 0004 Fastify/Kysely catalog: adr/0004-fastify-kysely-metadata-catalog.md
+    - 0005 Table deletion during synchronization: adr/0005-hard-delete-catalog-tables-during-synchronization.md
+    - 0006 Physical and logical relationships: adr/0006-separate-physical-and-logical-relationships.md
+    - 0007 Authoritative schema synchronization: adr/0007-durable-authoritative-schema-synchronization.md
+    - 0008 Manual catalog cleanup: adr/0008-allow-manual-catalog-metadata-cleanup.md
+    - 0009 Sequential description generation: adr/0009-use-one-sequential-description-generation-run.md
+    - 0010 Bounded source samples: adr/0010-allow-bounded-real-source-samples-for-description-generation.md
   - AI catalog description acceptance: testing/2026-08-29-ai-catalog-description-generation-acceptance.md
-  - Authentication: architecture/authentication.md
-  - Local authentication installation: install/authentication-local.md
-  - Generic OIDC: install/authentication-oidc.md
-  - Authentik: install/authentik.md
-  - Docker installation (4 contexts): installazione-docker-4-contesti.md
-  - Memory management: gestione-memory.md
-  - Operating skills: skills.md
-  - Initial disambiguation: disambiguazione-iniziale.md
-- General topics:
-  - Pi model configuration: general/pi-configuration.md
+  - Design records:
+    - Metadata catalog design: plans/2026-08-26-metadata-catalog-from-thothai.md
+    - Description generation design: plans/2026-08-28-ai-catalog-description-generation.md
+    - Description generation specification: plans/2026-08-28-ai-catalog-description-generation-spec.md