113 lines
2.7 KiB
Markdown
113 lines
2.7 KiB
Markdown
# 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.
|