feat: fix issues Stellar-Uzima#1004, Stellar-Uzima#1003, Stellar-Uzima#1002, Stellar-Uzima#998 assigned to Penielka

- Stellar-Uzima#1004: Add .devcontainer/devcontainer.json with Rust 1.92.0, Soroban CLI 21.7.7,
  wasm target, and recommended VS Code extensions
- Stellar-Uzima#1003: Add docker-compose.yml and Dockerfile.dev for one-click local
  development environment with Stellar node, contract deployment, and test data
- Stellar-Uzima#1002: Add soroban contract invoke CLI examples to contract_template (5 entrypoints)
  and patient_consent_management (4 entrypoints) doc comments
- Stellar-Uzima#998: Add FHIR R4 Consent resource mapping to patient_consent_management with
  to_fhir_consent() conversion, validate_fhir_consent() validator, and 6 unit tests

Author: Penielka

.devcontainer/devcontainer.json

@@ -0,0 +1,43 @@
+{
+  "name": "Uzima Contracts",
+  "image": "mcr.microsoft.com/devcontainers/rust:1-1-bookworm",
+  "features": {
+    "ghcr.io/devcontainers/features/rust:1": {
+      "version": "1.92.0",
+      "profile": "minimal"
+    }
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "rust-lang.rust-analyzer",
+        "tamasfe.even-better-toml",
+        "vadimcn.vscode-lldb",
+        "fill-labs.dependi",
+        "github.vscode-github-actions",
+        "ms-azuretools.vscode-docker",
+        "yzhang.markdown-all-in-one",
+        "timonwong.shellcheck"
+      ],
+      "settings": {
+        "rust-analyzer.cargo.target": "wasm32-unknown-unknown",
+        "rust-analyzer.checkOnSave.command": "clippy",
+        "rust-analyzer.checkOnSave.allTargets": false,
+        "editor.formatOnSave": true,
+        "editor.rulers": [100],
+        "[rust]": {
+          "editor.defaultFormatter": "rust-lang.rust-analyzer"
+        }
+      }
+    }
+  },
+  "postCreateCommand": "rustup target add wasm32-unknown-unknown && rustup component add rustfmt clippy rust-src && cargo install --locked soroban-cli --version 21.7.7 && make build",
+  "remoteUser": "root",
+  "mounts": [
+    "source=${localWorkspaceFolder}/target,target=/workspaces/Uzima-Contracts/target,type=volume"
+  ],
+  "containerEnv": {
+    "SOROBAN_RPC_URL": "http://localhost:8000/soroban/rpc",
+    "SOROBAN_NETWORK_PASSPHRASE": "Standalone Network ; February 2017"
+  }
+}

Dockerfile.dev

@@ -0,0 +1,17 @@
+# Dockerfile.dev — Development environment for Uzima Contracts
+FROM rust:1.92.0-bookworm
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    git \
+    build-essential \
+    jq \
+    shellcheck \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN rustup target add wasm32-unknown-unknown && \
+    rustup component add rustfmt clippy rust-src
+
+RUN cargo install --locked soroban-cli --version 21.7.7
+
+WORKDIR /workspace

contracts/contract_template/src/lib.rs

@@ -53,6 +53,16 @@ impl ContractTemplate {
     ///
     /// # Auth
     /// No auth required — the deployer becomes the admin.
+    ///
+    /// # Example (Soroban CLI)
+    /// ```bash
+    /// soroban contract invoke \
+    ///     --id $CONTRACT_ID \
+    ///     --source admin \
+    ///     --network local \
+    ///     -- initialize \
+    ///     --admin $(soroban config identity address admin)
+    /// ```
     pub fn initialize(env: Env, admin: Address) -> Result<(), Error> {
         if env.storage().instance().has(&DataKey::Admin) {
             return Err(Error::AlreadyInitialized);
@@ -70,6 +80,16 @@ impl ContractTemplate {
     ///
     /// # Auth
     /// Requires auth from the **current** admin.
+    ///
+    /// # Example (Soroban CLI)
+    /// ```bash
+    /// soroban contract invoke \
+    ///     --id $CONTRACT_ID \
+    ///     --source admin \
+    ///     --network local \
+    ///     -- transfer_admin \
+    ///     --new_admin GDT6C5XN6N4KMARBER2KEJCQA7NGK7IE46YH4XQLAWXI5QPLFXXOB7KJ
+    /// ```
     pub fn transfer_admin(env: Env, new_admin: Address) -> Result<(), Error> {
         let admin = Self::get_admin(&env)?;
         // Always call require_auth() before any state changes.
@@ -84,6 +104,17 @@ impl ContractTemplate {
     ///
     /// # Auth
     /// Requires auth from the admin.
+    ///
+    /// # Example (Soroban CLI)
+    /// ```bash
+    /// soroban contract invoke \
+    ///     --id $CONTRACT_ID \
+    ///     --source admin \
+    ///     --network local \
+    ///     -- update_data \
+    ///     --caller $(soroban config identity address admin) \
+    ///     --data "Hello, Stellar!"
+    /// ```
     pub fn update_data(env: Env, caller: Address, data: String) -> Result<(), Error> {
         // 1. Authenticate the caller first.
         caller.require_auth();
@@ -116,6 +147,16 @@ impl ContractTemplate {
     // -----------------------------------------------------------------------
 
     /// Return the current admin address.
+    ///
+    /// # Example (Soroban CLI)
+    /// ```bash
+    /// soroban contract invoke \
+    ///     --id $CONTRACT_ID \
+    ///     --source admin \
+    ///     --network local \
+    ///     --dry-run \
+    ///     -- get_admin
+    /// ```
     pub fn get_admin(env: &Env) -> Result<Address, Error> {
         env.storage()
             .instance()
@@ -124,6 +165,16 @@ impl ContractTemplate {
     }
 
     /// Return the stored data, if any.
+    ///
+    /// # Example (Soroban CLI)
+    /// ```bash
+    /// soroban contract invoke \
+    ///     --id $CONTRACT_ID \
+    ///     --source admin \
+    ///     --network local \
+    ///     --dry-run \
+    ///     -- get_data
+    /// ```
     pub fn get_data(env: Env) -> Option<ContractData> {
         env.storage().persistent().get(&DataKey::Data)
     }