https://github.com/penguintechinc/iceshelves
A K8s and KVM marketplace solution for rapidly deploying tested applications! A special thank you to Mist.IO for general inspiration!
https://github.com/penguintechinc/iceshelves
Last synced: 6 months ago
JSON representation
A K8s and KVM marketplace solution for rapidly deploying tested applications! A special thank you to Mist.IO for general inspiration!
- Host: GitHub
- URL: https://github.com/penguintechinc/iceshelves
- Owner: penguintechinc
- License: other
- Created: 2025-10-07T19:23:55.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-01-22T16:41:26.000Z (6 months ago)
- Last Synced: 2026-01-23T08:38:50.918Z (6 months ago)
- Language: Python
- Size: 8.89 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://github.com/PenguinCloud/project-template/actions/workflows/ci.yml)
[](https://github.com/PenguinCloud/project-template/actions/workflows/docker-build.yml)
[](https://codecov.io/gh/PenguinCloud/project-template)
[](https://goreportcard.com/report/github.com/PenguinCloud/project-template)
[](https://semver.org)
[](LICENSE.md)
```
____ _ _ _____ _ _
| _ \ _ __ ___ (_) ___ ___| |_ |_ _|__ _ __ ___ _ __ | | __ _| |_ ___
| |_) | '__/ _ \| |/ _ \/ __| __| | |/ _ \ '_ ` _ \| '_ \| |/ _` | __/ _ \
| __/| | | (_) | | __/ (__| |_ | | __/ | | | | | |_) | | (_| | || __/
|_| |_| \___/| |\___|\___|\__| |_|\___|_| |_| |_| .__/|_|\__,_|\__\___|
_/ | |_|
|__/
```
# 🏗️ Enterprise Project Template
**The Ultimate Multi-Language Development Foundation**
This comprehensive project template provides a production-ready foundation for enterprise software development, incorporating best practices from Penguin Tech Inc projects. Built with security, scalability, and developer experience at its core, it offers standardized tooling for Go, Python, and Node.js applications with integrated licensing, monitoring, and enterprise-grade infrastructure.
## ✨ Why Choose This Template?
### 🏭 Enterprise-Ready Architecture
Built for production from day one with multi-language support (Go 1.24+, Python 3.12/3.13, Node.js 18+), comprehensive CI/CD pipelines, and enterprise-grade security scanning.
### 🔒 Security First
- **8-stage security validation** including Trivy, CodeQL, and Semgrep scanning
- **TLS 1.2 minimum enforcement**, preferring TLS 1.3
- **Automated vulnerability detection** with Dependabot and Socket.dev integration
- **Secrets management** with environment-based configuration
### 🚀 Performance Optimized
- **Multi-architecture Docker builds** (amd64/arm64) with Debian-slim base images
- **Parallel CI/CD workflows** for optimized build times
- **eBPF/XDP networking** support for high-performance applications
- **Connection pooling** and caching strategies built-in
### 🏢 PenguinTech License Server Integration
- **Centralized feature gating** with `https://license.penguintech.io`
- **Universal JSON response format** across all products
- **Multi-tier licensing** (community/professional/enterprise)
- **Usage tracking and compliance** reporting
### 🔄 Self-Healing & Monitoring
- **Built-in health checks** and self-healing capabilities
- **Prometheus metrics** and Grafana dashboard integration
- **Structured logging** with configurable verbosity levels
- **Real-time monitoring** and alerting
### 🌐 Multi-Environment Support
- **Air-gapped deployment** ready with local caching
- **Container orchestration** with Kubernetes and Helm
- **Environment-specific configurations** for dev/staging/production
- **Blue-green deployment** support with automated rollbacks
## 🛠️ Quick Start
```bash
# Clone and setup
git clone
cd your-project
make setup # Install dependencies and setup environment
make dev # Start development environment
```
## 📚 Key Components
### Core Technologies
- **Languages**: Go 1.24+, Python 3.12/3.13, Node.js 18+
- **Databases**: PostgreSQL with PyDAL/GORM, Redis/Valkey caching
- **Containers**: Docker with multi-stage builds, Kubernetes deployment
- **Monitoring**: Prometheus, Grafana, structured logging
### Security Features
- Multi-factor authentication (MFA) and JWT tokens
- Role-based access control (RBAC)
- Automated security scanning and vulnerability management
- Compliance audit logging (SOC2, ISO27001 ready)
### Development Workflow
- Comprehensive test coverage (unit, integration, e2e)
- Automated code quality checks (linting, formatting, type checking)
- Version management with semantic versioning
- Feature branch workflow with required reviews
## 📖 Documentation
- **Getting Started**: [docs/development/](docs/development/)
- **API Reference**: [docs/api/](docs/api/)
- **Deployment Guide**: [docs/deployment/](docs/deployment/)
- **Architecture Overview**: [docs/architecture/](docs/architecture/)
- **License Integration**: [docs/licensing/](docs/licensing/)
## 🤝 Contributing
We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
### Maintainers
- **Primary**: creatorsemailhere@penguintech.group
- **General**: info@penguintech.group
- **Company**: [www.penguintech.io](https://www.penguintech.io)
### Community Contributors
- *Your name could be here! Submit a PR to get started.*
## 📞 Support & Resources
- **Documentation**: [./docs/](docs/)
- **Premium Support**: https://support.penguintech.group
- **Community Issues**: [GitHub Issues](../../issues)
- **License Server Status**: https://status.penguintech.io
## 📄 License
This project is licensed under the Limited AGPL3 with preamble for fair use - see [LICENSE.md](docs/LICENSE.md) for details.
**License Highlights:**
- **Personal & Internal Use**: Free under AGPL-3.0
- **Commercial Use**: Requires commercial license
- **SaaS Deployment**: Requires commercial license if providing as a service
### Contributor Employer Exception (GPL-2.0 Grant)
Companies employing official contributors receive GPL-2.0 access to community features:
- **Perpetual for Contributed Versions**: GPL-2.0 rights to versions where the employee contributed remain valid permanently, even after the employee leaves the company
- **Attribution Required**: Employee must be credited in CONTRIBUTORS, AUTHORS, commit history, or release notes
- **Future Versions**: New versions released after employment ends require standard licensing
- **Community Only**: Enterprise features still require a commercial license
This exception rewards contributors by providing lasting fair use rights to their employers. See [LICENSE.md](docs/LICENSE.md) for full terms.