Issue 7 Add room app

.gitignore

@@ -297,4 +297,6 @@ pyrightconfig.json
 opt/
 
 # google api 
-server/api/booking/google_calendar/google_calendar_service.json
+server/api/booking/google_calendar/google_calendar_service.json
+
+server/media/

server/api/room/README.md

@@ -0,0 +1,96 @@
+# Room API Endpoints
+
+## Authentication
+
+- **Read (GET):** Anyone can list or retrieve rooms.
+- **Write (POST, PATCH, PUT):** Only authenticated users can create or update rooms.
+- **Delete:** Not allowed (returns 405).
+
+---
+
+## List Rooms
+
+**GET** `/api/rooms/`
+
+### Query Parameters (all optional):
+
+- `name`: Filter rooms by name (case-insensitive, partial match).
+- `location`: Filter by location name (case-insensitive, partial match).
+- `min_capacity`: Minimum capacity (integer).
+- `max_capacity`: Maximum capacity (integer).
+- `min_datetime`: Start datetime after or equal to (ISO 8601).
+- `max_datetime`: End datetime before or equal to (ISO 8601).
+- `amenity`: Filter by amenity name(s). Comma-separated for multiple.  
+  Example: `?amenity=Projector,Whiteboard`
+
+**Pagination:**  
+Results are paginated (10 per page by default). Use `?page=2` for next page.
+
+**Example Request:**
+
+```
+GET /api/rooms/?name=meeting&location=Main&min_capacity=5&amenity=Projector,Whiteboard
+```
+
+---
+
+## Retrieve Room
+
+**GET** `/api/rooms/{id}/`
+
+Returns details for a single room.
+
+---
+
+## Create Room
+
+**POST** `/api/rooms/`  
+**Auth required**
+
+**Body Example:**
+
+```json
+{
+  "name": "Conference Room",
+  "location": 1,
+  "capacity": 20,
+  "amenities_id": [1, 2],
+  "start_datetime": "2025-12-11T09:00:00Z",
+  "end_datetime": "2025-12-11T18:00:00Z",
+  "recurrence_rule": "FREQ=DAILY;BYDAY=MO,TU,WE",
+  "is_active": true
+}
+```
+
+---
+
+## Update Room
+
+**PATCH/PUT** `/api/rooms/{id}/`  
+**Auth required**
+
+**Body:** Same as create. Partial updates allowed.
+
+---
+
+## Delete Room
+
+**DELETE** `/api/rooms/{id}/`  
+**Not allowed** (returns 405 Method Not Allowed).
+
+---
+
+## Notes
+
+- Unauthenticated users only see rooms where `is_active=true`.
+- A room cannot be deleted but you can change its `is_active`
+- Filtering by multiple amenities returns rooms that have **all** specified amenities.
+- Validation: `end_datetime` must be after `start_datetime`.
+- Validation: `recurrence_rule` must start with FREQ= and contain valid frequency
+
+---
+
+## Related Endpoints
+
+- **Locations:** `/api/locations/`
+- **Amenities:** `/api/amenities/`

server/api/room/admin.py

@@ -0,0 +1,25 @@
+from django.contrib import admin
+from .models import Room, Location, Amenity
+# Register your models here.
+
+
+@admin.register(Room)
+class RoomAdmin(admin.ModelAdmin):
+    list_display = ("id", "name", "location",
+                    "start_datetime", "end_datetime", "recurrence_rule", "is_active")
+    search_fields = ("name", "location__name", "amenities__name")
+    list_display_links = ("name",)
+
+
+@admin.register(Location)
+class LocationAdmin(admin.ModelAdmin):
+    list_display = ("id", "name")
+    search_fields = ("name",)
+    list_display_links = ("name",)
+
+
+@admin.register(Amenity)
+class AmenitiesAdmin(admin.ModelAdmin):
+    list_display = ("id", "name")
+    search_fields = ("name",)
+    list_display_links = ("name",)

server/api/room/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class RoomConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "api.room"

server/api/room/migrations/0001_initial.py

@@ -0,0 +1,50 @@
+# Generated by Django 5.2.9 on 2025-12-10 13:13
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = []
+
+    operations = [
+        migrations.CreateModel(
+            name="Amenities",
+            fields=[
+                ("id", models.AutoField(primary_key=True, serialize=False)),
+                ("name", models.CharField(max_length=32)),
+            ],
+        ),
+        migrations.CreateModel(
+            name="Location",
+            fields=[
+                ("id", models.AutoField(primary_key=True, serialize=False)),
+                ("name", models.CharField(max_length=64)),
+            ],
+        ),
+        migrations.CreateModel(
+            name="Room",
+            fields=[
+                ("id", models.AutoField(primary_key=True, serialize=False)),
+                ("name", models.CharField(max_length=32)),
+                ("img", models.ImageField(upload_to="room_images/")),
+                ("capacity", models.IntegerField()),
+                ("is_active", models.BooleanField(default=True)),
+                ("start_datetime", models.DateTimeField()),
+                ("end_datetime", models.DateTimeField()),
+                ("recurrence_rule", models.CharField(blank=True, max_length=64)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                ("amenities", models.ManyToManyField(blank=True, to="room.amenities")),
+                (
+                    "location",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE, to="room.location"
+                    ),
+                ),
+            ],
+        ),
+    ]

server/api/room/migrations/0002_alter_room_capacity.py

@@ -0,0 +1,21 @@
+# Generated by Django 5.2.9 on 2025-12-10 13:48
+
+import django.core.validators
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("room", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="room",
+            name="capacity",
+            field=models.PositiveIntegerField(
+                validators=[django.core.validators.MinValueValidator(1)]
+            ),
+        ),
+    ]

server/api/room/migrations/0003_alter_room_img.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.2.9 on 2025-12-10 14:59
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("room", "0002_alter_room_capacity"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="room",
+            name="img",
+            field=models.ImageField(blank=True, null=True, upload_to="room_images/"),
+        ),
+    ]

server/api/room/migrations/0004_alter_room_location.py

@@ -0,0 +1,21 @@
+# Generated by Django 5.2.9 on 2025-12-10 15:35
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("room", "0003_alter_room_img"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="room",
+            name="location",
+            field=models.ForeignKey(
+                on_delete=django.db.models.deletion.PROTECT, to="room.location"
+            ),
+        ),
+    ]

server/api/room/migrations/0005_alter_amenities_options_alter_location_options.py

@@ -0,0 +1,21 @@
+# Generated by Django 5.2.9 on 2025-12-11 16:24
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("room", "0004_alter_room_location"),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name="amenities",
+            options={"ordering": ["id"]},
+        ),
+        migrations.AlterModelOptions(
+            name="location",
+            options={"ordering": ["id"]},
+        ),
+    ]

server/api/room/migrations/0006_rename_amenities_amenity.py

@@ -0,0 +1,17 @@
+# Generated by Django 5.2.9 on 2025-12-11 16:40
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("room", "0005_alter_amenities_options_alter_location_options"),
+    ]
+
+    operations = [
+        migrations.RenameModel(
+            old_name="Amenities",
+            new_name="Amenity",
+        ),
+    ]

server/api/room/models.py

@@ -0,0 +1,43 @@
+from django.db import models
+from django.core.validators import MinValueValidator
+
+
+class Location(models.Model):
+    id = models.AutoField(primary_key=True)
+    name = models.CharField(max_length=64, blank=False)
+
+    class Meta:
+        ordering = ['id']
+
+    def __str__(self):
+        return self.name
+
+
+class Amenity(models.Model):
+    id = models.AutoField(primary_key=True)
+    name = models.CharField(max_length=32, blank=False)
+
+    class Meta:
+        ordering = ['id']
+
+    def __str__(self):
+        return self.name
+
+
+class Room(models.Model):
+    id = models.AutoField(primary_key=True)
+    name = models.CharField(max_length=32, blank=False)
+    img = models.ImageField(upload_to='room_images/', blank=True, null=True)
+    location = models.ForeignKey(
+        Location, on_delete=models.PROTECT, blank=False)
+    capacity = models.PositiveIntegerField(validators=[MinValueValidator(1)])
+    amenities = models.ManyToManyField(Amenity, blank=True)
+    is_active = models.BooleanField(default=True)
+    start_datetime = models.DateTimeField(blank=False)
+    end_datetime = models.DateTimeField(blank=False)
+    recurrence_rule = models.CharField(max_length=64, blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    def __str__(self):
+        return self.name