chore: sync from fn-registry agent

2026-06-10 11:43:45 +02:00
commit 7c475be581
9 changed files with 519 additions and 0 deletions
@@ -0,0 +1,137 @@
+# Convenciones de archivos — vault osint
+
+Estándar para organizar la información de personas (y, a futuro, dominios y casos) en el vault
+`osint` (`/home/enmanuel/Obsidian/osint`). Toda extracción desde otros vaults o desde sesiones
+de navegación OSINT debe dejar los archivos siguiendo este estándar.
+
+## 1. Estructura física (estándar: plano + subcarpeta de documentos)
+
+```
+osint/
+  README.md
+  _self.md                              # ficha del titular (Enmanuel), referencia, NO es objetivo
+  personas/
+    <slug>.md                           # ficha de la persona (su "index")
+    <slug>/                             # carpeta con las notas-documento de esa persona
+      <doc-slug>.md
+  dominios/
+  organizaciones/                       # empresas/entidades (mismo patrón <slug>.md + <slug>/)
+  lugares/                              # direcciones/lugares de interés
+  casos/
+  inbox/
+  attachments/
+    personas/
+      <slug>/
+        <doc-slug>-NN.<ext>             # imágenes/PDFs de esa persona
+```
+
+Regla: la ficha vive como `.md` suelto en `personas/` (todas las fichas listables en un nivel);
+sus documentos en una subcarpeta homónima; los binarios en `attachments/personas/<slug>/`.
+
+## 2. Slug
+
+El `slug` es la clave estable de una persona. Se deriva del nombre completo:
+
+- minúsculas, sin acentos ni `ñ` (transliteración: `ñ`→`n`, `á`→`a`, …)
+- espacios y separadores → `-`
+- solo `[a-z0-9-]`, sin guiones dobles ni al inicio/fin
+
+Ejemplo: `Enmanuel Gutiérrez Pérez` → `enmanuel-gutierrez-perez`.
+
+## 3. Ficha de persona — `personas/<slug>.md`
+
+Frontmatter:
+
+```yaml
+tipo: persona
+nombre: "Enmanuel Gutierrez Perez"        # nombre legible original
+aliases: ["Enmanuel Gutierrez Perez"]     # nombres viejos para que wikilinks previos resuelvan
+slug: enmanuel-gutierrez-perez
+sexo: hombre                              # hombre|mujer|null
+fecha_nacimiento: 1997-03-05              # ISO o null
+dni: 54370345R                           # o null
+direccion: "Calle Eugenia Rios 14, 29718 Almachar, Malaga"   # texto plano, no wikilink
+pais: españa
+tags: [persona, osint]
+fuente: "NotasDeObsidian/personas/Enmanuel Gutierrez Perez.md"   # origen de la extracción
+```
+
+Body, secciones en este orden (omitir las vacías):
+
+```markdown
+## Documentos
+- [[enmanuel-gutierrez-perez/dni|DNI]]
+- [[enmanuel-gutierrez-perez/certificado-digital|Certificado digital]]
+
+## Relaciones
+- [[manuel-gutierrez-gamez|Manuel Gutierrez Gamez]] — hermano
+
+## Notas
+Texto libre de investigación.
+```
+
+## 4. Nota-documento — `personas/<slug>/<doc-slug>.md`
+
+Una nota-documento agrupa los attachments de un tipo de documento de la persona.
+
+`<doc-slug>` canónico (deriva del título original quitando el nombre de la persona y
+normalizando):
+
+| Título original (ejemplos) | doc-slug | doc_tipo |
+|---|---|---|
+| `Dni X`, `DNI de X` | `dni` | dni |
+| `Certificado Digital X` | `certificado-digital` | certificado |
+| `Carnet de conducir de X`, `Documentos Carnet Conducir X` | `carnet-conducir` | carnet |
+| `Fotos X`, `Fotos de X` | `fotos` | fotos |
+| `Vida Laboral X` | `vida-laboral` | laboral |
+| `Nominas <empresa> X` | `nominas-<empresa>` | laboral |
+| `Documentos <banco> X` (Abanca, BBVA, Cajamar…) | `documentos-<banco>` | banco |
+| `Modelo 100 X`, `Alta autonomo X` | `modelo-100`, `alta-autonomo` | fiscal |
+| `Datos empadronamiento X` | `empadronamiento` | otro |
+| `Contrato <x> X` | `contrato-<x>` | contrato |
+| (sin patrón claro) | slug del título sin el nombre | otro |
+
+Frontmatter:
+
+```yaml
+tipo: documento
+doc_tipo: dni                            # dni|certificado|carnet|fotos|banco|fiscal|laboral|contrato|otro
+persona: "[[enmanuel-gutierrez-perez]]"
+fuente: "NotasDeObsidian/Dni Enmanuel Gutierrez.md"
+```
+
+Body: los embeds reescritos a la ruta de attachments de la persona:
+
+```markdown
+![[attachments/personas/enmanuel-gutierrez-perez/dni-1.jpg]]
+![[attachments/personas/enmanuel-gutierrez-perez/dni-2.jpeg]]
+```
+
+## 5. Attachments — `attachments/personas/<slug>/`
+
+- Cada binario referenciado por una nota-documento se mueve a `attachments/personas/<slug>/`.
+- Se renombra a `<doc-slug>-NN.<ext>` (1-indexed, en el orden en que aparece en la nota),
+  preservando la extensión original en minúsculas. Ej: `dni-1.jpg`, `dni-2.jpeg`,
+  `documentos-abanca-1.pdf`.
+- Si el nombre original es relevante, se anota en el body de la nota-documento como comentario.
+
+## 6. Entidades que NO son personas
+
+Notas como `FenixFood SL`, `Documento Endesa`, `Documentos Aduanas …` van a `organizaciones/`;
+las direcciones/lugares (`Calle Eugenia Rios …`) van a `lugares/`. Ambas carpetas siguen el
+mismo patrón que `personas/`: `<slug>.md` como ficha + subcarpeta `<slug>/` para sus
+documentos + `attachments/<organizaciones|lugares>/<slug>/` para sus binarios. El frontmatter
+usa `tipo: organizacion` / `tipo: lugar` en vez de `tipo: persona`.
+
+## 7. Relaciones y direcciones
+
+- **Relaciones** entre personas (`Hermano de [[X]]`) se normalizan a la sección `## Relaciones`
+  de la ficha, enlazando al `slug` de la otra persona con alias legible.
+- **Direcciones**: en el frontmatter `direccion` como texto plano (no wikilink). Si una dirección
+  es entidad de investigación propia, tiene además su ficha en `lugares/<slug>.md`, y la persona
+  la enlaza con `direccion: "[[lugares/<slug>|texto legible]]"` si se quiere navegable.
+
+## 8. Idempotencia de la extracción
+
+El migrador debe ser re-ejecutable: si una persona ya existe en osint con su slug, se
+actualiza (no se duplica). Los attachments ya movidos no se vuelven a mover.