新员工入职首日沉浸指南：一键搭建本地环境与提交第一个 PR

在很多初创团队中，“新员工入职（Onboarding）”往往是一个充满挫败感的过程：
新招来的资深工程师第一天入职，领到电脑后，开始按照一份陈旧的 Wiki 文档手动安装各种依赖。结果因为本地操作系统版本差异、缺少某个未记录的环境变量、或者本地数据库版本不兼容，整整折腾了两天依然无法在本地把项目跑起来。

新员工在无尽的环境报错中耗尽了最初的热情，团队也浪费了宝贵的高薪工时。

工程效能优秀的团队，必须把“首日极速沉浸（Day-1 Onboarding）”当成衡量工程基础设施健康度的核心指标：
新员工从领取电脑、克隆代码，到本地一键拉起完整开发环境、跑通核心单测并向主干提交第一个有效的 PR，整个过程必须在 3 小时内彻底闭环。

Day-1 极速入职的三大工程基石

为了消灭环境配置摩擦，我们在代码库中落地了三套自动化基建：

┌────────────────────────────────────────────────────────┐
│             【基石一：Docker Compose 一键依赖底座】      │
│  - 纯本地运行：PostgreSQL (含 pgvector)、Redis、MinIO  │
│  - 一行命令：make up 瞬间拉起所有依赖，0 外部环境依赖   │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│             【基石二：自动化假数据与种子数据注入 (Seeding)】│
│  - 一行命令：make seed 自动注入包含 10 个测试租户与   │
│    50 条完整工作流的测试数据集，即刻具备真实交互体验   │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│             【基石三：第一个“破冰 PR (Good First Issue)”】│
│  - 在看板中常驻一个明确的微小任务 (如补充一个健康检查) │
│  - 当天完成 PR 提交、CI 门禁验证与正式合并主干上线     │
└────────────────────────────────────────────────────────┘

极简但全能的 Makefile 入职指令集

在项目根目录下，Makefile 是唯一的开发者交互入口：

.PHONY: help up down seed test run-dev

help:
	@echo "YueJoy 开发者极速上手指令集:"
	@echo "  make up       - 一键拉起本地 PostgreSQL/pgvector/Redis 容器"
	@echo "  make seed     - 注入本地测试种子数据"
	@echo "  make test     - 运行全量核心单元测试"
	@echo "  make run-dev  - 启动后端开发热重载服务"

up:
	@echo "--> 正在启动本地基础依赖容器..."
	docker compose -f deployments/docker-compose.dev.yml up -d

seed:
	@echo "--> 正在注入开发测试种子数据..."
	go run scripts/seed/main.go

test:
	@echo "--> 正在执行全量单元测试与竞态检测..."
	go test -race -coverprofile=coverage.out ./internal/...

run-dev: up
	@echo "--> 启动 Go 后端开发服务 (端口: 8080)..."
	go run cmd/server/main.go

新员工首日下午的“破冰仪式”：提交第一个 PR

入职第一天的下午 15:00，Mentor 会为新员工分配一个预先准备好的“Good First Issue”：

• 例如：为健康检查接口 /healthz 增加一个返回当前服务 Git Commit Hash 的字段；
• 或者：为工作流解析器补充两个边界异常情况的表驱动测试用例。

新员工按照以下标准流程走通闭环：

1. 切出分支 feature/day1-onboarding-check；
2. 修改代码并本地执行 make test 验证通过；
3. 向 GitHub 提交 PR；
4. 自动化 CI 流水线在 2 分钟内亮起绿灯；
5. Mentor 在 10 分钟内完成 Code Review 并点击 Approve；
6. 代码合并进 main，自动化 CD 流水线将其部署至预发环境。

极速 Onboarding 带来的文化力量

当新员工在入职第一天的下班前，看到自己亲手编写的代码已经合并进主干并在测试环境中正常运行时，其内心会建立起对团队工程素养极其强烈的敬畏与信任。

把繁琐的环境配置封装在自动化工具之中，让每一位新加入的优秀人才能够把全部智力即刻投入到业务创造中，这是高战斗力小团队最硬核的技术文化。