Oliver/social-reporting-tool
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

README: document the cd /opt/social-reporting && git pull && cutover-in-place flow

Browse source 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
DJP 2026-04-29 18:40:55 -04:00
parent 5770b2579d
commit 6785cd396d
1 changed files with 22 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
README.md
View file

@ -12,6 +12,28 @@ npm run pipe seed --report <brief-id>
For the full V2 spec see [DEVELOPER_BRIEF_V2.md](./DEVELOPER_BRIEF_V2.md).
## Deploying V2 over an existing V1 install
If V1 is already deployed at `/opt/social-reporting`, cut over in place:
```bash
ssh you@optical-dev.oliver.solutions
cd /opt/social-reporting
git pull origin main # pulls in v2/, removes V1 dirs
bash v2/deploy/cutover-in-place.sh # stops V1, migrates secrets, starts V2
```
The script prompts before doing anything destructive, migrates
APIFY/Anthropic/Azure secrets from V1's `.env` into a fresh `v2/.env`,
swaps the Apache conf to V2's, and starts the V2 docker stack. It also
prompts for the email that will be auto-promoted to super-admin on first
SSO sign-in (`BOOTSTRAP_SUPER_ADMIN_EMAIL`).
The Azure-registered redirect URI
`https://optical-dev.oliver.solutions/social-reports/login.html` is
preserved by V2 (Vite `base: /social-reports/`, React Router basename,
and an explicit `/login.html` route alias).
## V1 archive
V1 source is preserved on the `v1-archive` branch (frozen at the last V1