mirror of
git://f0xx.org/ac/ac-ms-url-shortener
synced 2026-07-29 02:18:23 +03:00
44 lines
1.2 KiB
Markdown
44 lines
1.2 KiB
Markdown
# Contributing — url-shortener
|
|
|
|
Standalone service. **All API and deploy code changes happen in this repository**, not as loose files in the android_cast monorepo.
|
|
|
|
**Remote:** `git://f0xx.org/androidcast_project/url-shortener`
|
|
**Default branch:** `next`
|
|
|
|
## Workflow
|
|
|
|
```bash
|
|
cd backend/url-shortener # when cloned as submodule
|
|
git checkout next
|
|
git pull origin next
|
|
|
|
# develop …
|
|
./scripts/run-php-tests.sh
|
|
export BEARER=… ./scripts/smoke_shorten.sh
|
|
|
|
git add -A
|
|
git commit -m "your message"
|
|
git push origin next
|
|
```
|
|
|
|
Then in the **android_cast** parent repo:
|
|
|
|
```bash
|
|
cd ../.. # monorepo root
|
|
git add backend/url-shortener
|
|
git commit -m "Bump url-shortener submodule"
|
|
git push origin <branch>
|
|
```
|
|
|
|
## Deploy (BE)
|
|
|
|
See [DEPLOY.md](DEPLOY.md). Sync this tree to `/var/www/localhost/htdocs/apps/s/` — no crashes-console PHP required for the public API.
|
|
|
|
## Hub admin
|
|
|
|
Operator UI (mint bearer, list links) is in the monorepo: `examples/crash_reporter/backend/?view=short_links`. That code talks to the same MariaDB `url_shortener` schema; it is **not** part of this repo.
|
|
|
|
## Docs
|
|
|
|
Normative SPEC/DR live in the monorepo (`docs/specs/20100611_3_url_shortener.md`). This repo ships implementation + OpenAPI + deploy snippets only.
|