Back to Projects
Aug 2024

Tracer Survey (Alumni & Supervisor)

A configurable tracer-survey backend where questions and branching rules are stored as data, with faculty-scoped administration and structured export.

Overview

Tracer Survey supports configurable alumni/supervisor questionnaires, faculty-scoped administration, email workflows, and structured export. I built the backend API architecture, relational survey model, branching configuration, and authorization flow.

The survey structure is stored in the database so clients do not need to maintain separate copies of the branching rules.

Survey branching is data

Questions, triggers, and next-question relationships are persisted and returned to the client as configuration.

This makes it possible to change a published survey without rewriting branching logic in every frontend.

It also introduces graph checks that belong on the backend: referenced questions must exist, required paths should remain reachable, and respondents should not get trapped by invalid cycles.

The current implementation stores the graph centrally; full cycle/reachability validation is still an area to strengthen.

Faculty-scoped access

Administrative API requests validate both the authenticated user and the faculty scope before reads, changes, or exports.

Frontend visibility is not used as the security check.

Email and export workload

Blast email and spreadsheet export currently fit the project scope, but both can become long-running work as volume grows.

At larger scale, per-recipient delivery and background export jobs would be more appropriate than keeping the whole operation inside one HTTP request.

Current limits

The next useful improvements are pre-publication survey graph validation, stronger cross-faculty regression tests, and background delivery/export when real usage requires it.

Gambaran umum

Tracer Survey mendukung kuesioner alumni/supervisor yang dapat dikonfigurasi, administrasi per fakultas, email workflow, dan export terstruktur. Saya membangun arsitektur backend API, relational survey model, konfigurasi branching, dan authorization flow.

Struktur survei disimpan di database agar setiap client tidak perlu memiliki salinan sendiri dari aturan branching.

Survey branching disimpan sebagai data

Pertanyaan, trigger, dan hubungan next-question disimpan dan dikirim ke client sebagai konfigurasi.

Ini memungkinkan perubahan survei yang sudah dipublikasikan tanpa menulis ulang branching logic di setiap frontend.

Konsekuensinya muncul kebutuhan pemeriksaan graph di backend: pertanyaan yang dirujuk harus ada, jalur wajib harus tetap terjangkau, dan responden tidak boleh terjebak pada cycle yang tidak valid.

Implementasi saat ini menyimpan graph secara terpusat, sedangkan validasi cycle/reachability menyeluruh masih perlu diperkuat.

Akses sesuai fakultas

Request API administratif memvalidasi pengguna terautentikasi serta cakupan fakultas sebelum membaca, mengubah, atau export data.

Visibilitas di frontend tidak dianggap sebagai pemeriksaan keamanan.

Workload email dan export

Blast email dan spreadsheet export masih sesuai lingkup proyek, tetapi keduanya dapat menjadi proses panjang saat volume meningkat.

Pada skala lebih besar, pengiriman per penerima dan background export jobs lebih sesuai daripada menjalankan seluruh operasi di satu HTTP request.

Keterbatasan saat ini

Perbaikan berikutnya adalah validasi survey graph sebelum publikasi, cross-faculty regression tests yang lebih kuat, serta background delivery/export saat penggunaan nyata memerlukannya.

Resumen

Tracer Survey permite encuestas configurables para alumni/supervisors, administración por facultad, email workflows y exportación estructurada. Desarrollé la arquitectura backend API, modelo relacional de encuestas, configuración de branching y autorización.

La estructura de encuesta se guarda en database para que los clientes no mantengan copias separadas de las reglas de branching.

Survey branching como datos

Preguntas, triggers y relaciones next-question se almacenan y entregan al cliente como configuración.

Así es posible cambiar una encuesta publicada sin reescribir el branching logic de cada frontend.

Esto exige validaciones de graph en el backend: las preguntas referenciadas deben existir, los caminos obligatorios ser alcanzables y los encuestados no quedar atrapados en cycles inválidos.

El graph se almacena centralmente, aunque la validación completa de cycles/reachability todavía necesita mejoras.

Acceso por facultad

Las solicitudes API de administración validan al usuario autenticado y el alcance de facultad antes de lecturas, modificaciones o exportaciones.

La visibilidad del frontend no funciona como control de seguridad.

Workload de email y exportación

Blast email y spreadsheet export son suficientes para el alcance actual, pero pueden convertirse en operaciones largas al aumentar el volumen.

A mayor escala, envíos por destinatario y background export jobs son preferibles a ejecutar toda la operación en un HTTP request.

Límites actuales

Las próximas mejoras son validación del survey graph previa a la publicación, mejores cross-faculty regression tests y background delivery/export cuando el uso lo requiera.

Présentation

Tracer Survey propose des questionnaires configurables pour diplômés/supervisors, une administration par faculté, des email workflows et des exports structurés. J’ai conçu l’architecture backend API, le modèle relationnel, la configuration des branches et l’autorisation.

La structure de l’enquête est enregistrée en database afin d’éviter que chaque client duplique les règles de branching.

Survey branching comme données

Les questions, triggers et relations next-question sont persistés et envoyés aux clients sous forme de configuration.

Une enquête publiée peut donc être modifiée sans réécrire le branching logic de chaque frontend.

Mais cela impose des vérifications de graph dans le backend : les références doivent exister, les chemins requis être accessibles et les répondants ne doivent pas être bloqués dans des cycles invalides.

Le graph est actuellement stocké de manière centralisée ; la validation complète des cycles/reachability doit encore être renforcée.

Accès limité à la faculté

Les requêtes API administratives vérifient l’utilisateur authentifié et sa faculté avant lecture, modification ou export.

Masquer des contrôles frontend n’est pas un contrôle de sécurité.

Workloads d’email et d’export

Les blast emails et spreadsheet exports conviennent au projet, mais peuvent devenir longs lorsque le volume augmente.

À plus grande échelle, une livraison par destinataire et des background export jobs seraient préférables à une opération entière dans un HTTP request.

Limites actuelles

Les priorités sont la validation du survey graph avant publication, de meilleurs cross-faculty regression tests et des background delivery/export jobs lorsque l’usage réel le justifie.

Überblick

Tracer Survey unterstützt konfigurierbare Alumni-/Supervisor-Fragebögen, fakultätsbezogene Verwaltung, E-Mail-Workflows und strukturierte Exports. Ich entwickelte die Backend-API-Architektur, das relationale Survey-Modell, Branching-Konfiguration und Authorization Flow.

Die Umfragestruktur wird in der Datenbank gespeichert, damit Clients keine eigenen Kopien der Branching-Regeln pflegen müssen.

Survey Branching ist Daten

Fragen, Triggers und Next-Question-Beziehungen werden persistiert und als Konfiguration an Clients geliefert.

Dadurch lassen sich veröffentlichte Umfragen ändern, ohne die Branching Logic in jedem Frontend neu schreiben zu müssen.

Das erfordert Graph-Prüfungen im Backend: Referenzierte Fragen müssen vorhanden sein, erforderliche Pfade erreichbar bleiben und Teilnehmer dürfen nicht in ungültigen Cycles hängen.

Der Graph wird zentral gespeichert, doch eine vollständige Cycle-/Reachability-Validierung muss noch verbessert werden.

Fakultätsbezogener Zugriff

Administrative API Requests prüfen Authentifizierung und Fakultätsbereich vor dem Lesen, Bearbeiten oder Exportieren.

Frontend-Sichtbarkeit ist keine Sicherheitsprüfung.

E-Mail- und Export-Workload

Blast Email und Spreadsheet Export passen noch zum Projektumfang, können bei höherem Volumen jedoch zu lang laufenden Jobs werden.

Im größeren Maßstab wären Zustellung pro Empfänger und Background Export Jobs geeigneter als komplette Operationen in einem HTTP Request.

Aktuelle Grenzen

Wichtige Verbesserungen sind Survey-Graph-Validierung vor Veröffentlichung, stärkere Cross-Faculty Regression Tests und bei Bedarf Background Delivery/Export.

概要

Tracer Surveyは卒業生とSupervisor向けの設定可能なアンケート、学部別Admin管理、Email Workflow、構造化Exportを提供します。私はBackend API Architecture、Relational Survey Model、Branching Configuration、Authorization Flowを担当しました。

Surveyの構造はDatabaseに保存し、各ClientがBranching Ruleを重複管理しなくて済むようにしています。

Survey Branchingをデータとして管理

質問、Trigger、Next-questionの関係を永続化し、設定としてClientへ返します。

これにより公開済みSurveyも、FrontendごとのBranching Logicを書き直さず変更できます。

一方でBackend側にはGraph Validationが必要です。参照先の質問が存在し、必要なPathへ到達でき、回答者が無効なCycleに閉じ込められないことを保証する必要があります。

現状はGraphを集中管理していますが、完全なCycle/Reachability Validationは今後の改善点です。

学部別アクセス権限

Admin API Requestでは読み取り、編集、Exportの前に認証ユーザーと学部Scopeの両方を検証します。

FrontendでControlを非表示にすることはSecurity Checkの代わりになりません。

EmailとExportのWorkload

Blast EmailとSpreadsheet Exportは現状の規模には十分ですが、データ量が増えると長時間処理になります。

大規模化した場合、1つのHTTP Requestで全処理するより、宛先ごとの配送とBackground Export Jobsが適切です。

現在の制約

優先課題は公開前のSurvey Graph Validation、学部間アクセスを確認するRegression Tests、実運用に応じたBackground Delivery/Exportです。