Files
mortgagefi-helper/docs/Home.md
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

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