Modular Academic Content Processing Platform - Split into focused subprojects

This is the main project that orchestrates all subprojects:

integral-philosophy/
├── 🧠 subprojects/integral-philosophy-core/     # Core processing engine
├── 🌐 subprojects/integral-philosophy-web/      # Web interface & API
├── 🛠️ subprojects/integral-philosophy-cli/     # Command-line tools
├── 📚 subprojects/integral-philosophy-docs/    # Documentation
├── 📚 subprojects/integral-philosophy-content/ # Sample content
├── ⚙️ subprojects/integral-philosophy-config/ # Configuration
├── 🚀 subprojects/integral-philosophy-deploy/  # Deployment
└── 🧪 subprojects/integral-philosophy-tests/  # Testing suite

```bash

git clone --recursive https://github.com/dominicusin/integral-philosophy.git cd integral-philosophy

git submodule update --init --recursive ```

```bash

./setup-all.sh

./start-full.sh ```

```bash cd subprojects/integral-philosophy-core pip install -e ".[dev]" integral-core parse content.md --format md ```

```bash cd subprojects/integral-philosophy-web pip install -e ".[dev]" integral-web --port 8000 ```

```bash cd subprojects/integral-philosophy-cli pip install -e ".[dev]" integral-publisher process https://example.com --output ./results ```

🌐 Web Interface → 🔌 API Gateway → 🧠 Core Engine → 📚 Output
     │                    │                    │               │
  • React UI         • FastAPI          • Content Parsers   • HTML
  • WebSocket         • Background Jobs    • Format Converters  • PDF  
  • Live Updates      • Rate Limiting     • Content Validators • EPUB
  • File Management    • JWT Auth         • Content Generators • TEI XML

```bash

cd subprojects/integral-philosophy-core git checkout -b feature/new-parser npm run dev

cd ../integral-philosophy-tests pytest tests/integration/ ```

```bash

./run-integration-tests.sh

docker-compose -f docker-compose.dev.yml up ```

```bash

./install-all.sh

./install-core.sh # Core engine only ./install-web.sh # Web interface only ./install-cli.sh # CLI tools only ```

```bash

docker-compose up -d

docker-compose up -d web api core ```

```bash

kubectl apply -f deploy/kubernetes/

kubectl apply -f deploy/kubernetes/web/ kubectl apply -f deploy/kubernetes/api/ ```

```bash docker stack deploy -c docker-compose.yml integral-philosophy ```

• User Guide - Complete user documentation
• Developer Guide - Architecture and development
• API Reference - Full API documentation
• Deployment Guide - Production deployment

• Test Suite - Testing documentation
• CI/CD - GitHub Actions workflows
• Quality Gates - Code quality checks

• Purpose: Core content processing engine
• Language: Python 3.8+
• Dependencies: BeautifulSoup, Pandoc, Pandas
• Tests: pytest, coverage
• CI: GitHub Actions

• Purpose: Web interface and REST API
• Technologies: FastAPI, React, WebSocket
• Features: Real-time updates, file management
• Tests: pytest, Playwright
• CI: GitHub Actions

• Purpose: Command-line interface tools
• Features: Unified CLI, batch processing
• Compatibility: Works with core engine
• Tests: pytest, integration tests

1. Choose subproject to work on
2. Create feature branch
3. Make changes with tests
4. Submit pull request

• Use semantic versioning
• Follow project coding standards
• Update cross-project tests
• Document breaking changes

MIT License - see LICENSE file

• ✨ Modular Architecture - Split into 8 focused subprojects
• 🔧 Better Separation - Clear boundaries and dependencies
• 🚀 Easier Development - Independent development cycles
• 📦 Flexible Deployment - Deploy individual components
• 🔄 Improved Testing - Focused testing for each subproject

🚀 Integral Philosophy Publishing System - Now Modular and Production-Ready!