cesnimda
b176a44627
Active docs/ was stub scaffolding while the real docs sat in docs/_archive/. Restore and correct them, and record the Phase 0 work. - docs/architecture/current.md: verified system map (from archived SYSTEM_OVERVIEW, 9 corrections against code). - docs/research/competitors.md: sourced competitor analysis (from archived PRODUCT_RESEARCH, feature matrix corrected). - docs/decisions/ADR-002-job-application-model.md: the Job/JobApplication split. - docs/application-discovery-report.md, docs/implementation-roadmap.md, docs/phase-0-foundation-report.md, docs/career-workspace-branch-assessment.md. - Remove 10 zero-byte placeholder files that advertised content that never existed. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
181 lines
1.9 KiB
Markdown
181 lines
1.9 KiB
Markdown
# User Onboarding Experience
|
|
|
|
## Purpose
|
|
|
|
Define how new users should experience Jobjakt from registration to first successful job application workflow.
|
|
|
|
The onboarding goal is not to show every feature.
|
|
|
|
The goal is to quickly help users achieve value.
|
|
|
|
---
|
|
|
|
# Core Principle
|
|
|
|
The user should understand:
|
|
|
|
"Jobjakt helps me organise my job search and create better applications."
|
|
|
|
within the first few minutes.
|
|
|
|
---
|
|
|
|
# Current Ideal Flow
|
|
|
|
## Step 1 - Registration
|
|
|
|
Supported:
|
|
|
|
- Email/password registration.
|
|
- Google registration.
|
|
- Microsoft registration.
|
|
|
|
After registration:
|
|
|
|
Create user account.
|
|
|
|
Verify email where required.
|
|
|
|
Redirect to onboarding.
|
|
|
|
---
|
|
|
|
# Step 2 - Profile Creation
|
|
|
|
Collect basic information:
|
|
|
|
Required:
|
|
|
|
- Name.
|
|
- Email.
|
|
|
|
Optional:
|
|
|
|
- Profile picture.
|
|
- Location.
|
|
- Professional title.
|
|
|
|
Avoid asking unnecessary questions.
|
|
|
|
---
|
|
|
|
# Step 3 - Import Career Information
|
|
|
|
Prompt user:
|
|
|
|
"Do you already have a CV?"
|
|
|
|
Options:
|
|
|
|
## Upload CV
|
|
|
|
Supported:
|
|
|
|
- PDF.
|
|
- DOCX.
|
|
- Common CV formats.
|
|
|
|
System:
|
|
|
|
- Extracts information.
|
|
- Creates structured career profile.
|
|
- Allows user review.
|
|
|
|
---
|
|
|
|
## Create Manually
|
|
|
|
User builds:
|
|
|
|
- Experience.
|
|
- Skills.
|
|
- Education.
|
|
|
|
---
|
|
|
|
# Step 4 - Connect Email
|
|
|
|
Optional.
|
|
|
|
Purpose:
|
|
|
|
Enable:
|
|
|
|
- Email tracking.
|
|
- Application communication.
|
|
|
|
Supported providers:
|
|
|
|
- Gmail.
|
|
- Microsoft.
|
|
- IMAP.
|
|
|
|
Do not block the user.
|
|
|
|
---
|
|
|
|
# Step 5 - Add First Job
|
|
|
|
Guide user through:
|
|
|
|
Import job URL.
|
|
|
|
↓
|
|
|
|
Extract details.
|
|
|
|
↓
|
|
|
|
Review information.
|
|
|
|
↓
|
|
|
|
Create application.
|
|
|
|
---
|
|
|
|
# Step 6 - Create Application Documents
|
|
|
|
Optional workflow:
|
|
|
|
CV
|
|
|
|
↓
|
|
|
|
Cover Letter
|
|
|
|
↓
|
|
|
|
Portfolio
|
|
|
|
↓
|
|
|
|
Additional files
|
|
|
|
Users can skip any step.
|
|
|
|
---
|
|
|
|
# Onboarding Rules
|
|
|
|
Never:
|
|
|
|
- Force users through long forms.
|
|
- Require optional information.
|
|
- Hide the skip option.
|
|
|
|
Always:
|
|
|
|
- Show progress.
|
|
- Explain benefits.
|
|
- Provide clear next actions.
|
|
|
|
---
|
|
|
|
# First Success Moment
|
|
|
|
The user should reach:
|
|
|
|
"I have my first job application tracked."
|
|
|
|
as quickly as possible. |