Files

Siavash Sameni 6ae581ab2e feat(ui): Ghibli/Miyazaki reskin + Obsidian docs vault + project audit

UI: warm daylight design system (Tailwind v4 @theme palette, gh-* component
classes, watercolor grain, Zen Maru Gothic + Klee One fonts), animated SSR-safe
GhibliBackground (drifting clouds, meadow hills, soot sprites), and a full reskin
of navbar, connect button, dapp page, loan cards, settings modal, and readme.
Fixes the bg-white-on-dark loan-card inconsistency. Web3/business logic untouched.

Docs: converted docs/ into an Obsidian vault (frontmatter, [[wikilinks]],
callouts, Home MOC, folders Architecture/Operations/Audits) and added a
full-project audit note (Project Audit 2026-06). Redacted a real leaked Schedy
key value from the security audit example (rotate it at Schedy).

Also commits the previously-untracked server layer: app/api (cron + tasks routes)
and lib (redis, ssrf-guard, task-store).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-14 08:13:53 +04:00

2.8 KiB

Raw Blame History

title, tags, type, status, updated

title

🌾 MortgageFi — Documentation Vault

[!info] This is an Obsidian vault Open the docs/ folder as a vault to get backlinks, the graph view, and live [[wikilinks]]. Every note carries YAML frontmatter (title, tags, type, status, updated) so you can query it with Dataview.

MortgageFi is a decentralized mortgage-lending platform. Users deposit ERC-721 collateral into audited debt vaults, borrow stablecoins against crypto collateral (cbBTC, WETH, WBTC), pay down debt on-chain to extend liquidation timers, and receive email/push alerts before liquidation.

🗺️ Map of Content

Architecture

Architecture — system overview, component diagrams, data flows
API Reference — REST endpoints for nftcache, the scheduler, and ntfy

Operations

Deployment — Docker Compose, Vercel, and standalone deploys
Development — local setup, adding chains, testing, troubleshooting
Migration Notes — library/version upgrade notes & rollback plan
Alert Changes — notification & scheduling behaviour history

Audits

Security Audit — findings, severities, remediations
Performance Audit — bottlenecks and optimization opportunities
Project Audit 2026-06 — current full-project health review

🧭 Architecture at a glance

┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
│   Next.js   │────▶│  Scheduler API   │────▶│    ntfy     │
│   Frontend  │     │  (Vercel + Redis)│     │(push/email) │
└──────┬──────┘     └──────────────────┘     └─────────────┘
       │
       ▼
┌─────────────┐     ┌─────────────┐
│  nftcache   │────▶│  Blockchain │
│(NFT scanner)│     │(Base/Arb)   │
└─────────────┘     └─────────────┘

🧱 Tech stack

Component	Technology
Frontend	Next.js 16, React 19, TypeScript, Tailwind CSS 4, wagmi 3
NFT Cache	Go 1.22, BadgerDB
Scheduler	Next.js API Routes, Upstash Redis
Notifications	ntfy (self-hosted)
Proxy	nginx
Orchestration	Docker Compose

🏷️ Tag index

#mortgagefi · #architecture · #api · #ops · #audit · #security · #performance

Architecture · API Reference · Deployment · Development · Security Audit · Performance Audit · Project Audit 2026-06

2.8 KiB Raw Blame History