Welcome
Getting started
Section titled “Getting started”Audience: Anyone brand-new to the Portal project.
- TL;DR tour – 5-minute overview of the architecture, core user journeys and the tech stack.
- Local setup – from cloning the repo to the first successful
php artisan test. - Glossary – key terms (e.g. “Care Package”, “Service Group”, “RCTI”).
- Who to ask – Teams channels, usual reviewers and team rituals.
Our ways of working
Section titled “Our ways of working”How we collaborate and ship.
- Cadence – daily stand ups, fortnightly sprints with retros and planning.
- Discovery and Design process – how do uncover requirements and shape the solution.
- Definition of Ready / Done – what each ticket must tick before dev starts and before merge.
- Branching & releases – Gitflow-light (
main,dev,release/*). - Code review etiquette – one approvals, tests and lints must pass.
- Incident response – TBA.
Onboarding
Section titled “Onboarding”Step-by-step path for new joiners (devs, designers, QA or PMs).
- Day 1 – hardware, access, mandatory training.
- Week 1–2 – first ticket/design and pair-programming slots.
- Useful links – HR forms, leave policies, expense claims.
- Onboarding for engineers
- Onboarding for QA
- Onboarding for designers
Infrastructure
Section titled “Infrastructure”Where and how the Portal runs.
- Environments –
dev,staging,mainand others on AWS. - CI/CD – GitHub Actions → Envoyer → deployed
- Secrets & config – TBC.
- Observability stack – Sentry, CloudWatch Logs.
- Data stores – Aurora MySQL, S3 for documents, Redis for queues/cache.
Design
Section titled “Design”- Design system – colour tokens, typography scale, component library (Figma + Storybook).
- UX guidelines – accessibility (WCAG 2.1 AA), responsive grids, form validation patterns.
- Research vault – persona cards, journey maps, past usability test videos.
Engineering
Section titled “Engineering”- Tech stack – Laravel 12, Vue 3 with Inertia.js, TypeScript, Tailwind.
- Key domains – Billing, Documents, Reporting, Admin.
- Coding standards – PSR-12, Laravel Pint preset, ESLint/Prettier.
- Testing – Pest for PHP, Vitest for Vue, end-to-end Playwright suite.
- Performance – TBC.
- Test pyramid – unit, service, E2E proportions and tooling.
- Release checklist – regression pack, accessibility spot-checks, smoke tests.
- Bug triage process – severity matrix and SLA.
- Test data – anonymised fixtures and seeders.
- Reporting – Xray dashboards and weekly quality metrics.
Product
Section titled “Product”- Vision & OKRs – how the Portal supports Trilogy Care’s strategic goals.
- Roadmap – next two quarters at a glance (link to Productboard).
- Feature flags – naming convention and rollout stages.
- User feedback loops – NPS surveys, support ticket tagging, community calls.
- Analytics – Posthog analytics, retention cohorts, key product metrics.