Skip to content

Commit f8f9977

Browse files
httpsphlhttpsphl
authored
Merge pull request #210 from httpsphl/feat/catalog-marketing-roles
feat(catalog): eighteen marketing and sales roles (G4, 2/4)
2 parents 174a41b + 4a195ff commit f8f9977

31 files changed

Lines changed: 1177 additions & 14 deletions

‎app/src/features/catalog/agency.test.tsx‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ describe("the Bot agency", () => {
3333

3434
fireEvent.click(within(invite).getByRole("button", { name: "See all bots" }));
3535
const dialog = await screen.findByRole("dialog", { name: "Bot agency" });
36-
expect(await within(dialog).findAllByRole("listitem")).toHaveLength(26);
36+
expect(await within(dialog).findAllByRole("listitem")).toHaveLength(44);
3737
});
3838

3939
test("a crew with only its chief invites the owner to pick bots, and a click adds one", async () => {
@@ -82,10 +82,10 @@ describe("the Bot agency", () => {
8282
await openCrewWithChief();
8383
fireEvent.click(screen.getByRole("button", { name: "Bot agency" }));
8484
const dialog = await screen.findByRole("dialog", { name: "Bot agency" });
85-
expect(await within(dialog).findAllByRole("listitem")).toHaveLength(26);
85+
expect(await within(dialog).findAllByRole("listitem")).toHaveLength(44);
8686

87-
// Only the kinds that have a role are offered.
88-
expect(within(dialog).queryByRole("button", { name: "Marketing & sales" })).toBeNull();
87+
fireEvent.click(within(dialog).getByRole("button", { name: "Marketing & sales" }));
88+
expect(within(dialog).getAllByRole("listitem")).toHaveLength(18);
8989
fireEvent.click(within(dialog).getByRole("button", { name: "Product & management" }));
9090
expect(within(dialog).getAllByRole("listitem")).toHaveLength(14);
9191

@@ -129,7 +129,7 @@ describe("the Bot agency", () => {
129129
expect(addCalls(fake)[0]).toMatchObject({ templateId: "code-reviewer" });
130130

131131
fireEvent.click(within(dialog).getByRole("button", { name: "Back to all bots" }));
132-
expect(within(dialog).getAllByRole("listitem")).toHaveLength(26);
132+
expect(within(dialog).getAllByRole("listitem")).toHaveLength(44);
133133
});
134134

135135
test("the same role twice gets another name", async () => {

‎app/src/i18n/en/catalog.ts‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
import { base } from "./catalogBase";
2+
import { marketing } from "./catalogMarketing";
23
import { product } from "./catalogProduct";
34

45
// The Bot agency (spec 26): ready-made bots the owner adds to a crew. The
@@ -45,5 +46,5 @@ export const catalog = {
4546
pairs: "Works well with",
4647
technical: "What the bot is told when it starts",
4748
},
48-
roles: { ...base, ...product },
49+
roles: { ...base, ...product, ...marketing },
4950
};

‎app/src/i18n/en/catalogMarketing.ts‎

Lines changed: 172 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,172 @@
1+
// Marketing and sales roles (spec 26.3): what the owner reads about each.
2+
3+
export const marketing = {
4+
"seo-specialist": {
5+
name: "SEO Specialist",
6+
role: "Helps a site show up in search: finds what people look for, fixes pages and plans content",
7+
summary: "Finds what people search for and improves your pages so they get found",
8+
about:
9+
"Finds the words people really use to look for what you sell, checks your pages for what holds them back and suggests changes to titles, text and structure. It only uses honest methods, and results take weeks.",
10+
when: "When your site is up but people are not finding it.",
11+
pairs: "Writer, to write the pages, and Developer, to fix technical problems.",
12+
},
13+
"email-marketer": {
14+
name: "Email Marketer",
15+
role: "Plans and writes email campaigns and sequences, with a clear goal and respect for consent",
16+
summary:
17+
"Writes emails and sequences that get opened and answered, with consent and an easy way out",
18+
about:
19+
"Plans and writes emails and automatic sequences (welcome, follow-up, win-back, announcements) with subject-line options and a clear action. It never sends anything and it reminds you that email laws apply.",
20+
when: "When you have a list of people who agreed to hear from you and want to use it well.",
21+
pairs: "Designer, for the layout, and Data Analyst, to read the results.",
22+
},
23+
"content-strategist": {
24+
name: "Content Strategist",
25+
role: "Plans what to publish, for whom and why, so that content supports a business goal",
26+
summary: "Plans what to publish, for whom and why, with a calendar tied to your goals",
27+
about:
28+
"Chooses a few themes you can speak about with real knowledge, and builds a calendar you can keep: each piece with its goal, its format and the question it answers. Then it writes a short brief for each.",
29+
when: "When you post a lot but do not know if it leads anywhere.",
30+
pairs: "Writer and Video Scriptwriter, who make the pieces, and Researcher, for facts.",
31+
},
32+
copywriter: {
33+
name: "Copywriter",
34+
role: "Writes persuasive, honest copy for ads, landing pages and product pages",
35+
summary: "Writes headlines and copy that make people act, without exaggerating",
36+
about:
37+
"Writes headlines, ads, landing pages and product descriptions with several options, each built on what the buyer cares about. It keeps claims you can prove and never makes up testimonials or numbers.",
38+
when: "When a page or an ad is not getting people to act.",
39+
pairs: "SEO Specialist, for search words, and Designer, for the layout.",
40+
},
41+
"ads-manager": {
42+
name: "Ads Manager",
43+
role: "Plans paid ad campaigns, writes the ads and reads the results, but never spends money by itself",
44+
summary:
45+
"Plans your ads, writes them and reads the results, and never spends a cent without you",
46+
about:
47+
"Plans a small start for your paid ads, writes them for each platform and, when you give it the numbers, tells you what to stop, keep and test. It never creates or pays for an ad: you do, with its plan.",
48+
when: "When you want to try paid ads without wasting money.",
49+
pairs: "Copywriter, for the text, and Data Analyst, for the numbers.",
50+
},
51+
"video-scriptwriter": {
52+
name: "Video Scriptwriter",
53+
role: "Writes scripts and shot lists for short and long videos",
54+
summary:
55+
"Writes video scripts with a strong start, a clear structure and a list of shots to film",
56+
about:
57+
"Writes scripts in two columns, what is said and what is seen, with a strong first few seconds and a list of what you need to film. It does not make the video.",
58+
when: "For a short video, a product demo or a tutorial.",
59+
pairs:
60+
"Content Strategist, for the plan around the video, and Copywriter, for the call to action.",
61+
},
62+
"newsletter-editor": {
63+
name: "Newsletter Editor",
64+
role: "Plans and writes a recurring newsletter: topics, issues and a consistent voice",
65+
summary: "Plans and writes your newsletter issue by issue, in a voice readers recognize",
66+
about:
67+
"Defines what your newsletter promises, keeps a plan of the next issues and writes each one in a steady voice. It checks facts, credits its sources and never sends an issue by itself.",
68+
when: "When you want a newsletter but not the weekly blank page.",
69+
pairs: "Researcher, for facts, and Designer, for images.",
70+
},
71+
"community-manager": {
72+
name: "Community Manager",
73+
role: "Drafts replies, welcomes members and flags problems in your community, following rules you set",
74+
summary: "Prepares replies and moderation for your community, following the rules you set",
75+
about:
76+
"Drafts replies and welcome messages in your community's voice and flags what needs you: complaints, harassment, safety or legal matters. It never posts, deletes or bans anyone on its own.",
77+
when: "When your group or page is growing faster than you can answer.",
78+
pairs:
79+
"Customer Support, for customer problems, and Content Strategist, for conversation ideas.",
80+
},
81+
"ecommerce-manager": {
82+
name: "E-commerce Manager",
83+
role: "Looks after an online store: product pages, catalog, promotions and what to fix first",
84+
summary: "Improves your online store: product pages, catalog, promotions and what to fix first",
85+
about:
86+
"Goes through your product pages like a buyer, rewrites titles and descriptions, looks at what sells and what does not and plans promotions your margin can afford. It never touches the store itself.",
87+
when: "When you have an online store and want more sales from it.",
88+
pairs: "Copywriter, for text, and SEO Specialist, for search.",
89+
},
90+
"brand-strategist": {
91+
name: "Brand Strategist",
92+
role: "Defines what a brand stands for, how it sounds and how it differs from others",
93+
summary: "Defines who your brand is, how it speaks and what makes it different",
94+
about:
95+
"Asks about your story, looks at how similar businesses present themselves and writes a short guide: who you serve, your promise, your values, your voice with examples, and what makes you different.",
96+
when: "When you are starting out, or when what you say sounds like everyone else.",
97+
pairs: "Designer, Copywriter and Content Strategist, who follow the guide.",
98+
},
99+
"competitor-analyst": {
100+
name: "Competitor Analyst",
101+
role: "Studies competitors from public information and shows where you stand and where you can win",
102+
summary: "Studies your competitors from public sources and shows where you can stand out",
103+
about:
104+
"Reads your competitors' sites, prices, offers and reviews, compares them with you on what customers care about and suggests moves. Everything has its source and date, and it only uses public information.",
105+
when: "Before you set prices, launch something or change how you present yourself.",
106+
pairs: "Pricing Analyst and Brand Strategist, who use what it finds.",
107+
},
108+
"growth-marketer": {
109+
name: "Growth Marketer",
110+
role: "Designs small experiments to get more customers and checks which ones worked",
111+
summary: "Runs small, measured experiments to find what brings more customers",
112+
about:
113+
"Finds the biggest leak between a stranger and a customer and proposes one small experiment at a time, with what to measure and how long to wait. It tells you honestly when a result is just noise.",
114+
when: "When you want more customers and do not know what to try first.",
115+
pairs: "Data Analyst, for the numbers, and Ads Manager or Email Marketer, to run a test.",
116+
},
117+
"conversion-optimizer": {
118+
name: "Conversion Optimizer",
119+
role: "Finds why visitors do not buy or sign up and proposes fixes to test",
120+
summary: "Finds why visitors leave without buying and suggests changes to test",
121+
about:
122+
"Walks through your page as a stranger on a phone, finds what makes people doubt or give up and proposes specific changes, ordered by expected effect, each one to be tested. No tricks like fake countdowns.",
123+
when: "When you get visits but few sales or sign-ups.",
124+
pairs: "Copywriter and Designer, who make the changes, and Data Analyst, to read the tests.",
125+
},
126+
"pr-writer": {
127+
name: "PR Writer",
128+
role: "Writes press releases, pitches and statements that are accurate and newsworthy",
129+
summary: "Writes press releases and pitches that journalists can use, and that are true",
130+
about:
131+
"Writes press releases, pitches to journalists and statements, and tells you when there is no real news. Every fact comes from you or a named source, and it sends nothing to anyone.",
132+
when: "For a launch, an award, an event or a delicate moment you must explain.",
133+
pairs: "Researcher, to find outlets, and Writer, to polish.",
134+
},
135+
"reputation-manager": {
136+
name: "Reputation Manager",
137+
role: "Reads reviews and mentions, drafts honest replies and spots patterns to fix",
138+
summary: "Reads your reviews, drafts honest replies and shows what customers keep saying",
139+
about:
140+
"Sorts your reviews, drafts a reply to each one that needs it and shows what customers keep praising or complaining about, so you can fix the cause. It never argues, never writes fake reviews and never posts by itself.",
141+
when: "When reviews pile up and you do not have time to answer them well.",
142+
pairs: "Customer Support and Operations Manager, to fix real problems.",
143+
},
144+
"proposal-writer": {
145+
name: "Proposal Writer",
146+
role: "Writes clear proposals and quotes that match what the client asked for",
147+
summary:
148+
"Writes proposals and quotes that answer what the client asked and are easy to say yes to",
149+
about:
150+
"Writes the client's problem back to them, lists exactly what is and is not included, lays out the steps, the price and the terms, and makes it easy to accept. It asks you for the numbers instead of inventing them.",
151+
when: "When a client asks for a quote and you want to answer well and fast.",
152+
pairs: "Pricing Analyst, for the price, and Sales Coach, for the conversation.",
153+
},
154+
"sales-coach": {
155+
name: "Sales Coach",
156+
role: "Prepares for sales conversations: questions, objections and follow-ups, with practice",
157+
summary: "Helps you prepare sales calls, handle objections and follow up well",
158+
about:
159+
"Prepares you for a sales conversation with the right questions and honest answers to the objections you expect, plays the customer so you can practice and writes the follow-up. It never helps pressure anyone.",
160+
when: "Before an important call, or when you keep losing the same kind of sale.",
161+
pairs: "Researcher, to learn about the customer, and Proposal Writer.",
162+
},
163+
"pricing-analyst": {
164+
name: "Pricing Analyst",
165+
role: "Helps set prices from costs, competitors and what customers value, and tests options",
166+
summary: "Helps you set prices from your costs, the market and what customers value",
167+
about:
168+
"Works out your real cost and margin, compares what others charge and what they include, proposes a price range with the reasons and a small test to try. You always set the price.",
169+
when: "When you are launching something, or suspect you charge too little.",
170+
pairs: "Competitor Analyst, for the market, and Data Analyst, for sales numbers.",
171+
},
172+
};

‎app/src/i18n/es/catalog.ts‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
import type { Messages } from "../en";
22
import { base } from "./catalogBase";
3+
import { marketing } from "./catalogMarketing";
34
import { product } from "./catalogProduct";
45

56
export const catalog: Messages["catalog"] = {
@@ -42,5 +43,5 @@ export const catalog: Messages["catalog"] = {
4243
pairs: "Combina bien con",
4344
technical: "Lo que recibe el bot cuando empieza",
4445
},
45-
roles: { ...base, ...product },
46+
roles: { ...base, ...product, ...marketing },
4647
};

0 commit comments

Comments
 (0)