195 lines
4.3 KiB
Markdown
195 lines
4.3 KiB
Markdown
# Mapeo HST - Airtable
|
|
|
|
**Estado:** Implementado
|
|
**Última actualización:** 2026-01-04
|
|
|
|
---
|
|
|
|
## Descripción
|
|
|
|
Sistema de mapeo bidireccional entre los tags semánticos HST/FLG almacenados en PostgreSQL y las múltiples bases de Airtable utilizadas por el equipo.
|
|
|
|
---
|
|
|
|
## Bases Airtable
|
|
|
|
| Base | ID | Tablas | Columna en map |
|
|
|------|-----|--------|----------------|
|
|
| hst_flg | appxaEAneiaYtO8NC | hst, flg | airtable_hst_flg |
|
|
| hst_psn | appOyP8gZfm9Bdcgm | hst | airtable_hst_psn |
|
|
| lumalia | appZgRKY5sG6E9zJy | hst in | airtable_lumalia |
|
|
| lum | apps8bynpQRuMPEid | hst in | airtable_lum |
|
|
| tuzzaro | appDaK3LcfWFrlc5u | hst in | airtable_tuzzaro |
|
|
| psn | appWIVTR5cYd3aIDJ | hst in | airtable_psn |
|
|
| bck | apprqWlmqdj98YIUt | hst in | airtable_bck |
|
|
| pff | appAyCPZAtkPhkOAh | hst in | airtable_pff |
|
|
|
|
---
|
|
|
|
## Tabla de Mapeo
|
|
|
|
**Schema:** `map`
|
|
**Tabla:** `airtable_map`
|
|
**Ubicación:** PostgreSQL en servidor HST (72.62.2.84)
|
|
|
|
### Estructura
|
|
|
|
```sql
|
|
CREATE TABLE map.airtable_map (
|
|
id SERIAL PRIMARY KEY,
|
|
als VARCHAR(255), -- Alias del tag
|
|
mrf_hst VARCHAR(64), -- Hash MRF en HST
|
|
airtable_hst_flg VARCHAR(20),
|
|
airtable_hst_psn VARCHAR(20),
|
|
airtable_lumalia VARCHAR(20),
|
|
airtable_lum VARCHAR(20),
|
|
airtable_tuzzaro VARCHAR(20),
|
|
airtable_psn VARCHAR(20),
|
|
airtable_bck VARCHAR(20),
|
|
airtable_pff VARCHAR(20),
|
|
created_at TIMESTAMP DEFAULT NOW()
|
|
);
|
|
|
|
CREATE INDEX idx_map_als ON map.airtable_map(als);
|
|
CREATE INDEX idx_map_mrf ON map.airtable_map(mrf_hst);
|
|
```
|
|
|
|
### Contenido
|
|
|
|
| Origen | Registros |
|
|
|--------|-----------|
|
|
| hst | 963 |
|
|
| flg | 65 |
|
|
| **Total** | **1028** |
|
|
|
|
### Estado de Mapeo
|
|
|
|
| Columna | Registros con ID |
|
|
|---------|------------------|
|
|
| airtable_hst_flg | 797 |
|
|
| airtable_hst_psn | 796 |
|
|
| airtable_lumalia | 746 |
|
|
| airtable_lum | 746 |
|
|
|
|
---
|
|
|
|
## Lógica de Matching
|
|
|
|
El mapeo se realiza por **alias normalizado**:
|
|
|
|
1. Lowercase
|
|
2. Eliminar espacios extra
|
|
3. Eliminar "/" en conectores (ej: "M12 / 6p" → "M12 6p")
|
|
4. Normalizar variantes:
|
|
- `prototipo` se omite
|
|
- `especificaciones` → `especificación`
|
|
|
|
### Formato de Alias
|
|
|
|
```
|
|
{ref} {nombre}
|
|
```
|
|
|
|
Ejemplos:
|
|
- `spe m12 6p female`
|
|
- `flg spain`
|
|
- `hst acero inoxidable`
|
|
- `rbc cable de cinta`
|
|
|
|
---
|
|
|
|
## Grupos HST
|
|
|
|
| Grupo | Descripción | Cantidad |
|
|
|-------|-------------|----------|
|
|
| hst | Tags principales | 717 |
|
|
| spe | Especificaciones técnicas | 142 |
|
|
| vsn | Visiones | 40 |
|
|
| vue | Vistas | 21 |
|
|
| msn | Misiones/Proyectos | (pendiente) |
|
|
|
|
---
|
|
|
|
## Conectores Añadidos
|
|
|
|
Conectores técnicos sincronizados con Airtable:
|
|
|
|
### JST
|
|
- jst jwpf 2p/3p/4p female/male
|
|
- jst sm 2p/3p/4p female/male
|
|
|
|
### Roscas M
|
|
- M8 4p female/male
|
|
- M12 2+2p/4p/6p/8p female/male
|
|
- M15 3p female/male
|
|
- M16 2p/2+4p female/male/screw
|
|
- M20 3p/4p screw
|
|
- M25 2+2p female/male
|
|
- M29 4p female/male
|
|
- mr30 female/male
|
|
|
|
### Otros
|
|
- xt30 female/male
|
|
- xt60 female/male
|
|
- ethernet
|
|
- utp, ftp, s/ftp, sf/utp
|
|
- rbc (ribbon cable / cable de cinta)
|
|
|
|
---
|
|
|
|
## Convenciones de Nombres
|
|
|
|
| Campo | Español | Inglés |
|
|
|-------|---------|--------|
|
|
| nombre_es | hembra/macho | - |
|
|
| nombre_en | - | female/male |
|
|
| Roscas | M8, M12, M16... (mayúsculas) | M8, M12, M16... |
|
|
| Resto | minúsculas | minúsculas |
|
|
|
|
---
|
|
|
|
## Archivos
|
|
|
|
| Ubicación | Archivo | Descripción |
|
|
|-----------|---------|-------------|
|
|
| HST Server | /hst/map/airtable_map.sql | Schema SQL |
|
|
| HST Server | /hst/map/airtable_map_data.sql | Datos (INSERT) |
|
|
| R2 | documentos adjuntos/architect/airtable_map.sql | Schema + datos completos |
|
|
| R2 | documentos adjuntos/architect/mapeo_simplificado_hst_flg_airtable.md | Tabla MD (4 bases) |
|
|
| R2 | documentos adjuntos/architect/mapeo_completo_hst_flg_airtable.md | Tabla MD (8 bases) |
|
|
| R2 | documentos adjuntos/architect/proyectos_msn.md | 108 proyectos pendientes |
|
|
|
|
---
|
|
|
|
## Pendientes
|
|
|
|
- [ ] Añadir 108 proyectos al grupo `msn`
|
|
- [ ] Sincronización automática bidireccional
|
|
- [ ] Webhook para cambios en Airtable
|
|
|
|
---
|
|
|
|
## Uso
|
|
|
|
### Consultar mapeo
|
|
|
|
```sql
|
|
SELECT * FROM map.airtable_map WHERE als LIKE '%spain%';
|
|
```
|
|
|
|
### Obtener ID de Airtable para un tag HST
|
|
|
|
```sql
|
|
SELECT als, airtable_hst_flg, airtable_lumalia
|
|
FROM map.airtable_map
|
|
WHERE mrf_hst = 'abc123...';
|
|
```
|
|
|
|
### Buscar por ID de Airtable
|
|
|
|
```sql
|
|
SELECT als, mrf_hst
|
|
FROM map.airtable_map
|
|
WHERE airtable_hst_flg = 'recXXXXXXXX';
|
|
```
|