Feat/328 model doc comments (#354)

* feat(contract): standardize event name trimming (#326)

- Add `name` field to `EventRegistrationArgs` and `EventInfo` structs
- Implement `trim_string` helper to strip leading/trailing ASCII whitespace
- Apply trimming to event name in `register_event` before persisting
- Add `name` field to local `EventInfo` copy in ticket_payment contract
- Add `test_register_event_name_trimming` test with intentionally messy names
- Update all existing test fixtures to include the new `name` field

* chore(server): add .dockerignore to reduce Docker build context

Excludes target/, .env files, .git/, editor artifacts, and other
non-essential files from the Docker build context.

- target/ is the primary source of bloat (can be GBs in Rust projects)
- .env files must never be baked into images
- .git/ metadata (~30MB) is not needed at build time
- Docs, scripts, and OS artifacts excluded for a leaner context

* docs(server): add doc comments to model structs (#328)

Add /// and //! doc comments to all structs and fields in
server/src/models/ to improve database layer understandability.

- User: documents role distinction from Organizer
- Organizer: documents ownership relationship to Events
- Event: documents FK to Organizer and cascade behaviour
- TicketTier: documents quantity tracking semantics
- Ticket: documents status lifecycle (active/used/cancelled)
  and QR code generation timing
- Transaction: documents status lifecycle (pending/completed/failed)
  and Stellar hash usage for on-chain payments
- mod.rs: adds module-level doc with entity relationship diagram

Author: Chibey-max

contract/contracts/event_registry/src/lib.rs

@@ -359,8 +359,12 @@ impl EventRegistry {
 
         let platform_fee_percent = storage::get_platform_fee(&env);
 
+        // Sanitize: trim leading/trailing whitespace from the event name
+        let trimmed_name = trim_string(&env, &args.name);
+
         let event_info = EventInfo {
             event_id: args.event_id.clone(),
+            name: trimmed_name,
             organizer_address: args.organizer_address.clone(),
             payment_address: args.payment_address.clone(),
             platform_fee_percent,
@@ -1863,6 +1867,49 @@ fn is_zero_address(env: &Env, address: &Address) -> bool {
     address.to_string() == zero_account
 }
 
+/// Trims leading and trailing ASCII whitespace from a Soroban `String`.
+fn trim_string(env: &Env, s: &String) -> String {
+    let len = s.len();
+    if len == 0 {
+        return s.clone();
+    }
+
+    // Copy string bytes into a stack buffer for manipulation
+    let mut buf = [0u8; 256];
+    let len_usize = len as usize;
+    // If name exceeds buffer, return as-is (shouldn't happen in practice)
+    if len_usize > buf.len() {
+        return s.clone();
+    }
+    s.copy_into_slice(&mut buf[..len_usize]);
+
+    let mut start = 0usize;
+    while start < len_usize {
+        let b = buf[start];
+        if b == b' ' || b == b'\t' || b == b'\n' || b == b'\r' {
+            start += 1;
+        } else {
+            break;
+        }
+    }
+
+    let mut end = len_usize;
+    while end > start {
+        let b = buf[end - 1];
+        if b == b' ' || b == b'\t' || b == b'\n' || b == b'\r' {
+            end -= 1;
+        } else {
+            break;
+        }
+    }
+
+    if start == 0 && end == len_usize {
+        return s.clone();
+    }
+
+    String::from_bytes(env, &buf[start..end])
+}
+
 fn validate_metadata_cid(env: &Env, cid: &String) -> Result<(), EventRegistryError> {
     let cid_len = cid.len();
     if !(MIN_METADATA_CID_LEN..=MAX_METADATA_CID_LEN).contains(&cid_len) {