growqr-app/docs
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: initial docs repo with project inventory and all documentation

Browse Source 
- Added REPO_INVENTORY.md with all repos, branches, remotes, and staging info
- Added .gitignore
- Synced all existing docs from local workspace
- Centralized documentation hub for GrowQR team
This commit is contained in:
-Puter
2026-06-22 15:04:27 +05:30
commit e6685203fe
71 changed files with 35044 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
services_prd/MATCHMAKING ENGINE.docx.md
+407
View File
File diff suppressed because one or more lines are too long
services_prd/Marketplace_BRD.docx.md
+584
View File
@@ -0,0 +1,584 @@
**GrowQR**
**MARKETPLACE**
**DEVELOPER BRD — TECHNICAL SPECIFICATION**
Career Services Platform • Verified Providers • 5 Delivery Formats • v1.0 • March 2026
| Marketplace Microservice This document contains specifications, business logic, and acceptance criteria required for development. |
| :---: |
| Document Title | Marketplace — Developer BRD Technical Specification |
| :---- | :---- |
| Version | 1.0 — March 2026 |
| :---- | :---- |
| Service Type | Standalone Microservice — Career Services Supply Layer |
| :---- | :---- |
| Provider Types | GrowQR-Certified Coaches | Verified Senior Users | Corporate Firms | GrowQR In-House |
| :---- | :---- |
| Delivery Formats | Live 1:1 Video | Async Review | Group Workshop | Done-For-You | Retainer Package |
| :---- | :---- |
| Pricing Model | Provider sets price freely — GrowQR takes commission % (rate TBD — business decision pending) |
| :---- | :---- |
| Discovery | Open browsing \+ Pathway-triggered smart recommendations |
| :---- | :---- |
| Mentors Relationship | Marketplace is the supply layer. Mentors (11-service) \= curated subset drawn from Marketplace providers. |
| :---- | :---- |
| Innovation Features | Supply Seeding | Outcome Guarantee | Q-Score Verified Results | Group Demand Aggregation | Pre-Booking Engine |
| :---- | :---- |
| 1\. EXECUTIVE SUMMARY |
| :---- |
GrowQR Marketplace is a verified career services platform where professionals offer paid services to GrowQR users. It operates as a standalone microservice and serves as the supply layer for the entire GrowQR platform — including the Mentors service within the 11-service pathway model.
Unlike generic freelance marketplaces, every provider on GrowQR Marketplace is validated and approved before going live. Services are directly aligned to career development needs: interview preparation, resume building, social branding, job search coaching, domain guidance, and more.
Users discover providers through open browsing and through intelligent recommendations surfaced by the Pathways engine based on their Q-Score gaps and current cycle phase.
## **1.1 Marketplace vs Mentors — Architectural Relationship**
| Marketplace and Mentors are not the same thing. Marketplace is the full open platform of verified providers. Mentors is a curated, GrowQR-selected subset of Marketplace providers that is surfaced inside a user’s active pathway cycle. A provider must first be listed on Marketplace before they can be selected as a Mentor. |
| :---- |
| Dimension | Marketplace | Mentors (11-Service) |
| :---- | :---- | :---- |
| Access | Any verified GrowQR user can browse and book freely | Surfaced by Pathways engine at scheduled cycle touchpoints |
| Provider selection | User chooses any available provider | GrowQR curates and recommends based on pathway match |
| Pricing | Provider sets price; GrowQR takes commission | May be subsidised or coin-redeemable within pathway |
| Booking trigger | User-initiated at any time | Pathway-triggered (monthly touchpoint) |
| Provider pool | All validated Marketplace providers | Curated subset hand-picked by GrowQR from Marketplace |
| Session format | All 5 formats available | Primarily live 1:1 and retainer |
| 2\. PROVIDER TYPES & VALIDATION |
| :---- |
Four provider types are permitted on the Marketplace. All must complete GrowQR’s validation process before their profile goes live. Validation criteria vary by provider type.
| Provider Type | Description | Validation Requirements |
| :---- | :---- | :---- |
| GrowQR-Certified External Coach | Independent coaches and mentors certified by GrowQR through an internal accreditation process | Application \+ credentials review \+ sample session evaluation \+ GrowQR certification badge awarded |
| Verified Senior User | Experienced GrowQR platform users (typically 5+ years in their domain) who apply to offer services to peers | Minimum Q-Score thresholds \+ experience verification \+ portfolio review \+ GrowQR approval |
| Corporate / Institutional Provider | Coaching firms, HR consultancies, universities, and training organisations offering team or individual services | Business registration \+ service catalogue review \+ compliance check \+ signed provider agreement |
| GrowQR In-House Expert | GrowQR staff or contracted experts offering services directly on the platform | Internal onboarding only — no external validation required |
## **2.1 Provider Validation Flow**
| Step | Action | System Behaviour | Outcome |
| :---- | :---- | :---- | :---- |
| 1 | Provider submits application | Application form: personal/company info, domain expertise, credentials, work samples, service types intended | Application record created with status: Pending Review |
| 2 | GrowQR review | Internal team reviews credentials, samples, and profile completeness | Status updated: Under Review |
| 3 | Sample session (coaches only) | Applicant completes a 20-min sample session with a GrowQR reviewer | Session scored on rubric; pass/fail recorded |
| 4 | Decision | GrowQR approves or rejects | Approved: profile activated. Rejected: reason sent, reapplication permitted after 30 days |
| 5 | Profile build | Provider builds their Marketplace profile, sets services, prices, availability | Profile status: Draft until published |
| 6 | Go live | Provider publishes profile | Profile visible to all users; eligible for pathway recommendations |
## **2.2 Provider Profile Contents**
* Full name and professional photo
* Domain expertise tags (e.g. Software Engineering, Product Management, Sales, Marketing)
* Years of experience and career highlights
* Services offered: format, duration, price per service
* Portfolio: sample work, case studies, testimonials
* Certifications and credentials (verified badge shown if GrowQR-certified)
* Availability calendar: real-time slots for live sessions
* Response time indicator for async services
* Rating and review history (post-launch, populated by completed bookings)
* Total sessions completed and repeat booking rate
| 3\. SERVICE CATEGORIES |
| :---- |
Marketplace services are organised into categories aligned to GrowQR’s career development modules. Providers list their services under one or more categories. The Pathways engine uses category tags to surface relevant provider recommendations.
| Category | Services Included | GrowQR Module Alignment |
| :---- | :---- | :---- |
| Interview Preparation | Mock interviews, interview strategy coaching, role-specific interview practice, pre-interview briefing sessions | Upskills — Practice / Interview Service |
| Resume & Cover Letter | Resume review, resume rewrite, cover letter writing, ATS optimisation, LinkedIn profile review | Opportunity — Resume & Cover Letter Service |
| Social & Personal Branding | LinkedIn profile overhaul, content strategy, personal brand audit, thought leadership coaching | Opportunity — Social Branding Service |
| Career Coaching | Career direction coaching, career change strategy, goal-setting sessions, career identity clarity | Pathways — General Guidance |
| Job Search Strategy | Job search planning, application strategy, recruiter outreach coaching, salary negotiation prep | Opportunity — Job Matchmaking |
| Domain & Industry Guidance | Sector-specific career advice, industry entry coaching, domain skill gap guidance | Pathways — Domain Mapping |
| Skills Development Coaching | Personalised skill-building plans, learning roadmap sessions, soft skills coaching | Upskills — Courses / Roleplay |
| Entrepreneurship & Business | Startup mentoring, business validation sessions, founder coaching, side-hustle guidance | Pathways — Entrepreneurial Builder Archetype |
| Academic & Graduate Guidance | University application coaching, graduate programme strategy, first-job preparation | Pathways — Student Persona |
| 4\. FIVE SERVICE DELIVERY FORMATS |
| :---- |
Every service listed on Marketplace must be assigned to one of five delivery formats. Each format has distinct booking flows, delivery requirements, and completion criteria.
| ▶ FORMAT 1: LIVE 1:1 VIDEO SESSION |
| :---- |
| User books a specific time slot from the provider’s availability calendar |
| Duration options set by provider: 20 min / 30 min / 45 min / 60 min / 90 min |
| Session conducted via GrowQR’s integrated video tool (or provider-specified link) |
| Booking confirmed: calendar invite sent to both parties; reminder notifications at 24hr and 1hr before |
| Session recording: optional, requires consent from both parties before session starts |
| Post-session: provider submits session notes within 24hrs; user prompted to leave a review |
| Completion triggered: when session end time is reached or provider marks as complete |
| Cancellation policy: enforced per platform rules (see Section 8\) |
| ⏱ FORMAT 2: ASYNC REVIEW |
| :---- |
| User submits material for review: resume, LinkedIn profile URL, cover letter, portfolio, or other document |
| Provider has a defined turnaround time (set at listing creation): 24hrs / 48hrs / 72hrs |
| Provider delivers feedback as: annotated document, written report, or recorded video walkthrough |
| User receives notification when feedback is delivered |
| User can submit one follow-up question within 48hrs of receiving feedback (included in service) |
| Completion triggered: when provider marks delivery as complete |
| Suitable for: Resume reviews, LinkedIn audits, portfolio feedback, cover letter reviews |
| 👥 FORMAT 3: GROUP SESSION / WORKSHOP |
| :---- |
| Provider creates a group session with defined: topic, date/time, max participants (cap set by provider), price per seat |
| Users browse upcoming sessions and book individual seats |
| Minimum participant threshold: provider sets minimum number required for session to run (e.g. 3 of 10 seats) |
| If minimum not met 24hrs before session: session cancelled, all users refunded automatically |
| Session conducted via GrowQR’s integrated group video tool |
| Session recording available to all attendees for 7 days post-session (default) |
| Post-session: all attendees prompted to review; provider receives aggregate rating |
| Suitable for: Industry panels, skill workshops, cohort coaching, webinars |
| ✅ FORMAT 4: DONE-FOR-YOU SERVICE |
| :---- |
| Provider delivers a completed work product on behalf of the user |
| User submits brief: role target, key achievements, tone preferences, and any existing materials |
| Provider sets delivery timeline at listing creation: 3 days / 5 days / 7 days |
| Provider submits first draft to user via platform messaging |
| User entitled to: 1 revision request within 5 days of first draft delivery |
| Final delivery marked complete by user or auto-completed after 5 days of no response |
| Suitable for: Resume writing, cover letter writing, LinkedIn profile rewrite, bio writing |
| Quality review applies to this format (see Section 8 — Dispute Resolution) |
| 📅 FORMAT 5: RETAINER / MULTI-SESSION PACKAGE |
| :---- |
| Provider offers a structured package: defined number of sessions over a defined period |
| Examples: 4 sessions over 4 weeks / 8 sessions over 2 months / 12 sessions over 3 months |
| Full package price paid upfront at booking; provider cannot change price after booking |
| Scheduling: individual sessions booked by user within the package period using provider’s availability |
| Unused sessions: if package period expires with unused sessions, partial refund issued per platform policy |
| Suitable for: Ongoing career coaching, job search accountability, skill development programmes |
| This format feeds directly into the Mentors (11-service) model for Tier 3 pathway users |
| 5\. PRICING & COMMISSION MODEL |
| :---- |
| Commission rate is a business decision pending final approval. The BRD specifies the commission architecture and enforcement logic. The actual percentage must be confirmed by the business team before development of the payments module. |
| :---- |
## **5.1 Pricing Model**
Providers set their own prices freely for all services and packages. GrowQR does not restrict pricing. The platform takes a commission percentage from each completed transaction. This model follows the Fiverr/Upwork approach and incentivises providers to price competitively.
| Pricing Rule | Detail |
| :---- | :---- |
| Provider sets price | No minimum or maximum enforced by platform at v1. Provider enters price at service listing creation. |
| Price displayed to user | User sees the full price inclusive of all platform fees. No hidden charges. |
| Commission deducted | GrowQR commission deducted from provider payout at the point of transaction completion. Rate: TBD. |
| Provider payout | Net amount (price minus commission) transferred to provider. Payout schedule: TBD by business team. |
| Currency | Platform handles transactions in the user’s regional currency. Currency conversion logic: TBD. |
| Refunds | Refund amount returned to user in full. GrowQR absorbs commission on refunded transactions. |
| Package pricing | Retainer packages priced as a single total. Commission applied to full package value at booking. |
## **5.2 Commission Architecture**
| Commission Component | Specification |
| :---- | :---- |
| Commission rate | TBD — Business decision pending. To be confirmed before payments module development. |
| Commission trigger | Commission deducted when: session marked complete / async delivery accepted / done-for-you final delivery confirmed |
| Dispute hold | If dispute raised, commission held in escrow until resolution. Released to GrowQR on dispute closure. |
| Refund handling | On full refund: GrowQR absorbs commission. On partial refund: commission recalculated on net completed value. |
| Provider dashboard | Provider sees: gross earnings, commission deducted, net payout, pending transactions, payout history |
| 6\. DISCOVERY & RECOMMENDATION ENGINE |
| :---- |
Users find Marketplace providers through two complementary mechanisms: open browsing with search and filters, and intelligent recommendations surfaced by the GrowQR Pathways engine based on Q-Score gaps and current pathway cycle phase.
## **6.1 Open Browsing**
* Marketplace homepage: featured providers, recently added, top-rated, trending by category
* Search bar: free-text search by provider name, skill, service type, or keyword
* Filter panel: Category, Delivery format, Price range, Rating (min stars), Availability (date range), Provider type (certified/verified/corporate/in-house), Duration
* Sort options: Relevance, Price (low to high / high to low), Rating, Most booked, Newest
* Provider card view: photo, name, top category, rating, price from, verified badge, quick-book button
* Provider profile page: full details, all services listed, availability calendar, reviews, portfolio
## **6.2 Pathway-Triggered Smart Recommendations**
* Pathways engine analyses user’s current Q-Score gaps and active cycle phase
* Matches gaps to Marketplace service categories and provider specialisms
* Surfaces up to 3 recommended providers per relevant category at the right cycle moment
* Recommendation card shown in: Pathway dashboard, weekly cycle task list, and Marketplace homepage (personalised section)
* Example triggers:
* User Q-Score CQm below target → recommend Interview Prep or Social Branding providers
* User entering Job Matching phase (Week 4+) → recommend Resume & Cover Letter providers
* User archetype: Entrepreneurial Builder → surface Entrepreneurship & Business coaching providers
* User’s pathway milestone: first interview booked → recommend pre-interview 1:1 session
* Pathway recommendations are suggestions only — user is never forced to book and can dismiss
## **6.3 Mentors Pool Selection**
* GrowQR internal team curates the Mentors pool from active, high-rated Marketplace providers
* Selection criteria: minimum rating threshold, minimum sessions completed, active availability, domain alignment to GrowQR archetypes
* Mentors pool reviewed and updated monthly
* Providers are not informed of their Mentor pool status — it does not change their Marketplace listing
* When Pathways engine surfaces a Mentor touchpoint in a user’s cycle, it draws exclusively from the Mentors pool
| 7\. BOOKING & SESSION MANAGEMENT |
| :---- |
## **7.1 Booking Flow**
| Step | User Action | System Response | Data Captured |
| :---- | :---- | :---- | :---- |
| 1 | User selects service from provider profile | Display service details, price, available slots (live) or turnaround time (async) | Service ID, User ID |
| 2 | User selects slot / submits brief | Live: calendar slot picker. Async/Done-For-You: brief submission form. Group: seat selection. | Slot / brief / seat preference |
| 3 | Payment | User completes payment. Amount shown in full before confirmation. | Payment intent created; transaction ID |
| 4 | Confirmation | Booking confirmed. Calendar invite sent (live sessions). Confirmation email to both parties. | Booking ID, status: Confirmed |
| 5 | Delivery | Provider delivers service per format requirements | Completion event sent to system |
| 6 | Completion | User confirms receipt (or auto-completed per format rules) | Status: Completed; commission triggered |
| 7 | Review | User prompted to leave rating and written review (optional but encouraged) | Rating, review text, timestamp |
## **7.2 Booking States**
| State | Condition | System Behaviour |
| :---- | :---- | :---- |
| Pending | Payment initiated but not confirmed | Hold slot/seat; release if payment not confirmed within 10 minutes |
| Confirmed | Payment successful | Send confirmations; add to provider’s schedule; notify user |
| In Progress | Session started or delivery underway | Timer active for live sessions; turnaround clock active for async |
| Delivered | Provider marks delivery complete | Notify user; start 5-day acceptance window (async/done-for-you) |
| Completed | User confirms or acceptance window expires | Release commission; prompt review; update provider stats |
| Disputed | User raises dispute before completion | Hold commission; escalate to GrowQR review team |
| Cancelled | Cancelled by user or provider per policy | Refund processed per cancellation policy; slot released |
| No-Show | Provider does not attend live session | Auto-refund issued; provider strike recorded |
## **7.3 Cancellation Policy**
| Cancellation Timing | User Refund | Provider Payout |
| :---- | :---- | :---- |
| More than 24hrs before live session | Full refund | No payout |
| Less than 24hrs before live session | 50% refund | 50% payout (late cancellation fee) |
| No-show by user | No refund | Full payout to provider |
| No-show by provider | Full refund \+ platform credit | No payout \+ strike recorded |
| Async/Done-For-You: cancelled before provider starts | Full refund | No payout |
| Async/Done-For-You: cancelled after provider starts | No refund | Full payout |
| Group session: cancelled by platform (min not met) | Full refund to all attendees | No payout to provider |
| 8\. QUALITY ASSURANCE & DISPUTE RESOLUTION |
| :---- |
GrowQR operates a two-layer quality model: proactive quality review (before and during provider listing) and reactive dispute resolution (after a service is delivered). Both mechanisms are required at v1, particularly given the Done-For-You service format.
## **8.1 Proactive Quality Controls**
| Control | Description | Applies To |
| :---- | :---- | :---- |
| Provider validation | All providers pass GrowQR’s approval process before any service goes live | All provider types |
| Sample session review | Coaches and mentors complete a graded sample session before certification | GrowQR-certified coaches |
| Listing review | All service listings reviewed by GrowQR team before publishing. Listings that misrepresent scope rejected. | All service formats |
| Ongoing rating monitoring | Providers with average rating below 3.5 stars (from minimum 5 reviews) flagged for review | All providers |
| Dispute rate monitoring | Providers with dispute rate above 10% of total sessions placed on probation and reviewed | All providers |
| Re-validation | Providers inactive for 6+ months must re-validate before re-activating their listing | All providers |
## **8.2 Dispute Resolution Process**
| Step | Timeframe | Action |
| :---- | :---- | :---- |
| 1\. User raises dispute | Within 5 days of delivery | User selects dispute reason from defined list: Service not delivered / Quality significantly below description / Provider no-show / Other |
| 2\. System holds commission | Immediate | Commission held in escrow. Provider notified of dispute. |
| 3\. Provider responds | Within 48hrs | Provider submits response and any supporting evidence via platform messaging |
| 4\. GrowQR review | Within 3 business days | GrowQR review team assesses dispute, evidence, and delivery record |
| 5\. Resolution | Within 5 business days total | GrowQR issues decision: Full refund / Partial refund / No refund \+ commission released to provider |
| 6\. Appeals | Within 48hrs of decision | Either party may appeal once. Final decision issued within 3 additional business days. No further appeals. |
## **8.3 Dispute Reasons Defined**
* Service not delivered: Provider did not deliver within stated timeframe and did not communicate
* Quality significantly below description: Delivered work materially does not match the service listing
* Provider no-show: Live session not attended by provider without prior notice
* Scope mismatch: Provider delivered something outside the agreed service scope
* Technical failure: Session could not proceed due to platform technical issue (GrowQR liability — auto-refund)
## **8.4 Provider Strike System**
| Strike Event | Action |
| :---- | :---- |
| 1 no-show | Warning issued. Recorded on provider account. |
| 2 no-shows OR 1 upheld dispute | Formal warning. 7-day listing suspension. Mandatory response to GrowQR review team. |
| 3 no-shows OR 2 upheld disputes | Listing suspended. Full re-validation required before reinstatement. |
| 4 strikes of any type | Permanent removal from Marketplace. Provider cannot reapply. |
| 9\. INTEGRATION WITH GROWQR PLATFORM |
| :---- |
| Integrated Service | Data Shared | Direction | Purpose |
| :---- | :---- | :---- | :---- |
| Pathways Service | User Q-Score gaps, current cycle phase, archetype | Pathways → Marketplace | Drives pathway-triggered provider recommendations |
| Pathways Service — Mentors | Curated mentor pool (provider IDs, domain tags, archetypes) | Marketplace → Pathways | Feeds the Mentors touchpoint in pathway cycles |
| Wallet / Rewards | Coin balance, transaction events | Marketplace → Wallet | Enables coin-subsidised bookings |
| Notification Service | Booking confirmations, reminders, delivery alerts, dispute updates | Marketplace → Notify | Push, email, and in-app notifications for all booking events |
| Dashboard Service | Bookings count, sessions completed, providers reviewed | Marketplace → Dashboard | Updates user’s activity summary and achievement tracking |
| Assessment Service | Q-Score gap profile | Assessment → Marketplace | Used by recommendation engine to match service category to skill gaps |
| User Profile Service | Verified user status, Q-Score profile, pathway tier | Profile → Marketplace | Controls access; verifies eligibility to book services |
| 10\. INNOVATION FEATURES — MARKET FAILURE PREVENTION |
| :---- |
Five structural innovations are built into the Marketplace to prevent the cold start problem and drive sustainable supply-demand balance. These features are first-principles differentiators — no competing career marketplace offers all five simultaneously.
| The cold start problem is the primary cause of marketplace failure: providers will not list if there are no users, and users will not come if there are no providers. Each innovation below directly addresses a specific failure mode. |
| :---- |
## **10.1 Supply Seeding from GrowQR’s Own Platform**
Problem solved: Empty marketplace at launch — no providers, no trust signals, no bookings.
GrowQR’s own Tier 3 Premium users who complete their pathway and achieve a verifiable outcome (job placement, promotion, career pivot) are the first provider candidates. They have three things no external recruit has: a verified GrowQR success story, measurable Q-Score improvement data, and platform credibility.
**How it works:**
* System monitors pathway completions and outcome events (job landed, promotion recorded, career pivot confirmed)
* Users who meet the threshold (pathway completed \+ Q-Score improvement of 15+ points \+ outcome verified) are flagged as Provider Candidates
* GrowQR sends a targeted invitation: “You went from Q-Score 45 to 78 and landed a Senior PM role in 3 months. Help others do the same — earn from your experience.”
* Invited users enter a fast-track validation flow (abbreviated — platform activity serves as credential verification)
* First cohort of providers seeded before public Marketplace launch
**System Requirements:**
* Pathway Service must emit outcome events to Marketplace microservice
* Candidate flagging logic: pathway\_completed \= true AND q\_score\_delta ≥ 15 AND outcome\_event received
* Fast-track provider application flow: reduced steps, platform data pre-fills credentials
* Provider profile auto-populates: Q-Score improvement stats, pathway completed badge, outcome verified badge
## **10.2 Outcome Guarantee Tier**
Problem solved: User trust — why pay for a service when I don’t know if it will work?
Providers who opt in to the Outcome Guarantee tier commit to a defined, measurable outcome for the user. If the outcome is not achieved within the agreed timeframe, the user receives a partial refund. This is structurally impossible on any other career marketplace because no other platform can measure outcomes the way GrowQR can via Q-Scores.
**Outcome types by service category:**
| Service Category | Outcome Definition | Timeframe | Refund if Unmet |
| :---- | :---- | :---- | :---- |
| Interview Preparation | User receives at least 1 interview invitation within 30 days of session | 30 days post-session | 50% refund |
| Resume & Cover Letter | User’s resume ATS score improves by defined threshold (measured in-platform) | Immediate on delivery | Full refund |
| Social Branding | User’s LinkedIn profile view count increases by 20%+ within 30 days | 30 days | 50% refund |
| Career Coaching | User Q-Score in target domain improves by 10+ points within 60 days | 60 days | 50% refund |
| Skills Development | User Q-Score in coached skill area improves by 8+ points within 45 days | 45 days | 50% refund |
**System Requirements:**
* Provider opts in at service listing level — not all services must be Outcome Guaranteed
* Outcome Guarantee badge displayed prominently on provider card and service listing
* System tracks outcome trigger events per booking: interview invitations, Q-Score reassessment results, LinkedIn analytics sync
* Automated outcome check at timeframe expiry: if outcome event not detected → refund triggered automatically
* Provider payout held in partial escrow for outcome guarantee period
* Providers with Outcome Guarantee badge ranked higher in search results and pathway recommendations
* New DB fields required: outcome\_guarantee (BOOL), outcome\_type, outcome\_timeframe\_days, outcome\_refund\_pct on marketplace\_services table
## **10.3 Q-Score Verified Results on Provider Profiles**
Problem solved: Fake or unverifiable reviews — the standard 5-star system is gamed on every marketplace.
Because GrowQR measures Q-Scores before and after every service interaction, provider profiles can display objective, platform-verified outcome data that no external marketplace can replicate. This makes GrowQR’s social proof structurally defensible.
**What is displayed on each provider profile:**
* Average Q-Score improvement across all clients (e.g. “Clients improved their CQm by an average of 18 points”)
* Q-Score improvement breakdown by domain (per service category)
* Number of verified Q-Score measurements (sample size shown for credibility)
* Comparison badge: “Top 10% of Interview Prep providers by client Q-Score improvement”
* Timeline chart: client Q-Score trajectory before and after working with this provider
**System Requirements:**
* Q-Score delta calculated per booking: compare user’s relevant Q-Score at booking date vs next reassessment date
* Attribution window: Q-Score improvement attributed to provider if reassessment occurs within 60 days of session completion
* Minimum sample size: Q-Score stats shown only after provider has 3+ completed bookings with Q-Score data
* Privacy: Q-Score data displayed as aggregated averages only — no individual user data exposed on provider profile
* New DB table required: marketplace\_qscore\_outcomes (booking\_id, provider\_id, q\_score\_name, score\_before, score\_after, delta, measurement\_date, attributed BOOL)
* Provider profile API must include q\_score\_stats object in response
## **10.4 Group Session Demand Aggregation Engine**
Problem solved: Providers fear empty calendars; individual booking volumes too low to sustain a provider’s time investment early in the platform lifecycle.
The Pathways engine actively aggregates demand for group sessions by matching pathway cycle phases across users. When a provider posts a group session, GrowQR pushes targeted notifications to all users whose current pathway cycle and Q-Score gaps align with that session’s topic — filling seats without the provider needing to do any marketing.
**How it works:**
* Provider creates a group session: topic, category, date/time, price per seat, max/min participants
* System identifies all active pathway users whose: current cycle week is 2–4 AND service category matches session topic AND Q-Score gap in relevant domain is ≥15 points
* Targeted push notification sent to matched users: “Based on your pathway, this session is recommended for you this week”
* Session also surfaced in weekly cycle task list as a recommended touchpoint
* Provider dashboard shows: seats filled, demand score (how many users were notified vs booked)
* If session reaches minimum participants early: “Almost full” urgency indicator shown to remaining matched users
**System Requirements:**
* Group session matching query: JOIN pathway\_weekly\_cycles \+ marketplace\_services on category \+ q\_score\_gap threshold
* Notification Service integration: targeted push/email per matched user with session details and booking link
* Pathway engine must expose current\_week and gap\_categories per active user for matching query
* Demand score tracking: notifications\_sent vs bookings\_converted per group session (for provider analytics)
## **10.5 Pre-Booking Engine**
Problem solved: Users disengage before they reach the stage where Marketplace is most valuable; providers have unpredictable and lumpy demand.
The Pre-Booking Engine allows users to reserve a provider slot in advance — at the moment the pathway cycle predicts they will need it — with no charge until 48 hours before the session. This locks future demand, fills provider calendars weeks in advance, and keeps users committed to their pathway progression.
**How it works:**
* When user activates a pathway, Pathways engine calculates future high-value Marketplace moments based on the weekly cycle schedule
* At those predicted moments (e.g. Week 3: user entering interview phase), system surfaces: “You’ll be ready for interview prep in 2 weeks. Book a top-rated coach now — no charge until 48hrs before.”
* User selects provider and slot — booking is held with zero payment captured
* 48 hours before session: payment captured automatically from saved payment method. User notified.
* Cancellation before 48hr window: no charge, slot released
* Cancellation within 48hr window: standard cancellation policy applies
* Provider sees pre-bookings in calendar as “Pending Payment” — slot is held and cannot be double-booked
**System Requirements:**
* New booking status: pre\_booked (slot held, payment not yet captured)
* Payment capture job: runs every hour, captures payment for pre\_booked sessions where slot\_datetime is within 48hrs
* Pathway engine must emit pre-booking suggestion events with predicted\_need\_week and service\_category
* Provider availability: pre\_booked slots shown as held in availability calendar — not available for other bookings
* User payment method must be saved at pre-booking time (card saved, no charge yet)
* New DB fields on marketplace\_bookings: booking\_type (standard/pre\_booked), payment\_capture\_scheduled\_at, payment\_captured\_at
| 10.6 ADDITIONAL DATABASE FIELDS — INNOVATION FEATURES |
| :---- |
| Table | Additional Fields for Innovation Features |
| :---- | :---- |
| marketplace\_services | outcome\_guarantee (BOOL default false), outcome\_type (enum), outcome\_definition (text), outcome\_timeframe\_days (INT), outcome\_refund\_pct (INT 0-100), outcome\_escrow\_days (INT) |
| marketplace\_bookings | booking\_type (enum: standard/pre\_booked), payment\_capture\_scheduled\_at (TIMESTAMP nullable), payment\_captured\_at (TIMESTAMP nullable), outcome\_check\_due\_at (TIMESTAMP nullable), outcome\_achieved (BOOL nullable) |
| marketplace\_providers | is\_seeded\_provider (BOOL), seed\_pathway\_id (FK nullable), seed\_q\_score\_delta (INT nullable), fast\_track\_validated (BOOL), q\_score\_avg\_improvement (DECIMAL), q\_score\_sample\_size (INT) |
| marketplace\_qscore\_outcomes | outcome\_id (PK), booking\_id (FK), provider\_id (FK), user\_id (FK), q\_score\_name, score\_before (INT), score\_after (INT), delta (INT), measurement\_date (DATE), attributed (BOOL), attribution\_window\_days (INT) |
| marketplace\_group\_demand | demand\_id (PK), service\_id (FK), users\_notified (INT), users\_booked (INT), notification\_sent\_at (TIMESTAMP), cycle\_week\_match (INT), gap\_category (VARCHAR) |
| 11\. ACCEPTANCE CRITERIA |
| :---- |
| \# | Acceptance Criterion | Pass / Fail |
| :---- | :---- | :---- |
| **1** | Provider application flow completes successfully for all four provider types. Application record created with correct status transitions: Pending → Under Review → Approved / Rejected. | \[ \] PASS \[ \] FAIL |
| **2** | Approved providers can build a profile and publish services. Unapproved providers cannot publish. Rejected providers cannot reapply for 30 days. | \[ \] PASS \[ \] FAIL |
| **3** | All five delivery formats (Live 1:1, Async, Group, Done-For-You, Retainer) can be created as service listings by providers and booked by users. | \[ \] PASS \[ \] FAIL |
| **4** | Open browsing returns correctly filtered and sorted provider results. All filter options (category, format, price, rating, availability, provider type) function correctly. | \[ \] PASS \[ \] FAIL |
| **5** | Pathway-triggered recommendations surface up to 3 relevant providers per category based on user Q-Score gaps and active cycle phase. Recommendations appear in Pathway dashboard and weekly cycle task list. | \[ \] PASS \[ \] FAIL |
| **6** | Booking flow completes for all five formats: payment processed, booking confirmed, calendar invite sent (live sessions), brief received (async/done-for-you), seat assigned (group). | \[ \] PASS \[ \] FAIL |
| **7** | All booking state transitions function correctly: Pending → Confirmed → In Progress → Delivered → Completed. | \[ \] PASS \[ \] FAIL |
| **8** | Cancellation policy enforced: correct refund and payout amounts calculated for each cancellation scenario. | \[ \] PASS \[ \] FAIL |
| **9** | Provider no-show triggers automatic full refund and strike recorded on provider account. | \[ \] PASS \[ \] FAIL |
| **10** | Dispute flow completes end-to-end: user raises dispute, commission held in escrow, provider notified, GrowQR review team receives escalation, resolution issued within 5 business days. | \[ \] PASS \[ \] FAIL |
| **11** | Strike system enforced: correct action taken at 1, 2, 3, and 4 strike thresholds. | \[ \] PASS \[ \] FAIL |
| **12** | Commission deducted correctly at transaction completion. Provider payout calculated as gross minus commission. Commission rate field configurable by admin (pending business decision on rate). | \[ \] PASS \[ \] FAIL |
| **13** | Group session auto-cancels and refunds all attendees if minimum participant threshold not met 24hrs before session. | \[ \] PASS \[ \] FAIL |
| **14** | Retainer packages: full amount charged at booking. Partial refund issued for unused sessions when package period expires. | \[ \] PASS \[ \] FAIL |
| **15** | Mentor pool API endpoint returns correctly curated provider subset. Pathways service can query by archetype and domain tag. | \[ \] PASS \[ \] FAIL |
| **16** | Provider dashboard shows gross earnings, commission deducted, net payout, pending transactions, and payout history accurately. | \[ \] PASS \[ \] FAIL |
| **17** | Review system: users can leave rating and review only after booking is marked Completed. Provider rating average updates correctly. Provider cannot review their own service. | \[ \] PASS \[ \] FAIL |
| **18** | Done-for-you 1-revision entitlement enforced: user can submit one revision request within 5 days of first draft. Second revision requests rejected. | \[ \] PASS \[ \] FAIL |
| **19** | Provider rating monitoring: providers below 3.5 stars (min 5 reviews) flagged in admin dashboard. Providers above 10% dispute rate flagged for review. | \[ \] PASS \[ \] FAIL |
| **20** | Supply Seeding: System correctly identifies Provider Candidates (pathway completed \+ Q-Score delta ≥15 \+ outcome event). Fast-track application flow pre-fills profile from platform data. Seeded provider badge displays on profile. | \[ \] PASS \[ \] FAIL |
| **21** | Outcome Guarantee: Providers can opt in per service listing. Outcome badge displays on provider card and listing. Outcome check job fires at timeframe expiry. Automated refund triggered correctly if outcome not detected. Partial escrow held and released correctly. | \[ \] PASS \[ \] FAIL |
| **22** | Q-Score Verified Results: q\_score\_outcomes table populated correctly with before/after scores attributed within 60-day window. Provider profile displays aggregated Q-Score improvement stats. Stats hidden until minimum 3 bookings with Q-Score data. No individual user data exposed. | \[ \] PASS \[ \] FAIL |
| **23** | Group Demand Aggregation: Matching query correctly identifies users whose cycle week and Q-Score gap align with group session topic. Targeted notifications sent to matched users. Demand score (notified vs booked) tracked per session and visible in provider dashboard. | \[ \] PASS \[ \] FAIL |
| **24** | Pre-Booking Engine: Pre-booked slots held in provider calendar and blocked from other bookings. Payment capture job fires correctly within 48hrs of session time. Cancellations before 48hr window result in zero charge. Pathway engine suggestion events surface pre-booking prompts at correct cycle weeks. | \[ \] PASS \[ \] FAIL |
| DOCUMENT APPROVAL |
| :---- |
| Product Owner | \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ Date: \_\_\_/\_\_\_/\_\_\_\_\_\_ |
| :---- | :---- |
| Tech Lead | \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ Date: \_\_\_/\_\_\_/\_\_\_\_\_\_ |
| :---- | :---- |
| Status: \[ \] APPROVED — Ready for development \[ \] REVISIONS NEEDED Comments: \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ |
| :---- |
services_prd/Pathways_BRD.docx.md
+278
View File
@@ -0,0 +1,278 @@
**GrowQR**
**PATHWAYS**
**MICROSERVICE SPECIFICATION**
Option A: LinkedIn / Resume-Based • Option B: Premium Psychometric • v4.0 • March 2026
| Pathway Microservice — Development Handover This document defines the business logic, user flows, and acceptance criteria for the Pathways service. |
| :---: |
| Service | Pathways — Career Development Orchestration Engine |
| :---- | :---- |
| Generation Options | Option A: LinkedIn / Resume scan | Option B: Psychometric \+ Q-Score (Premium) |
| :---- | :---- |
| User Tiers | Tier 1: Basic (Free) | Tier 2: Report (One-Time) | Tier 3: Premium (Subscription) |
| :---- | :---- |
| Platforms | LinkedIn— multi-country labour data: India, USA, Europe |
| :---- | :---- |
| Version | 4.0 — March 2026 |
| :---- | :---- |
| 1\. WHAT IS PATHWAYS? |
| :---- |
Pathways is the central orchestration engine of GrowQR. It takes a user’s background, interests, skills, and goals — and turns them into a personalised career development journey coordinated across all 11 GrowQR services.
**The core question Pathways answers:**
***“What else can I — given my personality, skills, and background — do and achieve in the world?”***
Not just: “What is the next job title in my current career?”
Pathways generates a wide range of career combination options — some expected, some surprising — based on who the user actually is, not just what their CV says. It then activates a structured journey to help them get there.
| What Pathways Does | What Pathways Is Not |
| :---- | :---- |
| Generates multiple career path options from the user’s profile and questionnaire | A simple job search tool |
| Orchestrates 11 services into weekly development cycles | A course platform or LMS |
| Produces a professional Pathway Report PDF | A static one-time plan |
| Adapts in real-time as Q-Scores improve and activities complete | A rigid 12-month roadmap |
| Surfaces live job market data by region (India, USA, Europe) | A recruitment agency |
| 2\. THE QUESTIONNAIRE FLOW |
| :---- |
Before any pathway is generated — whether Option A or Option B — the user completes a short questionnaire. This is the input layer that drives career combination generation. It is asking about experience, interests, and skills — but GrowQR goes further by combining this with profile data and Q-Scores.
| The questionnaire is designed to take 5–10 minutes maximum. Questions are conversational, not clinical. The goal is to surface what the user cares about and where they want to go — not to test them. |
| :---- |
**2.1 Questionnaire Structure — Four Steps (Most of it can be taken Linkedin or Resume)**
| STEP 1: PREVIOUS EXPERIENCE |
| :---- |
| What is your current or most recent job title? |
| How many years of professional experience do you have? (Student / 0–2 years / 3–5 years / 6–10 years / 10+ years) |
| Which industry or domain have you worked in most? (dropdown with multi-select) |
| What are 3–5 things you have done professionally that you are most proud of? (free text, short) |
| STEP 2: INTERESTS & WHAT ENERGISES YOU |
| :---- |
| Which of these activities energise you most? (multi-select from 12–15 options e.g. solving complex problems, leading people, building products, creating content, selling ideas, analysing data, coaching others, designing experiences) |
| What topics do you find yourself reading about or watching videos on outside of work? (free text) |
| Do you prefer working independently, in a team, or leading others? (single select) |
| What kind of environment brings out your best work? (e.g. fast-moving startup, large organisation, remote, client-facing) |
| STEP 3: SKILLS |
| :---- |
| What are your top 3–5 skills? (free text or tag selection from skill bank) |
| Which skills do you most want to develop in the next 12 months? (multi-select) |
| Are there any domains or tools you have taught yourself outside of formal education? (free text) |
| STEP 4: GOALS & DIRECTION |
| :---- |
| Where do you want to be in your career in 1–3 years? (free text) |
| What matters more to you right now — higher earnings, greater fulfilment, or a balance of both? (slider: 0% earnings / 100% fulfilment ↔ 100% earnings / 0% fulfilment) |
| Is there a specific role, company type, or industry you are aiming for? (optional, free text) |
| What is your biggest career challenge right now? (multi-select: lack of direction / skills gaps / not getting interviews / need to change industry / want to grow faster / starting from scratch) |
**2.2 What the Questionnaire Generates**
Once the four steps are complete, the system combines questionnaire responses with any available profile data (LinkedIn scan or resume) to generate:
* A wide range of career combination options — not just one or two obvious paths, but a broader set of possibilities the user may not have considered
* Each combination shows: role title, domain, match rationale, required skills, salary range (by region), and demand level
* Options are grouped by: Close Match (high overlap with current skills), Adjacent (moderate pivot), and Stretch (ambitious but achievable with development)
* The Visual Career Web is rendered from this output — showing the combinations as an interactive node map
* A Career Identity Statement is generated: 2–3 sentences summarising the user’s transferable value
| The questionnaire output feeds both Option A and Option B. For Option A users, it is the primary input. For Option B Premium users, it is combined with the psychometric assessment and full 25 Q-Score results for deeper personalisation. |
| :---- |
| 3\. VISUAL CAREER WEB |
| :---- |
The Visual Career Web is the primary output display of the questionnaire flow. Instead of showing career options as a plain list, it renders them as an interactive node diagram — the user’s current role or profile at the centre, with recommended career paths radiating outward.
**3.1 How It Works**
* Centre node: user’s current role or “Your Starting Point” if no current role
* Surrounding nodes: career path combinations grouped by Close Match, Adjacent, and Stretch
* Each node shows on hover or tap: role title, match %, salary range, demand level (High / Medium / Low)
* Clicking a node expands it: skill gaps, top courses, live job links, regional salary chart
* Filter bar: user can adjust weightings (skills match / salary priority / growth potential / interests alignment) — web re-renders
* Colour coding: Green \= high demand, Amber \= medium demand, Grey \= low demand or emerging
* Mobile: full interactive on desktop and tablet; card-stack view on mobile
**3.2 Tier-Gated Behaviour**
| Feature | Tier 1 Basic | Tier 2 Report | Tier 3 Premium |
| :---- | :---- | :---- | :---- |
| Career web visible | Yes — full web | Yes — full web | Yes — full web |
| Node expansion (full detail) | 2 nodes only, rest locked | All nodes | All nodes \+ Q-Score gap mapping |
| Live job links per path | 3 per node | 10 per node | Unlimited real-time |
| Salary data | Range only | Full chart | Full chart \+ regional comparison |
| Pathway activation | Locked — upgrade prompt | 1-month activation | 3 / 6 / 12-month activation |
| 4\. THREE-TIER USER MODEL |
| :---- |
Users enter at any tier. Each tier delivers real value. Higher tiers unlock deeper personalisation and longer pathway activation.
| | Tier 1: Basic | Tier 2: Report | Tier 3: Premium |
| :---- | :---- | :---- | :---- |
| Access | Free — no account required | One-time purchase | Subscription |
| Input | LinkedIn URL or resume upload \+ questionnaire | Same as Tier 1 | Psychometric assessment \+ 25 Q-Scores \+ questionnaire |
| Career Web | Full web, 2 nodes expandable | Full web, all nodes | Full web, all nodes \+ Q-Score mapping |
| Report | 2-section teaser PDF | Full 14–16 page PDF | Full PDF, auto-updates as progress made |
| Pathway Activation | None | 1 month — all 11 services | 3 / 6 / 12 months — all 11 services |
| Personalisation | Profile \+ questionnaire | Profile \+ questionnaire | Psychometric \+ Q-Score \+ questionnaire |
| Upgrade Prompt | Purchase Report or start Premium | Upgrade to Premium after 1 month | Ongoing — no further upgrade needed |
| 5\. TWO PATHWAY GENERATION OPTIONS |
| :---- |
Both options activate the full 11-service orchestration engine once a pathway is live. The difference is the depth of input used to personalise the pathway.
| OPTION A: BASIC — LinkedIn / Resume-Based Available to Tier 1, 2 and 3 as starting point • No psychometric required |
| :---- |
| Input: LinkedIn URL or uploaded resume (PDF / DOCX) \+ completed questionnaire (4 steps) |
| Parser extracts: current role, skills, work history, education, certifications, industry |
| Combined with questionnaire responses to generate career combination options |
| Career Identity Statement generated: 2–3 sentences of transferable value summary |
| Visual Career Web rendered: 3–5+ career path combinations across Close Match, Adjacent, Stretch |
| Skill gap analysis per path: which skills need development to reach each option |
| 4-week curriculum generated with specific course links mapped to skill gaps |
| Live job postings surfaced per path from regional job platforms |
| Regional labour market data applied: salary, demand, top hiring companies (India / USA / Europe) |
| Full Pathway Report PDF generated for Tier 2 and Tier 3 users |
| 1-month pathway activated for Tier 2\. 3/6/12-month pathway activated for Tier 3\. |
| OPTION B: PREMIUM — Psychometric \+ Q-Score Tier 3 only • Maximum personalisation • Scientifically validated |
| :---- |
| Input: Completed psychometric assessment (10–30 questions) \+ all 25 Q-Scores measured \+ questionnaire |
| Big Five personality profiling \+ behavioural analysis (work style, learning style, motivation drivers) |
| Algorithm: 60% psychometric weighting \+ 40% Q-Score weighting \+ questionnaire as contextual layer |
| User sets earnings vs. fulfilment ratio (slider) — adjusts pathway recommendations accordingly |
| Personality Archetype assigned: one of five (see Section 7\) |
| Three pathway options ranked: Primary (85%+ match), Alternative 1 (75–85%), Alternative 2 (65–75%) |
| User selects and activates one pathway — only one active pathway permitted at any time |
| Full 14–16 page Pathway Report PDF generated with archetype analysis, radar charts, and GrowQR branding |
| Weekly cycles generated across all 11 services for 3, 6, or 12 months |
| Adaptive engine: pathway adjusts in real-time as Q-Scores improve and services are completed |
| Monthly Q-Score reassessment; Report PDF auto-updated on significant score changes |
| 6\. 11-SERVICE ORCHESTRATION |
| :---- |
Pathways does not contain the 11 services. It is an orchestration layer that coordinates them through touchpoints. Once a user activates a pathway (Tier 2 or Tier 3), all 11 services are engaged in a structured weekly cycle. Suggestions:
| Service | Primary Skills Built | Cycle Frequency |
| :---- | :---- | :---- |
| 1\. Roleplay (LMS) | Communication, Emotional Intelligence, Influence | Weekly |
| 2\. Interview Practice | Analytical thinking, Communication, Leadership | Weekly |
| 3\. Courses | Technical, Domain, Business, Learning skills | Weekly — heavy in Month 1 |
| 4\. Assessment | All 25 Q-Scores measured | Week 1 baseline; monthly after |
| 5\. Resume & Cover Letter | Updated automatically as skills develop | As skills develop |
| 6\. Social Branding | Reputation, Influence, Networking, Marketing | Bi-weekly |
| 7\. Job Matching | All Q-Scores (matching layer) | Light Month 1; heavy Month 2+ |
| 8\. Events | Networking, Social, Cultural | 1–2 per month |
| 9\. Networking | Networking, Social, Influence | Weekly Month 1; bi-weekly after |
| 10\. Mentors | Learning, Growth, Vision, Leadership | Monthly sessions |
| 11\. Community | Social, Networking, Reputation | Bi-weekly |
**6.1 Six Weekly Cycle Rules \- Suggestions:**
| Rule | Description |
| :---- | :---- |
| Rule 1: Start with Assessment | Week 1 always begins with Q-Score baseline measurement. Cannot be skipped. |
| Rule 2: Core Services Weekly | Courses, Roleplay, and Interview Practice appear every week throughout the pathway. |
| Rule 3: Support Services Scheduled | Mentors monthly. Community bi-weekly. Networking weekly in Month 1, bi-weekly after. |
| Rule 4: Time Balance | Total weekly commitment: 2–3 hours. Hard cap: 3.5 hours. Prevents burnout. |
| Rule 5: Progression | Month 1: 60% Learn / 40% Apply. Month 2: 50/50. Month 3+: 30% Learn / 70% Apply. |
| Rule 6: Adaptive | Skipped service \= higher priority next week. Q-Score \+10 points \= advanced content unlocked. |
| 7\. PATHWAY REPORT — PDF SPECIFICATION |
| :---- |
The Pathway Report is a professionally designed PDF document generated for Tier 2 (one-time purchase) and Tier 3 (subscription). Tier 1 receives a 2-section teaser. The report is 14–16 pages, full colour, GrowQR branded.
| Section | Title | Contents |
| :---- | :---- | :---- |
| 1 | Your Personality Archetype | Archetype badge, top 5 Q-Scores with radar chart, what motivates you, how you work best |
| 2 | Career Path Recommendations | Primary path (85%+), Alternative 1 (75–85%), Alternative 2 (65–75%), comparison table |
| 3 | Skill Development Plan | Q-Score gap analysis, top 5 priority skills, course links, milestone checkpoints |
| 4 | Job Market Alignment | Demand indicator, salary range by experience (region-specific), top 15 companies hiring |
| 5 | Weekly Action Plan | Month 1 week-by-week calendar, 11-service touchpoint grid, monthly goals checklist |
| 6 | 11 Services Map | Each service: what it does, when to use, expected outcome |
| 7 | Progress Tracking | Q-Score trend chart, monthly snapshot, milestone checklist, application pipeline |
| 8 | Next Steps | Top 3 immediate actions, support resources, motivational close |
| 8\. FIVE PERSONALITY ARCHETYPES — OPTION B REFERENCE |
| :---- |
Used in Option B (Premium) only. Archetype is assigned based on Q-Score profile after psychometric assessment is complete.
| Archetype | Q-Score Thresholds | Typical Pathways |
| :---- | :---- | :---- |
| Technical Specialist | TQ ≥75, IQ ≥75, XQ ≥70, DQ ≥70 | Software Engineer, Data Scientist, Technical Architect |
| Strategic Leader | StQ ≥75, LdrQ ≥75, VQ ≥70, InQ ≥70, EQ ≥70 | VP/Director, Strategy Consultant, Founder/CEO |
| Creative Innovator | CrQ ≥75, CQx ≥70, IQ ≥70, CQm ≥70 | Product Designer, UX Researcher, Creative Director |
| Sales & Influence Driver | MQ ≥75, InQ ≥75, NQ ≥70, CQm ≥70 | Sales Director, Business Development, Growth Lead |
| Entrepreneurial Builder | GQ ≥75, XQ ≥75, DQ ≥75, AQ ≥70, RQ ≥70 | Founder/Startup, Product Manager, Independent Consultant |
| 9\. SYSTEM CONSTRAINTS |
| :---- |
The following constraints must be enforced by the system at all times:
| \# | Constraint |
| :---- | :---- |
| 1 | Only 1 active pathway permitted per user at any time. Activating a new pathway deactivates the previous. |
| 2 | Pathway switching requires a minimum of 2- 4 weeks completed on the current pathway. |
| 3 | Pathway regeneration is limited to once per calendar month. |
| 4 | Timeline options are fixed: 1 month (Tier 2), or 3 / 6 / 12 months (Tier 3). No custom timelines. |
| 5 | Option B generation requires all 25 Q-Scores to be completed. Partial assessments are rejected. |
| 6 | Career goal input is validated by NLP. Vague goals (e.g. ‘better job’) are rejected with a clarification prompt. |
| 7 | Weekly cycle time cap: maximum 3.5 hours of service touchpoints per week. |
| 8 | Questionnaire must be completed before any pathway is generated, regardless of option or tier. |
| 9 | Region is auto-detected on first use. Labour market data served from matching regional dataset. Manual override available. |
| 10 | Generated reports stored for 12 months from creation date. |
| 10\. ACCEPTANCE CRITERIA |
| :---- |
| \# | Acceptance Criterion | Pass / Fail |
| :---- | :---- | :---- |
| **1** | Questionnaire flow completes all 4 steps for all users (Tier 1, 2, and 3). Responses captured correctly. Questionnaire must be completed before pathway generation is triggered. | \[ \] PASS \[ \] FAIL |
| **2** | Career combination options generated from questionnaire \+ profile data. Options grouped correctly into Close Match, Adjacent, and Stretch categories. | \[ \] PASS \[ \] FAIL |
| **3** | Career Identity Statement generated for every user on questionnaire completion. | \[ \] PASS \[ \] FAIL |
| **4** | Visual Career Web renders with correct nodes per combination category. Filter adjustments re-render the web in real-time. Tier-gated content enforced (Tier 1: 2 nodes expandable; Tier 2+: all nodes). | \[ \] PASS \[ \] FAIL |
| **5** | Option A pathway generated correctly from LinkedIn URL or resume upload \+ questionnaire. Skill gap analysis, 4-week curriculum, and live job postings populated per path. | \[ \] PASS \[ \] FAIL |
| **6** | Option B pathway generated using 60% psychometric \+ 40% Q-Score algorithm. Requires all 25 Q-Scores completed. Archetype assigned correctly from Q-Score thresholds. | \[ \] PASS \[ \] FAIL |
| **7** | Three pathway options generated for Option B: Primary (85%+), Alt 1 (75–85%), Alt 2 (65–75%). Match percentages calculated correctly. | \[ \] PASS \[ \] FAIL |
| **8** | Tier 1: 2-section teaser PDF generated with upgrade CTA. Tier 2 and 3: Full 14–16 page Pathway Report PDF generated with all 8 sections and GrowQR branding. Generation time under 5 seconds. | \[ \] PASS \[ \] FAIL |
| **9** | Tier 2: 1-month pathway activated on purchase. All 11 services available. Deactivates after 30 days if not upgraded. | \[ \] PASS \[ \] FAIL |
| **10** | Tier 3: 3/6/12-month pathway active. Weekly cycles follow all 6 generation rules. Adaptive engine adjusts cycle based on Q-Score changes and service completions. | \[ \] PASS \[ \] FAIL |
| **11** | Both Option A and Option B activate full 11-service orchestration on pathway activation. | \[ \] PASS \[ \] FAIL |
| **12** | Regional labour market data served correctly for India, USA, and Europe. Salary, demand, and company data accurate per region. Auto-detection functional with manual override. | \[ \] PASS \[ \] FAIL |
| **13** | All 10 system constraints enforced correctly. | \[ \] PASS \[ \] FAIL |
| **14** | Monthly Q-Score reassessment updates pathway recommendations and triggers report regeneration when score changes by 10+ points. | \[ \] PASS \[ \] FAIL |
| **15** | Google Drive PDF save functions correctly for Tier 3 users (optional feature). | \[ \] PASS \[ \] FAIL |
services_prd/SocialBranding_BRD.docx.md
+396
View File
@@ -0,0 +1,396 @@
**GrowQR**
**SOCIAL BRANDING**
**DEVELOPER BRD — TECHNICAL SPECIFICATION**
Individual Social Branding • Enterprise Social Branding • 4 Platforms • 6 Personas • v1.0 • March 2026
| Social Branding Microservices This document contains specifications, business logic, and acceptance criteria for development. |
| :---: |
| Document Title | Social Branding Service — Developer BRD Technical Specification |
| :---- | :---- |
| Version | 1.0 — March 2026 |
| :---- | :---- |
| Service Type | Standalone Microservice — Part of Opportunity Module |
| :---- | :---- |
| Target Platforms | LinkedIn | Instagram | Twitter/X | YouTube |
| :---- | :---- |
| Target Launch | April 1st — LinkedIn, Instagram, YouTube, Twitter/X , Git |
| :---- | :---- |
| Part 1 | Individual Social Branding — 6 end-goal personas, full automation with approval |
| :---- | :---- |
| Part 2 | Enterprise Social Branding — Company brand presence, governance, multi-platform management |
| :---- | :---- |
| Q-Score Integration | Brand Score (0–100) feeds RQx. Q-Score changes trigger automatic profile and content updates. |
| :---- | :---- |
| Data Collection | Method TBD by technical team — BRD specifies data requirements only |
| :---- | :---- |
| PART 1 — INDIVIDUAL SOCIAL BRANDING |
| :---: |
Part 1 covers the Social Branding service for individual GrowQR users. It is a fully automated, AI-managed presence builder across LinkedIn, Instagram, Twitter/X, and YouTube — with user approval at every execution step.
| 1\. SERVICE OVERVIEW — INDIVIDUAL |
| :---- |
The Individual Social Branding service transforms a user’s professional presence from a passive profile into an active, consistent, and strategically managed brand. The service operates on a Scrape → Analyse → Generate → Approve → Post → Track loop, fully managed by GrowQR’s AI layer.
The service is built on five structural pillars drawn from proven social branding principles:
| Pillar | Definition | How GrowQR Implements It |
| :---- | :---- | :---- |
| Consistency | Uniform brand voice, visual style, and messaging across all platforms | AI enforces tone, vocabulary, and visual style rules per persona across all connected platforms |
| Target Audience | Understanding the social habits of the user’s ideal audience (recruiters, clients, peers, investors) | Audience profile built from user’s pathway archetype, target role, and Q-Score profile |
| Content Strategy | A defined mix of educational, entertaining, and inspirational content mapped to brand values | 80/20 content model: 80% pre-baked persona toolkit, 20% dynamic AI-generated content |
| Engagement | Active interaction with followers: likes, comments, DMs, connection requests | AI drafts engagement responses; user approves or auto-approves based on engagement rules |
| Platform Selection | Right platforms for the user’s archetype and target audience | Archetype-conditional platform activation — not all platforms recommended to all users |
## **1.1 The Automation Loop**
| Stage | Action | Human Touch Point |
| :---- | :---- | :---- |
| 1\. Connect | User connects social accounts via OAuth | One-time setup per platform |
| 2\. Scrape / Collect | System collects profile data, post history, engagement metrics, follower data | None — automated |
| 3\. Analyse | AI analyses profile completeness, content performance, audience alignment, Brand Score calculated | User reviews Brand Score dashboard |
| 4\. Generate | AI generates: profile rewrites, content calendar, post drafts, engagement responses | User reviews all generated content |
| 5\. Approve | User approves, edits, or rejects each item in the approval queue | Primary user interaction point |
| 6\. Post / Execute | Approved content scheduled and posted. Profile updates applied. Engagement responses sent. | None — automated post-approval |
| 7\. Track | System monitors: impressions, profile views, follower growth, engagement rate, recruiter search appearances | User reviews weekly analytics dashboard |
| 8\. Feed Back | Performance data feeds Brand Score and RQx Q-Score. Pathway engine updates recommendations. | None — automated |
| 2\. BRAND SCORE — THE SOCIAL Q-SCORE |
| :---- |
Brand Score is a single 0–100 metric that measures the strength, consistency, and discoverability of a user’s professional presence across all connected platforms. It is GrowQR’s proprietary social presence measurement and feeds directly into RQx (Reputation Quotient) in the Q-Score engine.
| Brand Score is not a vanity metric. It is calculated from objective, measurable signals. As the user takes actions recommended by the Social Branding service, their Brand Score improves. Brand Score improvement directly improves their RQx Q-Score, which in turn updates their pathway recommendations. |
| :---- |
## **2.1 Brand Score Components**
| Component | Weight | What It Measures |
| :---- | :---- | :---- |
| Profile Completeness | 20% | All profile sections populated, keyword-optimised, and aligned to target role across active platforms |
| Content Consistency | 20% | Posting frequency maintained, tone consistent, visual style uniform across platforms |
| Audience Growth | 15% | Follower/connection growth rate over 30-day rolling window |
| Engagement Rate | 15% | Likes, comments, shares, and saves as a percentage of reach per post |
| Recruiter Visibility | 15% | Profile appearance rate in relevant recruiter and talent searches (LinkedIn primary) |
| Content Quality | 10% | AI-assessed relevance, originality, and alignment to persona content framework |
| Cross-Platform Consistency | 5% | Messaging and voice alignment across all connected platforms |
## **2.2 Brand Score → RQx Integration**
* Brand Score calculated after every platform data sync (example: frequency: daily for LinkedIn, 48hrs for others)
* Brand Score mapped to RQx using a defined conversion formula: RQx contribution \= Brand Score × 0.4 (40% weighting of RQx from Brand Score)
* RQx update event emitted to Assessment Service and Pathways Service on every Brand Score change of 5+ points
* Pathways engine re-evaluates Social Branding touchpoint recommendations on RQx update
* User’s Brand Score history stored and displayed as a trend line on the Social Branding dashboard
| 3\. SIX END-GOAL PERSONAS — CONTENT FRAMEWORK |
| :---- |
Every user’s Social Branding strategy is driven by their end-goal persona. The persona is derived from the user’s active pathway archetype, target role, and career goal input. Users can switch personas as their goals evolve. Each persona has a defined platform mix, content angle, and posting frequency.
| Platform activation is archetype-conditional. Not all platforms are recommended to all users. The system activates platforms relevant to the user’s persona and prompts the user to connect them. Users can override and connect any platform manually. |
| :---- |
| PERSONA 1: JOB SEEKER Archetype: All archetypes — active job search phase |
| :---- |
| **Recommended Platforms** LinkedIn (primary), Twitter/X (secondary for tech/creative roles) **Content Angle** Recruiter visibility, skills signalling, open-to-work positioning, achievement highlights **Posting Frequency** LinkedIn: 4x per week. Twitter/X: 3x per week if active. |
| PERSONA 2: CAREER TRANSITIONER Archetype: All archetypes — changing domain or role type |
| :---- |
| **Recommended Platforms** LinkedIn (primary), Instagram (if transitioning to creative/coaching/consulting) **Content Angle** Narrative reframing: connecting past experience to new direction, learning journey documentation **Posting Frequency** LinkedIn: 3x per week. Instagram: 2x per week if active. |
| PERSONA 3: THOUGHT LEADER Archetype: Strategic Leader, Entrepreneurial Builder, Domain Expert |
| :---- |
| **Recommended Platforms** LinkedIn (primary), Twitter/X (primary), YouTube (secondary) **Content Angle** Industry insights, opinion pieces, trend analysis, frameworks and models, contrarian takes **Posting Frequency** LinkedIn: 5x per week. Twitter/X: daily. YouTube: 1x per month minimum. |
| PERSONA 4: DOMAIN EXPERT Archetype: Technical Specialist, Creative Innovator |
| :---- |
| **Recommended Platforms** LinkedIn (primary), GitHub (external link), YouTube (tutorials/walkthroughs) **Content Angle** Deep technical content, how-to posts, case studies, project showcases, certification highlights **Posting Frequency** LinkedIn: 3x per week. YouTube: 2x per month. |
| PERSONA 5: ENTREPRENEUR / FOUNDER Archetype: Entrepreneurial Builder |
| :---- |
| **Recommended Platforms** LinkedIn (primary), Twitter/X (primary), Instagram (brand building), YouTube (storytelling) **Content Angle** Build-in-public content, startup journey, lessons learned, team culture, product milestones **Posting Frequency** LinkedIn: 5x per week. Twitter/X: daily. Instagram: 3x per week. YouTube: 2x per month. |
| PERSONA 6: EXECUTIVE / ENTERPRISE LEADER Archetype: Strategic Leader — VP, Director, C-suite level |
| :---- |
| **Recommended Platforms** LinkedIn (primary), Twitter/X (secondary) **Content Angle** Executive presence: strategic vision, culture and values, industry leadership, org transformation, speaking engagements **Posting Frequency** LinkedIn: 3x per week. Twitter/X: 2x per week. |
| 4\. THE 80/20 CONTENT MODEL |
| :---- |
All content generated by GrowQR’s Social Branding service follows an 80/20 split: 80% pre-baked toolkit content and 20% dynamic AI-generated content. This balance ensures consistency and quality (80%) while maintaining relevance and freshness (20%).
## **4.1 80% — Pre-Baked Toolkit**
The pre-baked toolkit is a library of proven content frameworks, post templates, hooks, and evergreen structures mapped to each persona and platform. This content is designed, tested, and maintained by GrowQR. It does not require AI generation — it is filled with user-specific data at execution time.
| Content Type | Description | Persona Applicability |
| :---- | :---- | :---- |
| Achievement Post | Structured template: milestone \+ what it took \+ what you learned. Fills with user’s real achievements from pathway completions. | All personas |
| Skills Signal Post | Highlights a specific skill or certification. Links to Q-Score improvement data. | Job Seeker, Domain Expert, Career Transitioner |
| Insight Share | Short opinion or observation on an industry trend. Structure: Hook \+ Insight \+ Question to audience. | Thought Leader, Executive, Entrepreneur |
| Career Story Post | Narrative format: where I was \+ what changed \+ where I am now. Used for transitions and milestones. | Career Transitioner, Entrepreneur |
| Project Showcase | Work sample or project result with context. Visual-first for Instagram; text+image for LinkedIn. | Domain Expert, Creative Innovator, Entrepreneur |
| Engagement Prompt | Question or poll to drive comments. Mapped to user’s domain for relevant audience response. | All personas |
| Weekly Reflection | End-of-week summary: what I worked on, what I learned, what’s next. | Thought Leader, Entrepreneur, Executive |
| Company/Role Spotlight | Highlights a company or role the user is targeting or has experience with. Builds recruiter relevance. | Job Seeker, Career Transitioner |
## **4.2 20% — Dynamic Content**
Dynamic content is AI-generated in real-time based on signals from the user’s platform activity, Q-Score progress, pathway milestones, and trending topics in their domain. This content is fresh, timely, and personalised — it cannot be pre-baked.
* Q-Score improvement post: auto-generated when user improves a Q-Score by 10+ points. Frames the improvement as a professional growth story.
* Pathway milestone post: auto-generated when user completes a course, earns a certificate, or achieves a pathway milestone.
* Trending topic response: AI monitors trending topics in the user’s domain. Generates a short opinion post when a relevant trend is detected.
* Interview or job application event: auto-generated encouragement and visibility post when user applies for a role or secures an interview (with user consent).
* Engagement response drafts: AI drafts replies to comments on the user’s posts, maintaining persona tone and voice.
* Profile update trigger: when user’s Q-Scores or pathway status changes significantly, AI generates updated headline, about section, and skills list for user approval.
## **4.3 Content Calendar Generation Rules**
| Rule | Description |
| :---- | :---- |
| Rule 1: Frequency Enforcement | System enforces minimum posting frequency per persona. If user has not approved content for upcoming slots, system sends reminder 48hrs in advance. |
| Rule 2: Platform Sequencing | Content is not duplicated across platforms. Each platform receives a uniquely formatted version adapted to that platform’s style and audience. |
| Rule 3: Content Mix Enforcement | System ensures the 80/20 split is maintained over any 2-week rolling window. Prevents over-reliance on either toolkit or dynamic content. |
| Rule 4: No Auto-Post Without Approval | No content is ever posted without explicit user approval. Auto-approve mode is available as an opt-in setting only. |
| Rule 5: Tone Lock | Once user’s brand voice is established (after first 2 weeks), tone settings are locked unless user explicitly resets them. |
| Rule 6: Sensitive Topic Filter | AI applies a topic filter before generating content. Posts that touch on politically sensitive, legally risky, or reputationally harmful territory are flagged and not queued for approval. |
| 5\. PLATFORM SPECIFICATIONS — INDIVIDUAL |
| :---- |
## **5.1 LinkedIn**
| Capability | Specification |
| :---- | :---- |
| Profile Analysis | Audit: Headline, About, Experience, Skills, Recommendations, Featured section, Activity. Score each section 0–100. Benchmark against target role requirements and top 10% of professionals in same role. |
| Profile Rewrite | AI generates optimised versions of: Headline (3 variants), About section, Experience bullet points (per role), Skills list (mapped to Q-Scores and target JD keywords). User selects and approves. |
| Recruiter Visibility | Keyword gap analysis: identifies terms recruiters search for this role that are missing from profile. Injects keywords into profile sections naturally. |
| Content Posting | Supports: text posts, image posts, document carousels, polls, article links. Content formatted to LinkedIn algorithm best practices (hook in first 2 lines, no external links in body). |
| Connection Strategy | Identifies target connections based on user’s pathway: target companies, role peers, hiring managers in target domain. AI drafts personalised connection request notes. |
| Engagement Automation | AI drafts comments on posts from target connections and industry leaders. User approves before sending. Builds visibility with relevant audience. |
| Analytics Tracked | Profile views (7-day, 30-day), Search appearances, Post impressions, Engagement rate per post, Connection acceptance rate, Follower growth |
## **5.2 Instagram**
| Instagram is activated for: Career Transitioner (creative/coaching roles), Entrepreneur/Founder, Domain Expert (creative/design roles). Not recommended by default for Technical Specialist or Strategic Leader personas unless user opts in. |
| :---- |
| Capability | Specification |
| :---- | :---- |
| Profile Analysis | Bio, profile photo, link-in-bio, highlight covers, grid aesthetic consistency, story frequency. Score for professional brand alignment. |
| Content Types | Feed posts (static image, carousel), Reels (short-form video), Stories (ephemeral). Each type has distinct content templates in the pre-baked toolkit. |
| Visual Style Consistency | AI enforces visual brand rules: colour palette (derived from user’s LinkedIn brand colours), font style, filter consistency. Applied to all generated visual templates. |
| Caption Framework | Each caption follows: Hook (first line visible before ‘more’) \+ Value (body) \+ CTA (final line) \+ Hashtags (max 5, domain-specific). Hashtag bank maintained per persona. |
| Story Strategy | Stories used for: behind-the-scenes content, quick tips, polls, Q\&As. Frequency: 3–5 stories per week. Story templates provided per persona. |
| Analytics Tracked | Reach, Impressions, Profile visits, Follower growth, Story views, Reel plays, Link-in-bio clicks, Saves per post |
## **5.3 Twitter / X**
| Twitter/X is targeted for Phase 2 launch. Architecture and data model specified here for development readiness. April 1st launch excludes Twitter/X. |
| :---- |
| Capability | Specification |
| :---- | :---- |
| Profile Analysis | Bio (160 chars), header image, pinned tweet, posting frequency, engagement rate, follower-to-following ratio. |
| Content Types | Short posts (under 280 chars), Threads (multi-tweet narrative), Quote posts (with commentary), Replies (engagement strategy). |
| Thread Framework | Threads used for: insight breakdowns, how-to guides, career lessons, domain deep-dives. Format: Hook tweet \+ 5–10 body tweets \+ CTA final tweet. |
| Posting Strategy | Optimal posting times calculated per user’s audience timezone. Threads on weekdays, shorter posts and replies on weekends. |
| Analytics Tracked | Impressions, Engagements, Profile clicks, Link clicks, Follower growth, Thread completion rate |
## **5.4 YouTube**
| Capability | Specification |
| :---- | :---- |
| Channel Analysis | Channel art, About section, playlist structure, video titles and descriptions (SEO), thumbnail consistency, upload frequency, subscriber growth rate. |
| Content Types | Long-form (10–20 min): deep dives, case studies, tutorials. Short-form (YouTube Shorts, under 60 sec): tips, quick insights, career advice clips. |
| Video Brief Generation | AI generates video briefs: title (3 variants), hook script (first 30 seconds), chapter outline, description with keywords, tags, thumbnail concept. User records; AI does not generate video. |
| SEO Optimisation | Title keyword analysis, description keyword injection, tag strategy, chapter timestamps. Benchmarked against top-performing videos in user’s domain. |
| Thumbnail Strategy | AI generates thumbnail design brief: text overlay, colour scheme, facial expression guidance (if talking head). Thumbnail template provided per persona. |
| Upload Frequency | Persona-based targets: Thought Leader (1x/month minimum), Domain Expert (2x/month), Entrepreneur (2x/month). System prompts user when cadence is falling behind. |
| Analytics Tracked | Views, Watch time, Subscriber growth, Click-through rate (thumbnails), Average view duration, Top traffic sources |
| 6\. DATA REQUIREMENTS — INDIVIDUAL |
| :---- |
| Data collection method (API vs scraping vs user-authenticated export) is TBD and left to the technical team. This section specifies what data is required. The technical team must define the collection mechanism, document any legal or rate-limit constraints, and confirm data availability before development of the collection layer. |
| :---- |
| Platform | Data Required | Frequency |
| :---- | :---- | :---- |
| LinkedIn | Profile sections (headline, about, experience, education, skills, certifications, featured, recommendations). Post history (last 90 days). Engagement per post (likes, comments, shares). Profile view count. Search appearance count. Connection count. Follower count. | Daily sync |
| Instagram | Bio, profile photo URL, follower count, following count, post count. Feed posts (last 60 days): caption, image URL, likes, comments, saves, reach, impressions. Story views (last 30 days). Reel plays. | 48-hour sync |
| Twitter/X | Bio, follower count, following count. Tweet history (last 60 days): text, impressions, engagements, link clicks, retweets, replies. Profile visits. | 48-hour sync (Phase 2\) |
| YouTube | Channel stats: subscriber count, total views, video count. Per-video: title, description, tags, views, watch time, CTR, average view duration, subscriber change. Upload dates. | Weekly sync |
| PART 2 — ENTERPRISE SOCIAL BRANDING |
| :---: |
Part 2 covers the Social Branding service for companies and organisations. An enterprise account manages its brand presence across social platforms — defining what to post, what not to post, maintaining brand voice consistency, and managing AI-assisted content creation and scheduling across multiple platforms with an internal approval workflow.
| 7\. SERVICE OVERVIEW — ENTERPRISE |
| :---- |
Enterprise Social Branding gives companies a governed, AI-assisted platform to manage their professional brand presence. It is distinct from the individual service in three fundamental ways: it serves an organisation rather than a person, it includes multi-user approval workflows (not just single-user approval), and it includes brand governance rules that define what content is and is not acceptable before the AI generates anything.
| Dimension | Individual Social Branding | Enterprise Social Branding |
| :---- | :---- | :---- |
| Subject | A person’s professional brand | A company’s brand presence |
| Platforms | Personalised per archetype and persona | Standardised across all company-connected platforms |
| Content strategy | Persona-driven, career-goal aligned | Brand voice and values-driven, audience-targeted |
| Approval workflow | Single user approves | Multi-role workflow: Creator → Editor → Approver |
| Brand governance | Tone rules per persona | Explicit content policy: what to post, what not to post |
| Analytics focus | Individual brand growth, recruiter visibility | Company reach, audience growth, brand sentiment |
| Q-Score integration | Feeds RQx for individual | Not Q-Score integrated — separate enterprise analytics |
## **7.1 Enterprise Account Structure**
* An enterprise account is associated with a company entity (not an individual user)
* Multiple team members can be added to the enterprise account with defined roles
* Three roles: Content Creator (drafts content), Content Editor (reviews and edits), Brand Approver (final approval before posting)
* At least one Brand Approver must be assigned before any content can go live
* Enterprise account connects company social profiles (LinkedIn Company Page, Instagram Business, Twitter/X Business, YouTube Channel)
| 8\. BRAND GOVERNANCE FRAMEWORK — ENTERPRISE |
| :---- |
Brand governance is the defining capability of the Enterprise service. Before the AI generates any content, it operates within a set of brand rules defined by the company. These rules determine what gets created, what gets filtered, and what gets flagged for human review.
## **8.1 Brand Voice Definition**
The enterprise sets its brand voice at account setup. Brand voice is defined across five dimensions:
| Dimension | Options | Example |
| :---- | :---- | :---- |
| Tone | Professional / Conversational / Authoritative / Inspirational / Technical | A fintech company selects: Professional \+ Authoritative |
| Formality | Formal / Semi-formal / Casual | Most enterprises: Semi-formal |
| Perspective | First person (we) / Third person (company name) | Most LinkedIn company posts: First person (we) |
| Language style | Simple and direct / Rich and descriptive / Data-led / Story-led | Tech companies often: Simple and direct \+ Data-led |
| Audience | Talent/Recruitment / Clients/Customers / Industry peers / Investors / General public | Can select multiple; content adapted per audience tag |
## **8.2 Content Policy — What to Post**
* Company milestones: product launches, funding announcements, partnerships, awards
* Thought leadership: industry trends, company perspective on market developments, research and data
* Culture and values: team stories, behind-the-scenes, company events, diversity and inclusion content
* Product and service highlights: feature announcements, case studies, client success stories (with consent)
* Recruitment content: open roles, employer brand, employee testimonials, workplace benefits
* Educational content: how-to guides, industry education, tips relevant to the company’s domain
* Engagement content: polls, questions, community challenges aligned to brand values
## **8.3 Content Policy — What Not to Post (Governance Rules)**
The following rule categories are configurable by the enterprise at account setup. The AI applies these rules as filters before generating any content. Content that violates a rule is not queued — it is discarded or flagged for human review.
| Rule Category | Default Setting | Configurable? |
| :---- | :---- | :---- |
| Political statements or partisan content | Blocked — never generated | Yes — enterprise can unlock with justification |
| Commentary on competitors by name | Blocked — never generated | Yes — enterprise can unlock for specific approved comparisons |
| Unverified claims or statistics | Flagged for human review before queuing | No — always flagged |
| Sensitive social topics (religion, race, gender commentary) | Flagged for human review | Yes — enterprise can block entirely |
| Legal or compliance-sensitive content (regulatory, financial) | Flagged for legal review tag | No — always flagged |
| Crisis or incident response content | Blocked from AI generation — must be human-authored | No — always blocked from AI |
| Content featuring named individuals (external) | Requires explicit approval flag | No — always requires approval |
| Off-brand tone (outside defined voice dimensions) | Regenerated automatically before queuing | No — always enforced |
| 9\. ENTERPRISE CONTENT ENGINE |
| :---- |
## **9.1 Content Generation Flow**
| Step | Action | Role Responsible | System Behaviour |
| :---- | :---- | :---- | :---- |
| 1 | Content brief input | Content Creator or AI-initiated | Creator provides topic/theme OR system auto-generates brief from content calendar schedule |
| 2 | Brand governance check | System (automated) | Brief checked against content policy rules. Blocked topics discarded. Flagged topics tagged for review. |
| 3 | AI content generation | System (automated) | AI generates post draft applying: brand voice rules, platform format requirements, 80/20 content model, audience targeting |
| 4 | Creator review | Content Creator | Creator reviews draft, makes edits, adds platform-specific adjustments |
| 5 | Editor review | Content Editor | Editor reviews for brand alignment, tone consistency, factual accuracy |
| 6 | Brand approval | Brand Approver | Final approval. Can approve, request changes, or reject. Only Brand Approver can push to scheduled. |
| 7 | Schedule and post | System (automated) | Approved content scheduled per platform optimal posting time. Posted automatically at scheduled time. |
| 8 | Performance tracking | System (automated) | Impressions, engagement, follower data collected. Brand analytics dashboard updated. |
## **9.2 Enterprise 80/20 Content Model**
The same 80/20 content model applies to enterprise, with enterprise-specific content types:
| Content Type | Category | Description |
| :---- | :---- | :---- |
| Company milestone post | 80% Toolkit | Template: announcement \+ context \+ what it means for customers/team \+ CTA. Fills with company-specific data. |
| Thought leadership post | 80% Toolkit | Template: industry observation \+ company perspective \+ supporting data point \+ question to audience. |
| Culture post | 80% Toolkit | Template: team story or value highlight \+ what it demonstrates about the company \+ employee quote (with consent). |
| Job opening post | 80% Toolkit | Template: role title \+ why this role matters \+ what kind of person thrives here \+ apply link. |
| Educational post | 80% Toolkit | Template: common misconception or question in domain \+ company perspective \+ practical takeaway. |
| Trending topic response | 20% Dynamic | AI monitors industry news. Generates company perspective post when relevant trend detected. Always flagged for Brand Approver review. |
| Milestone reaction | 20% Dynamic | AI auto-generates draft when company milestone event detected (e.g. funding announcement, award won). Requires full approval workflow. |
| Engagement response | 20% Dynamic | AI drafts responses to comments on company posts. Creator reviews before sending. |
| 10\. ACCEPTANCE CRITERIA |
| :---- |
**Part 1 — Individual Social Branding**
| \# | Acceptance Criterion | Pass / Fail |
| :---- | :---- | :---- |
| **1** | OAuth connection completes for all four platforms (LinkedIn, Instagram, Twitter/X, YouTube). Profile data collected on first sync. Sync schedule runs per defined frequency. | \[ \] PASS \[ \] FAIL |
| **2** | Brand Score calculated correctly from all 7 components. Brand Score feeds RQx via defined formula. RQx update event emitted to Assessment and Pathways services on Brand Score change of 5+ points. | \[ \] PASS \[ \] FAIL |
| **3** | Profile analysis runs for all four platforms. Section-by-section audit scores generated. Benchmark against target role applied. Profile recommendations generated with current and recommended text. | \[ \] PASS \[ \] FAIL |
| **4** | Profile recommendations can be approved and applied to the live platform profile. Rejected recommendations discarded. Applied recommendations update the social\_profile\_recommendations table correctly. | \[ \] PASS \[ \] FAIL |
| **5** | Content calendar generated for correct persona with correct platform mix. 80/20 split enforced over any 2-week rolling window. All 6 content calendar rules applied correctly. | \[ \] PASS \[ \] FAIL |
| **6** | Pre-baked toolkit content fills correctly with user-specific data (achievements, Q-Score stats, pathway milestones). All 8 toolkit content types functional. | \[ \] PASS \[ \] FAIL |
| **7** | Dynamic content triggers fire correctly: Q-Score improvement event, pathway milestone event, trending topic detection, profile update trigger. | \[ \] PASS \[ \] FAIL |
| **8** | Approval queue functions correctly: user can approve (with optional edits), reject, or request regeneration for each content item. No content posted without approved status. | \[ \] PASS \[ \] FAIL |
| **9** | Auto-approve mode available as opt-in only. When enabled, content posts without individual approval. Can be disabled at any time. | \[ \] PASS \[ \] FAIL |
| **10** | Approved content posted to correct platform at scheduled time. Platform-specific formatting applied (LinkedIn: no external link in body. Instagram: hashtags appended. YouTube: description and tags generated.) | \[ \] PASS \[ \] FAIL |
| **11** | Engagement queue populated with AI-drafted responses to comments and connection requests. User approval required before sending. | \[ \] PASS \[ \] FAIL |
| **12** | Analytics collected per platform per sync cycle. Performance data stored in social\_content\_performance table. Analytics dashboard displays all tracked metrics with trend lines. | \[ \] PASS \[ \] FAIL |
| **13** | Persona switching updates platform activation recommendations, content calendar strategy, and posting frequency rules immediately. | \[ \] PASS \[ \] FAIL |
| **14** | Archetype-conditional platform activation: Instagram not recommended by default for Technical Specialist or Strategic Leader personas. System surfaces recommendation prompt for relevant personas only. | \[ \] PASS \[ \] FAIL |
**Part 2 — Enterprise Social Branding**
| \# | Acceptance Criterion | Pass / Fail |
| :---- | :---- | :---- |
| **1** | Enterprise account creation completes with brand voice and content policy configuration. Multi-role team setup (Creator, Editor, Approver) functional. Minimum one Approver enforced before content can go live. | \[ \] PASS \[ \] FAIL |
| **2** | Brand governance rules applied before AI content generation. Blocked topics discarded without queuing. Flagged topics tagged and routed to enterprise\_content\_flags table for human review. | \[ \] PASS \[ \] FAIL |
| **3** | All 8 governance rule categories enforced: political content blocked, competitor mentions blocked, unverified claims flagged, sensitive topics flagged, legal content flagged, crisis content blocked from AI, named individuals require approval, off-brand tone regenerated. | \[ \] PASS \[ \] FAIL |
| **4** | Brand voice rules (tone, formality, perspective, language style, audience) applied to all AI-generated content. Off-brand drafts regenerated automatically before entering approval queue. | \[ \] PASS \[ \] FAIL |
| **5** | Three-stage approval workflow enforced: Creator → Editor → Brand Approver. Content cannot skip stages. Only Brand Approver role can push content to scheduled status. | \[ \] PASS \[ \] FAIL |
| **6** | All 8 enterprise content types (5 toolkit \+ 3 dynamic) generated correctly. Trending topic and milestone dynamic content always routed to Brand Approver regardless of workflow stage. | \[ \] PASS \[ \] FAIL |
| **7** | Flagged content resolution workflow completes: flag raised → human reviews → approved/rejected/edited → flag closed. Content entry status updates correctly on resolution. | \[ \] PASS \[ \] FAIL |
| **8** | Enterprise analytics collected per platform. Brand analytics dashboard displays follower growth, impressions, engagement rate, and top-performing posts per platform. | \[ \] PASS \[ \] FAIL |
| **9** | Enterprise content calendar visible across all team member roles with correct status labels per approval stage. Each role sees only the actions available to their role. | \[ \] PASS \[ \] FAIL |