Help Center

Platform Guide (SynNovator)

SynNovator Web Platform User Manual

The English version of this manual is being updated to match the new Chinese manual (issue #106). For now, please refer to the Chinese version at the language switcher (zh-CN) for the most up-to-date guidance.

The new manual covers:

  • Manual scope and key concepts
  • Quick links to all platform pages
  • Account and personal space
  • Home feed, activity, and discovery
  • Participant flow: registration → development → submission
  • Team and organization collaboration
  • Bounty browsing, creation, and completion
  • Grant rounds: browsing, applying, and managing
  • Credits, redemption, and rewards
  • Reputation and leaderboards
  • Notifications, follows, and interactions
  • Troubleshooting common issues
  • Recommended workflows for participants and teams

English translation is tracked in issue #106. Contributions welcome.

System Guide (HackForger)

HackForger System Guide

HackForger is the underlying system engine of the Synnovator platform. Built on Forgejo, it provides complete Git collaboration capabilities plus extension modules designed for co-creation activities. This page is a capability index — find the feature you need, then follow the link to go deeper.

Core Git Collaboration Capabilities

These capabilities are inherited from Forgejo. Usage is identical to Forgejo / Gitea / GitHub:

  • Repositories — Create, Fork, branches, tags, protection rules, template repositories, mirror sync
  • Pull Requests / Merge Requests — Code review, conflict resolution, checks, auto-merge
  • Issues — Labels, milestones, project boards, automation, lock/pin
  • Wiki / Project Docs — Built-in repository Wiki, custom home page
  • Forgejo Actions / Workflows — .forgejo/workflows/*.yml CI/CD, self-hosted runner support
  • Full-text Search — Multi-dimensional search across code, Issues, Commits, and Wiki
  • Webhooks / External Integrations — Push code/Issue events to Slack, WeCom, external CI, and more
  • SSH / HTTPS Access — Personal Access Token (PAT), SSH key management
  • Organizations / Teams — Multi-level permissions, shared team repositories

If you are familiar with GitHub, the workflows here are nearly identical. For detailed usage documentation, refer to the upstream Forgejo Docs.

HackForger Platform Extension Modules

These are the modules HackForger adds on top of Forgejo to power Synnovator's co-creation activities:

Module Description Access Path
Hackathon Event creation, registration, tracks, judges, scoring, leaderboard /explore/hackathons
Bounty Issue linking, apply/claim, escrow, multi-party prize pool /explore/bounties
Grant Funding rounds, project applications, review, allocation /explore/grants
Credits Platform-wide credits ledger, redemption store, order history /credits
Submissions Aggregated browsing of submissions across all activities /explore/submissions
Feed Activity/Bounty/Grant/Credits event stream / dashboard
Reputation User participation metrics, leaderboard, tier badges /explore/reputation

Developer Resources

  • API Reference — Visit /api/swagger for the full OpenAPI documentation; HackForger-specific endpoints start with /api/v1/hackforger/
  • CLI Tool — hackforger-cli (repository root, Go implementation, for bulk creation and management of activities)
  • AI Agent Integration — Authorize via PAT to let an AI agent operate the platform API on your behalf

Need Help?

  • Platform feature questions — Read the "Platform Guide (Synnovator)" section on this page
  • Git / repository questions — Refer to Forgejo Docs
  • Found a bug — Open an issue in the HackForger GitHub repository