docs: reorganize tree, restore architecture + research from archive, add Phase 0 reports
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>
This commit is contained in:
@@ -0,0 +1,181 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user