feat: Build Treasury Dashboard

.env.example

@@ -26,3 +26,10 @@ PUBLIC_STELLAR_HORIZON_URL="http://localhost:8000"
 # PUBLIC_STELLAR_NETWORK_PASSPHRASE="Public Global Stellar Network ; September 2015"
 # PUBLIC_STELLAR_RPC_URL=
 # PUBLIC_STELLAR_HORIZON_URL=
+
+# Optional contract IDs used by the scholarship application and DAO views
+# PUBLIC_LEARN_TOKEN_CONTRACT="CB..."
+# PUBLIC_SCHOLARSHIP_TREASURY_CONTRACT="CB..."
+# PUBLIC_SCHOLARSHIP_GOVERNANCE_CONTRACT="CB..."
+# PUBLIC_SCHOLARSHIP_MIN_LRN="100"
+# PUBLIC_USDC_CONTRACT_ID="CB..." # USDC token contract address (testnet or mainnet)

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,49 @@
+name: Bug report
+description: Report something that is broken in LearnVault.
+title: "[Bug]: "
+labels:
+  - bug
+  - triage
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to file a bug report.
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide exact steps so we can reproduce the issue.
+      placeholder: |
+        1. Go to ...
+        2. Click ...
+        3. Observe ...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What should have happened?
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      description: What happened instead?
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: Include OS, browser, Node.js version, and wallet details if relevant.
+      placeholder: macOS 14.4, Chrome 123, Node 22.2.0, Freighter
+    validations:
+      required: true
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional context
+      description: Logs, screenshots, links, or any extra information.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: LearnVault Discord
+    url: https://discord.gg/learnvault
+    about: Ask questions and discuss implementation details with the community.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,29 @@
+name: Feature request
+description: Suggest a new capability or improvement for LearnVault.
+title: "[Feature]: "
+labels:
+  - enhancement
+  - triage
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: What problem are you trying to solve?
+      placeholder: It is difficult to ... because ...
+    validations:
+      required: true
+  - type: textarea
+    id: proposed_solution
+    attributes:
+      label: Proposed solution
+      description: Describe the ideal implementation or behavior.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: What alternatives did you evaluate and why were they insufficient?
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/smart_contract.yml

@@ -0,0 +1,42 @@
+name: Smart contract issue
+description: Report or request a smart contract change.
+title: "[Contract]: "
+labels:
+  - smart-contract
+  - triage
+body:
+  - type: input
+    id: contract_name
+    attributes:
+      label: Contract name
+      description: Which contract is affected?
+      placeholder: CourseMilestone
+    validations:
+      required: true
+  - type: input
+    id: function_name
+    attributes:
+      label: Function name
+      description: Which function is involved?
+      placeholder: complete_course_milestone
+    validations:
+      required: true
+  - type: textarea
+    id: rust_error
+    attributes:
+      label: Rust error (if any)
+      description: Paste compiler/runtime error output.
+      placeholder: error[E0XXX]: ...
+    validations:
+      required: false
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction steps
+      description: Minimal steps to reproduce the issue.
+      placeholder: |
+        1. Run ...
+        2. Submit transaction ...
+        3. Observe ...
+    validations:
+      required: true

.github/pull_request_template.md

@@ -0,0 +1,30 @@
+## Summary of changes
+
+-
+
+## Related issue(s)
+
+Closes #NNN
+
+## Type of change
+
+- [ ] feat
+- [ ] fix
+- [ ] docs
+- [ ] refactor
+- [ ] test
+
+## Testing checklist
+
+- [ ] `npm run lint`
+- [ ] `npx tsc --noEmit`
+- [ ] `npm run build`
+- [ ] Added/updated tests where applicable
+
+## Screenshots (for UI changes)
+
+<!-- Add before/after screenshots or screen recordings. -->
+
+## Deployment notes (for contract changes)
+
+<!-- List migration steps, environment updates, or contract addresses. -->

.github/workflows/contracts-ci.yml

@@ -0,0 +1,42 @@
+name: Contracts CI
+
+on:
+  push:
+    paths:
+      - "contracts/**"
+  pull_request:
+    paths:
+      - "contracts/**"
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  contracts:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Add wasm target
+        run: rustup target add wasm32v1-none
+
+      - name: Cache cargo and target
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: ". -> target"
+
+      - name: Build contracts
+        run: cargo build --target wasm32v1-none --release
+
+      - name: Run tests
+        run: cargo test
+
+      - name: Run clippy
+        run: cargo clippy -- -D warnings
+
+      - name: Check formatting
+        run: cargo fmt --check

.github/workflows/frontend-ci.yml

@@ -0,0 +1,50 @@
+name: Frontend CI
+
+on:
+  push:
+    paths:
+      - "src/**"
+      - "package.json"
+      - "vite.config.ts"
+  pull_request:
+    paths:
+      - "src/**"
+      - "package.json"
+      - "vite.config.ts"
+
+jobs:
+  frontend:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Prettier check
+        run: npx prettier --check src/
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload build artifact
+        if: success()
+        uses: actions/upload-artifact@v4
+        with:
+          name: frontend-dist
+          path: dist
+          if-no-files-found: error

.github/workflows/preview-comment.yml

@@ -0,0 +1,34 @@
+# .github/workflows/preview-comment.yml
+name: Preview deployment comment
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  comment-preview-url:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+    steps:
+      - name: Wait for Vercel preview
+        uses: patrickedqvist/wait-for-vercel-preview@v1.3.1
+        id: vercel_preview
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          environment: Preview
+          max_timeout: 120
+
+      - name: Post preview URL comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `🚀 **Preview deployed!**\n\n${process.env.PREVIEW_URL}\n\n> Built against Stellar Testnet`
+            })
+        env:
+          PREVIEW_URL: ${{ steps.vercel_preview.outputs.url }}
+