feat(compliance): add License Register DocType

av_tools/compliance/doctype/license_register/__init__.py

@@ -0,0 +1,2 @@
+# Copyright (c) 2026, Aakvatech and contributors
+# For license information, please see license.txt

av_tools/compliance/doctype/license_register/license_register.js

@@ -0,0 +1,8 @@
+// Copyright (c) 2026, Aakvatech and contributors
+// For license information, please see license.txt
+
+// frappe.ui.form.on("License Register", {
+// 	refresh(frm) {
+
+// 	},
+// });

av_tools/compliance/doctype/license_register/license_register.json

@@ -0,0 +1,262 @@
+{
+ "actions": [],
+ "autoname": "naming_series:",
+ "creation": "2026-05-06 13:12:00",
+ "doctype": "DocType",
+ "engine": "InnoDB",
+ "field_order": [
+  "details_tab",
+  "license_details_section",
+  "license_type",
+  "license_name",
+  "license_number",
+  "column_break_details",
+  "company",
+  "branch",
+  "fee_paid",
+  "column_break_ncpn",
+  "status",
+  "posting_date",
+  "posting_time",
+  "authority_dates_section",
+  "issuing_authority",
+  "issue_date",
+  "expiry_date",
+  "column_break_dates",
+  "reminder_days_before",
+  "notify_role",
+  "notes_section",
+  "license_attachment",
+  "naming_series",
+  "amended_from",
+  "column_break_mnbd",
+  "notes"
+ ],
+ "fields": [
+  {
+   "fieldname": "details_tab",
+   "fieldtype": "Tab Break",
+   "label": "Details"
+  },
+  {
+   "fieldname": "license_details_section",
+   "fieldtype": "Section Break",
+   "label": "License Details"
+  },
+  {
+   "fieldname": "naming_series",
+   "fieldtype": "Select",
+   "label": "Series",
+   "options": "LIC-.YYYY.-.#####",
+   "reqd": 1,
+   "set_only_once": 1
+  },
+  {
+   "fieldname": "license_type",
+   "fieldtype": "Link",
+   "in_list_view": 1,
+   "in_standard_filter": 1,
+   "label": "License Type",
+   "options": "License Type",
+   "reqd": 1
+  },
+  {
+   "fieldname": "license_name",
+   "fieldtype": "Data",
+   "in_list_view": 1,
+   "label": "License Name",
+   "reqd": 1
+  },
+  {
+   "fieldname": "column_break_details",
+   "fieldtype": "Column Break"
+  },
+  {
+   "fieldname": "license_number",
+   "fieldtype": "Data",
+   "in_list_view": 1,
+   "label": "License / Certificate Number",
+   "reqd": 1
+  },
+  {
+   "default": "Active",
+   "fieldname": "status",
+   "fieldtype": "Select",
+   "in_list_view": 1,
+   "in_standard_filter": 1,
+   "label": "Status",
+   "options": "Active\nExpired\nPending Renewal\nSuspended\nCancelled"
+  },
+  {
+   "fieldname": "authority_dates_section",
+   "fieldtype": "Section Break",
+   "label": "Authority & Dates"
+  },
+  {
+   "fieldname": "issuing_authority",
+   "fieldtype": "Data",
+   "label": "Issuing Authority",
+   "reqd": 1
+  },
+  {
+   "fieldname": "issue_date",
+   "fieldtype": "Date",
+   "label": "Issue Date",
+   "reqd": 1
+  },
+  {
+   "fieldname": "column_break_dates",
+   "fieldtype": "Column Break"
+  },
+  {
+   "fieldname": "expiry_date",
+   "fieldtype": "Date",
+   "label": "Expiry Date",
+   "reqd": 1
+  },
+  {
+   "default": "30",
+   "description": "Number of days before expiry to trigger a reminder notification",
+   "fieldname": "reminder_days_before",
+   "fieldtype": "Int",
+   "label": "Reminder Days Before Expiry",
+   "mandatory_depends_on": "eval: doc.reminder_days_before"
+  },
+  {
+   "fieldname": "company",
+   "fieldtype": "Link",
+   "in_standard_filter": 1,
+   "label": "Company",
+   "options": "Company",
+   "reqd": 1
+  },
+  {
+   "fieldname": "branch",
+   "fieldtype": "Link",
+   "in_standard_filter": 1,
+   "label": "Branch / Premises",
+   "options": "Branch"
+  },
+  {
+   "fieldname": "fee_paid",
+   "fieldtype": "Currency",
+   "label": "Fee Paid"
+  },
+  {
+   "collapsible": 1,
+   "fieldname": "notes_section",
+   "fieldtype": "Section Break"
+  },
+  {
+   "fieldname": "notes",
+   "fieldtype": "Text Editor",
+   "label": "Notes"
+  },
+  {
+   "fieldname": "license_attachment",
+   "fieldtype": "Attach",
+   "label": "License / Certificate Attachment"
+  },
+  {
+   "fieldname": "amended_from",
+   "fieldtype": "Link",
+   "label": "Amended From",
+   "no_copy": 1,
+   "options": "License Register",
+   "print_hide": 1,
+   "read_only": 1
+  },
+  {
+   "fieldname": "column_break_ncpn",
+   "fieldtype": "Column Break"
+  },
+  {
+   "default": "Today",
+   "fieldname": "posting_date",
+   "fieldtype": "Date",
+   "label": "Posting Date",
+   "read_only": 1
+  },
+  {
+   "default": "now",
+   "fieldname": "posting_time",
+   "fieldtype": "Time",
+   "label": "Posting Time",
+   "read_only": 1
+  },
+  {
+   "description": "A role for users who will recieve reminder notification",
+   "fieldname": "notify_role",
+   "fieldtype": "Link",
+   "label": "Notify Role",
+   "options": "Role"
+  },
+  {
+   "fieldname": "column_break_mnbd",
+   "fieldtype": "Column Break"
+  }
+ ],
+ "links": [
+  {
+   "link_doctype": "Inspection Record",
+   "link_fieldname": "license_register"
+  }
+ ],
+ "modified": "2026-05-06 14:19:05.322331",
+ "modified_by": "Administrator",
+ "module": "Compliance",
+ "name": "License Register",
+ "naming_rule": "By \"Naming Series\" field",
+ "owner": "Administrator",
+ "permissions": [
+  {
+   "create": 1,
+   "delete": 1,
+   "email": 1,
+   "export": 1,
+   "print": 1,
+   "read": 1,
+   "report": 1,
+   "role": "System Manager",
+   "share": 1,
+   "write": 1
+  },
+  {
+   "email": 1,
+   "export": 1,
+   "print": 1,
+   "read": 1,
+   "report": 1,
+   "role": "All",
+   "share": 1
+  }
+ ],
+ "row_format": "Dynamic",
+ "show_title_field_in_link": 1,
+ "sort_field": "creation",
+ "sort_order": "DESC",
+ "states": [
+  {
+   "color": "Green",
+   "title": "Active"
+  },
+  {
+   "color": "Red",
+   "title": "Expired"
+  },
+  {
+   "color": "Orange",
+   "title": "Pending Renewal"
+  },
+  {
+   "color": "Yellow",
+   "title": "Suspended"
+  },
+  {
+   "color": "Pink",
+   "title": "Cancelled"
+  }
+ ],
+ "title_field": "license_name",
+ "track_changes": 1
+}

av_tools/compliance/doctype/license_register/license_register.py

@@ -0,0 +1,65 @@
+# Copyright (c) 2026, Aakvatech and contributors
+# For license information, please see license.txt
+
+import frappe
+from frappe import _
+from frappe.model.document import Document
+from frappe.utils import getdate, nowdate, date_diff
+
+
+class LicenseRegister(Document):
+	def before_save(self):
+		self.validate_dates()
+		self.update_status()
+
+	def validate_dates(self):
+		if self.issue_date and self.expiry_date:
+			if getdate(self.issue_date) > getdate(self.expiry_date):
+				frappe.throw(
+					_("Issue Date cannot be after Expiry Date"),
+					title=_("Invalid Dates"),
+				)
+
+	def update_status(self):
+		"""Auto-update status based on expiry date."""
+		if self.status in ("Suspended", "Cancelled"):
+			return
+
+		today = getdate(nowdate())
+		expiry = getdate(self.expiry_date) if self.expiry_date else None
+
+		if not expiry:
+			return
+
+		if expiry < today:
+			self.status = "Expired"
+		elif self.reminder_days_before and date_diff(expiry, today) <= self.reminder_days_before:
+			self.status = "Pending Renewal"
+		else:
+			self.status = "Active"
+
+
+def update_license_statuses():
+	"""Scheduled job to auto-update license statuses daily.
+	Called via hooks.py scheduler_events.
+	"""
+	licenses = frappe.get_all(
+		"License Register",
+		filters={"status": ("in", ["Active", "Pending Renewal"])},
+		fields=["name", "expiry_date", "reminder_days_before", "status"],
+	)
+
+	today = getdate(nowdate())
+
+	for lic in licenses:
+		expiry = getdate(lic.expiry_date)
+		new_status = lic.status
+
+		if expiry < today:
+			new_status = "Expired"
+		elif lic.reminder_days_before and date_diff(expiry, today) <= lic.reminder_days_before:
+			new_status = "Pending Renewal"
+
+		if new_status != lic.status:
+			frappe.db.set_value("License Register", lic.name, "status", new_status)
+

av_tools/compliance/doctype/license_register/test_license_register.py

@@ -0,0 +1,9 @@
+# Copyright (c) 2026, Aakvatech and Contributors
+# See license.txt
+
+# import frappe
+from frappe.tests.utils import FrappeTestCase
+
+
+class TestLicenseRegister(FrappeTestCase):
+	pass