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>
65 lines
2.8 KiB
Markdown
65 lines
2.8 KiB
Markdown
---
|
|
title: Home
|
|
tags: [mortgagefi, moc]
|
|
type: moc
|
|
status: stable
|
|
updated: 2026-06-14
|
|
---
|
|
|
|
# 🌾 MortgageFi — Documentation Vault
|
|
|
|
> [!info] This is an [Obsidian](https://obsidian.md) 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`
|
|
|
|
## Related
|
|
[[Architecture]] · [[API Reference]] · [[Deployment]] · [[Development]] · [[Security Audit]] · [[Performance Audit]] · [[Project Audit 2026-06]]
|