TapPass Internal

Internal handbook for the TapPass team. Not for customers.

Your first day

New-hire onboarding Two-week ramp: accounts, cloning the monorepo, first PR, first on-call shadow.

How we work Meetings, rituals, comms, decision records, PR etiquette.

FAQ Questions new hires ask, answers Jens types too often on Slack.

Glossary Internal terms and product vocabulary.

Architecture overview The mental model you need to reason about TapPass.

Data model Postgres schema, the tables that matter, common read-only queries.

Pipeline step anatomy How steps work end-to-end. Write one, wire it, test it.

Frontend architecture React 19 + Tailwind + Radix. State, routing, styling conventions.

Local setup Clone → first governed call in about 15 minutes.

Coding conventions Style, structure, error handling, review norms.

Testing What runs where, real Postgres for integration, MockTransport for HTTP.

Debugging Local + production. Audit trail is ground truth.

Database & migrations Alembic, zero-downtime patterns, indexing rules.

Feature flags Lifecycle, naming, and how to actually remove them.

Release process How code gets from main to production. Rollback procedures.

Deployments Service map and per-service reference.

Monitoring & alerts Dashboards, thresholds, SLOs, on-call workflow.

Incident response Severity levels, status doc template, postmortem template.

Access control Who has access to what, provisioning, offboarding.

Secret management Where secrets live, rotation, never-do list.

Audit trail internals Hash chain, signatures, checkpoints — the compliance story under the hood.

Compliance program GDPR, EU AI Act, SOC 2 roadmap. What we tell auditors.

Pricing & plans Public plans, internal floor, discount authority — confidential.

OEM / White-label Reselling TapPass under a partner brand.

Tool stack Every SaaS we use, with access notes and deliberate exclusions.

Team directory Who owns what. Ping the right person the first time.

Runbooks Rotate keys, restore backup, escalate customer, incident response.

Code review Checklist, approval levels, how to disagree.

Source: github.com/tappass/docs-internal. Every page is a markdown file under src/content/docs/. Ship a PR — it auto-deploys on merge.

If you’re looking for something that isn’t here yet, write it. The best time to capture knowledge is the moment you learn it.