File size: 6,734 Bytes
788eab4
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
# Institutional Placement Engine: Pitch Presentation Outline

**Competition**: Campus Placement System  
**Problem Statement**: Core Engine ("One student, three drives, one Tuesday")  
**Tagline**: *Deterministic Eligibility. 1-Second Clash-Free Scheduling. 100% Air-Gapped.*

---

## Slide 1: Title & The Tuesday Morning Nightmare
- **Visual**: Split graphic: on the left, chaotic sticky notes, competing spreadsheets, and frantic coordinators; on the right, the clean, unified Institutional Placement Engine.
- **Talking Points**:
  - Collegiate placement departments orchestrate the most consequential weeks of their students' academic lives under acute operational pressure.
  - 600 candidates, 12 concurrent companies, 8 physical rooms, and shifting corporate cut-offs.
  - A student holding an offer at 10 AM is legally blocked by institutional policy for an afternoon drive.
  - Room double-bookings lead to canceled corporate rounds; manual eligibility mistakes spark student grievances and accusations of coordinator bias.

---

## Slide 2: Why Legacy Tools & Cloud Platforms Fail
- **Visual**: Comparison matrix: Legacy Spreadsheets vs Enterprise SaaS vs Core Engine Placement Engine.
- **Talking Points**:
  - **Spreadsheets**: Silent formula errors, lack of audit trails, impossible concurrent conflict resolution.
  - **Commercial Cloud Portals**: Require internet access (failing during campus network brownouts), leak student PII to commercial clouds, and lack deterministic constraint solvers.
  - **The Requirement**: A single-laptop, 100% offline engine that guarantees mathematical rigor, complete data sovereignty, and zero-clash operations.

---

## Slide 3: The Architectural Blueprint: Pure Domain Core
- **Visual**: C4 Container Diagram illustrating Pure Domain Core decoupled from Storage via Repository Protocols.
- **Talking Points**:
  - **Pure Functional Core**: Eligibility rules, offer policies, scheduling constraints, and what-if simulations run as pure deterministic Python functions with zero database I/O.
  - **Single-Port LAN Serving**: A single command boots both the FastAPI backend and bundled React SPA on port 8000, broadcasting a local URL for student smartphones on the campus Wi-Fi.
  - **Relational Integrity**: SQLite in Write-Ahead Logging (WAL) mode with strict foreign key constraints and optimistic concurrency control (`version` stamps).

---

## Slide 4: Key Innovation 1 — Typed Rule AST & Empathic Explainability
- **Visual**: Screenshot of AST Node Evaluation and the Two-Tier Explanation Engine.
- **Talking Points**:
  - **13 Rule Primitives**: CGPA, 10th/12th/diploma percentages, branch aliases, active/historical backlogs, gap years, and boolean groups.
  - **Demographic Isolation**: Protected demographic attributes (`gender`, `caste`, `religion`, `category`) are barred from eligibility logic at the type-system level.
  - **Two-Tier Explanations**:
    - *Candidate*: Respectful, single-line explanation: *"Not eligible: your CGPA is 6.8 and this company requires 7.0 or above."*
    - *Officer*: Complete cryptographic trace citing rule ID, database source, actual vs cut-off values, and SHA-256 data snapshot hash.

---

## Slide 5: Key Innovation 2 — Deterministic Document Extraction
- **Visual**: Side-by-side view of raw messy PDF circular and parsed AST fields with confidence badges.
- **Talking Points**:
  - University TPOs receive circulars as messy emails, PDFs, and Word documents.
  - **100% Deterministic & Offline**: Zero LLM hallucinations, zero cloud APIs, zero token costs.
  - **Benchmark Validation**: Successfully parsed **25 out of 25 benchmark announcements (100.0%)** without manual re-typing, averaging **14.6 milliseconds** per document.

---

## Slide 6: Key Innovation 3 — 1-Second Constraint Scheduling (OR-Tools CP-SAT)
- **Visual**: Interactive Rooms $\times$ Time Schedule Grid with "0 Clashes Verified" Badge.
- **Talking Points**:
  - Modeled as a formal Constraint Satisfaction Problem (CSP) in Google OR-Tools CP-SAT.
  - **Hard Constraints**: `NoOverlap` on physical rooms, `NoOverlap` on company panels, `NoOverlap` on candidates across concurrent drives, plus 15-minute inter-block walking buffers.
  - **World-Class Performance**:
    - 600 students across 12 drives and 8 rooms solved in **1.05 seconds** (Target: < 60s).
    - 1,800 students across 40 drives and 20 rooms solved in **5.04 seconds**.

---

## Slide 7: Key Innovation 4 — Interactive What-If Simulation & Dynamic Headlines
- **Visual**: What-If panel showing dynamic headline and schedule displacement preview.
- **Talking Points**:
  - Placement officers can test prospective changes in 18 milliseconds without modifying production state.
  - **Data-Driven Dynamic Headlines**: Headlines like *"Lowering cut-off from 7.0 to 6.5 adds 38 students; 6 clash with Northwind test at 10:00"* are generated directly from data deltas.
  - **Publish Workflow**: Monotonic versioning with immutable historical snapshots and instant one-click rollback.

---

## Slide 8: Institutional Security & Air-Gap Compliance
- **Visual**: STRIDE Threat Model matrix and Automated Socket Interception Verification.
- **Talking Points**:
  - **Air-Gap Verification**: Automated socket-level tests intercept OS network calls to mathematically prove **zero outbound connections**.
  - **Cryptographic Security**: Argon2id password hashing, AES-256 Fernet field-level encryption, PBKDF2-encrypted `.enc` database exports, and one-click cryptographic institutional wipe.
  - **Candidate Privacy**: Candidates authenticate via roll number + temporary code, accessing strictly their own schedule pass with zero access to peer rankings.

---

## Slide 9: Measured Benchmark Scorecard
- **Visual**: Summary Scorecard comparing Core Engine targets against measured numbers:
  - Batch Eligibility: 1,800 students in **0.024s** (Target: < 1.0s).
  - Scheduler: 600 students / 12 drives / 8 rooms in **1.05s** (Target: < 60s).
  - Extraction: **25 / 25 announcements (100%)** (Target: $\ge$ 20/25).
  - Air-Gap Connections: **0 Outbound Calls** (Target: 0).
  - Test Suite: **149 / 149 Pytest passing**, **0 Ruff errors**, **0 Mypy errors**.

---

## Slide 10: Conclusion & Institutional Vision
- **Visual**: Placement engine running live on a single laptop serving mobile browsers across an air-gapped auditorium.
- **Closing Statement**:
  > *"The Institutional Placement Engine delivers institutional fairness, mathematical precision, and operational resilience. It transforms the chaotic Tuesday morning placement crisis into a calm, transparent, and completely clash-free triumph."*