项目开发追踪台

多个项目 · 一处记录 · 井井有条

开发多款 WordPress 插件、Typecho 插件、浏览器扩展、小程序、Web 应用时，常常被这些"琐事"困扰：哪些提交到官方了？哪些在本地、哪些在云端？旧版本归档在哪？上次更新是啥时候？这一款新版本要提审还是已经过审？

项目开发追踪台 就是为了解决这些问题：一个自托管的轻量后台，把所有项目的状态、版本、代码存放、旧版本归档、官方进度集中记录，一目了然。

🎯 核心功能

• 📊 仪表盘：项目总数、各状态统计、状态/类型分布、最近动态时间线
• 🧩 项目卡片管理：每款项目一张彩色卡片，记录名称、类型、状态、版本、代码仓库地址、代码存放路径、旧版本存放路径、官方页面链接、说明
• ⚡ 一键状态流转：开发中 → 待提交 → 提交官方 → 已上线 / 已更新 / 已停更 / 恢复开发
• 🔖 更新版本自动归档：点「更新版本」填新版本号，系统自动生成动态并记录"旧版 v1.0 已归档，存放：xxx"，旧版本在哪永远忘不了
• 📝 动态时间线：每次提交/更新/上线自动留痕，可手动补记，可按项目筛选
• 💾 数据备份：一键导出 JSON 到本地、可导入恢复（导入前自动备份现有数据）
• 🔒 单账号登录 + CSRF 防护，未安装时自动进入初始化向导
• 🎨 多彩扁平化 UI，手机访问友好

📸 界面预览

登录页

仪表盘

项目列表

动态记录

🛠 技术栈

🚀 快速开始

本地 phpStudy 部署（5 分钟）

1. 把项目文件夹复制到 D:\phpstudy_pro\WWW\你的目录
2. phpStudy 面板 → 网站 → 切换 PHP 7.4 或 8.x，启用扩展：pdo_mysql、mbstring、mysqli
3. 编辑 lib/config.php，填入你的数据库信息（host/库名/账号/密码）
4. 浏览器访问 http://127.0.0.15（或你配的端口）→ 首次自动进入安装页 → 设置管理员账号密码 → 完成

云服务器部署（宝塔示例）

1. 上传项目到 /www/wwwroot/你的域名/
2. 宝塔 → 软件商店 → 安装 MySQL（或已有）
3. 宝塔 → 数据库 → 添加数据库（库名 + 用户名 + 密码，访问权限：本地服务器）
4. 编辑 lib/config.php，填入宝塔给你的数据库信息
5. 宝塔 → 网站 → 设置 → PHP 版本 ≥ 7.4，扩展勾选 pdo_mysql、mbstring、mysqli
6. 浏览器访问域名 → 走安装页即可

🎯 典型工作流

场景：本地开发完一款新版本，要更新到官方

1. 项目列表找到对应卡片 → 点击打开详情
2. 点击「🔖 更新版本」→ 填写新版本号（如 v1.2.0）+ 更新备注
3. 系统自动：
   • 状态变为「已更新」
   • 写入动态：v1.1.0 → v1.2.0；旧版本 v1.1.0 已归档，存放：D:/plugins/archive
   • 旧版本归档位置就是你之前填写的"旧版本存放路径"
4. 接着点「🚀 提交官方」→ 写一行备注 → 完成。状态自动变「已提交官方」

场景：什么时候做了一次更新？

打开仪表盘或动态记录页，最近操作按时间倒序展示，所有提交/更新/上线动作都有彩色徽章 + 时间戳 + 关联项目，一眼找全。

💡 设计理念

• 数据在本地自己手里：MySQL/文件都在自己的服务器/电脑，可以随时导出/导入备份，不依赖任何第三方服务
• 简单到能 10 分钟装完：单文件入口 + 零依赖 + 任意 PHP 7.4+ 环境即可运行
• 多功能但界面不杂乱：状态/类型/动作都用中文彩色徽章，多彩扁平化风格，重要信息一眼可见
• 记录"过程"而不只是"结果"：每次状态流转都自动写入时间线，既能查"现在在哪"，也能查"这一路怎么走来的"

📂 目录结构

plugin-tracker/
├── index.php          # 入口：路由 + 页面 + API
├── lib/
│   ├── config.php     # 站点配置 + 数据库配置
│   ├── db.php         # PDO 封装（MySQL/SQLite 双驱动）
│   └── helpers.php    # 状态字典、鉴权、CSRF、JSON 输出
├── assets/
│   ├── css/style.css  # 多彩扁平化主题
│   └── js/app.js      # 前端交互
└── data/              # 运行期数据（配置、SQLite、备份）

❓ 常见问题

• 连不上数据库（1045 Access denied）：lib/config.php 里的账号密码与服务器实际不符；宝塔用户创建的数据库用户名密码在宝塔数据库列表可查看
• 中文乱码：浏览器按 GBK 渲染时乱码——程序已显式声明 Content-Type: text/html; charset=UTF-8，云服务器部署后仍乱码请检查 PHP 的 default_charset 与 MySQL 字符集（建议 utf8mb4）
• 保存说明丢失：早期版本 textarea 字段被 getForm 漏收集（已修复），升级后请刷新页面（Ctrl+F5）拿到新版 JS

📝 版本

v1.0 · 多款插件开发场景沉淀的轻量级项目追踪后台