213 lines
4.6 KiB
Markdown
213 lines
4.6 KiB
Markdown
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# Start backend server
|
|
uv run python dev.py
|
|
|
|
# Start frontend (in another terminal)
|
|
cd panel
|
|
npm run dev
|
|
```
|
|
|
|
## 🧪 Testing
|
|
|
|
### Run All Tests
|
|
```bash
|
|
uv run pytest tests/ -v
|
|
```
|
|
|
|
### Test Categories
|
|
|
|
#### Run only unit tests
|
|
```bash
|
|
uv run pytest tests/ -m "not e2e" -v
|
|
```
|
|
|
|
#### Run only integration tests
|
|
```bash
|
|
uv run pytest tests/ -m "integration" -v
|
|
```
|
|
|
|
#### Run only e2e tests
|
|
```bash
|
|
uv run pytest tests/ -m "e2e" -v
|
|
```
|
|
|
|
#### Run browser tests
|
|
```bash
|
|
uv run pytest tests/ -m "browser" -v
|
|
```
|
|
|
|
#### Run API tests
|
|
```bash
|
|
uv run pytest tests/ -m "api" -v
|
|
```
|
|
|
|
#### Skip slow tests
|
|
```bash
|
|
uv run pytest tests/ -m "not slow" -v
|
|
```
|
|
|
|
#### Run tests with specific markers
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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](docs/api.md)
|
|
- [Authentication](docs/auth.md)
|
|
- [RBAC System](docs/rbac-system.md)
|
|
- [Testing Guide](docs/testing.md)
|
|
- [Deployment](docs/deployment.md)
|
|
|
|
## 🤝 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
|
|
```bash
|
|
# 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](LICENSE) file for details.
|