Guides (Help & Informational Content)

Guides (Help & Informational Content)

Who this is for: admins, PMs, sales/GTM, new hires.

What a Guide is

A “Guide” is an authored informational/landing page, built from a series of content blocks, that bundles multiple services together under one theme (for example, a guide aimed at a specific audience or campaign). Patients browse a hub of published guides on their dashboard and can add whichever bundled services apply to them directly from a guide.

Authoring and approval workflow

1. An admin creates a guide and adds content blocks to it (title, subtitle, description, a “value” figure/unit for highlighting savings, a cover image, and the services it bundles).
2. A guide can be featured on the patient homepage.
3. Guides move through a status lifecycle: draft, submitted for review, approved (published), or rejected — with a record kept of who submitted/approved/rejected it and any reviewer comments.
4. Only a super admin can access the guides-authoring screen in the care portal.
5. Patients only ever see guides in “published” status.

Patient feedback on guides

Patients can leave feedback directly on a guide (separate from the case-completion review flow in Reviews & feedback).

Open questions

• No separate general FAQ/help-center section (distinct from Guides) was found in either portal’s code — if one exists, it wasn’t located in this pass.

Where this comes from

• parkingmd-care-portal/src/server/db/schema.ts (guides, guideBlocks)
• parkingmd-care-portal/src/app/(main)/admin/guides/page.tsx, .../guides/[id]/page.tsx
• parkingmd-care-portal/src/app/api/guides/route.ts, .../guides/[id]/route.ts, .../guides/[id]/review/route.ts, .../guides/[id]/feedbacks/route.ts, .../guides/feedbacks/route.ts
• parkingmd-patient-portal/src/app/(dashboard)/guides/page.tsx, .../guides/[slug]/page.tsx
• parkingmd-patient-portal/src/components/guides/GuideHub.tsx