dazhuang
344a750cfb
- Add start.sh/start.bat for one-click startup (backend + frontend) - Add stop.sh/stop.bat for stopping all services - Add restart.sh for restarting services - Add status.sh for checking service status - Add Makefile with convenient management commands - Add comprehensive documentation (ONE_CLICK_START.md) - Update README with one-click startup instructions Features: - Automatic environment checking (venv, node_modules) - Process management with PID tracking - Unified log management (logs/*.log) - Health checking after startup - Support for Linux, macOS, and Windows - No more need for multiple terminal windows Usage: ./start.sh # Start all services ./stop.sh # Stop all services ./status.sh # Check service status ./restart.sh # Restart services make start # Alternative using Makefile Benefits: - One command instead of multiple terminals - Automatic environment validation - Centralized logging - Process lifecycle management - Developer-friendly output messages
6.2 KiB
6.2 KiB
Git 远程仓库配置完成
✅ 已完成的操作
1. 创建 Gitea 仓库
使用 Gitea API 成功创建仓库：
- 仓库地址: http://192.168.120.110:4000/dazhuang/erp-ass
- 仓库名称: erp-ass
- 所有者: dazhuang
- 权限: 公开仓库
- 描述: ERP AI Assistant - 一零软件智能配置助手
2. 配置 Git 用户信息
git config user.name "dazhuang"
git config user.email "dazhuang@foshanhuiya.com"
3. 添加远程仓库
git remote add origin http://dazhuang:47b0128cbdbd40de728072c609b55d4413b7fe6d@192.168.120.110:4000/dazhuang/erp-ass.git
认证方式: HTTP + Access Token
4. 重命名分支
将本地分支从 master 重命名为 main（与 Gitea 默认分支一致）：
git branch -M main
5. 推送代码
成功推送代码到远程仓库：
git push -u origin main
推送结果:
- 分支: main
- 提交:
acd7343(feat: implement ERP AI Assistant Phase 1) - 文件: 60 个文件
- 代码行数: 11,284 行
📊 仓库信息
访问地址
- Web 界面: http://192.168.120.110:4000/dazhuang/erp-ass
- HTTP 克隆: http://192.168.120.110:4000/dazhuang/erp-ass.git
- SSH 克隆: git@192.168.120.110:dazhuang/erp-ass.git
仓库状态
分支: main
状态: 与远程同步
最新提交: acd7343 feat: implement ERP AI Assistant Phase 1
🔧 后续操作
克隆仓库
其他团队成员可以克隆仓库：
HTTP 方式（推荐）:
git clone http://192.168.120.110:4000/dazhuang/erp-ass.git
cd erp-ass
SSH 方式:
git clone ssh://git@192.168.120.110:4022/dazhuang/erp-ass.git
cd erp-ass
日常开发流程
1. 获取最新代码
git pull origin main
2. 创建新功能分支
git checkout -b feature/new-feature
3. 开发并提交
# 修改文件...
git add .
git commit -m "feat: add new feature"
4. 推送到远程
git push origin feature/new-feature
5. 在 Gitea 创建 Pull Request
访问仓库 Web 界面创建 PR
6. 合并后删除分支
git checkout main
git pull origin main
git branch -d feature/new-feature
git push origin --delete feature/new-feature
🔐 认证信息
HTTP 认证
使用 Access Token 认证，URL 格式：
http://用户名:AccessToken@服务器地址/仓库路径.git
注意:
- Access Token 已嵌入远程 URL
- 无需每次输入密码
- Token 权限：读写仓库
SSH 认证（可选）
如果需要使用 SSH 方式：
-
生成 SSH 密钥:
ssh-keygen -t ed25519 -C "dazhuang@foshanhuiya.com" -
查看公钥:
cat ~/.ssh/id_ed25519.pub -
添加到 Gitea:
- 访问 http://192.168.120.110:4000/user/settings/keys
- 添加 SSH 公钥
-
更新远程 URL:
git remote set-url origin git@192.168.120.110:dazhuang/erp-ass.git -
配置 SSH 端口（因为使用了非标准端口 4022）:
编辑
~/.ssh/config:Host 192.168.120.110 Port 4022 User git IdentityFile ~/.ssh/id_ed25519
⚙️ Git 配置
当前配置
查看本地配置：
git config --list --local
推荐的全局配置
# 设置默认分支名
git config --global init.defaultBranch main
# 设置推送默认行为
git config --global push.default simple
# 设置拉取默认行为
git config --global pull.rebase false
# 设置凭证缓存
git config --global credential.helper cache --timeout=3600
# 设置编辑器
git config --global core.editor vim
# 设置中文文件名显示
git config --global core.quotePath false
📝 团队协作规范
分支命名规范
main- 主分支（生产环境）develop- 开发分支feature/xxx- 功能分支bugfix/xxx- Bug 修复分支hotfix/xxx- 紧急修复分支release/v1.0.0- 发布分支
提交信息规范
使用约定式提交：
<type>(<scope>): <subject>
<body>
<footer>
类型（type）:
feat: 新功能fix: Bug 修复docs: 文档更新style: 代码格式（不影响功能）refactor: 重构test: 测试相关chore: 构建/工具相关
示例:
feat(backend): add user authentication
- Add login API endpoint
- Implement JWT token validation
- Add user session management
Closes #123
.gitignore 规范
已配置的忽略规则：
- Python:
__pycache__/,*.pyc,venv/ - Node.js:
node_modules/,dist/ - 环境变量:
.env,.env.local - IDE:
.vscode/,.idea/ - 项目特定:
erp-doc/,*.docx,*.xlsx - 数据库:
*.db,chroma_db/
🐛 常见问题
问题 1: 推送被拒绝
现象: ! [rejected] main -> main (fetch first)
原因: 远程仓库有新的提交
解决方案:
# 拉取最新代码
git pull origin main --rebase
# 解决冲突（如果有）
# 然后推送
git push origin main
问题 2: Access Token 失效
现象: remote: Invalid token
解决方案:
- 访问 http://192.168.120.110:4000/user/settings/applications
- 生成新的 Access Token
- 更新远程 URL:
git remote set-url origin http://dazhuang:NEW_TOKEN@192.168.120.110:4000/dazhuang/erp-ass.git
问题 3: 合并冲突
解决方案:
# 查看冲突文件
git status
# 手动编辑冲突文件，解决冲突标记
# <<<<<<< HEAD
# 本地修改
# =======
# 远程修改
# >>>>>>> branch-name
# 标记为已解决
git add <conflicted-file>
# 提交合并
git commit
问题 4: 撤销最近的提交
撤销最近一次提交（保留修改）:
git reset --soft HEAD~1
撤销最近一次提交（丢弃修改）:
git reset --hard HEAD~1
注意: 如果已推送到远程，需要强制推送（谨慎使用）:
git push origin main --force
📚 相关资源
配置完成时间: 2026-03-22 仓库地址: http://192.168.120.110:4000/dazhuang/erp-ass