panels-origin/api/iam_db.ts
Cursor Agent 493829d028
api: migrar todo el backend de SQLite a Postgres + Redis (fase 2-4e)
Fase 2 (driver):
- api/pg.ts: adaptador delgado sobre postgres.js (prepare/get/all/run,
  placeholders ? -> $n, withTenant con set_config para RLS), con parsers
  de tipo custom (numeric/date/timestamp(tz)/bigint) para que el resto
  del codigo heredado de SQLite (fechas/montos como string, ids como
  number) siga funcionando sin reescribir cada call-site a mano.
- api/platform_db.ts, api/iam_db.ts (nuevo), api/db.ts: pools separados
  por base/esquema (panels_platform, panels_product.iam,
  panels_product.core), owner pool para bootstrap/scripts/lookups
  administrativos que cruzan tenant a proposito.
- api/redis.ts: clientes iam/core separados (ACL panels_iam_redis /
  panels_core_redis).
- api/sessions.ts + auth.ts: sesiones ahora en Redis (cookie = id opaco,
  no HMAC autocontenido); revocacion real (logout, cambio de password).
- api/storage.ts (Fase 4c): documentos/PDFs via Contabo Object Storage
  (S3), con fallback a disco local si no hay credenciales S3 (dev).
- api/scope.ts: middleware withCoreScope/requireCoreAuth que abre la
  transaccion con app.tenant_id fijado (RLS) para cada request.
- api/cache.ts (Fase 4e): cache Redis con tenant_id obligatorio en la
  llave; aplicado a /v1/catalogs.

Fase 3 (reescritura SQL, ~80 endpoints en main.ts/companies.ts/budget.ts/
payroll.ts/payroll_http.ts/excel.ts/saas.ts/smtp.ts):
- Todo async/await, sintaxis Postgres (COALESCE, ~ regex, ON CONFLICT,
  now()/current_date, booleanos reales, RETURNING via lastInsertId()).
- IDOR cross-tenant cerrado: GET/PATCH /v1/projects/:id, /v1/workers/:id
  ya no dependen de que el handler recuerde el WHERE tenant_id -- Row
  Level Security lo hace estructuralmente (verificado con un segundo
  tenant real: 404 en vez de fuga de datos).
- API key ya no ve todos los tenants: ahora exige X-Tenant-Id explicito.

Fase 3b (tests): api/test_helpers.ts corre cada test en una transaccion
que siempre se revierte, contra el mismo baseline de Liquibase que
produccion (ya no un esquema SQLite escrito a mano). payroll_test.ts
reescrito con fixtures reales; 11/11 pasan contra Postgres.

Fase 4 (IAM/RBAC): iam.roles/permissions/role_permissions formalizados
(ver db/iam ya en fase 1); uploaded_by/created_by ahora son snapshot
desnormalizado (uploaded_by_id/name); seed() en runtime eliminado,
reemplazado por scripts/bootstrap-admin.ts (one-shot).

Fase 4d (zona horaria): nuevo endpoint /v1/configuracion (GET/PUT),
PAYROLL_TZ hardcodeado reemplazado por tenant_settings.timezone,
document_validity.ts ya no usa new Date() crudo.

Verificado end-to-end contra Postgres+Redis reales: login, sesiones,
catalogos con cache, alta de trabajador, subida/descarga de documento
cifrado, y el fix de IDOR probado con un segundo tenant real (403/404
en vez de fuga de datos).

Co-authored-by: alberto.martinez <alberto.martinez@mrdev.mx>
2026-09-02 20:47:45 +00:00

72 lines
2.8 KiB
TypeScript

import postgres, { createPool, PgDb, withTenant } from "./pg.ts";
import { config } from "./config.ts";
/**
* panels_product, esquema iam: identidad/roles/permisos DE CADA TENANT.
* Aislado de `core` a propósito (ver reglas del monolito modular) -- este
* módulo no debe importar nada de db.ts (core) ni viceversa.
*/
let appPool: postgres.Sql | null = null;
let authPool: postgres.Sql | null = null;
function getAppPool(): postgres.Sql {
if (!appPool) {
appPool = createPool(config.databaseUrlIam, { max: 10 });
}
return appPool;
}
/** Pool con credenciales _owner: SOLO para resolver login por username (el
* username es único globalmente, no por tenant, así que hay que buscarlo
* ANTES de saber a qué tenant pertenece -- RLS con tenant_id no puede
* aplicar todavía en ese punto). El dueño de la tabla omite RLS de forma
* nativa en Postgres (a menos que se use FORCE ROW LEVEL SECURITY, que a
* propósito no se activó -- ver db/iam/changesets/002-rls.sql). No usar
* este pool para nada más que esa resolución puntual. */
function getAuthPool(): postgres.Sql {
if (!authPool) {
authPool = createPool(config.databaseUrlIamOwner || config.databaseUrlIam, { max: 3 });
}
return authPool;
}
/** Health-check de arranque: falla rápido si Postgres no responde. */
export async function pingIamDb(): Promise<void> {
await getAppPool()`SELECT 1`;
}
/** Busca un usuario por username en CUALQUIER tenant (paso previo al login,
* antes de conocer el tenant_id). Devuelve la fila cruda; el caller decide
* qué hacer con tenant_id/role_code. */
export async function findUserByUsernameAnyTenant(username: string) {
const rows = await getAuthPool()`
SELECT id, username, password_hash, display_name, company_id, tenant_id,
role_code, must_change_password, email, created_at
FROM iam.users WHERE username = ${username}`;
return rows[0] as Record<string, unknown> | undefined;
}
/** Ejecuta `fn` con una conexión ya acotada por tenant_id via RLS (ver
* pg.ts#withTenant). Todo el resto del código de iam (fuera del login)
* debe pasar por aquí. */
export async function withIamTenant<T>(
tenantId: number | null,
fn: (db: PgDb) => Promise<T>,
): Promise<T> {
return await withTenant(getAppPool(), tenantId, fn);
}
/** Uso puntual sin transacción/RLS explícito -- reservado para el bootstrap
* (scripts/bootstrap-admin.ts) y para lecturas del propio rol _owner que
* necesitan ver todos los tenants a propósito (soporte/administración). */
export async function withIamOwner<T>(fn: (db: PgDb) => Promise<T>): Promise<T> {
return await fn(new PgDb(getAuthPool()));
}
export async function closeIamDb(): Promise<void> {
await appPool?.end({ timeout: 5 });
await authPool?.end({ timeout: 5 });
appPool = null;
authPool = null;
}