feat(certificate): implement compliance auditing, certificate templates, and troubleshooting guide

Resolves #379, #472, #483.
- Implemented immutable audit logging with institutional governance roles.
- Added certificate template system with variable substitution and pagination.
- Integrated automated compliance violation alerts and monitoring.
- Added comprehensive developer troubleshooting guide for Soroban operations.
- Optimized storage rent management (TTL) and implemented DoS protection (rate limiting).

Author: Vicky08100

contracts/certificate/src/events.rs

@@ -165,7 +165,6 @@ pub fn emit_certificate_shared(
     );
 }
 
-/// Emit when a compliance check is performed.
 pub fn emit_compliance_checked(
     env: &Env,
     verifier: &Address,
@@ -183,6 +182,25 @@ pub fn emit_compliance_checked(
     );
 }
 
+/// Emit when a compliance violation is detected.
+pub fn emit_compliance_violation(
+    env: &Env,
+    certificate_id: &BytesN<32>,
+    standard: &str,
+    details: &str,
+) {
+    emit_certification_event!(
+        env,
+        symbol_short!("cert"),
+        env.current_contract_address(),
+        CertificationEventData::ComplianceViolation(ComplianceViolationEvent {
+            certificate_id: certificate_id.clone(),
+            standard: String::from_str(env, standard),
+            violation_details: String::from_str(env, details),
+        })
+    );
+}
+
 /// Emit when a certificate template is created.
 pub fn emit_template_created(env: &Env, template_id: &String, created_by: &Address) {
     emit_certification_event!(