pplops

Lightweight R&D coordination: lead plans and reports; members query tasks and update progress.

Prerequisites

• Node.js 20+ and pnpm
• Python 3.11+ and uv

Setup

cd app
uv sync
pnpm install

Development

pnpm dev

• Web (Vite HMR): http://127.0.0.1:5173
• API (Uvicorn reload): http://127.0.0.1:8765 (not 8000 - Windows often blocks 8000 with WinError 10013)
• OpenAPI: http://127.0.0.1:8765/docs

After changing API routes, regenerate the web client types:

pnpm generate

Ensure the API is running when you run pnpm generate (or use a saved openapi.json).

Database

Default development: SQLite at app/pplops.db.

cd app
uv run alembic upgrade head
uv run python -m api.seed

Project layout

• app - FastAPI, SQLAlchemy, Alembic (authoritative API) + Typer CLI + shared schemas
• web - React, Vite, TanStack Query
• app/api - HTTP API (FastAPI)
• app/cli - CLI commands (Typer)
• app/schemas - shared enums and Pydantic schemas

External tools or automation should call the HTTP API (/docs, OpenAPI).

CLI

set PPLOPS_TOKEN=<jwt>
cd app
uv run pplops req-list
uv run pplops export-md -o snapshot.md