From cbb363671ab2ba8aac21cd24713dafbe1eafc8e3 Mon Sep 17 00:00:00 2001
From: Kijin Sung <kijin@kijinsung.com>
Date: Tue, 31 Mar 2026 22:27:20 +0900
Subject: [PATCH] Add DocumentModel::getBlankDocument() and fix some incorrect
 return type comments

---
 modules/document/document.model.php | 32 +++++++++++++++++++++--------
 1 file changed, 23 insertions(+), 9 deletions(-)

diff --git a/modules/document/document.model.php b/modules/document/document.model.php
index e95bcb32d..acf200d3d 100644
--- a/modules/document/document.model.php
+++ b/modules/document/document.model.php
@@ -146,22 +146,23 @@ class DocumentModel extends Document
 	}
 
 	/**
-	 * Import Document
+	 * Get a document.
+	 * 
 	 * @param int $document_srl
 	 * @param bool $is_admin
 	 * @param bool $load_extra_vars
 	 * @param bool $reload_counts
-	 * @return documentItem
+	 * @return DocumentItem
 	 */
 	public static function getDocument($document_srl = 0, $is_admin = false, $load_extra_vars = true, $reload_counts = true)
 	{
 		if(!$document_srl)
 		{
-			return new documentItem();
+			return new DocumentItem();
 		}
 		if(!isset($GLOBALS['XE_DOCUMENT_LIST'][$document_srl]))
 		{
-			$oDocument = new documentItem($document_srl, $load_extra_vars, $reload_counts);
+			$oDocument = new DocumentItem($document_srl, $load_extra_vars, $reload_counts);
 			if(!$oDocument->isExists())
 			{
 				return $oDocument;
@@ -176,13 +177,26 @@ class DocumentModel extends Document
 		return $GLOBALS['XE_DOCUMENT_LIST'][$document_srl];
 	}
 
+	/**
+	 * Create a blank document.
+	 * 
+	 * @param int $module_srl
+	 * @return DocumentItem
+	 */
+	public static function getBlankDocument($module_srl = 0): DocumentItem
+	{
+		$oDocument = new DocumentItem();
+		$oDocument->add('module_srl', $module_srl);
+		return $oDocument;
+	}
+
 	/**
 	 * Bringing multiple documents (or paging)
 	 * @param array|string $document_srls
 	 * @param bool $is_admin
 	 * @param bool $load_extra_vars
 	 * @param array $columnList
-	 * @return array value type is documentItem
+	 * @return array value type is DocumentItem
 	 */
 	public static function getDocuments($document_srls, $is_admin = false, $load_extra_vars = true, $columnList = array())
 	{
@@ -207,7 +221,7 @@ class DocumentModel extends Document
 		{
 			if(!isset($GLOBALS['XE_DOCUMENT_LIST'][$attribute->document_srl]))
 			{
-				$oDocument = new documentItem();
+				$oDocument = new DocumentItem();
 				$oDocument->setAttribute($attribute, false);
 			}
 			if($is_admin)
@@ -233,7 +247,7 @@ class DocumentModel extends Document
 	 * @param bool $except_notice
 	 * @param bool $load_extra_vars
 	 * @param array $columnList
-	 * @return Object
+	 * @return BaseObject
 	 */
 	public static function getDocumentList($obj, $except_notice = false, $load_extra_vars = true, $columnList = array())
 	{
@@ -300,7 +314,7 @@ class DocumentModel extends Document
 	 * Module_srl value, bringing the document's gongjisa Port
 	 * @param object $obj
 	 * @param array $columnList
-	 * @return object|void
+	 * @return BaseObject
 	 */
 	public static function getNoticeList($obj, $columnList = array())
 	{
@@ -338,7 +352,7 @@ class DocumentModel extends Document
 		{
 			if(!isset($GLOBALS['XE_DOCUMENT_LIST'][$attribute->document_srl]))
 			{
-				$oDocument = new documentItem();
+				$oDocument = new DocumentItem();
 				$oDocument->setAttribute($attribute, false);
 			}