Feature/budget management upstream

backend/index.js

@@ -21,6 +21,7 @@ const dashboardRoutes = require("./routes/dashboard.js");
 
 const analyticsRoutes = require("./routes/analytics.js");
 const porRoutes = require("./routes/por.js");
+const budgetRoutes = require("./routes/budget.js");
 const roomBookingRoutes = require("./routes/roomBooking.js");
 const app = express();
 
@@ -71,6 +72,7 @@ app.use("/api/announcements", announcementRoutes);
 app.use("/api/analytics", analyticsRoutes);
 app.use("/api/rooms", roomBookingRoutes);
 app.use("/api/por", porRoutes);
+app.use("/api/budget", budgetRoutes);
 
 // Start the server
 app.listen(process.env.PORT || 8000, () => {

backend/models/schema.js

@@ -646,6 +646,67 @@ const OrganizationalUnit = mongoose.model(
 );
 const Announcement = mongoose.model("Announcement", announcementSchema);
 
+const budgetTransactionSchema = new mongoose.Schema({
+  transaction_id: {
+    type: String,
+    required: true,
+    unique: true,
+    default: () => `BGT_${uuidv4()}`,
+  },
+  unit_id: {
+    type: mongoose.Schema.Types.ObjectId,
+    ref: "Organizational_Unit",
+    required: true,
+  },
+  event_id: {
+    type: mongoose.Schema.Types.ObjectId,
+    ref: "Event",
+    default: null,
+  },
+  type: {
+    type: String,
+    enum: ["ALLOCATION", "EXPENSE", "REFUND"],
+    required: true,
+  },
+  amount: {
+    type: Number,
+    required: true,
+    min: 0.01,
+  },
+  description: {
+    type: String,
+    default: "",
+    trim: true,
+    maxlength: 500,
+  },
+  created_by: {
+    type: mongoose.Schema.Types.ObjectId,
+    ref: "User",
+    required: true,
+  },
+  balance_after: {
+    type: Number,
+    required: true,
+    min: 0,
+  },
+  created_at: {
+  type: Date,
+  default: Date.now,
+},
+updated_at: {
+  type: Date,
+  default: Date.now,
+},
+});
+
+budgetTransactionSchema.index({ unit_id: 1, created_at: -1 });
+budgetTransactionSchema.index({ event_id: 1, created_at: -1 });
+
+const BudgetTransaction = mongoose.model(
+  "Budget_Transaction",
+  budgetTransactionSchema,
+);
+
 const roomSchema = new mongoose.Schema({
   room_id: {
     type: String,
@@ -772,7 +833,6 @@ const roomBookingSchema = new mongoose.Schema({
 roomBookingSchema.index({ room: 1, date: 1, startTime: 1, endTime: 1 });
 
 const RoomBooking = mongoose.model("RoomBooking", roomBookingSchema);
-
 module.exports = {
   User,
   Feedback,
@@ -784,6 +844,7 @@ module.exports = {
   Position,
   OrganizationalUnit,
   Announcement,
+  BudgetTransaction,
   Room,
   RoomBooking,
 };

backend/routes/budget.js

@@ -0,0 +1,45 @@
+const express = require("express");
+
+const isAuthenticated = require("../middlewares/isAuthenticated");
+const authorizeRole = require("../middlewares/authorizeRole");
+const { ROLE_GROUPS } = require("../utils/roles");
+const budgetController = require("../controllers/budgetController");
+
+const router = express.Router();
+
+router.get(
+  "/overview",
+  isAuthenticated,
+  authorizeRole(ROLE_GROUPS.ADMIN),
+  budgetController.getBudgetOverview,
+);
+
+router.get(
+  "/transactions",
+  isAuthenticated,
+  authorizeRole(ROLE_GROUPS.ADMIN),
+  budgetController.getBudgetTransactions,
+);
+
+router.post(
+  "/allocate",
+  isAuthenticated,
+  authorizeRole(ROLE_GROUPS.ADMIN),
+  budgetController.allocateBudget,
+);
+
+router.post(
+  "/spend",
+  isAuthenticated,
+  authorizeRole(ROLE_GROUPS.ADMIN),
+  budgetController.recordExpense,
+);
+
+router.post(
+  "/refund",
+  isAuthenticated,
+  authorizeRole(ROLE_GROUPS.ADMIN),
+  budgetController.recordRefund,
+);
+
+module.exports = router;

backend/seed.js

@@ -12,6 +12,7 @@ const {
   PositionHolder,
   Position,
   OrganizationalUnit,
+  BudgetTransaction,
   Room,
 } = require("./models/schema");
 
@@ -291,6 +292,7 @@ const initialUnitsData = [
  */
 const clearData = async () => {
   console.log("Clearing existing data...");
+
   await RoomBooking.deleteMany({});
   await Room.deleteMany({});
   await OrganizationalUnit.deleteMany({});
@@ -302,6 +304,7 @@ const clearData = async () => {
   await UserSkill.deleteMany({});
   await Achievement.deleteMany({});
   await Feedback.deleteMany({});
+  await BudgetTransaction.deleteMany({});
   console.log("All collections cleared successfully!");
 };