Skip to content

Internal development guide

Gerege Nexus (private-gerege-nexus) is a private project. This guide is for the authorized development team.

Монгол  ·  English

Maintainers

Development workflow

1. Reporting bugs

Check the open issues first so you don't file a duplicate. A good report includes:

  • Clear steps to reproduce.
  • Your environment (Go version, Node.js version, OS, PostgreSQL version).
  • Expected versus actual behaviour, with logs where possible.

2. Suggesting enhancements

Describe the use case, the problem you are solving and the solution you have in mind.

3. Submitting pull requests

  1. Create a branch — git checkout -b feature/amazing-feature.
  2. Follow the code conventions:
  3. Backend: Go 1.26+, gofmt formatting, structured logging with slog, explicit error handling.
  4. Frontend: Next.js 16 App Router, TypeScript strict mode, Tailwind CSS.
  5. Write tests — new backend logic ships with *_test.go coverage.
  6. Run the verification suite:
# Backend: format, static analysis, tests
cd backend
gofmt -l .
go vet ./...
go test -race ./...
golangci-lint run

# Frontend: typecheck and build
cd ../frontend
npx tsc --noEmit
npm run build
  1. Commit messages follow Conventional Commits:
  2. feat: add invoice management module
  3. fix: resolve stock level calculation rounding
  4. docs: update module authoring guide
  5. Open the PR against main. Lint, tests, the frontend build and the security scans must all be green.

Adding a new business module

  1. Create a package under backend/internal/apps/<module_name>/.
  2. Implement the internal.Module interface from backend/internal/module.go in full.
  3. Register the module with appregistry and add catalog/manifests/<slug>.json. The manifest must match appcatalog.Manifest exactly — a malformed manifest stops the server from booting.
  4. Add the app to catalog/apps.json. The apps table is synchronised from that file on every boot, so no manual SQL is required.
  5. Add the frontend view under frontend/app/<module_name>/page.tsx.

Writing a module walks through this in detail.

Documentation and translations

  • Mongolian is the primary language. Translations live under docs/ with the _EN, _ZH and _RU suffixes.
  • Do not use emoji in documentation. Where an icon is needed, use the Flaticon assets in assets/icons/ and add the source to ATTRIBUTION.md.
  • See README.md for how to add a new translation.