# HW & YZ (匯萬盈兆)

> Own-capital research workbench for market data, watchlists, price alerts, research notes, and platform asset pricing signals.

HW & YZ (full name: Holistic Wealth & Yield Zenith; Chinese: 匯萬盈兆, "匯聚智慧，盈途無限") is a market-data and research workbench. The platform provides real-time stock market indices data (S&P 500, NASDAQ 100, Dow Jones, Hang Seng Index), foreign exchange and commodity tracking, a dollar-cost averaging (DCA) calculator, securities watchlists, price alerts, research notes, and own-capital performance records. HW & YZ does not accept client funds, manage accounts, place trades, provide personalised recommendations, or replace regulated professional advice.

## About

HW & YZ LLP is a UK-registered limited liability partnership. The team consists of six named members: H.W. Tung, Y.Z. Cheung, Hunt Chiu, Yucy Mung, Zane Yuen, and Colin Chow, each focused on market research, data modelling, research workflow, and record keeping. The partnership is part of the United Communities of Feking ecosystem and its technical infrastructure is provided by Vector Lab. (vrh.cc). Market data is sourced from providers including Alpha Vantage, Bloomberg, EOD, IEX Cloud, Intrinio, Morningstar, Quandl, Refinitiv, Xignite, and Yahoo Finance.

## Pages

- **Home** (`/en`, `/zh`) -- Landing page with partnership introduction, team member profiles, risk warning section, research-workbench features, data access plans, FAQ section, and contact form.
- **Authentication** (`/en/auth`, `/zh/auth`) -- Login page with SUUD single sign-on integration and guest browsing option.
- **Dashboard** (`/en/dashboard`, `/zh/dashboard`) -- Authenticated user dashboard containing:
  - Market indices display (S&P 500, NASDAQ 100, DJI, HSI) with real-time price data
  - Securities watchlist with stock prices and dates
  - CFD asset tracking with current forex and commodity prices (EUR/USD, GBP/USD, USD/JPY, USD/CHF, AUD/USD, USD/CAD, USD/HKD, Brent, WTI, XAU/USD)
  - Own-capital performance curve chart
  - DCA calculator for historical calculation and scenario review
  - Research notes, price alerts, and watchlist workflows

## Features

- **Market indices tracking**
  - Real-time data for S&P 500, NASDAQ 100, Dow Jones Industrial Average, and Hang Seng Index
  - Historical OHLC (open, high, low, close) price data stored and served from local database
  - Index data fetched and cached from Yahoo Finance API
- **DCA calculator**
  - Dollar-cost averaging calculation tool
  - Configurable parameters: start date, end date, amount, frequency (daily, weekly, monthly, quarterly, annually), and stock symbol
  - Calculates shares purchased, end value, and profit for review
  - Visual chart showing value over time using ApexCharts
  - Input validation for dates, amounts, and supported symbols
- **Watchlists and alerts**
  - Stock price watchlist with symbol, price, and date
  - Price alert rules, trigger history, and notification records
  - CFD asset tracking for major forex pairs and commodities
- **Research notes**
  - Structured notes for thesis, assumptions, risks, entry/exit plan, and result review
  - Public/private note flag for future research journal workflows
- **Currency and cryptocurrency data**
  - Currency price tracking with AUM and USD values
  - 24-hour price change tracking
  - Historical price data with date-indexed storage
- **Data access plans**
  - Standard: market data basics, limited tool access, community access, basic support
  - Premium: webinars, research workflow tools, research note templates, 24/5 support
  - Ultimate: expanded alert history, advanced data views, platform asset signals, 24/7 support
- **Risk and compliance warnings**
  - Prominent risk disclaimer on the homepage
  - Research, tools, and market data labelled as educational and illustrative only
  - No client-fund custody, account management, trade placement, or personalised recommendations
- **Contact form**
  - Form fields: first name, last name, email, phone, subject, message
  - Messages stored in database with language preference
- **Bilingual interface**
  - Full English and Traditional Chinese (Hong Kong) support
  - All UI, content, data access plans, and FAQs in both languages

## Technical Details

- Built with TanStack Start, React 19, Vite, and Nitro
- Bilingual: English (en) and Traditional Chinese - Hong Kong (zh)
- Authentication: SUUD OAuth2/OIDC with custom OAuth implementation
- Database: SQLite via Drizzle ORM
- Market data: yahoo-finance2 library for fetching financial data
- Charts: ApexCharts via react-apexcharts for value curves and market visualisations
- Blockchain: @solana/web3.js (Solana integration for cryptocurrency data)
- Styling: Tailwind CSS 4

## Data Models

- **Index Prices**: historical OHLC price data for stock market indices (symbol, date, open, high, low, close)
- **Currency Prices**: cryptocurrency and currency tracking (currency name, date, AUM price, USD price, 24h change)
- **Research Notes**: thesis, assumptions, entry/exit plan, risk assumptions, result review, visibility state
- **Price Alerts**: user watch rules, trigger history, notification state
- **Messages**: contact form submissions (name, email, subject, message, language)
- **User**: authenticated users managed via SUUD OAuth
- **Session**: user sessions with token and device tracking
- **Account**: OAuth account linking

## API Endpoints

- `/api/indices` -- Fetch stock market index data
- `/api/stock` -- Fetch individual stock price data
- `/api/currency` -- Fetch currency and cryptocurrency prices
- `/api/calculate` -- Run DCA calculations
- `/api/platform/assets` -- Retrieve platform asset pricing signals
- `/api/platform/currency` -- Retrieve platform currency data
- `/api/messages` -- Submit contact form messages
- `/api/ai` -- AI-assisted analysis endpoint
- `/api/csrf` -- CSRF token generation for form security

## Related Services

- Part of the United Communities of Feking ecosystem at ucf.plus
- Authentication via SUUD (suud.net), the centralised single sign-on platform
- VIP subscription billing managed through Bills (bills.su)
- Technical infrastructure provided by Vector Lab. (vrh.cc)

## Contact

- Website: https://hwyz.uk
- Social media: Facebook, LinkedIn, Twitter
- Parent organisation: Vector Lab. (https://vrh.cc)