Admin portal/panel (#7)

Co-authored-by: veekshitha Nelluru <177645260+Veekshitha11@users.noreply.github.com>

Author: Ishankoradia

README.md

@@ -31,11 +31,40 @@ dalgo/
 │   ├── docker-compose.yml        ← production
 │   └── docker-compose.dev.yml    ← local dev
 └── scripts/
-    └── sync.sh        ← pull latest from individual repos (transition period)
+    ├── install-hooks.sh  ← run once after cloning to install git hooks
+    └── hooks/pre-commit  ← the hook (black + prettier + eslint on staged files)
 ```
 
 ---
 
+## Contributing
+
+### One-time setup after cloning
+
+```bash
+./scripts/install-hooks.sh
+```
+
+This installs a git pre-commit hook that runs automatically on every `git commit`:
+
+| Service | Tool | Behaviour |
+|---|---|---|
+| `backend/` | black | auto-formats and re-stages |
+| `prefect-proxy/` | black | auto-formats and re-stages |
+| `webapp/` | prettier | auto-formats and re-stages |
+| `webapp/` | eslint | check only — fix errors manually |
+
+**Auto-formatting:** black and prettier rewrite files in place and re-stage them, so your commit always lands clean. If prettier or black reformats something, just re-run `git commit` — the second attempt will pass.
+
+**ESLint errors:** fix them manually, then commit again. Warnings are also blocked (`--max-warnings=0`) to stay in sync with CI.
+
+### Requirements
+
+- `uv` — for backend/prefect-proxy black ([install](https://docs.astral.sh/uv/getting-started/installation/))
+- `node` + `npm` — for webapp prettier/eslint (node_modules must be installed: `cd webapp && npm install`)
+
+---
+
 ## Docker setup
 
 All compose commands run from the `docker/` directory.
@@ -81,72 +110,6 @@ docker compose -f docker-compose.dev.yml up -d --no-deps backend
 
 ---
 
-## Updating service code (transition period)
-
-Two scripts handle keeping the monorepo in sync with the individual repos while they're still active.
-
-### `scripts/bootstrap.sh` — full re-import with complete git history
-
-Rebuilds the monorepo from scratch: clones all four repos, rewrites their history into the correct subdirectory paths, merges them together, and commits the monorepo Docker infra on top.
-
-```bash
-# Rebuild locally
-./scripts/bootstrap.sh
-
-# Rebuild and force-push to origin/main in one step
-./scripts/bootstrap.sh --push
-```
-
-After a `--push`, teammates sync with:
-```bash
-git fetch --force && git reset --hard origin/main
-```
-
-**When to use:** when you want the monorepo to fully reflect the latest commits (and history) from all individual repos — e.g. before archiving the individual repos, or after a batch of changes has landed across multiple services.
-
-**Requires:** `brew install git-filter-repo`
-
----
-
-### `scripts/sync.sh` — lightweight code sync (no history rewrite)
-
-Pulls the latest code from each repo via rsync. Faster than bootstrap — caches clones in `.sync-cache/` so subsequent runs only fetch new commits. Does **not** touch `docker/`.
-
-```bash
-# Sync all services
-./scripts/sync.sh
-
-# Sync one service
-./scripts/sync.sh backend
-
-# Review what changed, then commit
-git diff --stat
-git add -A && git commit -m "sync: $(date +%Y-%m-%d)"
-```
-
-**When to use:** for routine day-to-day syncing between bootstraps — pulls latest code and `.env` files without rewriting history.
-
----
-
-### Which to use when
-
-| Scenario | Script |
-|---|---|
-| Catch up on a batch of changes, preserve per-commit history | `bootstrap.sh --push` |
-| Quick pull of latest code between bootstraps | `sync.sh` |
-| Final sync before archiving individual repos | `bootstrap.sh --push` |
-
-### Source repo → monorepo directory mapping
-
-| Source repo | Monorepo dir |
-|---|---|
-| `DalgoT4D/DDP_backend` | `backend/` |
-| `DalgoT4D/webapp_v2` | `webapp/` |
-| `DalgoT4D/prefect-proxy` | `prefect-proxy/` |
-| `DalgoT4D/ai-llm-service` | `ai-llm-service/` |
-
----
-
 ## Adding / changing Docker config
 
 All Dockerfiles and compose files live in `docker/`. Changes here do not affect the individual repos.