Conduct management

The Conduct module provides comprehensive behavior tracking and management for your school. It covers the full spectrum from positive recognition and rewards to disciplinary incidents, resolutions, and escalations, with built-in analytics to identify patterns and improve school culture.

---

Navigation path

Behavior (segment: behavior)

Sub-section	Path	Description
Dashboard	behavior	Overview and quick actions
Incidents	behavior/incidents	Log and manage incidents
Recognition	behavior/recognition	Positive behavior tracking
Types	behavior/types	Configure behavior types
Analytics	behavior/analytics	Reports and patterns

---

Conduct architecture

┌─────────────────────────────────────────────────────────────────────────┐
│                        Conduct Management System                         │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ┌─────────────────────────────────────────────────────────────────┐    │
│  │                      Behavior Types                              │    │
│  │                                                                   │    │
│  │   Positive • Negative • Neutral                                   │    │
│  │   Custom types with severity, points, notifications              │    │
│  │                                                                   │    │
│  └────────────────────────────────┬──────────────────────────────────┘    │
│                                   │                                      │
│              ┌────────────────────┼────────────────────┐                 │
│              │                    │                    │                 │
│              ▼                    ▼                    ▼                 │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────────┐   │
│  │  Positive        │  │  Incidents       │  │  Neutral             │   │
│  │  Recognition     │  │  (Negative)      │  │  Observations        │   │
│  │                  │  │                  │  │                      │   │
│  │  Awards, rewards │  │  Log → Review →  │  │  Notes without       │   │
│  │  Points earned   │  │  Resolve/Escalate│  │  point impact        │   │
│  │                  │  │                  │  │                      │   │
│  └────────┬─────────┘  └────────┬─────────┘  └──────────┬───────────┘   │
│           │                     │                       │               │
│           └─────────────────────┼───────────────────────┘               │
│                                 │                                        │
│                                 ▼                                        │
│  ┌──────────────────────────────────────────────────────────────────┐   │
│  │                     Points System                                 │   │
│  │                                                                   │   │
│  │  Positive points + Negative points = Net balance                  │   │
│  │  Track trends • Identify at-risk students • Reward high achievers │   │
│  │                                                                   │   │
│  └──────────────────────────────────────────────────────────────────┘   │
│                                 │                                        │
│                                 ▼                                        │
│  ┌──────────────────────────────────────────────────────────────────┐   │
│  │                    Analytics & Reporting                          │   │
│  │                                                                   │   │
│  │  Trends • Patterns • Repeat offenders • Top recognized students   │   │
│  │  Resolution rates • By class/grade • By location • By time        │   │
│  │                                                                   │   │
│  └──────────────────────────────────────────────────────────────────┘   │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘

---

Part 1: Behavior categories

All conduct records fall into one of three categories.

Category definitions

Category	Description	Points impact	Color
Positive	Recognition for good conduct, achievements, helpfulness	+ Add points	Emerald/green
Negative	Incidents requiring intervention or disciplinary action	− Deduct points	Red
Neutral	Observations or notes without positive/negative impact	No impact	Slate/gray

Category use cases

Category	Example behaviors
Positive	Academic excellence, helping others, leadership, perfect attendance
Negative	Tardiness, disruptive conduct, bullying, fighting, academic dishonesty
Neutral	Attendance notes, uniform reminders, counselor check-ins

---

Part 2: Severity levels

Severity determines the seriousness of an incident and suggested responses.

Severity definitions

Severity	Description	Default points	Admin review	Parent notify
Minor	Small infractions or minor recognition	1	–	–
Moderate	Notable conduct requiring attention	3	–	✓
Major	Serious incidents requiring admin involvement	5	✓	✓
Critical	Severe incidents requiring immediate escalation	10	✓	✓

Severity visual indicators

Severity	Color	Icon
Minor	Blue	Alert circle
Moderate	Amber	Alert triangle
Major	Orange	Alert octagon
Critical	Red	Skull/danger

---

Part 3: Incident statuses

Incidents progress through a workflow from reporting to resolution.

Status definitions

Status	Description	Terminal
reported	Incident logged, awaiting review	–
under_review	Being investigated	–
resolved	Addressed and closed	✓
escalated	Sent to higher authority	–
dismissed	Reviewed and dismissed	✓

Status workflow

Incident Reported
       │
       ▼
┌─────────────────┐
│    Reported     │ ← Initial state
└────────┬────────┘
         │
    ┌────┴────┐
    │         │
 Review    Dismiss
    │         │
    ▼         ▼
┌─────────────────┐    ┌─────────────────┐
│  Under Review   │    │   Dismissed     │ ← Terminal
└────────┬────────┘    └─────────────────┘
         │
    ┌────┴────────┐
    │             │
 Resolve      Escalate
    │             │
    ▼             ▼
┌─────────────────┐    ┌─────────────────┐
│    Resolved     │    │   Escalated     │
│    (Terminal)   │    │   (To admin)    │
└─────────────────┘    └────────┬────────┘
                                │
                           ┌────┴────┐
                           │         │
                        Resolve   Further
                           │      escalate
                           ▼
                    ┌─────────────────┐
                    │    Resolved     │
                    └─────────────────┘

---

Part 4: Resolution types

Resolutions define the outcome or consequence of an incident.

Resolution definitions

Resolution	Description	Positive	Suggested for
warning	Verbal or written warning issued	–	Minor, moderate negative
detention	After-school or lunch detention	–	Minor, moderate negative
suspension	Temporary removal from school	–	Major, critical negative
expulsion	Permanent removal from school	–	Critical negative
counseling	Referred to school counselor	–	All severities
parent_meeting	Meeting with parent/guardian	–	Moderate+ negative
community_service	Service hours assigned	–	Moderate, major negative
no_action	Noted, no action required	–	Minor negative, neutral
reward	Tangible reward given	✓	Positive
recognition	Public or formal recognition	✓	Positive

Resolution suggestions

The system suggests appropriate resolutions based on category and severity:

Category + Severity	Suggested resolutions
Positive (any)	Reward, recognition
Negative minor	Warning, no action
Negative moderate	Warning, detention, counseling
Negative major	Suspension, parent meeting, counseling
Negative critical	Suspension, expulsion, parent meeting

---

Part 5: Locations

Track where incidents occur for pattern analysis.

Location definitions

Location	Category	Description
classroom	Indoor	Regular classroom
playground	Outdoor	School playground area
cafeteria	Indoor	Dining hall
hallway	Indoor	Corridors and hallways
sports_field	Outdoor	Athletic facilities
laboratory	Indoor	Science or computer lab
library	Indoor	Library or media center
restroom	Indoor	Restroom facilities
bus	Transport	School bus or van
off_campus	Other	School event off campus
dormitory	Indoor	Student residential quarters
other	Other	Other location

---

Part 6: Behavior types

Behavior types are predefined conduct categories that standardize recording.

Type properties

Field	Type	Description
id	string	Unique identifier
tenantId	string	Tenant association
schoolId	string	School (or tenant-wide)
behaviorCode	string	Short code (e.g., "BULLY")
name	string	Display name
description	string	Full description
category	enum	Positive/negative/neutral
defaultSeverity	enum	Default severity level
defaultPoints	number	Default points value
requiresParentNotification	boolean	Auto-notify parents
requiresAdminReview	boolean	Requires admin review
isActive	boolean	Type is active
isSystemDefined	boolean	System vs custom type

Common positive behavior types

Name	Description	Default severity	Points
Academic Excellence	Outstanding academic performance	Moderate	+5
Helping Others	Assisting classmates or staff	Minor	+2
Leadership	Demonstrating positive leadership	Moderate	+5
Attendance Recognition	Perfect attendance achievement	Minor	+3
Community Service	Volunteering involvement	Moderate	+5
Good Citizenship	Following rules, showing respect	Minor	+2

Common negative behavior types

Name	Description	Default severity	Points	Parent notify	Admin review
Tardiness	Late to class or school	Minor	−1	–	–
Disruptive Conduct	Disrupting class	Moderate	−3	✓	–
Bullying	Harassment or intimidation	Major	−10	✓	✓
Fighting	Physical altercation	Critical	−15	✓	✓
Academic Dishonesty	Cheating, plagiarism	Major	−10	✓	✓
Property Damage	Damaging property	Major	−10	✓	✓
Inappropriate Language	Profanity	Moderate	−3	–	–
Dress Code Violation	Uniform issues	Minor	−1	–	–

Common neutral behavior types

Name	Description	Default severity	Points
Attendance Note	General attendance note	Minor	0
Uniform Reminder	Reminder about expectations	Minor	0
Restroom Pass	Restroom pass usage	Minor	0
Incomplete Work	Assignment not completed	Minor	0
Classroom Reminder	Reminder about expectations	Minor	0
Counselor Check-In	Student requested counselor	Moderate	0

Creating a behavior type

1. Navigate to Behavior → Types
2. Click Add Type
3. Fill required fields:
   • Name (required)
   • Category (required)
   • Default severity (required)
4. Configure settings:
   • Default points value
   • Requires parent notification
   • Requires admin review
5. Add description
6. Save type

---

Part 7: Incidents

Incidents are the core records in the conduct system.

Incident properties

Field	Type	Description
id	string	Incident identifier
tenantId	string	Tenant association
schoolId	string	School association
studentId	string	Student involved
classId	string	Class (if applicable)
teacherId	string	Reporting teacher
behaviorTypeId	string	Linked behavior type
incidentDate	date	Date of incident
incidentTime	time	Time of incident
location	enum	Where it occurred
description	string	Full description
witnesses	array	Witness names
category	enum	Positive/negative/neutral
severity	enum	Severity level
incidentStatus	enum	Current status
pointsAwarded	number	Positive points (if any)
pointsDeducted	number	Negative points (if any)
parentNotified	boolean	Parent was notified
parentNotifiedAt	datetime	When notified
parentNotifiedBy	string	Who notified
requiresFollowUp	boolean	Follow-up needed
followUpDate	date	Follow-up deadline
followUpNotes	string	Follow-up notes
resolutionType	enum	How resolved
actionTaken	string	Actions taken
resolutionNotes	string	Resolution notes
resolvedBy	string	Who resolved
resolvedAt	datetime	When resolved
escalatedTo	string	Escalated to whom
escalatedAt	datetime	When escalated
escalationReason	string	Why escalated
attachments	array	Supporting documents

Logging an incident

1. Navigate to Behavior → Incidents
2. Click Log Incident
3. Select student (search by name or ID)
4. Choose category (negative or neutral)
5. Select behavior type (or create custom)
6. Set severity level
7. Enter details:
   • Date and time
   • Location
   • Description
   • Witnesses (optional)
8. Configure notifications:
   • Notify parent ✓/✗
   • Set follow-up date (optional)
9. Review points impact
10. Save incident

Quick incident logging

For rapid entry:

1. Click Quick Log
2. Scan or enter student ID
3. Select from recent behavior types
4. Confirm severity
5. Submit

Incident detail view

Section	Content
Header	Category badge, date/time, status
Student	Name, ID, class, points balance
Details	Type, severity, location, description
Witnesses	List of witnesses
Points	Points awarded/deducted
Notifications	Parent notification status
Resolution	Actions, notes, resolved by
Timeline	History of changes
Attachments	Supporting documents

---

Part 8: Positive recognition

Dedicated workflow for recognizing positive behavior.

Recognition workflow

1. Navigate to Behavior → Recognition or click Add Recognition
2. Select student
3. Choose recognition type:
   • Excellent Work — Outstanding effort (+10 pts)
   • Helping Others — Kindness to others (+15 pts)
   • Leadership — Initiative and leading (+20 pts)
   • Active Participation — Class engagement (+5 pts)
   • Great Improvement — Significant progress (+15 pts)
   • Respectful Conduct — Respect to others (+10 pts)
   • Special Achievement — Notable accomplishment (+20 pts)
4. Or select custom behavior type
5. Adjust points if needed
6. Add description
7. Set date and location
8. Choose to notify parent (optional)
9. Save recognition

Quick recognition

1. From student profile or class view
2. Click Give Recognition
3. Select quick template
4. Confirm and save

---

Part 9: Resolving incidents

Resolutions close incidents and document outcomes.

Resolve workflow

1. Open incident detail
2. Click Resolve
3. Select resolution type:
   • Warning
   • Detention
   • Suspension
   • Expulsion
   • Counseling
   • Parent meeting
   • Community service
   • No action
4. Enter action taken:
   • Use template or write custom
   • Quick phrases available:
     • "Student acknowledged and apologized"
     • "Parent/guardian contacted"
     • "Student committed to improvement"
     • "Written reflection assigned"
     • "Restorative conversation held"
     • "Peer mediation completed"
5. Add resolution notes
6. Optionally schedule follow-up
7. Confirm resolution

Resolution templates

Resolution	Template
Warning	"Verbal warning issued regarding conduct expectations. Student acknowledged understanding."
Detention	"Detention assigned for [duration] on [date]. Student and parent notified."
Suspension	"Suspension assigned for [X] days starting [date]. Parent contacted."
Counseling	"Student referred to counselor. Initial session scheduled for [date]."
Parent meeting	"Meeting conducted with parent. Action plan agreed upon."

---

Part 10: Escalating incidents

Escalation routes serious incidents to appropriate authorities.

When to escalate

• Severity is critical
• Incident involves safety concerns
• Teacher cannot resolve independently
• Repeated incidents from same student
• Legal or policy implications

Escalate workflow

1. Open incident detail
2. Click Escalate
3. Select escalation target:
   • Department head
   • Dean of students
   • Principal
   • Disciplinary committee
4. Enter escalation reason
5. Confirm escalation

After escalation

• Status changes to "escalated"
• Target receives notification
• Original reporter remains informed
• New handler can resolve or further escalate

---

Part 11: Points system

The points system tracks cumulative behavior scores.

Points calculation

Net Points = Total Positive Points − Total Negative Points

Points balance display

Balance	Indicator	Description
Positive (+)	Green, trending up	Good standing
Zero (0)	Gray, neutral	Balanced
Negative (−)	Red, trending down	Needs attention

Student points balance

Each student has:

• Total positive points — Sum of all awards
• Total negative points — Sum of all deductions
• Net balance — Positive minus negative
• Trend — Improving, declining, or stable

Points tracking

1. Navigate to student profile
2. View behavior summary widget
3. See:
   • Current net balance
   • Positive count
   • Negative count
   • Recent trend
4. Click View All for full history

---

Part 12: Analytics and reporting

Comprehensive analytics for behavior patterns.

Summary metrics

Metric	Description
Total incidents	All incidents in period
Positive count	Recognition records
Negative count	Disciplinary incidents
Neutral count	Observation notes
Resolved count	Closed incidents
Pending count	Awaiting action
Escalated count	Sent to higher authority
Follow-up required	Needing follow-up
Net points	School-wide point balance

Breakdowns available

Dimension	Analysis
By category	Positive vs negative vs neutral
By severity	Minor, moderate, major, critical
By status	Reported, under review, resolved, etc.
By location	Classroom, playground, cafeteria, etc.
By time of day	Morning, afternoon, etc.
By day of week	Monday through Friday
By class	Comparison across classes
By grade	Grade-level patterns

Trend analysis

Period	Data points
Daily	Incidents per day
Weekly	Week-over-week comparison
Monthly	Month-over-month trends

Key reports

Report	Content
Top behavior types	Most frequent incident types
Repeat offenders	Students with multiple negative incidents
Top recognized students	Students with most positive points
Resolution metrics	Average resolution time, rate
Escalation rate	% of incidents escalated
Class comparison	Behavior by class/section

Resolution metrics

Metric	Description
Average resolution time	Hours from reported to resolved
Resolution rate	% of incidents resolved
Escalation rate	% of incidents escalated

Comparison metrics

Metric	Description
Previous period	Compare to last month/term
Change percentage	% change in incidents
Trend direction	Improving or declining

---

Part 13: Student behavior profile

Each student has a behavior profile showing their conduct history.

Profile sections

Section	Content
Summary	Points balance, trend, quick stats
History	List of all incidents
Timeline	Visual behavior timeline
Patterns	Detected patterns

Summary widget

Displayed on student profile:

• Net points balance
• Trend indicator (up/down/stable)
• Positive recognition count
• Negative incident count
• Recent incidents (last 30 days)
• Resolution rate

Quick actions

From student profile:

• Add Recognition — Log positive behavior
• Log Incident — Record negative incident
• View All — See complete history

---

Part 14: Follow-ups

Track incidents requiring follow-up attention.

Follow-up properties

Field	Description
requiresFollowUp	Flag indicating follow-up needed
followUpDate	Deadline for follow-up
followUpNotes	Notes about required follow-up

Follow-up workflow

1. When logging incident, check "Requires follow-up"
2. Set follow-up date
3. Add follow-up notes
4. Save incident
5. Follow-up appears in pending list
6. Complete follow-up and update notes
7. Clear follow-up flag

Pending follow-ups view

1. Navigate to Behavior → Incidents
2. Filter by "Requires follow-up"
3. Sort by follow-up date
4. Address each pending item

---

Permissions required

Action	Required permission
View dashboard	behavior.view
View incidents	behavior.incidents.view or behavior.view
Log incident	behavior.incidents.create or behavior.create
Edit incident	behavior.incidents.update or behavior.update
Delete incident	behavior.incidents.delete or behavior.delete
Resolve incident	behavior.incidents.update or behavior.update
Escalate incident	behavior.escalate or behavior.update
View types	behavior.types.view or behavior.view
Manage types	behavior.types.update or behavior.update
View analytics	behavior.analytics.view or behavior.view
View student profile	students.view and behavior.view

---

Best practices

Incident logging

• Log incidents promptly while details are fresh
• Be objective and factual in descriptions
• Include specific behaviors, not interpretations
• Note witnesses when applicable
• Attach supporting evidence if available

Resolutions

• Match resolution to severity appropriately
• Document actions taken clearly
• Follow through on assigned consequences
• Schedule follow-ups for serious incidents
• Involve parents for moderate+ incidents

Recognition

• Recognize positive behavior promptly
• Be specific about what is being recognized
• Vary recognition types and points
• Ensure equity in recognition across students
• Celebrate achievements publicly when appropriate

Analytics

• Review behavior reports weekly
• Identify and address patterns early
• Track repeat offenders for intervention
• Compare classes to identify systemic issues
• Celebrate improvement trends

---

Troubleshooting

Incident not saving

Causes:

• Required fields missing
• Network connectivity issue
• Permission denied

Fix:

1. Check all required fields are filled
2. Verify network connection
3. Confirm you have create permission
4. Try again

Points not updating

Causes:

• Incident not in resolved status
• Points field empty
• Calculation delay

Fix:

1. Verify incident has points value
2. Check incident status
3. Refresh page
4. Wait for recalculation

Cannot escalate

Causes:

• Incident already resolved/dismissed
• No escalation permission
• No escalation target selected

Fix:

1. Verify incident is not terminal
2. Check escalation permission
3. Select escalation target
4. Try again

Parent not notified

Causes:

• Parent contact info missing
• Notification disabled on type
• Notification manually unchecked

Fix:

1. Verify parent contact info in student record
2. Check behavior type settings
3. Manually trigger notification
4. Verify notification preferences

---

Related documentation

• Students — Student records and profiles
• Attendance — Attendance tracking
• Communications — Parent notifications
• Reports — Behavior reports
• Settings — System configuration