fn-registry agent
138 lines
5.5 KiB
Markdown
138 lines
5.5 KiB
Markdown
# 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.
|