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>
1.9 KiB
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.