ARCHITECTURE.md

Architecture Documentation: api.faculytics

This directory contains the architectural documentation for the api.faculytics project.

Table of Contents

1. Core Components

• System Overview
• Technology Stack
• Module Architecture (NestJS)
• Universal Ingestion Architecture

2. Data Model (ERD)

• Entity Relationship Diagrams
• Institutional Hierarchy
• Questionnaire Schema

3. Workflows

• Authentication & User Hydration
• Institutional Hierarchy Sync
• Questionnaire Submission & Scoring

4. Architectural Decisions

• External ID Stability
• Unit of Work Pattern
• Questionnaire Leaf-Weight Rules
• Institutional Snapshotting