feat(dev): add development orchestration scripts for local environment setup

1param(

2 [Parameter(Position = 0)][string]$Command = 'status',

3 [Parameter(Position = 1, ValueFromRemainingArguments = $true)][string[]]$Rest

4)

6$ErrorActionPreference = 'Stop'

8$Root = Split-Path -Parent $PSScriptRoot

9$DevDir = Join-Path $Root 'target\dev'

10$LogDir = Join-Path $DevDir 'logs'

11$PidDir = Join-Path $DevDir 'pids'

12$BinDir = Join-Path $Root 'target\debug'

13$DevHostKey = Join-Path $DevDir 'ssh_host_ed25519'

15$Services = [ordered]@{

16 migrate = @{ Exe = 'migrate'; Port = 0; Health = $false }

17 apihost = @{ Exe = 'apihost'; Port = 4081; Health = $true }

18 githost = @{ Exe = 'githost'; Port = 9418; Health = $true; Extra = @(4022) }

19 im = @{ Exe = 'im'; Port = 4082; Health = $true }

20 synchost = @{ Exe = 'synchost'; Port = 4083; Health = $true }

21 mails = @{ Exe = 'mails'; Port = 4084; Health = $true }

22 adminhost = @{ Exe = 'adminhost'; Port = 3004; Health = $true }

23 webhook = @{ Exe = 'webhook'; Port = 3005; Health = $true }

24 aihost = @{ Exe = 'aihost'; Port = 3006; Health = $true }

25 web = @{ Bun = 'web'; Port = 5173; Health = $false }

26 'web-admin' = @{ Bun = 'admin'; Port = 5174; Health = $false }

27}

28$Order = @('migrate', 'apihost', 'githost', 'im', 'synchost', 'mails', 'adminhost', 'webhook', 'aihost', 'web', 'web-admin')

29$Backends = @('migrate', 'apihost', 'githost', 'im', 'synchost', 'mails', 'adminhost', 'webhook', 'aihost')

30$Aliases = @{

31 api = 'apihost'

32 git = 'githost'

33 chat = 'im'

34 sync = 'synchost'

35 mail = 'mails'

36 hook = 'webhook'

37 ai = 'aihost'

38 admin = 'web-admin'

39 ui = 'web'

40}

42$Urls = [ordered]@{

43 apihost = 'http://127.0.0.1:4081 (Swagger: /api/docs)'

44 githost = 'http://127.0.0.1:9418 ssh://git@127.0.0.1:4022'

45 im = 'ws://127.0.0.1:4082'

46 synchost = 'http://127.0.0.1:4083/healthz'

47 mails = 'http://127.0.0.1:4084/healthz'

48 adminhost = 'http://127.0.0.1:3004'

49 webhook = 'http://127.0.0.1:3005'

50 aihost = 'http://127.0.0.1:3006/healthz'

51 web = 'http://127.0.0.1:5173'

52 'web-admin' = 'http://127.0.0.1:5174'

53}

55$Infra = @(

56 @{ Name = 'postgresql'; Port = 5432 },

57 @{ Name = 'redis8'; Port = 6379 },

58 @{ Name = 'rustfs'; Port = 9000 },

59 @{ Name = 'meilisearch'; Port = 7700 }

60)

62function Write-Info { param([string]$Message) Write-Host $Message }

63function Write-Warn { param([string]$Message) Write-Host $Message -ForegroundColor Yellow }

64function Write-Err { param([string]$Message) Write-Host $Message -ForegroundColor Red }

66function Ensure-Dir {

67 foreach ($dir in @($DevDir, $LogDir, $PidDir)) {

68 if (-not (Test-Path -LiteralPath $dir)) { New-Item -ItemType Directory -Force -Path $dir | Out-Null }

69 }

70}

72function Test-Port {

73 param([int]$Port, [int]$TimeoutMs = 1000)

74 if (-not $Port) { return $false }

75 $client = New-Object System.Net.Sockets.TcpClient

76 try {

77 $task = $client.ConnectAsync('127.0.0.1', $Port)

78 if (-not $task.Wait($TimeoutMs)) { return $false }

79 return $client.Connected

80 } catch {

81 return $false

82 } finally {

83 $client.Dispose()

84 }

85}

87function Test-Health {

88 param([string]$Name)

89 $svc = $Services[$Name]

90 if ($svc.Port -eq 0) { return $true }

91 if ($svc.Health) {

92 try {

93 $res = Invoke-WebRequest -UseBasicParsing -TimeoutSec 3 -Uri ("http://127.0.0.1:{0}/healthz" -f $svc.Port)

94 return ($res.StatusCode -eq 200)

95 } catch {

96 return $false

97 }

98 }

99 return (Test-Port $svc.Port)

100}

102function Get-PidPath { param([string]$Name) Join-Path $PidDir ("$Name.pid") }

104function Register-ServiceProcess {

105 param([string]$Name, [int]$ProcId)

106 Set-Content -LiteralPath (Get-PidPath $Name) -Value $ProcId -Encoding ascii

107}

109function Get-RunningPid {

110 param([string]$Name)

111 $file = Get-PidPath $Name

112 if (-not (Test-Path -LiteralPath $file)) { return 0 }

113 $procId = 0

114 if (-not [int]::TryParse((Get-Content -LiteralPath $file -First 1).Trim(), [ref]$procId)) { return 0 }

115 if (Get-Process -Id $procId -ErrorAction SilentlyContinue) { return $procId }

116 return 0

117}

119function Get-PortOwner {

120 param([int]$Port)

121 if (-not $Port) { return 0 }

122 $conn = Get-NetTCPConnection -State Listen -LocalPort $Port -ErrorAction SilentlyContinue | Select-Object -First 1

123 if ($conn) { return [int]$conn.OwningProcess }

124 return 0

125}

127function Test-OwnedByRepo {

128 param([int]$ProcId)

129 $proc = Get-Process -Id $ProcId -ErrorAction SilentlyContinue

130 if (-not $proc) { return $false }

131 $path = ''

132 try { $path = $proc.Path } catch { }

133 if ($path -and $path.StartsWith($Root, [StringComparison]::OrdinalIgnoreCase)) { return $true }

134 try {

135 $cmd = (Get-CimInstance Win32_Process -Filter "ProcessId=$ProcId" -ErrorAction SilentlyContinue).CommandLine

136 if ($cmd -and $cmd.Contains($Root)) { return $true }

137 } catch { }

138 return $false

139}

141function Ensure-HostKey {

142 if (Test-Path -LiteralPath $DevHostKey) { return $DevHostKey }

143 Ensure-Dir

144 Write-Info "[hostkey] 生成本地 SSH host key: $DevHostKey"

145 & ssh-keygen -q -t ed25519 -f $DevHostKey -N '""' -C 'gitdata-dev' | Out-Null

146 if (-not (Test-Path -LiteralPath $DevHostKey)) { throw 'ssh-keygen 执行失败' }

147 return $DevHostKey

148}

150function Set-ServiceEnv {

151 $hostKey = Ensure-HostKey

152 $env:APP_GIT__SSH__HOST_KEY_PATH = $hostKey

153 foreach ($dir in @('C:\opt\gitdata\repos', 'C:\opt\gitdata\objects')) {

154 if (-not (Test-Path -LiteralPath $dir)) {

155 try { New-Item -ItemType Directory -Force -Path $dir | Out-Null } catch { }

156 }

157 }

158 if (-not (Test-Path -LiteralPath 'C:\opt\gitdata\repos')) {

159 Write-Warn '[warn] 无法创建 C:\opt\gitdata\repos，请在 config/local.toml 或 APP_GIT__REPO_ROOT 指定可写目录'

160 }

161}

163function Invoke-Migrate {

164 Ensure-Dir

165 Set-ServiceEnv

166 $exe = Join-Path $BinDir 'migrate.exe'

167 if (-not (Test-Path -LiteralPath $exe)) { throw '缺少 target\debug\migrate.exe，请先执行 just build' }

168 Write-Info '[migrate] 同步数据库 schema ...'

169 $proc = Start-Process -FilePath $exe -WorkingDirectory $Root -PassThru -Wait `

170 -RedirectStandardOutput (Join-Path $LogDir 'migrate.log') `

171 -RedirectStandardError (Join-Path $LogDir 'migrate.err.log') `

172 -WindowStyle Hidden

173 if ($proc.ExitCode -ne 0) { throw "migrate 失败 (exit=$($proc.ExitCode))，见 just logs migrate" }

174 Write-Info '[migrate] 完成'

175}

177function Start-Daemon {

178 param([string]$Name, [string]$Exe, [string]$Arguments, [string]$WorkingDirectory, [string]$Out, [string]$Err)

179 $launcher = Join-Path $PidDir "$Name.cmd"

180 $lines = @(

181 '@echo off'

182 'set "APP_GIT__SSH__HOST_KEY_PATH=' + $env:APP_GIT__SSH__HOST_KEY_PATH + '"'

183 'cd /d "' + $WorkingDirectory + '"'

184 '"' + $Exe + '" ' + $Arguments + ' 1> "' + $Out + '" 2> "' + $Err + '"'

185 )

186 Set-Content -LiteralPath $launcher -Value $lines -Encoding ascii

188 $cmd = 'cmd.exe /c "' + $launcher + '"'

189 $result = Invoke-CimMethod -ClassName Win32_Process -MethodName Create -Arguments @{

190 CommandLine = $cmd

191 CurrentDirectory = $WorkingDirectory

192 }

193 if ($result.ReturnValue -ne 0) { throw "Win32_Process.Create failed (return=$($result.ReturnValue))" }

194 return [int]$result.ProcessId

195}

197function Start-One {

198 param([string]$Name)

199 $svc = $Services[$Name]

200 $running = Get-RunningPid $Name

201 if ($running -and (Test-Health $Name)) {

202 Write-Info "[$Name] 已在运行 (pid $running)"

203 return $false

204 }

205 if ($svc.Port -and (Test-Port $svc.Port)) {

206 Write-Warn "[$Name] 端口 $($svc.Port) 已被 pid $(Get-PortOwner $svc.Port) 占用，跳过"

207 return $false

208 }

210 Ensure-Dir

211 Set-ServiceEnv

212 $out = Join-Path $LogDir "$Name.log"

213 $err = Join-Path $LogDir "$Name.err.log"

215 if ($svc.ContainsKey('Bun')) {

216 $exe = (Get-Command bun.exe -ErrorAction SilentlyContinue).Source

217 if (-not $exe) { throw '未找到 bun.exe，请先安装 bun 并加入 PATH' }

218 $dir = Join-Path $Root $svc.Bun

219 if (-not (Test-Path -LiteralPath $dir)) { throw "缺少目录 $dir" }

220 $procId = Start-Daemon -Name $Name -Exe $exe -Arguments 'run dev' -WorkingDirectory $dir -Out $out -Err $err

221 } else {

222 $exe = Join-Path $BinDir ($svc.Exe + '.exe')

223 if (-not (Test-Path -LiteralPath $exe)) { throw "缺少 $exe，请先执行 just build" }

224 $procId = Start-Daemon -Name $Name -Exe $exe -Arguments '' -WorkingDirectory $Root -Out $out -Err $err

225 }

227 Register-ServiceProcess $Name $procId

228 Write-Info "[$Name] 启动 pid=$procId"

229 return $true

230}

232function Wait-Ready {

233 param([string]$Name, [int]$TimeoutSec = 60)

234 $deadline = (Get-Date).AddSeconds($TimeoutSec)

235 while ((Get-Date) -lt $deadline) {

236 if (Test-Health $Name) { return $true }

237 if (-not (Get-RunningPid $Name)) { return $false }

238 Start-Sleep -Milliseconds 500

239 }

240 return $false

241}

243function Stop-Stray {

244 param([string]$Name, [int]$Port)

245 if (-not $Port) { return }

246 $owner = Get-PortOwner $Port

247 if (-not $owner) { return }

248 if (Test-OwnedByRepo $owner) {

249 & taskkill /PID $owner /T /F | Out-Null

250 Write-Info "[$Name] 清理残留监听 $Port (pid $owner)"

251 } else {

252 Write-Warn "[$Name] 端口 $Port 仍被 pid $owner 占用（非本仓库进程，未处理）"

253 }

254}

256function Stop-One {

257 param([string]$Name)

258 $svc = $Services[$Name]

259 $procId = Get-RunningPid $Name

260 if ($procId) {

261 & taskkill /PID $procId /T /F | Out-Null

262 Write-Info "[$Name] 已停止 (pid $procId)"

263 } else {

264 Write-Info "[$Name] 未在运行"

265 }

266 Remove-Item -LiteralPath (Get-PidPath $Name) -Force -ErrorAction SilentlyContinue

267 Remove-Item -LiteralPath (Join-Path $PidDir "$Name.cmd") -Force -ErrorAction SilentlyContinue

268 Stop-Stray $Name $svc.Port

269 foreach ($port in @($svc.Extra)) { if ($port) { Stop-Stray $Name $port } }

270}

272function Resolve-Services {

273 param([string[]]$Requested)

274 if (-not $Requested -or $Requested.Count -eq 0) { return $Order }

275 $names = New-Object System.Collections.Generic.List[string]

276 foreach ($item in $Requested) {

277 $raw = $item.Trim()

278 if (-not $raw) { continue }

279 foreach ($part in $raw.Split(',')) {

280 $key = $part.Trim().ToLower()

281 if (-not $key) { continue }

282 if ($Aliases.ContainsKey($key)) { $key = $Aliases[$key] }

283 if ($key -eq 'all') {

284 foreach ($n in $Order) { if (-not $names.Contains($n)) { $names.Add($n) } }

285 continue

286 }

287 if ($key -eq 'backends') {

288 foreach ($n in $Backends) { if (-not $names.Contains($n)) { $names.Add($n) } }

289 continue

290 }

291 if ($key -eq 'frontends') {

292 foreach ($n in @('web', 'web-admin')) { if (-not $names.Contains($n)) { $names.Add($n) } }

293 continue

294 }

295 if (-not $Services.Contains($key)) {

296 throw "未知服务: $part；可用: $($Order -join ', ')（别名: api/git/chat/sync/mail/hook/ai/admin/ui/backends/frontends）"

297 }

298 if (-not $names.Contains($key)) { $names.Add($key) }

299 }

300 }

301 if ($names.Count -eq 0) { return $Order }

302 return $names.ToArray()

303}

305function Invoke-Check {

306 $ok = $true

307 Write-Info '== 工具链 =='

308 foreach ($tool in @('cargo', 'bun', 'ssh-keygen', 'wsl')) {

309 $found = Get-Command $tool -ErrorAction SilentlyContinue

310 if ($found) { Write-Info (" {0,-12} OK" -f $tool) } else { Write-Err (" {0,-12} 缺失" -f $tool); $ok = $false }

311 }

312 Write-Info '== WSL 基础设施 =='

313 foreach ($item in $Infra) {

314 if (Test-Port $item.Port) {

315 Write-Info (" {0,-12} 127.0.0.1:{1} OK" -f $item.Name, $item.Port)

316 } else {

317 Write-Err (" {0,-12} 127.0.0.1:{1} 不可用" -f $item.Name, $item.Port)

318 $ok = $false

319 }

320 }

321 Write-Info '== 后端二进制 =='

322 foreach ($name in $Backends) {

323 $exe = Join-Path $BinDir ($Services[$name].Exe + '.exe')

324 if (Test-Path -LiteralPath $exe) { Write-Info (" {0,-12} OK" -f $name) } else { Write-Warn (" {0,-12} 未构建（just build）" -f $name); $ok = $false }

325 }

326 if (-not $ok) {

327 Write-Info ''

328 Write-Info 'just infra 启动 WSL 侧 PostgreSQL / Redis / RustFS / Meilisearch'

329 Write-Info 'just build 构建全部后端二进制（前端由 build.rs 自动构建并内嵌）'

330 }

331}

333function Invoke-Infra {

334 param([switch]$Stop)

335 $verb = 'start'

336 if ($Stop) { $verb = 'stop' }

337 Write-Info "[infra] $verb WSL 服务: $($Infra.Name -join ', ')"

338 & wsl.exe -d Ubuntu -u root -- systemctl $verb @($Infra.Name)

339 if ($LASTEXITCODE -ne 0) { throw "wsl systemctl $verb 失败，请确认 WSL 发行版 Ubuntu 可用" }

340 Start-Sleep -Seconds 2

341 foreach ($item in $Infra) {

342 $state = 'DOWN'

343 if (Test-Port $item.Port) { $state = 'OK' }

344 Write-Info (" {0,-12} 127.0.0.1:{1} {2}" -f $item.Name, $item.Port, $state)

345 }

346}

348function Invoke-Up {

349 param([string[]]$Requested, [switch]$SkipMigrate)

350 $names = Resolve-Services $Requested

351 $needsBackend = $false

352 foreach ($n in $names) { if ($Backends -contains $n) { $needsBackend = $true } }

354 Set-ServiceEnv

355 foreach ($item in $Infra) {

356 if (-not (Test-Port $item.Port)) { Write-Warn "[warn] $($item.Name) 未监听 127.0.0.1:$($item.Port)，可执行 just infra" }

357 }

358 if ($needsBackend -and -not $SkipMigrate) { Invoke-Migrate }

360 foreach ($name in $Order) {

361 if ($names -notcontains $name) { continue }

362 if ($name -eq 'migrate') { continue }

363 try {

364 $started = Start-One $name

365 } catch {

366 Write-Err "[$name] 启动失败: $($_.Exception.Message)"

367 continue

368 }

369 if ($started) {

370 if (Wait-Ready $name 60) { Write-Info "[$name] 就绪" } else { Write-Err "[$name] 60s 内未就绪，见 just logs $name" }

371 }

372 }

374 Write-Info ''

375 Write-Info '服务地址:'

376 foreach ($name in $Order) {

377 if ($names -notcontains $name) { continue }

378 if ($name -eq 'migrate') { continue }

379 Write-Info (" {0,-10} {1}" -f $name, $Urls[$name])

380 }

381}

383function Invoke-Down {

384 param([string[]]$Requested)

385 $names = Resolve-Services $Requested

386 $reversed = @($Order)

387 [array]::Reverse($reversed)

388 foreach ($name in $reversed) {

389 if ($names -notcontains $name) { continue }

390 Stop-One $name

391 }

392}

394function Invoke-Status {

395 Write-Info ("{0,-10} {1,-8} {2,-9} {3}" -f 'SERVICE', 'PID', 'PORT', 'STATE')

396 foreach ($name in $Order) {

397 if ($name -eq 'migrate') { continue }

398 $svc = $Services[$name]

399 $procId = Get-RunningPid $name

400 $portState = 'closed'

401 if (Test-Port $svc.Port) { $portState = 'listen' }

402 $state = 'stopped'

403 if ($procId) {

404 if (Test-Health $name) { $state = 'ready' } else { $state = 'starting/fail' }

405 }

406 Write-Info ("{0,-10} {1,-8} {2,-9} {3}" -f $name, $procId, $portState, $state)

407 }

408}

410function Invoke-Logs {

411 param([string[]]$Names, [switch]$Follow)

412 if (-not $Names -or $Names.Count -eq 0) { $Names = @('apihost') }

413 $target = $Names[0]

414 if (-not $Services.Contains($target)) { throw "未知服务: $target" }

415 foreach ($name in $Names) {

416 foreach ($suffix in @('log', 'err.log')) {

417 $path = Join-Path $LogDir "$name.$suffix"

418 if ((Test-Path -LiteralPath $path) -and (Get-Item -LiteralPath $path).Length -gt 0) {

419 Write-Info "===== $name.$suffix (tail 80) ====="

420 Get-Content -LiteralPath $path -Tail 80

421 }

422 }

423 }

424 if ($Follow) {

425 $path = Join-Path $LogDir "$target.log"

426 if (-not (Test-Path -LiteralPath $path)) { throw "没有日志文件: $path" }

427 Write-Info "===== follow $target.log (Ctrl+C 退出) ====="

428 Get-Content -LiteralPath $path -Tail 0 -Wait

429 }

430}

432function Get-ConfigUrl {

433 param([string]$Scheme)

434 $file = Join-Path $Root 'config\local.toml'

435 if (Test-Path -LiteralPath $file) {

436 $pattern = '^\s*url\s*=\s*"' + $Scheme + '://([^"]+)"'

437 foreach ($line in Get-Content -LiteralPath $file) {

438 if ($line -match $pattern) { return ($Scheme + '://' + $Matches[1]) }

439 }

440 }

441 return ''

442}

444function Invoke-Psql {

445 $url = Get-ConfigUrl 'postgres'

446 if (-not $url) { throw '未能从 config/local.toml 解析 postgres url' }

447 Write-Info "[psql] $url"

448 & wsl.exe -d Ubuntu -- psql $url

449}

451function Invoke-Redis {

452 $url = Get-ConfigUrl 'redis'

453 if (-not $url) { throw '未能从 config/local.toml 解析 redis url' }

454 Write-Info "[redis-cli] $url"

455 & wsl.exe -d Ubuntu -- redis-cli -u $url

456}

458try {

459 switch ($Command.ToLower()) {

460 'check' { Invoke-Check }

461 'infra' { Invoke-Infra }

462 'infra-down' { Invoke-Infra -Stop }

463 'hostkey' { Write-Info "[hostkey] $(Ensure-HostKey)" }

464 'migrate' { Invoke-Migrate }

465 'up' { Invoke-Up -Requested $Rest }

466 'down' { Invoke-Down -Requested $Rest }

467 'restart' { Invoke-Down -Requested $Rest; Invoke-Up -Requested $Rest -SkipMigrate }

468 'status' { Invoke-Status }

469 'psql' { Invoke-Psql }

470 'redis' { Invoke-Redis }

471 'logs' {

472 $follow = $false

473 $names = @()

474 foreach ($item in $Rest) {

475 if ($item -in @('-f', '--follow')) { $follow = $true } else { $names += $item }

476 }

477 Invoke-Logs -Names $names -Follow:$follow

478 }

479 default { throw "未知命令: $Command (check/infra/infra-down/hostkey/migrate/up/down/restart/status/logs/psql/redis)" }

480 }

481} catch {

482 Write-Err "ERROR: $($_.Exception.Message)"

483 exit 1

484}

1# 本地开发依赖服务（macOS / Linux）。

2# 与 config/local.toml 的默认端口一一对应：

3# PostgreSQL 5432 / Redis 6379 / S3(RustFS) 9000 / Meilisearch 7700

4# 用法：

5# just infra 启动

6# just infra-down 停止

7# 仅用于本地开发，账号密码均为固定值，请勿用于任何对外环境。

8name: gitdata-dev

10services:

11 postgres:

12 image: postgres:16-alpine

13 container_name: gitdata-dev-postgres

14 restart: unless-stopped

15 environment:

16 POSTGRES_USER: postgres

17 POSTGRES_PASSWORD: postgres

18 POSTGRES_DB: gitdata

19 ports:

20 - "127.0.0.1:5432:5432"

21 volumes:

22 - postgres-data:/var/lib/postgresql/data

23 healthcheck:

24 test: ["CMD-SHELL", "pg_isready -U postgres -d gitdata"]

25 interval: 5s

26 timeout: 3s

27 retries: 20

29 redis:

30 image: redis:7-alpine

31 container_name: gitdata-dev-redis

32 restart: unless-stopped

33 command: ["redis-server", "--appendonly", "no", "--save", ""]

34 ports:

35 - "127.0.0.1:6379:6379"

36 healthcheck:

37 test: ["CMD", "redis-cli", "ping"]

38 interval: 5s

39 timeout: 3s

40 retries: 20

42 # S3 兼容对象存储：RustFS

43 rustfs:

44 image: rustfs/rustfs:latest

45 container_name: gitdata-dev-rustfs

46 restart: unless-stopped

47 environment:

48 RUSTFS_ADDRESS: ":9000"

49 RUSTFS_CONSOLE_ENABLE: "true"

50 RUSTFS_CONSOLE_ADDRESS: ":9001"

51 RUSTFS_ACCESS_KEY: rustfsadmin

52 RUSTFS_SECRET_KEY: rustfsadmin

53 RUSTFS_VOLUMES: /data

54 ports:

55 - "127.0.0.1:9000:9000"

56 - "127.0.0.1:9001:9001"

57 volumes:

58 - rustfs-data:/data

59 healthcheck:

60 test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:9000/ >/dev/null || exit 1"]

61 interval: 5s

62 timeout: 3s

63 retries: 20

65 meilisearch:

66 image: getmeili/meilisearch:v1.13

67 container_name: gitdata-dev-meilisearch

68 restart: unless-stopped

69 environment:

70 MEILI_MASTER_KEY: 48e6813b44ed0de5d7272e06967703fb

71 MEILI_ENV: development

72 MEILI_NO_ANALYTICS: "true"

73 ports:

74 - "127.0.0.1:7700:7700"

75 volumes:

76 - meili-data:/meili_data

77 healthcheck:

78 test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:7700/health >/dev/null || exit 1"]

79 interval: 5s

80 timeout: 3s

81 retries: 20

83 # 本地 S3 bucket 初始化（建出 config/local.toml 里声明的 bucket）

84 minio-init:

85 image: minio/mc:latest

86 container_name: gitdata-dev-bucket-init

87 depends_on:

88 rustfs:

89 condition: service_started

90 entrypoint: ["/bin/sh", "-c"]

91 command:

92 - |

93 until mc alias set local http://rustfs:9000 rustfsadmin rustfsadmin >/dev/null 2>&1; do sleep 1; done

94 mc mb --ignore-existing local/gitdata

95 echo "bucket ready: gitdata"

97volumes:

98 postgres-data:

99 rustfs-data:

100 meili-data:

1# GitData 本地开发入口（Windows / macOS / Linux）。

2#

3# Windows：直接在 Windows 上跑 Rust/前端，依赖服务（PostgreSQL / Redis / RustFS /

4# Meilisearch）由 WSL(Ubuntu) 的 systemd 托管（just infra）。

5# macOS/Linux：原生跑 Rust/前端，依赖服务由 docker compose 托管（just infra）。

6#

7# 配置沿用 config/local.toml（gitignore）。首次使用：

8# just check -> just infra -> just build -> just up

9# 常用：just up / just down / just status / just tail apihost

10#

11# 依赖工具：cargo、bun、ssh-keygen；Windows 额外需要 WSL 的 Ubuntu 发行版，

12# macOS/Linux 额外需要 docker + docker compose。

13# 需要 just >= 1.21。

15set shell := ["bash", "-cu"]

16set windows-shell := ["powershell.exe", "-NoLogo", "-NoProfile", "-Command"]

18root := justfile_directory()

19dev := if os() == "windows" {

20 root + "\\scripts\\dev.ps1"

21} else {

22 root + "/scripts/dev.sh"

23}

24# PowerShell 调用脚本需要 & 前缀；POSIX shell 直接执行

25invoke := if os() == "windows" { "& " } else { "" }

27# 查看服务状态（默认）

28status:

29 @{{ invoke }}"{{ dev }}" status

31# 自检：工具链 / 依赖服务 / 后端二进制

32check:

33 @{{ invoke }}"{{ dev }}" check

35# 启动依赖服务：PostgreSQL / Redis / RustFS(S3) / Meilisearch

36infra:

37 @{{ invoke }}"{{ dev }}" infra

39# 停止依赖服务

40infra-down:

41 @{{ invoke }}"{{ dev }}" infra-down

43# 生成 githost 使用的本地 SSH host key（target/dev/ssh_host_ed25519）

44hostkey:

45 @{{ invoke }}"{{ dev }}" hostkey

47# 同步数据库 schema

48migrate:

49 @{{ invoke }}"{{ dev }}" migrate

51# 构建全部后端二进制（web/admin 前端由 build.rs 构建并内嵌）

52build:

53 @cargo build --bins

55# 构建全部后端 release 二进制

56build-release:

57 @cargo build --release --bins

59# 启动全部服务（后端 + web + admin）

60up *svc='':

61 @{{ invoke }}"{{ dev }}" up {{ svc }}

63# 仅启动后端服务（apihost/githost/im/synchost/mails/adminhost/webhook/aihost）

64up-backend:

65 @{{ invoke }}"{{ dev }}" up backends

67# 仅启动前端 web(5173) 与 admin(5174)

68up-frontend:

69 @{{ invoke }}"{{ dev }}" up frontends

71# 停止全部服务，或指定：just down apihost im

72down *svc='':

73 @{{ invoke }}"{{ dev }}" down {{ svc }}

75# 重启全部服务，或指定：just restart apihost

76restart *svc='':

77 @{{ invoke }}"{{ dev }}" restart {{ svc }}

79# 最近日志：just logs / just logs apihost / just logs "apihost im"

80logs *svc="apihost":

81 @{{ invoke }}"{{ dev }}" logs {{ svc }}

83# 跟踪日志：just tail / just tail apihost

84tail svc="apihost":

85 @{{ invoke }}"{{ dev }}" logs {{ svc }} -f

87# 进入 PostgreSQL 交互终端

88psql:

89 @{{ invoke }}"{{ dev }}" psql

91# 进入 redis-cli 交互终端

92redis:

93 @{{ invoke }}"{{ dev }}" redis

95# URL 速查

96urls:

97 @echo " apihost http://127.0.0.1:4081 (Swagger: /api/docs)"

98 @echo " githost http://127.0.0.1:9418 ssh://git@127.0.0.1:4022"

99 @echo " im ws://127.0.0.1:4082"

100 @echo " synchost http://127.0.0.1:4083/healthz"

101 @echo " mails http://127.0.0.1:4084/healthz"

102 @echo " adminhost http://127.0.0.1:3004"

103 @echo " webhook http://127.0.0.1:3005"

104 @echo " aihost http://127.0.0.1:3006/healthz"

105 @echo " web http://127.0.0.1:5173"

106 @echo " web-admin http://127.0.0.1:5174"

108# 重新生成 openapi.json 与 admin/openapi.json

109openapi:

110 @cargo run -p openapi

112# 校验 openapi 是否与源码一致

113openapi-check:

114 @cargo run -p openapi -- --check

116# web 前端单独构建（cargo 构建时会自动执行）

117web-build:

118 @bun run --cwd web build

120# admin 前端单独构建

121admin-build:

122 @bun run --cwd admin build

124# web 前端 lint（oxlint + FSD 导航守卫）

125web-lint:

126 @bun run --cwd web lint

128# cargo fmt --all

129fmt:

130 @cargo fmt --all

132# cargo clippy 全 workspace

133clippy:

134 @cargo clippy --workspace --all-targets --all-features

136# 清理构建产物

137clean:

138 @cargo clean