Skip to content

The open alternative to Salesforce, designed for AI.

v1.7.1 — feat(partners): add a How to review playbook in Matching Admin (#24904)

Rashad Karanouh6fce999ba5c7
diff --git a/packages/twenty-apps/internal/twenty-partners/AGENTS.md b/packages/twenty-apps/internal/twenty-partners/AGENTS.md
index 65ebad20665..730cc38ea63 100644
--- a/packages/twenty-apps/internal/twenty-partners/AGENTS.md
+++ b/packages/twenty-apps/internal/twenty-partners/AGENTS.md
@@ -97,6 +97,27 @@ lives in `src/__tests__/helpers/`.
domain, or hoist the shared ID into `shared/`.
- One domain per commit when migrating (`git mv` only, imports fixed in the same commit).
+## Application review playbook
+
+The Matching Admin Workspace playbook is a standalone page in
+`src/modules/partner/application-intake/` (front-component + page layout +
+nav item). It must stay in lockstep with real behaviour. When you change any
+of the following, update the playbook in the same change:
+
+- Website form fields that land on Partner
+- The Partner Applications view (filter, columns, sort)
+- `validationStage` values used as the review decision
+- Intake side effects the reviewer needs to know (Discord on create;
+ welcome email on `VALIDATED`, linked from
+ `WELCOME_EMAIL_WORKFLOW_URL`)
+- Marketplace ranking bonuses in
+ `packages/twenty-website/src/partners-marketplace/completeness-score.ts`
+ (case study, cover, introduction, service, picture, calendar, rate,
+ category, ghost rule)
+
+Facts on the page come from the same constants the view and intake use. Do
+not leave stale steps. Do not keep a second copy on twenty.com or in a Note.
+
## Where does new code go?
External API call → `connector/`. Raw query/mutation → `graphql/`. Any logic →
diff --git a/packages/twenty-apps/internal/twenty-partners/package.json b/packages/twenty-apps/internal/twenty-partners/package.json
index 6f481b95925..a44db8b9ff0 100644
--- a/packages/twenty-apps/internal/twenty-partners/package.json
+++ b/packages/twenty-apps/internal/twenty-partners/package.json
@@ -1,6 +1,6 @@
{
"name": "twenty-partners",
- "version": "1.7.0",
+ "version": "1.7.1",
"license": "MIT",
"engines": {
"node": "^24.5.0",
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/__tests__/submit-partner-application.integration-test.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/__tests__/submit-partner-application.integration-test.ts
index 307071d2015..ba6a9bdb9c5 100644
--- a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/__tests__/submit-partner-application.integration-test.ts
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/__tests__/submit-partner-application.integration-test.ts
@@ -102,7 +102,6 @@ describe('submit-partner-application handler — upsert', () => {
name: true,
slug: true,
validationStage: true,
- reviewed: true,
partnerTier: true,
company: { id: true, name: true },
persons: { edges: { node: { id: true, name: { firstName: true, lastName: true }, emails: { primaryEmail: true } } } },
@@ -112,7 +111,6 @@ describe('submit-partner-application handler — upsert', () => {
expect(node?.name).toBe('YC Agency');
expect(node?.slug).toBe('yc-agency');
expect(node?.validationStage).toBe('APPLICATION');
- expect(node?.reviewed).toBe(false);
expect(node?.partnerTier).toBe('NEW');
expect(node?.company?.name).toBe('YC Agency');
expect(node?.persons?.edges).toHaveLength(1);
@@ -207,7 +205,7 @@ describe('submit-partner-application handler — upsert', () => {
expect(node?.hourlyRate).toEqual({ amountMicros: 175_000_000, currencyCode: 'USD' });
});
- it('preserves staff-owned columns (validationStage, reviewed) on resubmission', async () => {
+ it('preserves staff-owned columns (validationStage) on resubmission', async () => {
const first = await handler(authedEvent(baseInput({ email: '[email protected]' })));
await trackCreated(first);
expect(first.ok).toBe(true);
@@ -217,7 +215,7 @@ describe('submit-partner-application handler — upsert', () => {
updatePartner: {
__args: {
id: first.partnerId,
- data: { validationStage: 'VALIDATED', reviewed: true },
+ data: { validationStage: 'VALIDATED' },
},
id: true,
},
@@ -231,13 +229,11 @@ describe('submit-partner-application handler — upsert', () => {
partner: {
__args: { filter: { id: { eq: second.partnerId } } },
validationStage: true,
- reviewed: true,
city: true,
},
});
const node = partner.partner;
expect(node?.validationStage).toBe('VALIDATED');
- expect(node?.reviewed).toBe(true);
expect(node?.city).toBe('Berlin');
});
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/constants/how-to-review.constants.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/constants/how-to-review.constants.ts
new file mode 100644
index 00000000000..7e3b276b529
--- /dev/null
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/constants/how-to-review.constants.ts
@@ -0,0 +1,13 @@
+export const HOW_TO_REVIEW_FRONT_COMPONENT_ID =
+ 'c6470933-a33a-4adc-b9a9-1c8d2759f627';
+export const HOW_TO_REVIEW_PAGE_LAYOUT_ID =
+ '47f57740-c43e-4d1a-95be-b503f696786b';
+export const HOW_TO_REVIEW_PAGE_TAB_ID =
+ '33c38f18-4e1c-448e-99f7-728650e7e4cd';
+export const HOW_TO_REVIEW_PAGE_WIDGET_ID =
+ 'a1890015-e45f-4c09-bd9a-714a092cb324';
+export const HOW_TO_REVIEW_NAV_ITEM_ID =
+ '3306c356-d4f1-4582-80f0-b38e37b41dc4';
+
+export const WELCOME_EMAIL_WORKFLOW_URL =
+ 'https://partners.twenty.com/object/workflow/6306ce62-8aa2-4edb-bb8e-033b6524ebef';
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/constants/marketplace-ranking.constant.test.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/constants/marketplace-ranking.constant.test.ts
new file mode 100644
index 00000000000..83650c1f97c
--- /dev/null
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/constants/marketplace-ranking.constant.test.ts
@@ -0,0 +1,55 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { describe, expect, it } from 'vitest';
+
+import { MARKETPLACE_RANKING } from './marketplace-ranking.constant';
+
+// Read website sources as text: twenty-partners must not import twenty-website.
+
+const PACKAGES_ROOT = resolve(
+ dirname(fileURLToPath(import.meta.url)),
+ '../../../../../../../../',
+);
+
+const COMPLETENESS_SOURCE = readFileSync(
+ resolve(
+ PACKAGES_ROOT,
+ 'twenty-website/src/partners-marketplace/completeness-score.ts',
+ ),
+ 'utf8',
+);
+
+const GHOST_SOURCE = readFileSync(
+ resolve(
+ PACKAGES_ROOT,
+ 'twenty-website/src/partners-marketplace/is-ghost-partner.ts',
+ ),
+ 'utf8',
+);
+
+describe('MARKETPLACE_RANKING', () => {
+ it('matches the ranking constants in completeness-score.ts and is-ghost-partner.ts', () => {
+ const completenessAssignments = [
+ `const MIN_DESCRIPTION_LENGTH = ${MARKETPLACE_RANKING.introductionMinLength}`,
+ `const MAX_COUNTED_CASE_STUDIES = ${MARKETPLACE_RANKING.maxCountedCaseStudies}`,
+ `const POINTS_PER_CASE_STUDY = ${MARKETPLACE_RANKING.pointsPerCaseStudy}`,
+ `const POINTS_PER_CASE_STUDY_COVER = ${MARKETPLACE_RANKING.pointsPerCaseStudyCover}`,
+ `const POINTS_FOR_INTRODUCTION = ${MARKETPLACE_RANKING.pointsForIntroduction}`,
+ `const POINTS_FOR_SERVICE = ${MARKETPLACE_RANKING.pointsForService}`,
+ `const POINTS_FOR_PROFILE_PICTURE = ${MARKETPLACE_RANKING.pointsForProfilePicture}`,
+ `const POINTS_FOR_CALENDAR_LINK = ${MARKETPLACE_RANKING.pointsForCalendarLink}`,
+ `const POINTS_FOR_RATE_OR_BUDGET = ${MARKETPLACE_RANKING.pointsForRateOrBudget}`,
+ `const POINTS_FOR_CATEGORY = ${MARKETPLACE_RANKING.pointsForCategory}`,
+ ];
+
+ for (const assignment of completenessAssignments) {
+ expect(COMPLETENESS_SOURCE).toContain(assignment);
+ }
+
+ expect(GHOST_SOURCE).toContain(
+ `const GHOST_INTRODUCTION_MAX_LENGTH = ${MARKETPLACE_RANKING.ghostIntroductionMaxLength}`,
+ );
+ });
+});
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/constants/marketplace-ranking.constant.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/constants/marketplace-ranking.constant.ts
new file mode 100644
index 00000000000..5a8b1d68cf2
--- /dev/null
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/constants/marketplace-ranking.constant.ts
@@ -0,0 +1,15 @@
+// Copied from packages/twenty-website/src/partners-marketplace/completeness-score.ts
+// and is-ghost-partner.ts. Update both in the same change (see AGENTS.md).
+export const MARKETPLACE_RANKING = {
+ pointsPerCaseStudy: 4,
+ maxCountedCaseStudies: 3,
+ pointsPerCaseStudyCover: 1,
+ introductionMinLength: 120,
+ pointsForIntroduction: 2,
+ pointsForService: 2,
+ pointsForProfilePicture: 1,
+ pointsForCalendarLink: 1,
+ pointsForRateOrBudget: 1,
+ pointsForCategory: 1,
+ ghostIntroductionMaxLength: 40,
+} as const;
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/front-components/how-to-review.front-component.tsx b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/front-components/how-to-review.front-component.tsx
new file mode 100644
index 00000000000..e286565f627
--- /dev/null
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/front-components/how-to-review.front-component.tsx
@@ -0,0 +1,145 @@
+import { defineFrontComponent } from 'twenty-sdk/define';
+
+import {
+ HOW_TO_REVIEW_FRONT_COMPONENT_ID,
+ WELCOME_EMAIL_WORKFLOW_URL,
+} from 'src/modules/partner/application-intake/constants/how-to-review.constants';
+import { MARKETPLACE_RANKING } from 'src/modules/partner/application-intake/constants/marketplace-ranking.constant';
+import { PLAYBOOK_STYLES as styles } from 'src/modules/partner/application-intake/front-components/how-to-review/playbook-styles';
+import {
+ CASE_STUDY_BEATS_QUICK_FIELDS,
+ RANK_ROWS,
+} from 'src/modules/partner/application-intake/front-components/how-to-review/rank-rows';
+
+const HowToReview = () => (
+ <div style={styles.root}>
+ <article style={styles.article}>
+ <p style={styles.kicker}>Playbook</p>
+ <h1 style={styles.title}>Review a partner application</h1>
+ <p style={styles.lede}>
+ We list partners we can trust. Trust comes from proof they built a real
+ thing on Twenty.
+ </p>
+
+ <section style={styles.step}>
+ <div style={styles.num}>01</div>
+ <div>
+ <h2 style={styles.heading}>What to review</h2>
+ <p style={styles.body}>
+ Open <strong>Partner Applications</strong>. Newest first. Read the
+ form on the record. Nothing else.
+ </p>
+ <ul style={styles.list}>
+ <li>
+ <strong>Who</strong> — name, country, team type, languages
+ </li>
+ <li>
+ <strong>Cover</strong> — categories, skills
+ </li>
+ <li>
+ <strong>Money</strong> — hourly rate, minimum budget
+ </li>
+ </ul>
+ </div>
+ </section>
+
+ <section style={styles.trust}>
+ <div style={styles.num}>02</div>
+ <div>
+ <h2 style={styles.heading}>Proof of work — this is the review</h2>
+ <p style={styles.body}>
+ We need partners who have built a real thing on Twenty. That is how
+ we trust them.
+ </p>
+ <ul style={styles.list}>
+ <li>
+ <strong>Experience areas</strong> — apps, data models, workflows,
+ front components
+ </li>
+ <li>
+ <strong>Notes</strong> — a real project: who it was for, what they
+ built
+ </li>
+ <li>
+ <strong>Proof URL</strong> — instance, repo, or video that shows
+ that work
+ </li>
+ </ul>
+ <p style={styles.note}>
+ Open the proof yourself. The app does not fetch it. No Twenty work,
+ thin notes, or a dead proof link → do not list.
+ </p>
+ </div>
+ </section>
+
+ <section style={styles.step}>
+ <div style={styles.num}>03</div>
+ <div>
+ <h2 style={styles.heading}>Set Validation Stage</h2>
+ <div style={styles.pillRow}>
+ <span style={styles.pill}>VALIDATED — list them</span>
+ <span style={styles.pill}>POTENTIAL — keep, do not list</span>
+ <span style={styles.pill}>REJECTED — no</span>
+ </div>
+ <p style={styles.body}>
+ A change to <strong>VALIDATED</strong> sends the{' '}
+ <a href={WELCOME_EMAIL_WORKFLOW_URL} style={styles.link}>
+ welcome email
+ </a>{' '}
+ on its own. Do not send a second mail.
+ </p>
+ <p style={styles.note}>
+ The row leaves the queue when the stage is not APPLICATION.
+ </p>
+ </div>
+ </section>
+
+ <section style={styles.lastStep}>
+ <div style={styles.num}>04</div>
+ <div>
+ <h2 style={styles.heading}>They must fill the profile</h2>
+ <p style={styles.body}>
+ The welcome mail asks them into the workspace. Marketplace rank uses
+ a filled profile. A thin profile sits at the bottom — or stays
+ hidden.
+ </p>
+ <p style={styles.bodySpaced}>
+ Tell them to complete <strong>My Profile</strong> and{' '}
+ <strong>My Case Studies</strong>. Bonuses from the ranking code:
+ </p>
+ <table style={styles.table}>
+ <thead>
+ <tr>
+ <th style={styles.th}>What they add</th>
+ <th style={styles.thRight}>Bonus</th>
+ </tr>
+ </thead>
+ <tbody>
+ {RANK_ROWS.map((row) => (
+ <tr key={row.label}>
+ <td style={styles.td}>{row.label}</td>
+ <td style={styles.tdPoints}>{row.points}</td>
+ </tr>
+ ))}
+ </tbody>
+ </table>
+ <p style={styles.note}>
+ Introduction under {MARKETPLACE_RANKING.ghostIntroductionMaxLength}{' '}
+ characters and no picture → ghost. The directory hides them.
+ {CASE_STUDY_BEATS_QUICK_FIELDS
+ ? ' One case study beats picture + calendar + rate together.'
+ : ''}
+ </p>
+ </div>
+ </section>
+ </article>
+ </div>
+);
+
+export default defineFrontComponent({
+ universalIdentifier: HOW_TO_REVIEW_FRONT_COMPONENT_ID,
+ name: 'How to review',
+ description:
+ 'Admin playbook for reviewing partner applications in Matching Admin Workspace.',
+ component: HowToReview,
+});
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/front-components/how-to-review/playbook-styles.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/front-components/how-to-review/playbook-styles.ts
new file mode 100644
index 00000000000..06c018ebe30
--- /dev/null
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/front-components/how-to-review/playbook-styles.ts
@@ -0,0 +1,168 @@
+import { COLORS, FONT } from 'src/modules/shared/front-components/palette';
+
+const MONO = '"Azeret Mono", ui-monospace, monospace';
+
+export const PLAYBOOK_STYLES = {
+ root: {
+ display: 'flex',
+ justifyContent: 'center',
+ width: '100%',
+ minHeight: 'calc(100dvh - 56px)',
+ boxSizing: 'border-box' as const,
+ padding: 32,
+ fontFamily: FONT,
+ color: COLORS.fg,
+ background: COLORS.bg,
+ },
+ article: {
+ width: '100%',
+ maxWidth: 720,
+ },
+ kicker: {
+ fontFamily: MONO,
+ fontSize: 11,
+ letterSpacing: 1.4,
+ textTransform: 'uppercase' as const,
+ color: COLORS.accent,
+ margin: '0 0 8px',
+ },
+ title: {
+ fontSize: 28,
+ fontWeight: 500,
+ letterSpacing: -0.4,
+ margin: '0 0 8px',
+ },
+ lede: {
+ color: COLORS.muted,
+ fontSize: 15,
+ lineHeight: '22px',
+ margin: '0 0 28px',
+ },
+ step: {
+ display: 'grid',
+ gridTemplateColumns: '36px 1fr',
+ gap: 16,
+ padding: '20px 0',
+ borderTop: `1px solid ${COLORS.border}`,
+ },
+ lastStep: {
+ display: 'grid',
+ gridTemplateColumns: '36px 1fr',
+ gap: 16,
+ padding: '20px 0',
+ borderTop: `1px solid ${COLORS.border}`,
+ borderBottom: `1px solid ${COLORS.border}`,
+ },
+ trust: {
+ display: 'grid',
+ gridTemplateColumns: '36px 1fr',
+ gap: 16,
+ padding: '20px 16px',
+ margin: '0 -16px',
+ borderTop: `1px solid ${COLORS.border}`,
+ background: COLORS.accentSoft,
+ },
+ num: {
+ fontFamily: MONO,
+ fontSize: 13,
+ color: COLORS.accent,
+ paddingTop: 2,
+ },
+ heading: {
+ fontSize: 16,
+ fontWeight: 500,
+ margin: '0 0 6px',
+ },
+ body: {
+ margin: 0,
+ color: COLORS.fg,
+ fontSize: 14,
+ lineHeight: '22px',
+ },
+ bodySpaced: {
+ margin: '8px 0 0',
+ color: COLORS.fg,
+ fontSize: 14,
+ lineHeight: '22px',
+ },
+ list: {
+ margin: '8px 0 0',
+ paddingLeft: 18,
+ color: COLORS.fg,
+ fontSize: 14,
+ lineHeight: '22px',
+ },
+ note: {
+ marginTop: 8,
+ color: COLORS.muted,
+ fontSize: 13,
+ lineHeight: '20px',
+ },
+ pillRow: {
+ display: 'flex',
+ flexWrap: 'wrap' as const,
+ gap: 8,
+ margin: '8px 0',
+ },
+ pill: {
+ display: 'inline-flex',
+ alignItems: 'center',
+ fontFamily: MONO,
+ fontSize: 11,
+ letterSpacing: 0.4,
+ textTransform: 'uppercase' as const,
+ padding: '4px 8px',
+ borderRadius: 2,
+ background: COLORS.surfaceAlt,
+ color: COLORS.muted,
+ },
+ table: {
+ width: '100%',
+ borderCollapse: 'collapse' as const,
+ marginTop: 12,
+ fontSize: 13,
+ },
+ th: {
+ fontFamily: MONO,
+ fontSize: 10,
+ letterSpacing: 1.2,
+ textTransform: 'uppercase' as const,
+ textAlign: 'left' as const,
+ color: COLORS.muted,
+ fontWeight: 500,
+ padding: '6px 0',
+ borderBottom: `1px solid ${COLORS.border}`,
+ },
+ thRight: {
+ fontFamily: MONO,
+ fontSize: 10,
+ letterSpacing: 1.2,
+ textTransform: 'uppercase' as const,
+ textAlign: 'right' as const,
+ color: COLORS.muted,
+ fontWeight: 500,
+ padding: '6px 0',
+ borderBottom: `1px solid ${COLORS.border}`,
+ },
+ td: {
+ padding: '8px 0',
+ borderBottom: `1px solid ${COLORS.border}`,
+ verticalAlign: 'top' as const,
+ lineHeight: '18px',
+ },
+ tdPoints: {
+ padding: '8px 0 8px 16px',
+ borderBottom: `1px solid ${COLORS.border}`,
+ verticalAlign: 'top' as const,
+ lineHeight: '18px',
+ fontFamily: MONO,
+ fontSize: 12,
+ whiteSpace: 'nowrap' as const,
+ textAlign: 'right' as const,
+ color: COLORS.accent,
+ },
+ link: {
+ color: COLORS.accent,
+ textDecoration: 'underline' as const,
+ },
+} as const;
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/front-components/how-to-review/rank-rows.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/front-components/how-to-review/rank-rows.ts
new file mode 100644
index 00000000000..a941a664cce
--- /dev/null
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/front-components/how-to-review/rank-rows.ts
@@ -0,0 +1,42 @@
+import { MARKETPLACE_RANKING } from 'src/modules/partner/application-intake/constants/marketplace-ranking.constant';
+
+export const RANK_ROWS: { label: string; points: string }[] = [
+ {
+ label: 'Approved case study',
+ points: `+${MARKETPLACE_RANKING.pointsPerCaseStudy} each, max ${MARKETPLACE_RANKING.maxCountedCaseStudies}`,
+ },
+ {
+ label: 'Cover image on a counted case study',
+ points: `+${MARKETPLACE_RANKING.pointsPerCaseStudyCover} each, capped by counted case studies`,
+ },
+ {
+ label: `Introduction, ${MARKETPLACE_RANKING.introductionMinLength}+ characters`,
+ points: `+${MARKETPLACE_RANKING.pointsForIntroduction}`,
+ },
+ {
+ label: 'At least one service',
+ points: `+${MARKETPLACE_RANKING.pointsForService}`,
+ },
+ {
+ label: 'Profile picture',
+ points: `+${MARKETPLACE_RANKING.pointsForProfilePicture}`,
+ },
+ {
+ label: 'Calendar link',
+ points: `+${MARKETPLACE_RANKING.pointsForCalendarLink}`,
+ },
+ {
+ label: 'Hourly rate or min. budget',
+ points: `+${MARKETPLACE_RANKING.pointsForRateOrBudget}`,
+ },
+ {
+ label: 'At least one category',
+ points: `+${MARKETPLACE_RANKING.pointsForCategory}`,
+ },
+];
+
+export const CASE_STUDY_BEATS_QUICK_FIELDS =
+ MARKETPLACE_RANKING.pointsPerCaseStudy >
+ MARKETPLACE_RANKING.pointsForProfilePicture +
+ MARKETPLACE_RANKING.pointsForCalendarLink +
+ MARKETPLACE_RANKING.pointsForRateOrBudget;
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/mappers/build-partner-fields.mapper.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/mappers/build-partner-fields.mapper.ts
index 14ddd47d7f7..b7770545c5e 100644
--- a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/mappers/build-partner-fields.mapper.ts
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/mappers/build-partner-fields.mapper.ts
@@ -84,7 +84,6 @@ export function buildPartnerCreateData(
...partnerFields,
slug: slugify(input.companyName),
validationStage: 'APPLICATION',
- reviewed: false,
partnerTier: 'NEW',
companyId,
deploymentExpertise: deriveDeploymentExpertise(input.partnerScope) as CoreSchema.PartnerDeploymentExpertiseEnum[],
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/navigation-menu-items/how-to-review.navigation-menu-item.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/navigation-menu-items/how-to-review.navigation-menu-item.ts
new file mode 100644
index 00000000000..878a08348fa
--- /dev/null
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/navigation-menu-items/how-to-review.navigation-menu-item.ts
@@ -0,0 +1,16 @@
+import { NavigationMenuItemType, defineNavigationMenuItem } from 'twenty-sdk/define';
+
+import {
+ HOW_TO_REVIEW_NAV_ITEM_ID,
+ HOW_TO_REVIEW_PAGE_LAYOUT_ID,
+} from 'src/modules/partner/application-intake/constants/how-to-review.constants';
+
+export default defineNavigationMenuItem({
+ universalIdentifier: HOW_TO_REVIEW_NAV_ITEM_ID,
+ name: 'How to review',
+ type: NavigationMenuItemType.PAGE_LAYOUT,
+ icon: 'IconListCheck',
+ position: 10,
+ folderUniversalIdentifier: '0b2e499a-ae74-45e0-af08-243e19fc56aa',
+ pageLayoutUniversalIdentifier: HOW_TO_REVIEW_PAGE_LAYOUT_ID,
+});
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/navigation-menu-items/partner-applications.navigation-menu-item.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/navigation-menu-items/partner-applications.navigation-menu-item.ts
index 0156d5fa2eb..d6c9af89931 100644
--- a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/navigation-menu-items/partner-applications.navigation-menu-item.ts
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/navigation-menu-items/partner-applications.navigation-menu-item.ts
@@ -7,7 +7,7 @@ export default defineNavigationMenuItem({
universalIdentifier: PARTNER_APPLICATIONS_NAV_UNIVERSAL_IDENTIFIER,
type: NavigationMenuItemType.VIEW,
icon: 'IconInbox',
- position: 0,
- folderUniversalIdentifier: '857be3b5-82c6-45f7-b546-e20a8a97be8d',
+ position: 9,
+ folderUniversalIdentifier: '0b2e499a-ae74-45e0-af08-243e19fc56aa',
viewUniversalIdentifier: PARTNER_APPLICATIONS_VIEW_UNIVERSAL_IDENTIFIER,
});
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/page-layouts/how-to-review.page-layout.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/page-layouts/how-to-review.page-layout.ts
new file mode 100644
index 00000000000..146e02e4f35
--- /dev/null
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/page-layouts/how-to-review.page-layout.ts
@@ -0,0 +1,35 @@
+import { PageLayoutTabLayoutMode, definePageLayout } from 'twenty-sdk/define';
+
+import {
+ HOW_TO_REVIEW_FRONT_COMPONENT_ID,
+ HOW_TO_REVIEW_PAGE_LAYOUT_ID,
+ HOW_TO_REVIEW_PAGE_TAB_ID,
+ HOW_TO_REVIEW_PAGE_WIDGET_ID,
+} from 'src/modules/partner/application-intake/constants/how-to-review.constants';
+
+export default definePageLayout({
+ universalIdentifier: HOW_TO_REVIEW_PAGE_LAYOUT_ID,
+ name: 'How to review',
+ type: 'STANDALONE_PAGE',
+ tabs: [
+ {
+ universalIdentifier: HOW_TO_REVIEW_PAGE_TAB_ID,
+ title: 'How to review',
+ position: 0,
+ icon: 'IconListCheck',
+ layoutMode: PageLayoutTabLayoutMode.CANVAS,
+ widgets: [
+ {
+ universalIdentifier: HOW_TO_REVIEW_PAGE_WIDGET_ID,
+ title: 'How to review',
+ type: 'FRONT_COMPONENT',
+ gridPosition: { row: 0, column: 0, rowSpan: 14, columnSpan: 12 },
+ configuration: {
+ configurationType: 'FRONT_COMPONENT',
+ frontComponentUniversalIdentifier: HOW_TO_REVIEW_FRONT_COMPONENT_ID,
+ },
+ },
+ ],
+ },
+ ],
+});
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/views/partner-applications.view.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/views/partner-applications.view.ts
index 9bab82e4f35..b5d3d589666 100644
--- a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/views/partner-applications.view.ts
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/application-intake/views/partner-applications.view.ts
@@ -1,5 +1,6 @@
import {
ViewFilterOperand,
+ ViewSortDirection,
ViewType,
defineView,
getFieldUniversalIdentifier,
@@ -11,6 +12,7 @@ import {
PARTNER_SCOPE_FIELD_UNIVERSAL_IDENTIFIER,
PARTNER_TWENTY_EXPERIENCE_FIELD_UNIVERSAL_IDENTIFIER,
PARTNER_TWENTY_EXPERIENCE_NOTES_FIELD_UNIVERSAL_IDENTIFIER,
+ PARTNER_TWENTY_EXPERIENCE_PROOF_LINK_FIELD_UNIVERSAL_IDENTIFIER,
PARTNER_VALIDATION_STAGE_FIELD_UNIVERSAL_IDENTIFIER,
} from 'src/modules/partner/constants/partner-field-universal-identifiers';
import {
@@ -31,7 +33,6 @@ const PARTNER_CREATED_AT_FIELD_ID = getFieldUniversalIdentifier({
name: 'createdAt',
});
-// Naming: partner onboarding applicants — distinct from the Application object's "Applications" view.
export default defineView({
universalIdentifier: PARTNER_APPLICATIONS_VIEW_UNIVERSAL_IDENTIFIER,
name: 'Partner Applications',
@@ -76,17 +77,25 @@ export default defineView({
isVisible: true,
size: 280,
},
+ {
+ universalIdentifier: '2cb2cbe2-887a-4f7b-8aef-d44af8c4de96',
+ fieldMetadataUniversalIdentifier:
+ PARTNER_TWENTY_EXPERIENCE_PROOF_LINK_FIELD_UNIVERSAL_IDENTIFIER,
+ position: 5,
+ isVisible: true,
+ size: 240,
+ },
{
universalIdentifier: '835c9a7e-72ec-46c5-8d90-39a02998f561',
fieldMetadataUniversalIdentifier: PARTNER_CREATED_AT_FIELD_ID,
- position: 5,
+ position: 6,
isVisible: true,
size: 180,
},
{
universalIdentifier: '0175e169-377c-4ff5-b0f0-c3359cac48d9',
fieldMetadataUniversalIdentifier: PARTNER_USER_ON_PARTNER_FIELD_ID,
- position: 6,
+ position: 7,
isVisible: true,
size: 200,
},
@@ -100,4 +109,11 @@ export default defineView({
value: ['APPLICATION'],
},
],
+ sorts: [
+ {
+ universalIdentifier: '5224d99e-32f4-4900-8e6c-e01d4979a2bd',
+ fieldMetadataUniversalIdentifier: PARTNER_CREATED_AT_FIELD_ID,
+ direction: ViewSortDirection.DESC,
+ },
+ ],
});
diff --git a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/objects/partner.object.ts b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/objects/partner.object.ts
index 9482bc79a96..107b58ad64d 100644
--- a/packages/twenty-apps/internal/twenty-partners/src/modules/partner/objects/partner.object.ts
+++ b/packages/twenty-apps/internal/twenty-partners/src/modules/partner/objects/partner.object.ts
@@ -44,14 +44,6 @@ export default defineObject({
{ id: '19dc4929-735a-4b64-8f57-f34f3eaa3a73', value: 'REJECTED', label: 'Rejected', position: 4, color: 'red' },
],
},
- {
- universalIdentifier: '5af4e57e-7fa7-4c4f-b40f-37549361459a',
- type: FieldType.BOOLEAN,
- name: 'reviewed',
- label: 'Reviewed',
- icon: 'IconChecks',
- isNullable: true,
- },
{
universalIdentifier: 'd4fa6461-37b6-49ee-9181-dd482e74a70b',
type: FieldType.SELECT,
diff --git a/packages/twenty-apps/internal/twenty-partners/src/roles/partner.role.ts b/packages/twenty-apps/internal/twenty-partners/src/roles/partner.role.ts
index 9fa913a8c84..43dabfbc2fa 100644
--- a/packages/twenty-apps/internal/twenty-partners/src/roles/partner.role.ts
+++ b/packages/twenty-apps/internal/twenty-partners/src/roles/partner.role.ts
@@ -309,11 +309,6 @@ export default defineRole({
canReadFieldValue: false,
canUpdateFieldValue: false,
},
- {
- objectUniversalIdentifier: PARTNER_OBJECT_UNIVERSAL_IDENTIFIER,
- fieldUniversalIdentifier: '5af4e57e-7fa7-4c4f-b40f-37549361459a',
- canUpdateFieldValue: false,
- },
{
// Partner Tier — read-locked too: admin-only on the record page, hidden from partners.
objectUniversalIdentifier: PARTNER_OBJECT_UNIVERSAL_IDENTIFIER,
diff --git a/packages/twenty-website/src/partner-application/partner-application-copy.test.ts b/packages/twenty-website/src/partner-application/partner-application-copy.test.ts
new file mode 100644
index 00000000000..d2d41e16129
--- /dev/null
+++ b/packages/twenty-website/src/partner-application/partner-application-copy.test.ts
@@ -0,0 +1,19 @@
+import { PARTNER_APPLICATION_COPY } from './partner-application-copy';
+
+describe('partner application proof hint', () => {
+ const hint = PARTNER_APPLICATION_COPY.fields.twentyExperienceProofLinkHint.id;
+
+ it('asks first for a live instance or a YouTube link', () => {
+ expect(hint).toContain('live Twenty instance');
+ expect(hint).toContain('YouTube');
+ expect(hint.indexOf('live Twenty instance')).toBeLessThan(
+ hint.indexOf('Loom'),
+ );
+ });
+
+ it('still accepts the slower formats and says they are slower', () => {
+ expect(hint).toContain('Loom');
+ expect(hint).toContain('Drive');
+ expect(hint).toContain('slower to review');
+ });
+});
diff --git a/packages/twenty-website/src/partner-application/partner-application-copy.ts b/packages/twenty-website/src/partner-application/partner-application-copy.ts
index 3888871a04b..de0c9ce27c7 100644
--- a/packages/twenty-website/src/partner-application/partner-application-copy.ts
+++ b/packages/twenty-website/src/partner-application/partner-application-copy.ts
@@ -48,7 +48,7 @@ export const PARTNER_APPLICATION_COPY = {
twentyExperienceNotesHint: msg`Describe a real Twenty project (customer or internal): who it was for, what you built, and how you used the areas you selected. Min. ${TWENTY_EXPERIENCE_NOTES_MIN_LENGTH} characters.`,
twentyExperienceNotesPlaceholder: msg`Who it was for, what you built, which of the four areas you used…`,
twentyExperienceProofLink: msg`Proof URL *`,
- twentyExperienceProofLinkHint: msg`Link that shows the work (Loom, GitHub, Notion, Drive, public write-up…). No public workspace? Share a short Loom.`,
+ twentyExperienceProofLinkHint: msg`Best proof first: a live Twenty instance URL, a public repo, or a YouTube link. Loom, Drive and file links are accepted but slower to review.`,
hourlyRate: msg`Hourly rate *`,
hourlyRatePlaceholder: msg`150`,
projectBudgetMin: msg`Minimum project budget *`,
diff --git a/packages/twenty-website/src/partners-marketplace/completeness-score.ts b/packages/twenty-website/src/partners-marketplace/completeness-score.ts
index b0562f48ef3..da8ab1da7c0 100644
--- a/packages/twenty-website/src/partners-marketplace/completeness-score.ts
+++ b/packages/twenty-website/src/partners-marketplace/completeness-score.ts
@@ -6,6 +6,12 @@ const MAX_COUNTED_CASE_STUDIES = 3;
// otherwise three quick form fields beat evidence of delivered client work.
const POINTS_PER_CASE_STUDY = 4;
const POINTS_PER_CASE_STUDY_COVER = 1;
+const POINTS_FOR_INTRODUCTION = 2;
+const POINTS_FOR_SERVICE = 2;
+const POINTS_FOR_PROFILE_PICTURE = 1;
+const POINTS_FOR_CALENDAR_LINK = 1;
+const POINTS_FOR_RATE_OR_BUDGET = 1;
+const POINTS_FOR_CATEGORY = 1;
export const completenessScore = (
partner: RankedMarketplacePartner,
@@ -23,14 +29,24 @@ export const completenessScore = (
countedCaseStudies * POINTS_PER_CASE_STUDY +
countedCovers * POINTS_PER_CASE_STUDY_COVER;
- if (partner.description.trim().length >= MIN_DESCRIPTION_LENGTH) score += 2;
- if (partner.serviceCount >= 1) score += 2;
- if (partner.profilePictureUrl) score += 1;
- if (partner.calendarLink) score += 1;
+ if (partner.description.trim().length >= MIN_DESCRIPTION_LENGTH) {
+ score += POINTS_FOR_INTRODUCTION;
+ }
+ if (partner.serviceCount >= 1) {
+ score += POINTS_FOR_SERVICE;
+ }
+ if (partner.profilePictureUrl) {
+ score += POINTS_FOR_PROFILE_PICTURE;
+ }
+ if (partner.calendarLink) {
+ score += POINTS_FOR_CALENDAR_LINK;
+ }
if (partner.hourlyRateUsd !== null || partner.projectBudgetMinUsd !== null) {
- score += 1;
+ score += POINTS_FOR_RATE_OR_BUDGET;
+ }
+ if (partner.partnerScope.length >= 1) {
+ score += POINTS_FOR_CATEGORY;
}
- if (partner.partnerScope.length >= 1) score += 1;
return score;
};
diff --git a/packages/twenty-website/src/partners-marketplace/is-ghost-partner.ts b/packages/twenty-website/src/partners-marketplace/is-ghost-partner.ts
index d24f2e9091d..abc68427b1d 100644
--- a/packages/twenty-website/src/partners-marketplace/is-ghost-partner.ts
+++ b/packages/twenty-website/src/partners-marketplace/is-ghost-partner.ts
@@ -1,4 +1,7 @@
import { type MarketplacePartner } from './marketplace-partner';
+const GHOST_INTRODUCTION_MAX_LENGTH = 40;
+
export const isGhost = (p: MarketplacePartner): boolean =>
- p.description.trim().length < 40 && !p.profilePictureUrl;
+ p.description.trim().length < GHOST_INTRODUCTION_MAX_LENGTH &&
+ !p.profilePictureUrl;