🚀 Linux Do Community Credit Service Platform

中文

LINUX DO Credit is a credit service platform built for the Linux Do community, aimed at providing a series of credit-related services and offering a foundational framework for credit circulation for community developers.

• 🔐 OAuth2 Authentication - Integrated with Linux Do community account system
• 🛡️ Risk Control - Comprehensive trust level and risk assessment system
• 📊 Real-time Monitoring - Detailed distribution statistics and user behavior analysis
• 🎨 Modern Interface - Responsive design based on Next.js 16 and React 19
• ⚡ High Performance - Go Backend + Redis Cache + PostgreSQL Database

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Frontend      │    │    Backend      │    │   Database      │
│   (Next.js)     │◄──►│     (Go)        │◄──►│  (PostgreSQL)   │
│                 │    │                 │    │                 │
│ • React 19      │    │ • Gin Framework │    │ • PostgreSQL    │
│ • TypeScript    │    │ • OAuth2        │    │ • Redis Cache   │
│ • Tailwind CSS  │    │ • Session Store │    │                 │
│ • Shadcn UI     │    │ • OpenTelemetry │    │                 │
│                 │    │ • Swagger API   │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘

• Go 1.25.5 - Primary development language
• GIN - Web Framework
• GORM - ORM Framework
• Redis - Cache and session store
• PostgreSQL - Primary Database
• OpenTelemetry - Observability
• Swagger - API Documentation

• Next.js 16 - React Framework
• React 19 - UI Library
• TypeScript - Type Safety
• Tailwind CSS 4 - Styling Framework
• Shadcn UI - Component Library
• Lucide Icons - Icon Library

• Go >= 1.25.5
• Node.js >= 18.0
• PostgreSQL >= 18
• Redis >= 6.0
• pnpm >= 8.0 (Recommended)

git clone https://github.com/linux-do/credit.git
cd credit

Copy the configuration file and edit it:

cp config.example.yaml config.yaml

Edit config.yaml to configure database connections, Redis, OAuth2, etc.

# Create database
createdb -h <host> -p 5432 -U postgres linux_do_credit

# If you need to specify encoding, use:
# psql -h <host> -p 5432 -U postgres -c "CREATE DATABASE linux_do_credit WITH ENCODING 'UTF8' LC_COLLATE='zh_CN.UTF-8' LC_CTYPE='zh_CN.UTF-8' TEMPLATE template0;"

# Run migrations (automatically executed when starting the backend)

# Install Go dependencies
go mod tidy

# Generate API documentation
make swagger

# Start backend service
go run main.go api

cd frontend

# Install dependencies
pnpm install

# Start development server
pnpm dev

• Frontend Interface: http://localhost:3000
• API Documentation: http://localhost:8000/swagger/index.html
• Health Check: http://localhost:8000/api/health

For detailed configuration instructions, please refer to the config.example.yaml file.

# Run API server
go run main.go api

# Run task scheduler
go run main.go scheduler

# Run worker queue
go run main.go worker

# Generate Swagger documentation
make swagger

# Format and check code
make tidy

cd frontend

# Development mode (using Turbopack)
pnpm dev

# Build production version
pnpm build

# Start production service
pnpm start

# Lint and format code
pnpm lint
pnpm format

API documentation is automatically generated by Swagger and can be accessed after starting the backend service:

http://localhost:8000/swagger/index.html

# Backend testing
go test ./...

# Frontend testing
cd frontend
pnpm test

# Build image
docker build -t linux-do-credit .

# Run container
docker run -d -p 8000:8000 linux-do-credit

1. Build frontend resources:

   cd frontend && pnpm build

2. Compile backend program:

   go build -o credit main.go

3. Configure config.yaml for production

4. Start service:

   ./credit api

We welcome community contributions! Please read the following before submitting code:

• Contribution Guidelines
• Code of Conduct
• Contributor License Agreement

1. Fork this repository
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit changes (git commit -am 'Add your feature')
4. Push to branch (git push origin feature/your-feature)
5. Create Pull Request

This project is open source under the Apache2.0 License.

• Linux Do Community
• Issue Reporting
• Feature Request

Thanks to all developers who contributed to this project and the support of the Linux Do Community!