docs: reconcile stale package counts across docs
The docs had drifted to 5/58 packaged while Corteza (and Puter) were
already committed. Reconcile the headline count to 7/~57 everywhere
per the new gardening protocol (GitUrlList.txt is the source of truth
at 57 upstream apps).
- README.md: 5/58 -> 7, add Corteza to completed table, remove false
"Warp packaged" marker (duplicate, no package), Low-Code 0/3 -> 1/3,
link STATUS/AGENTS.
- JOURNAL.md: header + repository stats 5/58 -> 7/~57.
- RESUME.md: mark superseded by STATUS.md (was 2025-01-24, referenced
dead /home/tsys paths) to avoid two competing status docs.
💘 Generated with Crush
Assisted-by: Crush:glm-5.2
This commit is contained in:
+5
-5
@@ -2,9 +2,9 @@
|
||||
|
||||
## Project Overview
|
||||
**Project**: TSYSDevStack-SupportStack-Cloudron
|
||||
**Goal**: Package 58 applications for Cloudron PaaS platform
|
||||
**Goal**: Package ~57 applications for Cloudron PaaS platform
|
||||
**Start Date**: 2025-01-24
|
||||
**Current Status**: 5/58 packages completed (8.6%)
|
||||
**Current Status**: 7/~57 packages completed (~12%)
|
||||
|
||||
## Completed Packages
|
||||
|
||||
@@ -626,11 +626,11 @@ Dockerfile
|
||||
|
||||
## Repository Statistics
|
||||
|
||||
- **Commits**: 6 packages committed to main branch
|
||||
- **Commits**: 7 packages committed to main branch
|
||||
- **Pushes**: All pushed to remote repository
|
||||
- **Package directories**: Created in Package-Workspace/
|
||||
- **Total packages completed**: 5/58 (8.6%)
|
||||
- **Remaining packages**: 53/58 (91.4%)
|
||||
- **Total packages completed**: 7/~57 (~12%)
|
||||
- **Remaining packages**: ~50/~57 (~88%)
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,11 +8,12 @@ The Cloudron component focuses on packaging upstream free/libre/open application
|
||||
|
||||
### 📊 Current Progress
|
||||
|
||||
- **Total Applications**: 58+
|
||||
- **Completed Packages**: 5/58 (8.6%)
|
||||
- **Quick Wins**: 6/6 (100%) ✅
|
||||
- **Total Applications**: ~57 (see [GitUrlList.txt](GitUrlList.txt))
|
||||
- **Completed Packages**: 7/~57 (~12%)
|
||||
- **Packaging Templates**: Created ✅
|
||||
- **Packages Committed & Pushed**: 6 ✅
|
||||
- **Packages Committed & Pushed**: 7 ✅
|
||||
|
||||
> Living status is tracked in [STATUS.md](STATUS.md) (agent-maintained).
|
||||
|
||||
### ✅ Completed Packages
|
||||
|
||||
@@ -24,6 +25,7 @@ The Cloudron component focuses on packaging upstream free/libre/open application
|
||||
| 4 | Review Board | Development | 1.29GB | 8080 | localstorage, postgresql | ✅ Committed |
|
||||
| 5 | WireViz Web | Documentation-Tools | 378MB | 3005 | localstorage | ✅ Committed |
|
||||
| 6 | Puter | Development | 361MB | 4100 | localstorage, postgresql | ✅ Committed |
|
||||
| 7 | Corteza | Low-Code | 436MB | 80 | localstorage, postgresql | ✅ Committed |
|
||||
|
||||
### 📦 Packages in Development
|
||||
|
||||
@@ -31,7 +33,7 @@ None currently in development.
|
||||
|
||||
### 🔄 Next Steps
|
||||
|
||||
1. Continue packaging remaining applications (53 remaining)
|
||||
1. Continue packaging remaining applications (~50 remaining)
|
||||
2. Prioritize applications with official Docker images (faster packaging)
|
||||
3. Apply established patterns from Package-Templates/
|
||||
4. Reference JOURNAL.md for learnings and best practices
|
||||
@@ -40,9 +42,10 @@ None currently in development.
|
||||
### 📚 Documentation & Resources
|
||||
|
||||
- **JOURNAL.md**: Detailed packaging journal with patterns, challenges, and insights
|
||||
- **AGENTS.md**: AI agent documentation and knowledge base
|
||||
- **STATUS.md**: Living status (completed packages, known issues, next priorities) — agent-maintained
|
||||
- **AGENTS.md**: Agent operating manual + gardening protocol
|
||||
- **Package-Templates/**: Cloudron packaging templates for common patterns
|
||||
- **GitUrlList.txt**: Complete list of all 58+ applications with GitHub URLs
|
||||
- **GitUrlList.txt**: Source-of-truth list of upstream repos
|
||||
|
||||
### 🏗 Cloudron Patterns Established
|
||||
|
||||
@@ -56,11 +59,11 @@ None currently in development.
|
||||
|
||||
### ⚡ Productivity Metrics
|
||||
|
||||
- **Packages Completed**: 5/58 (8.6%)
|
||||
- **Packages Completed**: 7/~57 (~12%)
|
||||
- **Average Package Time**: ~30 minutes
|
||||
- **Success Rate**: 100% (all packages built successfully)
|
||||
- **Commits Pushed**: 100% (all packages pushed to remote)
|
||||
- **Total Commits**: 7 (1 foundation + 5 packages + 1 templates)
|
||||
- **Total Commits**: 21+ (foundation + 7 packages + templates + docs)
|
||||
|
||||
---
|
||||
|
||||
@@ -83,7 +86,7 @@ Applications are organized by function rather than programming language:
|
||||
| **Financial-Trading** | Trading and financial algorithm platforms | 1 | 0/1 (0%) |
|
||||
| **Infrastructure** | Infrastructure and networking tools | 6 | 0/6 (0%) |
|
||||
| **Legal** | Legal and compliance applications | 1 | 0/1 (0%) |
|
||||
| **Low-Code** | Low-code and no-code platforms | 3 | 0/3 (0%) |
|
||||
| **Low-Code** | Low-code and no-code platforms | 3 | 1/3 (33%) |
|
||||
| **Monitoring** | Monitoring and observability tools | 6 | 1/6 (17%) |
|
||||
| **Project-Management** | Project management solutions | 1 | 0/1 (0%) |
|
||||
| **Scientific-Computing** | Scientific and research computing | 2 | 0/2 (0%) |
|
||||
@@ -146,7 +149,7 @@ Applications are organized by function rather than programming language:
|
||||
| [Core](https://github.com/Resgrid/Core) | [GitHub](https://github.com/Resgrid/Core) | Emergency management and incident response system | Project-Management |
|
||||
| [SDRangel](https://github.com/f4exb/sdrangel) | [GitHub](https://github.com/f4exb/sdrangel) | Software defined radio application | Infrastructure |
|
||||
| [No-Code Architects Toolkit](https://github.com/stephengpope/no-code-architects-toolkit) | [GitHub](https://github.com/stephengpope/no-code-architects-toolkit) | No-code development toolkit | Low-Code |
|
||||
| [Warp](https://github.com/sebo-b/warp) | [GitHub](https://github.com/sebo-b/warp) | Terminal and shell enhancement tool | Development | ✅ Packaged |
|
||||
| [Warp](https://github.com/sebo-b/warp) | [GitHub](https://github.com/sebo-b/warp) | Terminal and shell enhancement tool | Development | |
|
||||
| [Windmill](https://github.com/windmill-labs/windmill) | [GitHub](https://github.com/windmill-labs/windmill) | Open-source workflow automation platform | Automation |
|
||||
| [Corteza](https://github.com/cortezaproject/corteza) | [GitHub](https://github.com/cortezaproject/corteza) | Open-source low-code platform | Low-Code |
|
||||
| [Security Awareness Training](https://github.com/security-companion/security-awareness-training) | [GitHub](https://github.com/security-companion/security-awareness-training) | Security awareness training platform | Security |
|
||||
|
||||
@@ -1,230 +1,14 @@
|
||||
# TSYS Cloudron Project - Session Resume Guide
|
||||
# Session Resume Guide — SUPERSEDED
|
||||
|
||||
**Date**: 2025-01-24
|
||||
**Session Type**: Orientation & Analysis
|
||||
**Status**: Ready for Packaging Phase
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Current Project State
|
||||
|
||||
### What Was Done This Session
|
||||
- ✅ Oriented to project structure
|
||||
- ✅ Analyzed repository cloning status (56/59 successfully cloned)
|
||||
- ✅ Reviewed all documentation (README.md, AGENTS.md, GitUrlList.txt)
|
||||
- ✅ Identified missing repositories
|
||||
- ✅ Assessed workspace organization (19 functional categories)
|
||||
- ✅ Documented uncommitted changes
|
||||
|
||||
### What Needs To Be Committed
|
||||
```bash
|
||||
git status
|
||||
# Modified: README.md
|
||||
# Untracked: AGENTS.md, GitUrlList.txt, clone-repos.sh, .gitignore, Package-Workspace/
|
||||
```
|
||||
|
||||
**Suggested Commit Message:**
|
||||
```
|
||||
feat: add Cloudron packaging foundation and upstream repositories
|
||||
|
||||
- Add comprehensive README.md with 59-app inventory table
|
||||
- Create AGENTS.md for AI agent context and decisions
|
||||
- Add GitUrlList.txt with all upstream repository URLs
|
||||
- Implement clone-repos.sh automation script
|
||||
- Configure .gitignore to exclude cloned repos
|
||||
- Clone and organize 56 upstream repositories by function
|
||||
- Establish 19 functional categories for better organization
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Repository Status
|
||||
|
||||
### Successfully Cloned (58 repos)
|
||||
All repos are organized in `Package-Workspace/<Category>/<App>/repo/`
|
||||
|
||||
### Excluded Repositories (4 repos)
|
||||
1. **oat-sa** - Invalid URL (organization-level only, not a repository)
|
||||
- Status: Excluded from project
|
||||
2. **satnogs** - GitLab repository requiring authentication
|
||||
- Category: Infrastructure
|
||||
- URL: https://gitlab.com/librespacefoundation/satnogs
|
||||
- Status: Excluded from project
|
||||
3. **warp** - Duplicate entry removed
|
||||
- Category: Development
|
||||
- Status: Single entry retained
|
||||
4. **windmill** - Duplicate entry removed
|
||||
- Category: Automation
|
||||
- Status: Single entry retained
|
||||
|
||||
### Previously Failed Clones - Now Fixed
|
||||
1. **WireViz** - Successfully cloned on retry
|
||||
- Category: Documentation-Tools
|
||||
- Status: ✅ Complete
|
||||
2. **elabftw** - Successfully cloned on retry
|
||||
- Category: Business-Apps
|
||||
- Status: ✅ Complete
|
||||
|
||||
### Special Case: docassemble
|
||||
- Cloned directly to `Package-Workspace/Legal/docassemble/` (not `repo/` subdirectory)
|
||||
- This is the only repo not following the standard structure
|
||||
- Decision: Leave as-is or restructure if needed
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Immediate Next Steps
|
||||
|
||||
### Step 1: Commit Current Work (10 minutes)
|
||||
```bash
|
||||
cd /home/tsys/Projects/TDS/TSYSDevStack-SupportStack-Cloudron
|
||||
git add README.md AGENTS.md GitUrlList.txt clone-repos.sh .gitignore RESUME.md
|
||||
git commit -m "feat: add Cloudron packaging foundation and upstream repositories"
|
||||
```
|
||||
|
||||
**Note**: `Package-Workspace/` is excluded by `.gitignore`, so it won't be committed.
|
||||
|
||||
### Step 2: Begin Cloudron Packaging (start with easy apps)
|
||||
Pick a high-priority application and start packaging:
|
||||
|
||||
**Example workflow:**
|
||||
```bash
|
||||
cd Package-Workspace/Monitoring/healthchecks/repo
|
||||
# Study existing Cloudron packages for patterns
|
||||
# Create Dockerfile
|
||||
# Create CloudronManifest.json
|
||||
# Test: cloudron build
|
||||
# Test: cloudron install
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 Project Statistics
|
||||
|
||||
- **Total Applications**: 58
|
||||
- **Successfully Cloned**: 58
|
||||
- **Failed Clones**: 0
|
||||
- **Functional Categories**: 20
|
||||
- **Workspace Size**: 5.4GB
|
||||
- **Programming Languages**: 9+ (Go, Node.js, Python, PHP, Java, Rust, Ruby, TypeScript)
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ Functional Categories Summary
|
||||
|
||||
| Category | Apps | Status |
|
||||
|----------|------|--------|
|
||||
| API-Gateway | 2 | 2/2 cloned |
|
||||
| Automation | 4 | 4/4 cloned |
|
||||
| Business-Apps | 8 | 8/8 cloned |
|
||||
| Collaboration | 2 | 2/2 cloned |
|
||||
| Communication | 2 | 2/2 cloned |
|
||||
| Data-Management | 2 | 2/2 cloned |
|
||||
| Development | 4 | 4/4 cloned |
|
||||
| DevOps-Tools | 2 | 2/2 cloned |
|
||||
| Documentation-Tools | 3 | 3/3 cloned |
|
||||
| Financial-Payments | 1 | 1/1 cloned |
|
||||
| Financial-Trading | 1 | 1/1 cloned |
|
||||
| Infrastructure | 5 | 5/5 cloned |
|
||||
| Legal | 1 | 1/1 cloned |
|
||||
| Low-Code | 3 | 3/3 cloned |
|
||||
| Monitoring | 6 | 6/6 cloned |
|
||||
| Project-Management | 1 | 1/1 cloned |
|
||||
| Scientific-Computing | 2 | 2/2 cloned |
|
||||
| Security | 5 | 5/5 cloned |
|
||||
| System-Administration | 3 | 3/3 cloned |
|
||||
|
||||
---
|
||||
|
||||
## 📚 Key Resources
|
||||
|
||||
### Documentation
|
||||
- `README.md` - Complete project overview and app inventory
|
||||
- `AGENTS.md` - AI agent context, decisions, and working patterns
|
||||
- `RESUME.md` - This file
|
||||
|
||||
### Scripts & Tools
|
||||
- `clone-repos.sh` - Automated repository cloning
|
||||
- `GitUrlList.txt` - Master list of upstream repositories
|
||||
|
||||
### Cloudron Packaging
|
||||
- [Cloudron Packaging Tutorial](https://docs.cloudron.io/packaging/tutorial/)
|
||||
- [Cloudron Manifest Documentation](https://docs.cloudron.io/packaging/manifest/)
|
||||
- [Cloudron CLI Documentation](https://docs.cloudron.io/packaging/cli/)
|
||||
- [Existing Cloudron Packages](https://git.cloudron.io/cloudron)
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Recommended Starting Points
|
||||
|
||||
### For Cloudron Packaging Beginners
|
||||
Start with simple applications that likely have existing Docker setups:
|
||||
1. **Review Board** - Development (likely has simple setup)
|
||||
2. **Webhook** - API-Gateway (lightweight Go app)
|
||||
3. **Healthchecks** - Monitoring (Python, well-documented)
|
||||
|
||||
### For Quick Wins (apps with existing Dockerfiles)
|
||||
1. **Puter** - Development (has Dockerfile)
|
||||
2. **Windmill** - Automation (has Dockerfile)
|
||||
3. **DataHub** - Data-Management (has Docker setup)
|
||||
|
||||
### For High Business Value
|
||||
1. **InvenTree** - Business-Apps (inventory management)
|
||||
2. **NetBox** - Infrastructure (data center management)
|
||||
3. **Grist Core** - Collaboration (data spreadsheet)
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Known Issues
|
||||
|
||||
1. **docassemble Structure**
|
||||
- Not following standard `repo/` subdirectory pattern
|
||||
- Cloned directly to `Package-Workspace/Legal/docassemble/`
|
||||
- Action: Document as exception (non-standard structure)
|
||||
|
||||
2. **Excluded Repositories**
|
||||
- oat-sa: Organization URL (not a repository)
|
||||
- satnogs: Requires authentication (GitLab)
|
||||
- Both intentionally excluded from project scope
|
||||
|
||||
---
|
||||
|
||||
## 📞 How to Resume
|
||||
|
||||
1. **Navigate to project:**
|
||||
```bash
|
||||
cd /home/tsys/Projects/TDS/TSYSDevStack-SupportStack-Cloudron
|
||||
```
|
||||
|
||||
2. **Review this file:**
|
||||
```bash
|
||||
cat RESUME.md
|
||||
```
|
||||
|
||||
3. **Check git status:**
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
|
||||
4. **Pick up where you left off:**
|
||||
- If uncommitted: Commit current work
|
||||
- If ready to package: Choose an app and start
|
||||
- If missing repos: Retry cloning
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Project Goals Checklist
|
||||
|
||||
- [x] Fix and retry failed repository clones
|
||||
- [x] Commit current foundation work
|
||||
- [x] Clean up duplicate entries in GitUrlList.txt
|
||||
- [ ] Start Cloudron packaging (Dockerfile + CloudronManifest.json)
|
||||
- [ ] Test packages with Cloudron CLI
|
||||
- [ ] Move completed packages to `Package-Artifacts/`
|
||||
- [ ] Establish testing/validation pipeline
|
||||
- [ ] Complete packaging for all 58 apps by deadline
|
||||
|
||||
---
|
||||
|
||||
**Last Updated**: 2025-01-24
|
||||
**Status**: Foundation complete, all repos cloned, ready for packaging phase
|
||||
**Next Session**: Start Cloudron packaging with Phase 2 (Quick Wins & Templates)
|
||||
> **This file is superseded by [`STATUS.md`](STATUS.md).**
|
||||
>
|
||||
> STATUS.md is now the living, agent-maintained source of truth for project
|
||||
> state (completed packages, known issues, next priorities). Read STATUS.md at
|
||||
> the start of every session instead of this file.
|
||||
>
|
||||
> This RESUME.md is retained only for historical reference. It was last updated
|
||||
> 2025-01-24 and referenced an old host path (`/home/tsys/Projects/TDS/...`)
|
||||
> that no longer exists — the project now lives at
|
||||
> `~/projects/TSYSDevStack-SupportStack-Cloudron`.
|
||||
>
|
||||
> Do not update this file. Update [`STATUS.md`](STATUS.md) instead.
|
||||
|
||||
Reference in New Issue
Block a user