docs/PROJECT_TAXONOMY.md

Project Taxonomy & Categories

Last Updated: 2025-01-27 Purpose: Standardized taxonomy for categorizing and organizing projects

---

Overview

This document defines the standard taxonomy for categorizing projects in the workspace, including categories, tags, and metadata standards.

---

Project Categories

1. Blockchain & DeFi

Projects related to blockchain technology, decentralized finance, and cryptocurrency.

Projects:

• 237-combo (DeFi Starter Kit)
• 27-combi (Aave Stablecoin Looping Tool)
• asle (Ali & Saum Liquidity Engine)
• CurrenciCombo (ISO-20022 Combo Flow)
• no_five (DBIS Atomic Amortizing Leverage Engine)
• quorum-test-network (Quorum Dev Quickstart)
• smom-dbis-138 (DeFi Oracle Meta Mainnet)
• strategic (TypeScript CLI + Solidity Atomic Executor)

Tags: blockchain, defi, solidity, ethereum, hyperledger, smart-contracts

---

2. Banking & Financial Infrastructure

Projects related to banking systems, financial services, and financial infrastructure.

Projects:

• dbis_core (DBIS Core Banking System)
• dbis_docs (DBIS Institutional Documentation)
• the_order (Digital Identity Platform)
• Aseret_Global monorepo projects
• Elemental_Imperium (DBIS Tripartite Body)

Tags: banking, financial, payments, compliance, iso20022, core-banking

---

3. Cloud Infrastructure & DevOps

Projects related to cloud infrastructure, DevOps, containerization, and infrastructure automation.

Projects:

• loc_az_hci (Proxmox VE → Azure Arc → Hybrid Cloud Stack)
• Sankofa (Sankofa Phoenix Cloud Platform)

Tags: infrastructure, devops, kubernetes, azure, proxmox, hybrid-cloud, terraform

---

4. Web Applications & Platforms

Web-based applications and platforms for end users.

Projects:

• Datacenter-Control-Complete (Datacenter Control System)
• miracles_in_motion (Nonprofit Platform)
• stinkin_badges (Badge Creation Platform PRO)

Tags: web-app, platform, react, nextjs, frontend, fullstack

---

5. Gaming & Metaverse

Gaming and metaverse projects.

Projects:

• metaverseDubai (Dubai Metaverse)

Tags: gaming, metaverse, unreal-engine, 3d, virtual-reality

---

6. Documentation

Documentation repositories.

Projects:

• dbis_docs (DBIS Documentation)
• panda_docs (Panda Documentation)
• iccc_docs (ICCC Documentation)

Tags: documentation, docs, markdown, knowledge-base

---

Project Metadata Standards

Required Metadata

• Name: Project name
• Status: Active / Placeholder / Archived
• Category: Primary category
• Tags: List of tags
• Monorepo: Monorepo name (if applicable)
• Last Updated: Last update date

Optional Metadata

• Technology Stack: Technologies used
• Deployment Platform: Where it's deployed
• Dependencies: Key dependencies
• Maintainer: Responsible team/person
• License: License type
• Repository: Git repository URL

---

Status Definitions

Active

• Project is actively developed
• Regular updates and maintenance
• Production-ready or in active development

Placeholder

• Project is planned but not yet implemented
• May have basic structure or documentation
• Content pending or in planning phase

Archived

• Project is no longer actively maintained
• Historical reference only
• Content may be archived in separate location

---

Tag System

Technology Tags

• typescript, javascript, python, rust, go, solidity
• react, nextjs, vue, angular
• nodejs, express, fastify, nestjs
• postgresql, mongodb, redis
• kubernetes, docker, terraform
• azure, aws, gcp

Domain Tags

• blockchain, defi, banking, financial
• infrastructure, devops, cloud
• identity, security, compliance
• documentation, tools, utilities

Status Tags

• production, staging, development, deprecated

---

Project Relationships

Hierarchical Relationships

• Monorepo → Submodules: Parent-child relationship
• Platform → Services: Platform hosting services

Dependency Relationships

• Depends On: Project requires another project
• Integrates With: Project integrates with another project
• Provides Services For: Project provides services for another

Ecosystem Relationships

• DBIS Ecosystem: dbis_core, dbis_docs, smom-dbis-138, Elemental_Imperium
• Sankofa Ecosystem: Sankofa, PanTel (JV with PANDA)
• DeFi Ecosystem: All Defi-Mix-Tooling projects
• Identity Ecosystem: the_order, stinkin_badges

---

Categorization Guidelines

Primary Category

• Choose the most relevant category
• Based on primary purpose
• One category per project

Tags

• Use multiple tags for better searchability
• Include technology, domain, and status tags
• Keep tags consistent across projects

Metadata

• Keep metadata up-to-date
• Review quarterly
• Update when project status changes

---

Search and Discovery

By Category

Navigate to category section in main README

By Tag

Search for projects by technology, domain, or status tags

By Relationship

Follow relationship links between projects

By Status

Filter projects by active/placeholder/archived status

---

Maintenance

Regular Updates

• Review taxonomy quarterly
• Update project categories as needed
• Ensure metadata is current

Adding New Projects

1. Assign primary category
2. Add appropriate tags
3. Fill in metadata
4. Document relationships
5. Update main README

---

Last Updated: 2025-01-27 Next Review: Q2 2025