README

CodeNest

一个可直接部署到宝塔 PHP 环境的轻量代码仓库网站 MVP，风格类似 GitHub，但实现更简单。

功能

• 用户注册 / 登录
• 创建代码仓库
• 仓库列表首页
• 上传 ZIP 作为一次代码快照（类似简化版 push）
• 浏览仓库历史版本
• 在线浏览目录树
• 在线预览文本文件
• 下载某次上传的 ZIP 包

技术栈

• PHP 8+
• MySQL 5.7+/8.0+
• 原生 PHP，无框架，部署简单

宝塔部署

1. 新建站点，PHP 版本选择 8.1+

2. 创建 MySQL 数据库，例如：

- 数据库名：codenest

- 用户名：codenest

- 密码：你自己改

3. 将本目录上传到站点根目录

4. 修改 config.php 中的数据库配置：

- DB_HOST

- DB_PORT

- DB_NAME

- DB_USER

- DB_PASS

5. 确保 PHP 开启扩展：

- pdo_mysql

- zip

6. 给 data/ 目录写权限

7. 访问站点即可，数据库表会自动初始化

当前说明

• 仓库代码以 ZIP 快照形式保存，不是真正的 Git 协议实现
• 适合先做产品原型 / 内部工具 / 演示版
• 如果你后面要，我可以继续把它升级成：

- 组织/团队

- issue / PR

- 分支模型

- WebHook

- 真正的 Git HTTP 接入

- SSH push 支持

内核升级文档

已附带两份后续升级文件：

• BRANCH_COMMIT_PLAN.md：从 ZIP 快照迁移到 Branch + Commit 内核的总体方案
• schema_v2.sql：下一阶段 MySQL 数据模型草案