ac-ms-url-shortener/CONTRIBUTING.md

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

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:

cd ../..   # monorepo root
git add backend/url-shortener
git commit -m "Bump url-shortener submodule"
git push origin <branch>

Deploy (BE)

See 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.