docs: make Timeweb production source of truth
This commit is contained in:
parent
5f6e00c49b
commit
2817717efd
37
README.md
37
README.md
@ -3,23 +3,44 @@
|
|||||||
Caterium catering SaaS frontend with Supabase backend.
|
Caterium catering SaaS frontend with Supabase backend.
|
||||||
|
|
||||||
## Production
|
## Production
|
||||||
Current Cloudflare Worker: `ancient-sound-04ab`
|
|
||||||
|
|
||||||
Cloudflare publishes **only `public/`**. SQL, Edge Functions, tests and documentation are not web-accessible.
|
Primary production URL: `https://app.caterium.ru`
|
||||||
|
|
||||||
|
Production frontend is hosted on Timeweb Cloud App Platform:
|
||||||
|
- repository: `pavlov346346-source/caterium-app`
|
||||||
|
- branch: `production`
|
||||||
|
- publish directory: `public`
|
||||||
|
- auto deploy: enabled for `production`
|
||||||
|
|
||||||
|
`main` is the integration branch. GitHub Actions runs the full Caterium QA workflow for each push to `main`. Only a successful QA run may promote the verified commit to `production`.
|
||||||
|
|
||||||
|
The Cloudflare Worker `ancient-sound-04ab` is retained only as a fallback. It is not the primary production target and must not replace the Timeweb deployment unless an intentional fallback procedure is being used.
|
||||||
|
|
||||||
## Deploy checks
|
## Deploy checks
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
npm install
|
npm ci
|
||||||
|
npm audit --audit-level=high
|
||||||
npm run check:deploy
|
npm run check:deploy
|
||||||
npm run test:e2e
|
npm run test:e2e
|
||||||
```
|
```
|
||||||
|
|
||||||
## Cloudflare Git deployment
|
The QA workflow performs these checks automatically. High/critical npm audit findings block promotion.
|
||||||
- Build command: `npm run check:deploy`
|
|
||||||
- Deploy command: `npx wrangler deploy`
|
## Cloudflare fallback
|
||||||
- Production branch: `main`
|
|
||||||
- Root directory: `/`
|
Use Cloudflare only as a backup deployment target. Manual fallback deployment is available as:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run deploy:cloudflare-backup
|
||||||
|
```
|
||||||
|
|
||||||
|
When configuring Git-based Cloudflare fallback deployment, use the verified `production` branch rather than `main` so the fallback receives the same QA-approved commit as Timeweb.
|
||||||
|
|
||||||
## Backend
|
## Backend
|
||||||
|
|
||||||
Supabase Edge Functions are versioned under `supabase/functions/`.
|
Supabase Edge Functions are versioned under `supabase/functions/`.
|
||||||
SQL migration/history files live under `ops/sql/`.
|
SQL migration/history files live under `ops/sql/`.
|
||||||
|
Database DDL changes should be applied as migrations and kept in repository history.
|
||||||
|
|
||||||
|
See `TIMEWEB-APP-PLATFORM.md` for the production hosting checklist.
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user