# TAX Vertical Working README

Date: 2026-06-12

TAX is the Zweispace vertical AI token folder for tax policy intelligence, Japan and global tax monitoring, lawyer-reviewed workflows, corporate transactions, real estate acquisition/divestment, and portfolio-affecting tax news.

## Current files

- `index.html` - first browser-ready public showing page.
- `jp/index.html` - Japanese public page for `https://tax.zweichain.net/jp/`.
- `mstyle.css` - page styling.
- `assets/tax-policy-intelligence-hero.png` - generated hero visual for the showing page.
- `assets/tax-social-card.png`, `assets/tax-social-square.png`, app icons, and favicon files - SMS/social preview kit.
- `metadata/tax.token.json` - draft token metadata, not deployed.
- `metadata/metamask-watch-asset.template.json` - wallet watch-asset payload template.
- `app/` - local SQLite MVP for member intake, tax/deal cases, loan/funding requests, and JSON status.
- `contracts/` - TAX ERC-20 contract.
- `scripts/`, `test/`, `hardhat.config.ts`, `package.json` - Hardhat deployment and verification workspace.
- `deploy/` - nginx, systemd, and static verification templates.
- `DEPLOYMENT.md` and `TOKEN-LAUNCH-RUNBOOK.md` - live-system and token launch runbooks.
- `tax-vertical-brief.md` - working vertical strategy and product frame.
- `TAX-token-guardrails.md` - token and professional-scope guardrails.
- `tax-news-feed-plan.md` - first feed taxonomy for global tax signals.
- `source-notes.md` - internal notes and public/private wording boundaries.

## Local MVP

Run:

```powershell
.\app\run-local.ps1
```

Open:

```text
http://127.0.0.1:8787/
```

The MVP uses SQLite at `app/data/tax_mvp.db` and stores professional member prospects plus case intake for tax, accounting, real estate, M&A, loan, funding, capital raising, and portfolio-tax workflows.

It also exposes TAX token utility endpoints:

- `/api/token-config`
- `/api/token-events`

Token events are off-chain workflow ledger rows until a real Zweichain deployment is available.

## Contract workspace

Install dependencies when ready:

```powershell
npm install
```

Then:

```powershell
npm run test
npm run check:env:private
npm run deploy:private
npm run verify:private
npm run check:env:public
npm run deploy:public
npm run verify:public
```

The token contract is `contracts/TAXToken.sol`: fixed-supply ERC-20, permit support, treasury owner, and pause/unpause. There is no future mint function in v1.

## Positioning

TAX should not be presented as generic accounting automation. The edge is tax-policy interpretation and tax-law decision support:

- Japanese tax reform and 税制改正大綱 literacy.
- Professional review by tax lawyers, zeirishi, accountants, and local specialists.
- Corporate M&A, restructuring, real estate, investment, development, divestment, and portfolio decisions.
- Loan application, capital raising, and investor-readiness support where tax, accounting, and finance intersect.
- Global tax news that changes after-tax economics.

## Public claim boundary

Public pages should say:

> TAX is AI-assisted tax policy intelligence and decision support reviewed by qualified professionals.

Public pages should not say:

> AI replaces tax lawyers, zeirishi, accountants, or official tax advice.

Public pages should also avoid naming private team credentials, former government roles, law-firm board roles, or client relationships until each person and firm has cleared the exact wording.

## Next build steps

1. Confirm domain target, likely `tax.zweichain.net`.
2. Confirm whether the PR TIMES reference can be linked and what exact Japanese wording is approved.
3. Add a real Japan tax-policy watchlist with official URLs.
4. Create first sample memo: `2026-tax-reform-watch-sample.md`.
5. Draft intake forms for M&A, real estate, and portfolio tax-news review.
6. Keep token use as internal/service credits until legal review clears any public token language.
7. Deploy TAX to private Zweichain staging, then public Zweichain only after environment, treasury, and legal checks.