G2-Pair1: VMS module — final submission

[WhoamiI00]

Visitor Management System module (final submission for IT3C03). Roll numbers: 23BCS028, 23BCS208, 23BCS017

Backend deliverables (applications/vms/):

• models.py — Visitor, Visit, VisitorPass, BlacklistEntry, EscortAssignment, SecurityIncident, SystemConfig, VisitingHours, AccessZone, etc.
• api/views.py + serializers.py + urls.py — 34 endpoints across staff / admin / super-admin tiers
• services.py — register, verify, issue_pass (QR), record_entry/exit (auto-releases escorts on exit), assign_escort (BR-046, is_vip gated), process_vip_visit, generate_report, import/export, update_config, configure_visiting_hours, configure_access_zone
• permissions.py — IsAuthenticated / IsVmsAdmin / IsSuperAdmin / CanRemoveBlacklist / CanBypassVIPApproval / HasHostApprovalAuthority
• validators.py — ID format, duration limits, visiting hours, config value validation, conflict detection
• notifications.py + tasks.py — host notification, escalation, cache refresh, location tracking activation
• migrations 0001 — 0004 (latter adds vip_level)
• Designated_Roles.md — role specification matching the assignment template
• tests/ — in-app smoke tests

Helper scripts:

• vms_rbac.py — read-only RBAC inventory tool (list / users / endpoints / matrix / check )
• vms_seed.py — idempotent demo-data seeder

URL wiring requires one additional line in Fusion/urls.py:
url(r'^vms/', include('applications.vms.api.urls')),

Issue that this pull request solves

Closes: # (issue number)

Proposed changes

Brief description of what is fixed or changed

Types of changes

Put an x in the boxes that apply

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Other (please describe):

Checklist

Put an x in the boxes that apply

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have created new branch for this pull request
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• My changes does not break the current system and it passes all the current test cases.

Screenshots

Please attach the screenshots of the changes made in case of change in user interface

Other information

Any other information that is important to this pull request

[FusionIIIT-Bot]

Congratulations for making your first Pull Request at Fusion!! 🎉 Someone from our team will review it soon.