Initial commit: add .gitignore and README
This commit is contained in:
defiQUG
49
.gitignore
vendored
Normal file
49
.gitignore
vendored
Normal file
@@ -0,0 +1,49 @@
|
|||||||
|
# Dependencies
|
||||||
|
node_modules/
|
||||||
|
.pnpm-store/
|
||||||
|
vendor/
|
||||||
|
|
||||||
|
# Package manager lock files (optional: uncomment to ignore)
|
||||||
|
# package-lock.json
|
||||||
|
# yarn.lock
|
||||||
|
|
||||||
|
# Environment and secrets
|
||||||
|
.env
|
||||||
|
.env.local
|
||||||
|
.env.*.local
|
||||||
|
*.env.backup
|
||||||
|
.env.backup.*
|
||||||
|
|
||||||
|
# Logs and temp
|
||||||
|
*.log
|
||||||
|
logs/
|
||||||
|
*.tmp
|
||||||
|
*.temp
|
||||||
|
*.tmp.*
|
||||||
|
|
||||||
|
# OS
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
|
|
||||||
|
# IDE
|
||||||
|
.vscode/
|
||||||
|
.idea/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
*~
|
||||||
|
|
||||||
|
# Build / output
|
||||||
|
dist/
|
||||||
|
build/
|
||||||
|
.next/
|
||||||
|
out/
|
||||||
|
*.pyc
|
||||||
|
__pycache__/
|
||||||
|
.eggs/
|
||||||
|
*.egg-info/
|
||||||
|
.coverage
|
||||||
|
htmlcov/
|
||||||
|
|
||||||
|
# Optional
|
||||||
|
.reports/
|
||||||
|
reports/
|
||||||
30
NOTICE.md
Normal file
30
NOTICE.md
Normal file
@@ -0,0 +1,30 @@
|
|||||||
|
# NOTICE
|
||||||
|
|
||||||
|
## Canonical Sovereign System
|
||||||
|
|
||||||
|
This repository implements **ICCC (International Court of Canonical Continuity)**, a Tier-1 canonical sovereign system as defined in the [Canonical Constitution](../../CANONICAL_CONSTITUTION.md).
|
||||||
|
|
||||||
|
### Constitutional Status
|
||||||
|
|
||||||
|
- **Tier**: Tier 1 – Sovereign Canon
|
||||||
|
- **System**: ICCC (International Court of Canonical Continuity)
|
||||||
|
- **Role**: Adjudicative and interpretive body resolving disputes of doctrine, interpretation, and continuity across sovereign systems
|
||||||
|
|
||||||
|
### Governance
|
||||||
|
|
||||||
|
Changes to this repository are subject to formal proposal and recognition requirements as established in the Canonical Constitution. This system operates under mutual recognition with DBIS, SMOM/SMOA, and GRU.
|
||||||
|
|
||||||
|
### Related Canonical Systems
|
||||||
|
|
||||||
|
- **DBIS** (Distributed Body of International Sovereignty) – Foundational sovereign framework
|
||||||
|
- **SMOM/SMOA** (Sovereign Management & Operations) – Operational coordination and execution
|
||||||
|
- **GRU** (Global Reserve Unit) – Monetary and settlement framework
|
||||||
|
|
||||||
|
### Reference
|
||||||
|
|
||||||
|
For the complete constitutional framework and governance principles, see: [CANONICAL_CONSTITUTION.md](../../CANONICAL_CONSTITUTION.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Status**: Canonical
|
||||||
|
**Last Updated**: 2025-01-27
|
||||||
232
README.md
Normal file
232
README.md
Normal file
@@ -0,0 +1,232 @@
|
|||||||
|
# ICCC Monorepo
|
||||||
|
|
||||||
|
**Status**: 🚧 **Placeholder - Under Planning**
|
||||||
|
**Purpose**: Unified monorepository for ICCC (International Cross-Chain Council) ecosystem projects.
|
||||||
|
|
||||||
|
> **Constitutional Status**: This repository implements **ICCC**, a Tier-1 canonical sovereign system. See [NOTICE.md](./NOTICE.md) and [CANONICAL_CONSTITUTION.md](../CANONICAL_CONSTITUTION.md) for details.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
ICCC Monorepo consolidates all ICCC-related projects into a single, unified repository structure. This enables shared code, unified versioning, simplified dependency management, and coordinated development across all ICCC initiatives.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Monorepo Structure
|
||||||
|
|
||||||
|
This monorepo uses git submodules to manage related projects:
|
||||||
|
|
||||||
|
```
|
||||||
|
iccc_monorepo/
|
||||||
|
├── .gitmodules # Git submodules configuration
|
||||||
|
├── iccc_portal/ # ICCC Portal application (submodule)
|
||||||
|
├── iccc_docs/ # ICCC Documentation (submodule)
|
||||||
|
├── packages/ # Shared packages (planned)
|
||||||
|
│ ├── iccc-shared/ # Shared TypeScript libraries
|
||||||
|
│ ├── iccc-api-client/ # API client libraries
|
||||||
|
│ └── iccc-schemas/ # JSON/GraphQL schemas
|
||||||
|
├── apps/ # Applications (planned)
|
||||||
|
│ └── [additional-apps]/ # Additional ICCC applications
|
||||||
|
├── tools/ # Development tools (planned)
|
||||||
|
└── docs/ # Monorepo documentation (planned)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Submodules
|
||||||
|
|
||||||
|
### iccc_portal
|
||||||
|
**Status**: Active
|
||||||
|
**Description**: ICCC Portal application - web-based portal for ICCC services and operations.
|
||||||
|
|
||||||
|
**Features** (Planned):
|
||||||
|
- User management interface
|
||||||
|
- Cross-chain governance interfaces
|
||||||
|
- Service management UI
|
||||||
|
- Analytics and reporting dashboards
|
||||||
|
|
||||||
|
### iccc_docs
|
||||||
|
**Status**: Active
|
||||||
|
**Description**: ICCC Documentation repository - comprehensive documentation for ICCC ecosystem.
|
||||||
|
|
||||||
|
**Contents** (Planned):
|
||||||
|
- Technical documentation
|
||||||
|
- API documentation
|
||||||
|
- User guides
|
||||||
|
- Governance documentation
|
||||||
|
- Integration guides
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
### Clone with Submodules
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Clone repository with all submodules
|
||||||
|
git clone --recurse-submodules <repository-url>
|
||||||
|
cd iccc_monorepo
|
||||||
|
|
||||||
|
# Or if already cloned, initialize submodules
|
||||||
|
git submodule update --init --recursive
|
||||||
|
```
|
||||||
|
|
||||||
|
### Update Submodules
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Update all submodules to latest commits
|
||||||
|
git submodule update --remote
|
||||||
|
|
||||||
|
# Update specific submodule
|
||||||
|
cd iccc_portal
|
||||||
|
git pull origin main
|
||||||
|
cd ..
|
||||||
|
git add iccc_portal
|
||||||
|
git commit -m "Update iccc_portal submodule"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Shared Resources (Planned)
|
||||||
|
|
||||||
|
### Shared Packages
|
||||||
|
|
||||||
|
**iccc-shared**:
|
||||||
|
- Common utilities and types
|
||||||
|
- Configuration helpers
|
||||||
|
- Validation schemas
|
||||||
|
- Constants and enums
|
||||||
|
|
||||||
|
**iccc-api-client**:
|
||||||
|
- REST API clients
|
||||||
|
- GraphQL clients
|
||||||
|
- WebSocket clients
|
||||||
|
- Type definitions
|
||||||
|
|
||||||
|
**iccc-schemas**:
|
||||||
|
- JSON schemas
|
||||||
|
- GraphQL schemas
|
||||||
|
- Protocol schemas
|
||||||
|
- Validation schemas
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Technology Stack (Planned)
|
||||||
|
|
||||||
|
### Package Manager
|
||||||
|
- **pnpm workspaces** (recommended) or npm/yarn
|
||||||
|
|
||||||
|
### Build Tooling
|
||||||
|
- **Turborepo** or **Nx** (for build orchestration)
|
||||||
|
- TypeScript
|
||||||
|
- ESLint / Prettier
|
||||||
|
|
||||||
|
### Development Tools
|
||||||
|
- Vitest or Jest (testing)
|
||||||
|
- Husky (git hooks)
|
||||||
|
- Changesets (versioning)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Development Workflow (Planned)
|
||||||
|
|
||||||
|
### Setup
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install dependencies
|
||||||
|
pnpm install
|
||||||
|
|
||||||
|
# Build all packages
|
||||||
|
pnpm build
|
||||||
|
|
||||||
|
# Run tests
|
||||||
|
pnpm test
|
||||||
|
|
||||||
|
# Start development servers
|
||||||
|
pnpm dev
|
||||||
|
```
|
||||||
|
|
||||||
|
### Working with Submodules
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Make changes in submodule
|
||||||
|
cd iccc_portal
|
||||||
|
# Make changes and commit
|
||||||
|
git add .
|
||||||
|
git commit -m "Your changes"
|
||||||
|
git push
|
||||||
|
cd ..
|
||||||
|
|
||||||
|
# Update parent repo reference
|
||||||
|
git add iccc_portal
|
||||||
|
git commit -m "Update iccc_portal submodule"
|
||||||
|
git push
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## CI/CD Pipeline (Planned)
|
||||||
|
|
||||||
|
### Workflow
|
||||||
|
1. Lint & Type Check
|
||||||
|
2. Unit Tests
|
||||||
|
3. Integration Tests
|
||||||
|
4. Build
|
||||||
|
5. E2E Tests
|
||||||
|
6. Deploy
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
- Monorepo-level documentation in this repository
|
||||||
|
- Project-specific documentation in submodules:
|
||||||
|
- **[iccc_portal](./iccc_portal/)** - Portal documentation
|
||||||
|
- **[iccc_docs](./iccc_docs/)** - Comprehensive documentation
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Related Projects
|
||||||
|
|
||||||
|
### ICCC Ecosystem
|
||||||
|
- **iccc_portal** - Portal application (submodule)
|
||||||
|
- **iccc_docs** - Documentation (submodule)
|
||||||
|
|
||||||
|
### Potential Integrations
|
||||||
|
- Cross-chain infrastructure
|
||||||
|
- Governance systems
|
||||||
|
- Documentation platforms
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
When contributing:
|
||||||
|
|
||||||
|
1. Follow monorepo standards
|
||||||
|
2. Update affected submodules
|
||||||
|
3. Run tests for all projects
|
||||||
|
4. Update documentation
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
[To be determined]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
**Current Status**: 🚧 Placeholder
|
||||||
|
**Next Steps**:
|
||||||
|
- Finalize monorepo structure
|
||||||
|
- Set up shared packages
|
||||||
|
- Configure build tooling
|
||||||
|
- Begin Phase 1 development
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Last Updated**: 2025-01-27
|
||||||
|
|
||||||
Reference in New Issue
Block a user