Discours.io Core

🚀 Modern community platform with GraphQL API, RBAC system, and comprehensive testing infrastructure.

🎯 Features

• 🔐 Authentication: JWT + OAuth (Google, GitHub, Facebook)
• 🏘️ Communities: Full community management with roles and permissions
• 🔒 RBAC System: Role-based access control with inheritance
• 🌐 GraphQL API: Modern API with comprehensive schema
• 🧪 Testing: Complete test suite with E2E automation
• 🚀 CI/CD: Automated testing and deployment pipeline

🚀 Quick Start

Prerequisites

• Python 3.11+
• Node.js 18+
• Redis
• uv (Python package manager)

Installation

# Clone repository
git clone <repository-url>
cd core

# Install Python dependencies
uv sync --group dev

# Install Node.js dependencies
cd panel
npm ci
cd ..

# Setup environment
cp .env.example .env
# Edit .env with your configuration

Development

# Start backend server
uv run python dev.py

# Start frontend (in another terminal)
cd panel
npm run dev

🧪 Testing

Run All Tests

uv run pytest tests/ -v

Test Categories

Run only unit tests

uv run pytest tests/ -m "not e2e" -v

Run only integration tests

uv run pytest tests/ -m "integration" -v

Run only e2e tests

uv run pytest tests/ -m "e2e" -v

Run browser tests

uv run pytest tests/ -m "browser" -v

Run API tests

uv run pytest tests/ -m "api" -v

Skip slow tests

uv run pytest tests/ -m "not slow" -v

Run tests with specific markers

uv run pytest tests/ -m "db and not slow" -v

Test Markers

• unit - Unit tests (fast)
• integration - Integration tests
• e2e - End-to-end tests
• browser - Browser automation tests
• api - API-based tests
• db - Database tests
• redis - Redis tests
• auth - Authentication tests
• slow - Slow tests (can be skipped)

E2E Testing

E2E tests automatically start backend and frontend servers:

• Backend: http://localhost:8000
• Frontend: http://localhost:3000

🚀 CI/CD Pipeline

GitHub Actions Workflow

The project includes a comprehensive CI/CD pipeline that:

1. 🧪 Testing Phase

   • Matrix testing across Python 3.11, 3.12, 3.13
   • Unit, integration, and E2E tests
   • Code coverage reporting
   • Linting and type checking

2. 🚀 Deployment Phase

   • Staging: Automatic deployment on dev branch
   • Production: Automatic deployment on main branch
   • Dokku integration for seamless deployments

Local CI Testing

Test the CI pipeline locally:

# Run local CI simulation
chmod +x scripts/test-ci-local.sh
./scripts/test-ci-local.sh

CI Server Management

The ./ci-server.py script manages servers for CI:

# Start servers in CI mode
CI_MODE=true python3 ./ci-server.py

📊 Project Structure

core/
├── auth/           # Authentication system
├── orm/            # Database models
├── resolvers/      # GraphQL resolvers
├── services/       # Business logic
├── panel/          # Frontend (SolidJS)
├── tests/          # Test suite
├── scripts/        # CI/CD scripts
└── docs/           # Documentation

🔧 Configuration

Environment Variables

• DATABASE_URL - Database connection string
• REDIS_URL - Redis connection string
• JWT_SECRET - JWT signing secret
• OAUTH_* - OAuth provider credentials

Database

• Development: SQLite (default)
• Production: PostgreSQL
• Testing: In-memory SQLite

📚 Documentation

• API Documentation
• Authentication
• RBAC System
• Testing Guide
• Deployment

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request

Development Workflow

# Create feature branch
git checkout -b feature/your-feature

# Make changes and test
uv run pytest tests/ -v

# Commit changes
git commit -m "feat: add your feature"

# Push and create PR
git push origin feature/your-feature

📈 Status

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.