# AssetFlow

> Real estate investment tracker with AI-powered investor protection

## About

AssetFlow is a web application for retail real estate investors. It provides portfolio tracking, payment management (both incoming investments and outgoing loans), return calculations, and AI-powered investor protection through Shield.

**Business:** Assets Flow (bootstrapped startup, solo founder)
**Website:** https://assetsflow.work
**Contact:** victor@assetsflow.work
**Status:** Beta with paying users, Paddle integration live

## Features

### Portfolio Tracking
- Track multiple real estate investment properties
- Support for both investments (incoming payments) and loans (outgoing payments)
- Multi-currency support with exchange rate integration
- Property details: location, type, status, investment dates

### Return Calculations
- **IRR** (Internal Rate of Return) — time-weighted return on invested capital
- **TWR** (Time-Weighted Return) — removes impact of cash flows
- **Cash-on-Cash** — annual cash income divided by total invested
- **Cap Rate** — net operating income divided by property value
- Methodology documented at [/legal/en/re-methodology.html](https://assetsflow.work/legal/en/re-methodology.html)

### Shield — AI Investor Protection
Three-layer protection system for real estate investors:
1. **Registry Verification** — Checks investment platforms and developers against FCA (UK), ISA (Israel), SEC (USA), GLEIF, California SOS, New York Socrata, SAM.gov warning lists and registries
2. **Media Monitoring** — GDELT and CourtListener integration for adverse media and legal proceedings
3. **LLM Risk Analysis** — Claude-powered analysis of investment risk, defamation-guardrail protected reports

### Other Features
- Payment calendar with monthly/weekly/daily views
- Statistics dashboard with investment vs loan tracking
- PDF report generation
- Hebrew (default) and English localization

## Pricing

| Plan | Price | Properties | Shield Reports |
|------|-------|-----------|----------------|
| Free | $0/mo | 2 max | — |
| Premium | $9.99/mo | Unlimited | 10/month |
| Professional | $19.99/mo | Unlimited | Unlimited |

See [pricing page](https://assetsflow.work/pricing.html) for full details.

## API & Agent Resources

### Static Resources (no auth required)

| Resource | URL | Description |
|----------|-----|-------------|
| Agent Skills Index | `/.well-known/agent-skills/index.json` | Machine-readable skill definitions (agentskills.io schema) |
| MCP Server Card | `/.well-known/mcp/server-card.json` | Model Context Protocol server metadata |
| API Catalog | `/.well-known/api-catalog` | RFC 8288 linkset of discoverable resources |
| OAuth Protected Resource | `/.well-known/oauth-protected-resource` | RFC 9728 resource metadata |
| auth.md | `/auth.md` | Full authentication guide for AI agents |
| Sitemap | `/sitemap.xml` | Site structure |
| Pricing | `/pricing.html` | Plan details |
| Terms | `/legal/terms.html` | Terms of Service |
| Privacy | `/legal/privacy.html` | Privacy Policy |
| Refund | `/legal/en/refund.html` | Refund Policy |
| Blog | `https://blog.assetsflow.work` | Articles and updates |

### Protected Resources (auth required)

- Investment portfolio data (properties, payments, returns)
- Shield investor protection reports and risk analysis
- User profile and settings

## Authentication

Protected APIs use Firebase ID tokens. See [auth.md](https://assetsflow.work/auth.md) for the full authentication flow and OAuth discovery endpoints.

## Technical Stack

- React 19 + TypeScript + Vite
- Tailwind CSS v4 + Zustand state management
- Firebase (Auth, Firestore, Cloud Functions, Hosting)
- Paddle (payments)
- Anthropic Claude (Shield LLM analysis)
- i18next (Hebrew + English, RTL support)