Skip to content

docs: refresh README (stack, contracts, roadmap, status) - #267

Merged
Sendi0011 merged 5 commits into
mainfrom
docs/readme-refresh
Sep 5, 2026
Merged

docs: refresh README (stack, contracts, roadmap, status)#267
Sendi0011 merged 5 commits into
mainfrom
docs/readme-refresh

Conversation

@Sendi0011

Copy link
Copy Markdown
Contributor

Refreshes the README to reflect the current state of the repo. Chain of 5 focused commits:

  1. Repo provenance – all 6 stale Sendi0011/Joint_Save refs (badge, clone, issues, discussions, footer) + 2 in ARCHITECTURE.md point to JointSave-org/Joint_Save
  2. Stack accuracy – Next.js 14 → 16, Node 18+/npm → Node 20+/pnpm, install/dev commands updated to match frontend/package.json and the pnpm-managed repo
  3. Contract suite + CI badges – Deployed Contracts table now explains the 8-contract suite vs. the 4 recorded testnet deployments; added frontend-unit and Playwright badges (deploy.yml stays badge-less as it's manual-only)
  4. Roadmap refresh – Phase 1 marked complete (reputation, microloan, DAO governance, USDC/multi-token + CCTP, scheduling, notifications, incident-response all shipped); remaining work rescooped into accurate Phase 2/3
  5. Architecture + Current Status – real on-chain/off-chain split described; new section honestly states deployment state, the Vercel re-link, CI coverage, and gaps tracked in [Feature] Admin incident-review and pause-authorization UI for the security circuit breaker #261/[Feature] Admin self-service emergency controls (manual pause/resume and emergency_withdraw) with SEP-53 signature proof #263

No product code or config changed — docs only. All new links verified to resolve; the 2 broken links that remain (LICENSE, docs/transactions-screenshot.png) pre-date this branch.

Closes: none (docs only)

…t_Save

The README badge, clone URL, issue/discussion links, and the footer all
pointed at the personal Sendi0011/Joint_Save repo, matching the same
provenance mix-up seen in the Vercel project link. Point every repository
reference at the canonical JointSave-org/Joint_Save so contributors fork,
submit issues, and check CI against the right repo.
The README advertised Next.js 14 and npm, but the codebase and CI run
Next.js 16, React 19 and pnpm (the packageManager field pins pnpm, and every
workflow uses pnpm install --frozen-lockfile). Update the stack section,
prerequisites and quick start so setup instructions match how the repo is
actually built, tested and deployed.
Add badges for the frontend unit-test and Playwright E2E workflows so the
header reflects all automated checks (deploy.yml stays badge-less as it is
manual-only), and correct the Deployed Contracts section: the repo ships 8
contracts but only factory + rotational/target/flexible WASM have recorded
testnet deployments. Clarify that governance/microloan/yield-strategy have
no recorded deployment and that microloan/reputation are feature-gated via
their NEXT_PUBLIC_*_CONTRACT_ID env vars.
…work

Phase 1 is complete — mark reputation, microloan, DAO governance, USDC/
multi-token (SEP-41) with CCTP, flexible scheduling, push notifications,
pool health, archival, disputes, and incident-response as shipped. Rescope
Phase 2 to the actual remaining work (DeFi liquidity wiring for the
scaffolded yield-strategy contract, protocol-wide analytics, group
messaging, mainnet hardening for the unrecorded governance/microloan/
yield-strategy deployments, and the admin emergency console) and move mainnet
deployment out of Phase 3, which now focuses on fiat rails, social features,
and native mobile.
Replace the stale four-contract description with the real lightweight
on-chain/off-chain split (factory + pool + supporting contracts, Next.js
frontend, Supabase, incident-response safeguards), and add a Current Status
section that honestly states what is deployed to testnet, that governance/
microloan/yield-strategy have no recorded deployment, the Vercel re-link
situation, the four CI workflows, and open gaps tracked in issues #261/#263.
@Sendi0011
Sendi0011 merged commit c6cc38c into main Sep 5, 2026
6 checks passed
@Sendi0011
Sendi0011 deleted the docs/readme-refresh branch September 5, 2026 17:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant