منصوبے کے بارے میں

Zeref is a research and approval platform built as a TypeScript monorepo, utilizing npm workspaces for modular development. The architecture includes a Next.js control room UI, background Node job runners, and a PostgreSQL database with pgvector for data storage. Playwright is employed for browser automation to snapshot data from configured sources, which is then processed through a typed pipeline for normalization and embedding. The platform emphasizes snapshot immutability, ensuring data integrity, and follows a contracts-first design with shared JSON shapes. A BFF pattern is used where the browser communicates with Next.js API routes rather than raw workers. AI components are mockable via environment flags, allowing for CI testing without live keys. The repository features phase-gated verification scripts, Docker Compose for local development, and a demo mode using fixtures for testing without live credentials.