How cetorres/acsp4hr_project works
Project type and purpose
• This is a full-stack web application (SPDS) for secure, privacy-preserving data sharing.
• Frontend: React (TypeScript) single-page application.
• Backend: NestJS (Node.js/TypeScript) REST API.
• Purpose: allow owners to publish encrypted datasets, permit authorized users to request access, run vetted computations (Python/R) on the data without exposing raw data, and return results.
High-level file-structure analysis
• Top-level directories:
– client/ → React app (src/api, components, contexts, pages).
– server/ → NestJS app (src/auth, computations, datasets, requests, users, tasks, vault, utils).
– server/run_computations/ → Python & R scripts invoked at runtime.
• Config & build scripts: vite.config.ts, nest-cli.json, tsconfig, package.json.
• Static assets: images/, events/ (presentations).
• Data stores indicated by server/.env.example (Postgres config) and dataset_files folders.
Key insights from README
• Architecture comprises:
– Client (React) → Backend API (NestJS) → Database (Postgres) + File Server (encrypted dataset files).
– Computation engine invokes Python/R scripts within a secure runtime.
– Uses AES-GCM encryption, client-server key exchange, JWT authentication, role-based guards.
– Background tasks (NestJS tasks module) for scheduled jobs.
– External service: SendGrid for email notifications.
• Database tables & relationships are fully described (users, datasets, variables, requests, computations, computation_runs, favorites).
Detail
• Next to file storage, note “AES-GCM encrypted at rest.”