---
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]]