Wiki source code of Lost & Found Database

Last modified by Treyfane Dingo on 2025/01/06 12:16

version	line-number	content
45.1	1	[[image:lf_head.png\|\|data-xwiki-image-style-alignment="end" height="138" width="600"]]
1.1	2
31.3	3	The Lost & Found module provides a powerful and user-friendly database designed to streamline the management of all lost or found items during a convention. This centralised system ensures that every reported item is logged, tracked, and retrievable, minimising the chances of miscommunication or oversight.
14.1	4
31.4	5	With the introduction of [[API V2.0>>doc:L\.A\.S\.S\.I\.E\..System Information.API V2\.0.WebHome]], accessing this data has become possible for external platforms, allowing the data to be displayed on various digital channels, such as the convention's official website, dedicated mobile apps, or even third-party services like a Telegram bot. This level of integration ensures that attendees can quickly and easily check the status of their lost or found items in real-time, no matter where they are.
31.3	6
31.7	7	Other than most, the Lost & Found module is its year-round accessible, as the data is not being reset or archived after an event concludes. This supports attendees who may realise they’ve lost something well after the event has wrapped up, if properly integrated on the convention's official website via the API 2.0.
31.3	8
31.9	9	----
31.3	10
46.1	11	= Status =
1.1	12
31.10	13	The status of an Lost & Found item can be set to either:
1.1	14
22.6	15	(% style="width:441px" %)
	16	\|(% style="width:177px" %)L - Lost\|(% style="width:260px" %)Item reported lost by it's owner
	17	\|(% style="width:177px" %)F - Found\|(% style="width:260px" %)Item handed in to Lost & Found
	18	\|(% style="width:177px" %)R - Returned\|(% style="width:260px" %)Item returned to it's owner
1.3	19
31.10	20	The respective option fields can be set to only show items of a certain status in the Lost & Found list.
	21
22.5	22	(% style="width:1343px" %)
42.8	23	\|(% style="text-align:center; vertical-align:middle; width:450px" %)[[image:lf_options.png\|\|height="102" width="400"]]\|(% style="width:904px" %)(((
22.4	24	show lost: as a part of the standard view, all items in Status L - Lost are shown if this field is checked
1.3	25
22.4	26	show found: as a part of the standard view, all items in Status F - Found are shown if this field is checked
22.2	27
31.9	28	show returned: items in Status R - Returned are already returned to their respective owner and will not be shown in the standard view unless this option is selected
22.5	29
	30
	31	The options can be freely combined to narrow the search for items.
22.2	32	)))
	33
42.2	34	----
	35
46.1	36	= Adding an Item =
1.4	37
14.1	38	An Item can be added to the Lost & Found Database by clicking the button (% class="btn btn-default" %)Add Item(%%) in the upper right corner of the screen. When adding items to the Lost & Found Database, some standards should be considered:
7.1	39
5.1	40	(% style="border:none" %)
42.13	41	\|(% style="text-align:center; vertical-align:middle; width:333px" %)[[image:lf1.png\|\|data-xwiki-image-style-text-wrap="true" height="459" width="300"]]\|(% style="text-align:center; vertical-align:middle; width:333px" %)[[image:lf2.png\|\|data-xwiki-image-style-text-wrap="true" height="458" width="300"]]\|(% style="vertical-align:middle; width:1246px" %)(((
3.1	42	(% class="box warningmessage" %)
	43	(((
	44	Personally Identifiable Information (PII) shall //never// be given in the Lost & Found Item Title or Description!
	45	)))
	46
42.6	47	1. The Lost & Found Item Title is public, might appear on the convention's webpage or in their APP and should be short an concise. Most of the time only a single or two words should be enough in this field. Refrain from descriptive verbs here.
42.7	48	Examples for the item title are: “Artwork”, “Artwork Badge”, “Attendee Badge”, “Bag”, “Bandana”, “Cap”, “Collar”, “Fursuit Badge”, “Fursuit Part”, “Fursuit Prop”, “Glasses”, “Gloves”, “Hat”, “Hoodie”, “Jacket”, “Jewellery”, “Key”, “Mask”, “Plush”, “Robe”, “Scarf”, “Shirt”, “Shoes”, “T-Shirt”, “Wristband Weight”, ...
20.3	49	Personally Identifiable Information (PII) shall //never// be used in this field.
1.5	50	1. In the select box right below the Lost & Found Item Title, the current status of the Lost & Found Item (i.e. "Found / Handed in" or "Reported Lost") can be selected.
20.4	51	1. The Lost & Found Item Description should be used to give the basic parameters of the respective Lost & Found item. This should be a short description of the item, not repeating the Lost & Found Item Title. The item's colour, the location where it was found or lost, a visible name or similar (e.g. black / rainbow, "GEEKVAPE", found at Open Stage) are appropriate here. Unnecessary filling words should be avoided here to make it more easy to search for items and to display the information on the convention's webpage or in their APP.
	52	Personally Identifiable Information (PII) shall //never// be used in this field.
20.9	53	1. The Log Comment is the only field which can include PII since it does not appear on the convention's webpage or in their APP but rather only in the log of the item. Contact information for the item can safely be entered here.
1.5	54	1. The Timestamp will be autofilled with the current date and time if empty, so it does not necessarily have to be filled for found items, but the rough time of the finding or loss can be entered here.
1.4	55
3.1	56	The new item can finally be added with the "Save" button.
5.1	57	)))
42.8	58	\|(% style="text-align:center; vertical-align:middle; width:333px" %)Add Item Dialogue\|(% style="text-align:center; vertical-align:middle; width:333px" %)Add Item Dialogue (filled)\|(% style="width:1246px" %)
3.1	59
42.2	60	----
	61
46.1	62	= Lost & Found Database List =
3.1	63
31.38	64	The added item will be shown in the Lost & Found Database list immediately.
7.1	65
24.2	66	[[image:lf_head.png\|\|height="277" width="1200"]]
7.1	67
42.2	68	----
	69
46.1	70	= Adding an Image to the Item =
7.1	71
42.7	72	The easiest way to add an image to an item is by use of L.A.S.S.I.E. Bot. Alternatively it can be uploaded in the Edit Lost & Found Item dialogue box directly from the computer.
7.1	73
	74	(% style="border:none" %)
42.14	75	\|(% style="text-align:center; vertical-align:middle; width:333px" %)[[image:IMG_0771.PNG\|\|height="541" width="250"]] \|(% style="text-align:center; vertical-align:middle; width:333px" %)[[image:IMG_0772.PNG\|\|height="541" width="250"]]\|(% style="vertical-align:middle; width:1246px" %)(((
7.1	76	(% class="box warningmessage" %)
	77	(((
18.1	78	//Do not //upload photos with visible Personally Identifiable Information (PII)!
20.10	79	//Do not// upload photos of attendee badges, ID cards or bank cards!
42.14	80
	81
44.1	82	Any image should// not// show too many details, e.g. no serial numbers or alike to make a positive identification by the owner possible, even if the image itself is published on the convention's official website!
7.1	83	)))
	84
24.2	85	* An image can easily be added directly in L.A.S.S.I.E. Bot, sending it to the bot with a caption "L" and the Item ID (e.g. "L1920"). The Image will then be added to the Lost & Found Database.
	86	* Images will always be turned to landscape format (counter clockwise) by L.A.S.S.I.E. Bot and the upload function!
42.9	87	* An image can be deleted by clicking the trash bin button next to the upload button in the Edit Lost & Found Item dialogue box.
17.1	88	)))
42.10	89	\|(% style="text-align:center; vertical-align:middle; width:333px" %)Image taken via smartphone and ready to be sent to L.A.S.S.I.E. Bot via telegram with the caption “L1920”\|(% style="text-align:center; vertical-align:middle; width:333px" %)Result of sending the image to L.A.S.S.I.E. Bot\|(% style="width:1246px" %)
16.1	90
42.2	91	----
	92
46.1	93	= Searching for Items =
7.1	94
31.38	95	The added image will be shown in the Lost & Found Database list automatically after a reload period of max. 15 seconds.
7.1	96
24.2	97	[[image:lf_head2.png\|\|height="336" width="1200"]]
7.1	98
31.38	99	The Search box in the Lost & Found Database is designed to perform a search across the Lost & Found information currently displayed in the Lost & Found Database list. It does not limit itself to the visible details displayed in the Lost & Found Database list but also extends its search functionality to the logs of all entries displayed.
31.35	100
31.38	101	However, this search capability may lead to unexpected results in certain cases. For example, a search for a short and simple term like "ID" might not (only) return the exact entry you were anticipating. Instead, it could generate a broader set of results, including any log entries where the term "ID" has been mentioned. This could include items that were not directly associated with the visible information you were targeting in the Lost & Found Database list.
31.35	102
42.2	103	----
	104
46.1	105	= Editing Items & Item Log =
31.35	106
31.22	107	The Lost & Found Item Log serves as a secure and organised tool to document observations, updates, or other relevant details about each item as they arise over time. All entries in the Item Log are treated as confidential, accessible only to authorised personnel. This ensures privacy, particularly when sensitive details about items or their potential owners are involved. Additionally, the log entries are fully searchable through the Search box, making it easy to retrieve specific information when needed.
31.11	108
31.25	109	For optimal clarity and usability, it is advisable to write short and concise log entries. Keeping entries focused, without filling words, and to the point not only saves time but also ensures that the information is easily understandable by others who may need to reference it later.
31.12	110
31.25	111	(% style="width:1000px" %)
31.26	112	\|(% style="text-align:center; vertical-align:middle" %)[[image:lfi1.png\|\|height="487" width="300"]]\|(% style="text-align:center; vertical-align:middle" %)[[image:lfi2.png\|\|height="487" width="300"]]\|(% style="text-align:center; vertical-align:middle; width:345px" %)[[image:lfi3.png\|\|height="519" width="300"]]
42.12	113	\|(% style="text-align:center; vertical-align:middle" %)Edit Item Dialogue\|(% style="text-align:center; vertical-align:middle" %)(((
	114	Edit Item Dialogue before saving
	115	with log entry written
42.13	116	)))\|(% style="text-align:center; vertical-align:middle; width:345px" %)Edit Item Dialogue after saving a log entry
31.19	117
42.2	118	----
	119
46.1	120	= Return of Items =
31.11	121
31.31	122	When an item is either returned to its rightful owner or discarded for any reason deemed appropriate by the client (the convention organisers), the item's status should be updated to R - Returned to Owner.
31.27	123
31.32	124	To save an item in this status, it is mandatory to add a Log comment detailing the circumstances of the return or disposal. Ideally, this comment should include specific information, such as the name or identifying details of the person the item was returned to, or a brief explanation of what was done with the item if it was discarded. Providing clear and thorough documentation in the Log at this point is a critical safeguard as well-documented entries can be invaluable in situations where questions or disputes arise. For instance, if an item is mistakenly handed to the wrong person, having a detailed log entry makes it much easier to trace what occurred and take corrective action if needed. A reliable audit trail can greatly assist in resolving potential issues.
31.30	125
31.33	126	(% style="width:666px" %)
31.34	127	\|(% style="text-align:center; vertical-align:middle" %)[[image:lfi4.png\|\|height="521" width="300"]]\|(% style="text-align:center; vertical-align:middle" %)[[image:lfi5.png\|\|height="563" width="300"]]
42.13	128	\|(% style="text-align:center; vertical-align:middle" %)Edit Item Dialogue before saving
	129	with log entry written and
	130	item selected as returned\|(% style="text-align:center; vertical-align:middle" %)Edit Item Dialogue after saving
31.33	131
	132