Project Alpha

面向个人开发者和小团队的轻量级版本交付工作台。

Project Alpha 把月度版本、需求、任务、里程碑、交付风险和变更记录放在一个本地工作区中。数据保存在设备上的 SQLite 文件里，不需要部署数据库或维护容器。

核心能力

• 版本计划：创建、编辑和发布月度版本，发布后自动锁定
• 需求与任务：统一管理优先级、负责人、工作量、外部链接和所属版本
• 交付看板：需求与任务双看板，支持拖拽流转和里程碑计划
• 风险分析：集中查看当前逾期、历史延期和计划调整
• 变更审计：记录操作人、操作时间和字段级前后值
• 本地持久化：SQLite WAL、自动备份、一致性快照和完整性检查

快速开始

安装 Node.js 20.19 或更高版本，然后执行：

npm install -g @tyrxuann/project-alpha
project-alpha start

启动完成后访问 http://localhost:8080。

project-alpha status
project-alpha logs
project-alpha stop

npm 会自动安装当前平台的预编译 Rust 服务端，不要求本机安装 Rust、SQLite 或 Docker。

数据安全

应用数据始终保存在 npm 安装目录之外。查看实际位置：

project-alpha data-dir

创建可独立恢复的一致性备份：

project-alpha backup
project-alpha backup ~/Backups/project-alpha.sqlite3

恢复时会停止后台服务、校验备份、自动保存当前数据库、原子替换并重新启动：

project-alpha restore ~/Backups/project-alpha.sqlite3
project-alpha doctor

Project Alpha 还会在数据库迁移前自动备份，并默认每 24 小时创建一个快照，保留最近 7 个自动备份。完整策略见数据备份与恢复。

CLI

| 命令 | 用途 | | --- | --- | | project-alpha start | 后台启动服务 | | project-alpha start --foreground | 前台启动服务 | | project-alpha restart | 重启服务 | | project-alpha status | 查看进程和健康状态 | | project-alpha logs | 持续查看后台日志 | | project-alpha backup [OUTPUT] | 创建一致性数据库快照 | | project-alpha restore <BACKUP> | 校验并恢复快照 | | project-alpha doctor | 检查数据库完整性和外键 | | project-alpha data-dir | 显示持久化数据目录 |

技术架构

| 层 | 技术 | | --- | --- | | 数据库 | SQLite、WAL、synchronous=FULL | | 后端 | Rust 2024、Axum、SQLx、Tokio | | 前端 | React 19、TypeScript、Vite、Tailwind CSS v4、shadcn/ui | | 分发 | npm 根包 + 平台预编译原生包 |

前端构建产物由 Rust 服务直接托管，对外只有一个本地 Web 入口。

从源码运行

git clone https://github.com/tyrxuann/project-alpha.git
cd project-alpha
npm install
npm run build
npm start

源码构建需要 Rust 1.97.1、nightly rustfmt、Node.js 和 make。详细步骤见开发指南。

文档

• 变更记录
• 安装、数据与部署
• 本地开发与质量检查
• 系统架构与工程组织
• 需求与设计
• 实现计划
• 每日早会与执行项规格
• 每日早会与执行项实现计划
• 关键工程决策
• 系统验证计划
• 文档索引

参与贡献

Issue 和 Pull Request 可以直接提交。变更应保持领域命名一致，并通过后端、前端、CLI、持久化和文档检查。

License

MIT