Streams, electives, languages — without the spreadsheet. PCM vs PCB. Three-language formula. Optional subject pool.

Why Subject Groups exist — the Class 11 stream selection problem

It is May at a CBSE school in Kanpur. The Class 10 board results just came out. 240 students promote to Class 11 and the academic office has six weeks to lock in stream selection. Some students want Science PCM. Some want Science PCB. Some are switching to Commerce. Three want Humanities with Psychology. Two students want Mathematics in Commerce as the elective. One wants Physical Education as the sixth subject in the Science stream.

In Excel this becomes a nightmare. The academic head opens a spreadsheet with 240 rows and 12 columns of subject names, and starts ticking. By 8 PM she has 47 students in stream combinations the school does not actually run. Two students are in PCM and PCB simultaneously. Four are missing a second language. The marksheet template breaks because Class 11 PCB "Mathematics" doesn't exist as an offering. The principal cancels Friday's stream-allocation parent meeting because the data is not ready.

Inkwelly Subject Groups solves this at the structural level. You define PCM, PCB, Commerce-with-Maths, Commerce-with-IP, Humanities as four mutually exclusive groups in Subject Offerings. You define Second Language as a MANDATORY_ONE pool of three. You define Optional Sixth Subject as a FREE_CHOICE pool of five. When the parent or counsellor opens the student's enrolment screen, the system enforces these rules. Two students cannot accidentally end up in PCM and PCB. Every student gets exactly one second language. The marksheet template generates correctly because every student's subject set is internally consistent.

How Subject Groups actually works

A Subject Group is a named container of subject offerings plus the rules students must follow when choosing among them. The four group types — STREAM, LANGUAGE_GROUP, ELECTIVE_GROUP, MANDATORY_GROUP — cover every Indian-school choice scenario, from "all Class 9 students must take Computer Applications" to "Class 11 PCM students may add Applied Mathematics as the seventh subject only if they did not opt for Physical Education".

The Selection Mode is the workhorse. MANDATORY_ALL means every subject in the group is auto-enrolled — the PCM stream's Physics + Chemistry + Mathematics is one such group. MANDATORY_ONE means the student must pick exactly one — common for second-language pools (English, Hindi, Sanskrit). MANDATORY_RANGE lets you say "pick 1 to 2 from this elective pool of 4" — common for ICSE Group 2 electives. FREE_CHOICE lets students pick any number, including zero — common for optional sixth subjects. CONDITIONAL lets you encode dependent rules — "Advanced Mathematics is available only if PCM was selected".

Groups can declare a prerequisite — Class 11 stream must be locked before Class 11 second language can be picked. Groups can be mutually exclusive — choosing PCM excludes PCB, Commerce and Humanities. Groups carry a conditionalRules JSON that supports IF_SUBJECT and IF_NOT_SUBJECT triggers for advanced cases. Once a group has any active student enrolments, deletion is blocked — the API returns SUBJECT_GROUP_HAS_ENROLLMENTS and forces you down the safe Disable path.

See it in action

“PCM aur PCB ke beech students ka mix-up har saal Class 12 ke marksheet pe pakda jaata tha. Inkwelly ke Subject Groups me mutual exclusion daala — ab admission desk pe hi UI rok deta hai. Six months me ek bhi ghalti nahi hui.”

Real-world scenarios from Indian schools

1. CBSE school locking Class 11 stream selection. In May, the academic head creates four STREAM groups — PCM, PCB, Commerce-with-Maths, Commerce-with-IP, Humanities — all isMutuallyExclusive=true. Each contains the right Subject Offerings. Class 10 results land. Counsellors open each student's profile and pick exactly one stream from the dropdown. The system auto-enrols all the MANDATORY_ALL subjects. The 240-student stream allocation, which used to take three weeks of Excel work, finishes in five days end-to-end.

2. ICSE Class 9 elective allocation. The school has Compulsory subjects (auto-enrolled), Group 1 = 3 of 4 (Hindi, History, Geography, Civics), Group 2 = 1 of 3 (Home Science, Business Studies, Economics), and a free-choice Music/Art/Dance pool. Four Subject Groups handle this — MANDATORY_GROUP for Compulsory, ELECTIVE_GROUP with MANDATORY_RANGE (3,3) for Group 1, ELECTIVE_GROUP with MANDATORY_RANGE (1,1) for Group 2, FREE_CHOICE for Arts pool. The student enrolment dialog shows live counts and blocks invalid saves.

3. NEP 2020 three-language formula in a State Board school. A Marathi-medium school in Pune offers Marathi (first language), English (mandatory second), and Hindi/Sanskrit/French (third, optional). Three LANGUAGE_GROUP groups encode the rules. The Conditional Rules JSON ensures Marathi cannot also be picked as third language. Parent app shows the chosen languages on the student profile in their script.

4. Mid-year stream change request. A PCB student wants to switch to PCM in October. The academic head opens the student profile, deselects PCB (which removes Biology enrolment), selects PCM (which adds Mathematics enrolment via MANDATORY_ALL). The audit log captures the change with timestamp and user. Term 1 marks for Biology stay archived; Term 2 marksheet now shows Mathematics. No data corruption, no orphan rows.

5. ICSE elective cap enforcement at scale. A 1,800-student ICSE school across Class 9–12 wants to enforce "no student can carry more than 7 academic subjects". One STREAM group (MANDATORY_ALL = 5 core), one ELECTIVE_GROUP with MANDATORY_RANGE (1,2) for Electives, plus FREE_CHOICE for 0–1 hobby subjects. The system blocks any student configuration that exceeds the cap. The principal's quarterly board report uses the audit log to show stream-and-elective compliance for every student.

See Subject Groups solve real CBSE Class 11 stream allocation

30-minute walkthrough on a real Indian school's Class 11 PCM/PCB/Commerce/Humanities setup. We show you mutual exclusion, three-language formula and the ICSE Group 2 elective rules.

Limits, safety and the small print

Maximum subjects per group. No hard cap, but the UI is optimized for 3–15 subjects per group. Beyond 30, consider splitting into multiple smaller groups to keep the student enrolment dialog scannable on a phone screen.

Code and slug uniqueness. Group code and slug must be unique per (school, session, organization) combination. Duplicate creates return SUBJECT_GROUP_ALREADY_EXISTS (HTTP 409). Codes like "PCM", "PCB", "COM-MATHS" are valid; spaces and special characters are auto-stripped from the slug.

Prerequisite cycles are detected. You cannot create A → B → A or A → B → C → A. The create endpoint runs a topological-sort check and returns PREREQUISITE_CYCLE_DETECTED (HTTP 400) before any record is written.

Subject offering must be active and in the same session. A group can only contain offerings that are already active for the same session. The API returns SUBJECT_OFFERING_NOT_FOUND if you try to attach an offering that does not exist in this session — protects against cross-session data leaks.

Range validation. For MANDATORY_RANGE, maxAllowed must be ≥ minRequired. The validator returns a clear error message rather than silently clamping. minRequired cannot exceed the count of subjects in the group.

Deletion is blocked when enrolments exist. Once any active student is enrolled via the group, the API returns SUBJECT_GROUP_HAS_ENROLLMENTS (HTTP 400) on delete attempts. Use the Active toggle to disable instead — historical enrolment data stays intact for parent app, transcript and inspection use cases.

Permissions. Only roles with academics.subject_groups.write can create, update, or delete groups. The role is part of Identity & Access Management and can be granted on a per-school basis to a regional academic head without exposing other school admin functions.