Regiones¶

Dos tablas en la app mangroove_regiones: la región con su grilla y las celdas que la componen.

La región es la única entidad cuya forma decide la de todas las demás: cada recorte, cada grilla agregada y cada resultado se alinea con su grilla. Por eso su grilla es inmutable desde la creación (RN-03).

Requerimientos cubiertos¶

• RF-O-02
• RF-O-03
• RF-C-01
• RF-C-08

Diagrama¶

---
config:
  elk:
    nodePlacementStrategy: NETWORK_SIMPLEX
  fontFamily: monospace
  layout: elk
---
classDiagram
    class Region {
        +uuid id
        +varchar(50) codigo
        +varchar(150) nombre
        +text aoi_wkt
        +float8 lon_min
        +float8 lat_min
        +float8 lon_max
        +float8 lat_max
        +float8 centro_lon
        +float8 centro_lat
        +smallint zoom_inicial
        +varchar(50) zona_horaria
        +integer epsg
        +smallint celda_m
        +float8 x0
        +float8 y0
        +integer ancho
        +integer alto
        +integer n_celdas
        +integer margen_m
        +float8 marea_lon
        +float8 marea_lat
        +boolean is_active
        +timestamptz created_at
        +timestamptz updated_at
    }
    class Celda {
        +uuid id
        +uuid region_id
        +integer fila
        +integer columna
        +integer este_m
        +integer norte_m
        +varchar(24) codigo
        +float8 lon
        +float8 lat
        +timestamptz created_at
    }
    Region "1" --> "*" Celda

Region¶

Un área de estudio con su polígono, su proyección y su grilla.

• Régimen: Borrado lógico
• Volumen estimado: 1-5 filas
• Origen:

  • RF-O-02
  • RN-03

Columnas¶

Constraints¶

CONSTRAINT chk_region_codigo
CHECK (codigo ~ '^[a-z][a-z0-9_]*$')

CONSTRAINT chk_region_caja
CHECK (
  lon_min BETWEEN -180 AND 180 AND lon_max BETWEEN -180 AND 180
  AND lat_min BETWEEN -90 AND 90 AND lat_max BETWEEN -90 AND 90
  AND lon_min < lon_max AND lat_min < lat_max
)

CONSTRAINT chk_region_epsg_utm
CHECK (epsg BETWEEN 32601 AND 32660 OR epsg BETWEEN 32701 AND 32760)

CONSTRAINT chk_region_celda
CHECK (celda_m BETWEEN 10 AND 1000)

CONSTRAINT chk_region_tamano
CHECK (ancho > 0 AND alto > 0 AND ancho::bigint * alto <= 1000000)

CONSTRAINT chk_region_zoom
CHECK (zoom_inicial BETWEEN 0 AND 22)

Triggers¶

Cálculo de la grilla¶

Al crear la región, el servicio proyecta la caja envolvente al EPSG del centroide y fija:

• x0 = floor(min(E) / celda_m) * celda_m
• y0 = ceil(max(N) / celda_m) * celda_m
• ancho = ceil((max(E) - x0) / celda_m)
• alto = ceil((y0 - min(N)) / celda_m)

El origen queda alineado a múltiplos del tamaño de celda, así que dos regiones con el mismo EPSG y el mismo tamaño de celda comparten bordes de celda donde se solapan.

Celda¶

Un cuadro de la grilla. Solo geometría: la máscara, el humedal y el país dependen de los insumos y viven en los resultados de cada corrida (D-10).

• Régimen: Solo inserción
• Volumen estimado: hasta 1 M por región
• Origen:

  • RN-04
  • RF-C-08

Columnas¶

Unicidad¶

Triggers¶

Ubicar una celda desde un punto¶

RF-C-08 no consulta esta tabla para encontrar la celda: proyecta el punto al EPSG de la región y calcula columna = floor((E − x0) / celda_m) y fila = floor((y0 − N) / celda_m). La tabla solo se lee después, por unq_celda_region_fila_columna, para unirla con su resultado. Un punto sobre el borde exacto entre dos celdas cae siempre en la de mayor columna y mayor fila, porque floor es determinista.