feat: add private_event fixed point type

so that non-public club events can also be awarded with points if a staff choses to do so.

Author: FreekBes

docs/architecture.md

@@ -161,9 +161,10 @@ Default fixed types initialized on initial startup:
 | `logtime` | 10 | Points per hour of campus presence |
 | `idle_logout` | -10 | Penalty for leaving a computer idling (negative) |
 | `exam` | 1000 | Factor in exam score formula |
-| `event_basic` | 1000 | Points for organizing a basic event |
-| `event_intermediate` | 3000 | Points for organizing an intermediate event |
-| `event_advanced` | 6000 | Points for organizing an advanced event |
+| `event_private` | 500 | Flat award for organizing a private event (e.g. for club members only) |
+| `event_basic` | 1000 | Flat award for organizing a basic event |
+| `event_intermediate` | 3000 | Flat award for organizing an intermediate event |
+| `event_advanced` | 6000 | Flat award for organizing an advanced event |
 | `ranking_bonus` | 0 | Not used directly; actual amounts come from ranking settings |
 
 #### `CodamCoalitionRanking`

docs/features/scoring.md

@@ -18,6 +18,7 @@ Fixed types are named categories defined in `CodamCoalitionFixedType`. They are
 | `logtime` | 10 | Points per hour of campus computer usage |
 | `idle_logout` | −10 | Penalty per automatic idle logout from a campus computer (negative value) |
 | `exam` | 1000 | Factor in the exam score formula (see below) |
+| `event_private` | 500 | Flat award for organizing a private event (e.g. for club members only) |
 | `event_basic` | 1000 | Flat award for organizing a basic event |
 | `event_intermediate` | 3000 | Flat award for organizing an intermediate event |
 | `event_advanced` | 6000 | Flat award for organizing an advanced event |
@@ -121,10 +122,19 @@ Awarded manually by admins via the admin interface. Flat amounts based on event
 
 These are the guidelines for the different tiers of events, including recommended criteria.
 
+##### Private event
+A private event is suitable for small gatherings of selected students (e.g. club members only), it's simple to organize, usually held within the campus building with minimal logistic requirements. Example: "Book Club Meeting".
+
+###### Criteria for a private event
+- Have an event listed in the Intra calendar.
+- Have a private audience (e.g. club members only).
+- Minimal logistic arrangements needed, such as reserving the auditorium or open space.
+
 ##### Basic event
 A basic event is suitable for small gatherings of students, it's simple to organize, held within the campus building with minimal logistic requirements , no budget involved. Example: "Movie Night".
 
 ###### Criteria for a basic event
+- Have an event listed in the Intra calendar that is open to all students.
 - Aim for around 1-10 attendees.
 - Minimal logistic arrangements needed, such as reserving the auditorium.
 - Short event duration, typically lasting 1-2 hours including setup and cleanup.
@@ -134,6 +144,7 @@ A basic event is suitable for small gatherings of students, it's simple to organ
 An intermediate-level event aimed at engaging a larger number of students through activities that require moderate planning and coordination. Example: "Eastern Lunch" & "Table Tennis League".
 
 ###### Criteria for an intermediate event
+- Have an event listed in the Intra calendar that is open to all students.
 - Aim for around 10-50 attendees.
 - Moderate logistical arrangements, including securing a location (inside or outside of the campus), prepare and coordinate activities or themes for - the event.
 - Limited budget requirement, covering food/drinks, possibility equipment and resources.
@@ -143,6 +154,7 @@ An intermediate-level event aimed at engaging a larger number of students throug
 An advanced-level event designed to bring together a large number of students for a significant social gathering or activity, requires extensive planning, resources and possibly external coordination. Example: "Student Party"
 
 ###### Criteria for an advanced event
+- Have an event listed in the Intra calendar that is open to all students.
 - Aim for more than 50 attendees.
 - Extensive planning with detailed scheduling and coordination, with several deadlines.
 - Might involve coordination with external stakeholders, such as partners.

src/dev/create_rankings.ts

@@ -29,7 +29,7 @@ const createRankings = async function(): Promise<void> {
 	await createRanking('Top Performers', 'Based on points gained through projects', 'Top Performer %login', 8400, ['project', 'exam']);
 	await createRanking('Top Endeavors', 'Based on points gained through logtime', 'Top Endeavor %login', 16800, ['logtime', 'idle_logout']);
 	await createRanking('Philanthropists', 'Based on points gained through donating evaluation points to the pool', 'Philanthropist %login', 16800, ['point_donated']);
-	await createRanking('Community Leaders', 'Based on points gained through organizing events', 'Community Leader %login', 12600, ['event_basic', 'event_intermediate', 'event_advanced']);
+	await createRanking('Community Leaders', 'Based on points gained through organizing events', 'Community Leader %login', 12600, ['event_private', 'event_basic', 'event_intermediate', 'event_advanced']);
 };
 
 const main = async function(): Promise<void> {

src/sync/fixed_point_types.ts

@@ -64,6 +64,11 @@ export const initCodamCoalitionFixedTypes = async function(): Promise<void> {
 			desc: "Each exam passed will grant the student with a fixed amount of points, influenced by the final mark. The score is calculated as (mark / 100) * fixed_point_amount.",
 			points: 1000, // recommended
 		},
+		{
+			type: "event_private",
+			desc: "Each private event organized (e.g. for club members only) will grant the student with this amount of points.",
+			points: 500, // recommended
+		},
 		{
 			type: "event_basic",
 			desc: "Each basic event organized will grant the student with this amount of points.",

templates/admin/points/manual/custom.njk

@@ -11,7 +11,7 @@
 </nav>
 
 <div class="alert alert-warning">
-	<p>Points for any <b>events</b> organized should be assigned using the <a href="/admin/points/manual/event_basic">event_basic</b>, <a href="/admin/points/manual/event_intermediate">event_intermediate</a> or <a href="/admin/points/manual/event_advanced">event_advanced</a> forms instead of this one.</b></p>
+	<p>Points for any <b>events</b> organized should be assigned using the <a href="/admin/points/manual/event_private">event_private</b>, <a href="/admin/points/manual/event_basic">event_basic</b>, <a href="/admin/points/manual/event_intermediate">event_intermediate</a> or <a href="/admin/points/manual/event_advanced">event_advanced</a> forms instead of this one.</b></p>
 </div>
 
 <ul class="nav nav-tabs mb-3">

templates/admin/points/manual/event.njk

@@ -15,11 +15,22 @@
 	<p>These are the guidelines for the different types of events, including recommended criteria:</p>
 
 	<ul>
+		<li class="mb-3">
+			<b>Private event</b>
+			<p>A private event is suitable for small gatherings of selected students (e.g. club members only), it's simple to organize, usually held within the campus building with minimal logistic requirements. Example: "Book Club Meeting".</p>
+			<i>Criteria for a private event:</i>
+			<ul>
+				<li>Have an event listed in the Intra calendar.</li>
+				<li>Have a private audience (e.g. club members only).</li>
+				<li>Minimal logistic arrangements needed, such as reserving the auditorium or open space.</li>
+			</ul>
+		</li>
 		<li class="mb-3">
 			<b>Basic event</b>
 			<p>A basic event is suitable for small gatherings of students, it's simple to organize, held within the campus building with minimal logistic requirements , no budget involved. Example: "Movie Night".</p>
 			<i>Criteria for a basic event:</i>
 			<ul>
+				<li>Have an event listed in the Intra calendar that is open to all students.</li>
 				<li>Aim for around 1-10 attendees.</li>
 				<li>Minimal logistic arrangements needed, such as reserving the auditorium.</li>
 				<li>Short event duration, typically lasting 1-2 hours including setup and cleanup.</li>
@@ -31,6 +42,7 @@
 			<p>An intermediate-level event aimed at engaging a larger number of students through activities that require moderate planning and coordination. Example:  "Eastern Lunch" & "Table Tennis League".</p>
 			<i>Criteria for an intermediate event:</i>
 			<ul>
+				<li>Have an event listed in the Intra calendar that is open to all students.</li>
 				<li>Aim for around 10-50 attendees.</li>
 				<li>Moderate logistical arrangements, including securing a location (inside or outside of the campus), prepare and coordinate activities or themes for the event.</li>
 				<li>Limited budget requirement, covering food/drinks, possibility equipment and resources.</li>
@@ -42,6 +54,7 @@
 			<p>An advanced-level event designed to bring together a large number of students for a significant social gathering or activity, requires extensive planning, resources and possibly external coordination. Example: "Student Party"</p>
 			<i>Criteria for an advanced event:</i>
 			<ul>
+				<li>Have an event listed in the Intra calendar that is open to all students.</li>
 				<li>Aim for more than 50 attendees.</li>
 				<li>Extensive planning with detailed scheduling and coordination, with several deadlines.</li>
 				<li>Might involve coordination with external stakeholders, such as partners.</li>