Initial InfraPulse scaffold

docs/development.md

@@ -0,0 +1,39 @@
+# Development
+
+## Local Docker Stack
+
+```bash
+cp .env.example .env
+docker compose -f docker-compose.dev.yml up --build
+```
+
+The dev stack runs PostgreSQL, Redis, backend, worker, and frontend.
+
+## Backend
+
+Backend source lives in `backend/app`. Migrations live in `backend/alembic`.
+
+Useful commands from `backend/`:
+
+```bash
+alembic upgrade head
+uvicorn app.main:app --reload
+```
+
+## Frontend
+
+Frontend source lives in `frontend/src`.
+
+Useful commands from `frontend/`:
+
+```bash
+npm install
+npm run dev
+```
+
+## Tests and Checks
+
+```bash
+./scripts/lint.sh
+./scripts/test.sh
+```