# Pushing to Gitea - Setup Instructions

This guide will help you push the InvenTree Stock Tool repository to your internal Gitea server.

## Prerequisites

- Git installed on your machine
- Access to your internal Gitea server
- Gitea account with repository creation permissions

## Step 1: Create Repository on Gitea

1. Log into your Gitea instance
2. Click the **+** button (top right) or go to **New Repository**
3. Fill in the repository details:
   - **Repository Name**: `inventree-stock-tool` (or your preferred name)
   - **Description**: "Barcode scanning application for InvenTree inventory management"
   - **Visibility**: Choose Private or Public as appropriate
   - **Initialize Repository**: Leave **UNCHECKED** (we already have a repo)
4. Click **Create Repository**

## Step 2: Add Gitea as Remote

After creating the repository, Gitea will show you the repository URL. It will look something like:
```
https://gitea.yourcompany.com/username/inventree-stock-tool.git
```

Add this as a remote to your local repository:

```bash
cd "C:\Users\berwn\Desktop\barcodes\stocktool"

# Add Gitea as remote origin
git remote add origin https://gitea.yourcompany.com/username/inventree-stock-tool.git

# Verify the remote was added
git remote -v
```

## Step 3: Push to Gitea

Push your code to the Gitea server:

```bash
# Push master branch to origin
git push -u origin master
```

You may be prompted for your Gitea username and password.

### Alternative: Using SSH

If you prefer SSH over HTTPS:

1. Add your SSH key to Gitea (Settings > SSH Keys)
2. Use the SSH URL instead:
   ```bash
   git remote add origin git@gitea.yourcompany.com:username/inventree-stock-tool.git
   git push -u origin master
   ```

## Step 4: Verify Upload

1. Go to your Gitea repository in your browser
2. You should see all files:
   - `stock_tool_gui_v2.py`
   - `README.md`
   - `FIXES_APPLIED.md`
   - `.gitignore`
   - `example_config.yaml`
   - Test files
3. The README should be displayed on the repository homepage

## Step 5: Setup Repository Settings (Optional)

### Add Topics/Tags
In Gitea, add relevant topics to help others find the repository:
- `inventree`
- `barcode-scanner`
- `inventory-management`
- `python`
- `tkinter`

### Branch Protection (Recommended)
If multiple people will be working on this:
1. Go to Settings > Branches
2. Add protection to `master` branch
3. Enable "Require pull request reviews before merging"

### Setup Collaborators
1. Go to Settings > Collaborators
2. Add team members who need access
3. Set appropriate permissions (Read, Write, Admin)

## Future Updates

After making changes to the code:

```bash
# Check what changed
git status

# Add changed files
git add stock_tool_gui_v2.py

# Commit with descriptive message
git commit -m "Fix: Corrected API endpoint for stock updates"

# Push to Gitea
git push origin master
```

## Quick Reference Commands

```bash
# Clone from Gitea (for other team members)
git clone https://gitea.yourcompany.com/username/inventree-stock-tool.git

# Pull latest changes
git pull origin master

# Create a new branch for features
git checkout -b feature/new-feature
git push -u origin feature/new-feature

# View commit history
git log --oneline

# View repository info
git remote show origin
```

## Troubleshooting

### Authentication Issues
If you have trouble authenticating:
- **HTTPS**: Use personal access token instead of password (Settings > Applications > Generate Token)
- **SSH**: Ensure your SSH key is added to Gitea

### Push Rejected
If push is rejected:
```bash
# Pull changes first
git pull origin master --rebase

# Then push
git push origin master
```

### Large Files Warning
The `.gitignore` is configured to exclude:
- Python cache files
- Virtual environments
- Config files with credentials (*.yaml except example)
- Log files

## Repository Structure

```
inventree-stock-tool/
├── .gitignore                    # Git ignore rules
├── README.md                     # Main documentation
├── FIXES_APPLIED.md              # Bug fix documentation
├── GITEA_SETUP.md                # This file
├── example_config.yaml           # Example configuration
├── stock_tool_gui_v2.py          # Main application
├── test_add_stock.py             # Tests
├── test_duplicate_handling.py    # Tests
├── test_parse_fix.py             # Tests
└── test_stock_level.py           # Tests
```

## Next Steps

1. Share the repository URL with your team
2. Update internal documentation with the Gitea link
3. Set up any CI/CD pipelines if needed
4. Consider adding issue templates for bug reports

---

**Repository initialized and ready for Gitea!**

Current commit: `ab0d1ae - Initial commit: InvenTree Stock Tool v2`