remove legacy backend stack and stale deployment docs after rebuild

This commit is contained in:
2026-02-23 23:43:33 -05:00
parent 6012dd3fcf
commit 2987ac06fa
40 changed files with 38 additions and 3163 deletions

View File

@@ -1,30 +1,16 @@
# Fiscal Clone 3.0 (Turbopack Rebuild)
# Fiscal Clone 3.0
Ground-up rebuild into a single Next.js 16 application that runs with Turbopack and internal API routes.
Turbopack-first rebuild of a fiscal.ai-style terminal with OpenClaw integration.
## What changed
## Stack
- Removed hard runtime dependency on the external backend for core app workflows.
- Added internal `app/api/*` services for watchlist, portfolio, filings, tasks, and health.
- Added durable local data store at runtime (`frontend/data/store.json`).
- Added async task engine with retry support for:
- `sync_filings`
- `refresh_prices`
- `analyze_filing`
- `portfolio_insights`
- Added OpenClaw integration through OpenAI-compatible `/v1/chat/completions`.
- Enforced Turbopack for both development and production builds.
- Next.js 16 App Router
- Turbopack for `dev` and `build`
- Internal API routes (`app/api/*`)
- Durable local task engine and JSON data store
- OpenClaw/ZeroClaw analysis via OpenAI-compatible chat endpoint
## Architecture
- `frontend/`: full app (UI + API + task engine)
- `frontend/app/api/*`: route handlers
- `frontend/lib/server/*`: storage, task processors, SEC/pricing adapters, OpenClaw client
- `frontend/data/store.json`: generated local runtime state (git-ignored)
The legacy `backend/` folder is retained in-repo but no longer required for the rebuilt local workflow.
## Run
## Run locally
```bash
cd frontend
@@ -32,9 +18,9 @@ npm install
npm run dev
```
Open: [http://localhost:3000](http://localhost:3000)
Open [http://localhost:3000](http://localhost:3000).
## Build (Turbopack)
## Production build
```bash
cd frontend
@@ -42,18 +28,21 @@ npm run build
npm run start
```
## OpenClaw setup
## Environment
Set in environment (for example `frontend/.env.local`):
Use root `.env` or `frontend/.env.local`:
```env
# leave blank for same-origin API
NEXT_PUBLIC_API_URL=
OPENCLAW_BASE_URL=http://localhost:4000
OPENCLAW_API_KEY=your_key
OPENCLAW_MODEL=zeroclaw
SEC_USER_AGENT=Fiscal Clone <support@fiscal.local>
```
If OpenClaw is not configured, the app falls back to local analysis responses so task flows remain testable.
If OpenClaw is unset, the app uses local fallback analysis so task workflows still run.
## API surface