# Nitrokite

Complete digital marketing platform for small businesses. Website creation, SEO tracking, online booking, social media content generation, review management, and customer feedback - all in one place.

## Project Structure

```
nitrokite/
├── backend/              # Go/Gin API server
│   ├── main.go
│   ├── go.mod
│   └── migrations/       # Database migrations
├── marketing/            # Astro marketing website
│   ├── src/
│   └── dist/            # Built static files
├── deployment/           # Infrastructure & deployment
│   ├── ansible/         # Server configuration
│   └── scripts/         # Deployment automation
└── .gitea/
    └── workflows/       # CI/CD pipelines
```

## Services

### Marketing Website
- **URL**: https://nitrokite.com
- **Tech**: Astro static site generator
- **Location**: `marketing/`
- [Marketing README](marketing/README.md)

### API Server
- **URL**: https://api.nitrokite.com
- **Tech**: Go + Gin + PostgreSQL
- **Location**: `backend/`
- [Backend README](backend/README.md)

### Git Server
- **URL**: https://git.nitrokite.com
- **Tech**: Gitea with 5 CI/CD runners

### Application
- **URL**: https://app.nitrokite.com
- **Tech**: TBD (SPA placeholder)

### Monitoring
- **URL**: https://grafana.nitrokite.com
- **Tech**: Grafana

## Quick Start

### Backend Development
```bash
cd backend
go mod download
air  # Live reload
```

### Marketing Development
```bash
cd marketing
npm install
npm run dev  # http://localhost:4321
```

### Deployment
```bash
cd deployment/ansible
ansible-playbook -i hosts.ini site.yml
```

## Infrastructure

- **Server**: Ubuntu 24.04 on DigitalOcean
- **SSL**: Let's Encrypt certificates (auto-renewal)
- **Reverse Proxy**: Nginx with HTTP/2
- **Database**: PostgreSQL 14
- **CI/CD**: Gitea Actions with 5 runners
- **Deployment**: Blue-green with automated rollback

## Development Workflow

1. **Feature Development**
   - Create branch from `main`
   - Develop locally with live reload
   - Push to feature branch

2. **Testing**
   - CI runs tests automatically
   - Manual testing on feature branch

3. **Deployment**
   - Merge to `main`
   - CI builds and stages deployment
   - Manual promotion to production
   - Automatic rollback on failure

## Monitoring & Operations

- **Health Checks**: Automated via deployment scripts
- **Logs**: `journalctl -u api-server -f`
- **Metrics**: Grafana dashboards
- **SSL Renewal**: Automatic via cron

## Documentation

- [Deployment Guide](deployment/README.md)
- [Backend API](backend/README.md)
- [Marketing Site](marketing/README.md)

## License

Copyright © 2025 Nitrokite. All rights reserved.