Хувь нэмэр оруулах
PetroNet System (petronet-gerege-nexus) төсөлд хувь нэмэр оруулах
сонирхол гаргасанд баярлалаа. Модуль бүтэцтэй, өндөр бүтээмжтэй нээлттэй эхийн
платформыг хамтдаа бүтээхэд таны оролцоог урьж байна.
This page has not been translated yet — it is shown in Mongolian, the language it is written in.
01Хариуцагчид
Төслийг дараах баг хөгжүүлж, хариуцан ажиллуулна:
- Gerege Systems Development Team (@gerege-systems)
- Gemini AI, Claude AI
02Ёс зүйн дүрэм
Хувь нэмэр оруулагч бүр Ёс зүйн дүрэм-ийг мөрдөнө.
Зохисгүй үйлдлийг community@gerege. хаягаар мэдэгдэнэ үү.
03Хэрхэн хувь нэмэр оруулах вэ
1. Алдаа мэдээлэх
Алдаа мэдээлэхийн өмнө нээлттэй issue-үүдийг шалгаж, давхардал үүсгэхээс сэргийлнэ үү. Мэдээлэлдээ дараахыг заавал оруулна:
- Алдааг давтан гаргах тодорхой алхмууд.
- Ажиллаж буй орчин (Go хувилбар, Node.js хувилбар, үйлдлийн систем, PostgreSQL хувилбар).
- Хүлээгдэж буй ба бодит үр дүн, боломжтой бол лог.
2. Шинэ боломж санал болгох
Санал болгож буй боломжийн хэрэглээний тохиолдол, шийдэх гэж буй асуудал, төсөөлж буй шийдлээ тодорхой бичнэ үү.
3. Pull request илгээх
Салбар үүсгэх —
git checkout -b feature/.amazing-feature Код бичих хэв маягийг мөрдөх:
- Backend: Go 1.26+,
gofmtформатлалт,slogбүтэцтэй логлолт, алдааг тодорхой шалгах. - Frontend: Next.js 16 App Router, TypeScript strict горим, Tailwind CSS.
- Backend: Go 1.26+,
Тест бичих — backend-д нэмэгдсэн логик бүрт
*_test.goтест дагалдана.Шалгалтуудыг ажиллуулах:
bash1# Backend: формат, статик шинжилгээ, тест2cd backend3gofmt -l .4go vet ./...5go test -race ./...6golangci-lint run7 8# Frontend: төрлийн шалгалт ба build9cd ../frontend10npx tsc --noEmit11npm run buildCommit бичлэг — Conventional Commits хэлбэрийг баримтална:
feat: add invoice management modulefix: resolve stock level calculation roundingdocs: update module authoring guide
PR нээх —
mainсалбар руу чиглүүлнэ. CI дээрх lint, тест, frontend build, аюулгүй байдлын шалгалт бүгд ногоон байх шаардлагатай.
04Шинэ бизнес модуль нэмэх
backend/дор шинэ пакет үүсгэнэ.internal/ apps/ <module_ name>/ backend/-ийнpkg/ nexus nexus.Moduleинтерфейсийг бүрэн хэрэгжүүлнэ.- Модулийг
nexus.Register-ээр бүртгэж,catalog/manifest файл нэмнэ. Manifest-ийн бүтэцmanifests/ <slug>. json appcatalog.-тэй яг таарах ёстой — алдаатай manifest бол сервер асахгүй.Manifest catalog/-д апп-аа бүртгэнэ.apps. json appsхүснэгт нь ачаалал бүрт энэ файлаас синк болох тул SQL гараар бичих шаардлагагүй.brand/дор дэлгэц нэмнэ.frontend/ src/ app/ <module_ name>/ page. tsx
Дэлгэрэнгүйг Модуль бичих-ээс үзнэ үү.
05backend/pkg/nexus -д хүрэх PR
Энэ пакет бол экосистемийн гэрээ: distribution repo бүр түүн рүү компилл хийж, tag-аар түгжинэ. Тиймээс:
- CODEOWNERS-ийн review заавал (
.).github/ CODEOWNERS - Экспортолсон гадаргуу өөрчлөгдвөл
go test ./ажиллуулж,pkg/ nexus -update testdata/-ийн diff-ийг PR-даа оруулна. Тэр diff нь гэрээ юу авч, юу алдсаныг review-д яг хэлнэ.api. txt - Эвдэх өөрчлөлт бол deprecation → нэг major цикл. Дүрмийг Модуль бичих-ийн «Хувилбарын амлалт» хэсгээс үзнэ үү.
06Баримт бичиг ба орчуулга
- Үндсэн хэл нь монгол. Орчуулгууд
docs/дор_EN,_ZH,_RUдагаварт байрлана. - Баримт бичигт emoji ашиглахгүй. Дүрс шаардлагатай бол
docs/дахь Flaticon дүрсийг ашиглаж,assets/ icons/ ATTRIBUTION.md-д эх сурвалжийг нэмнэ. - Орчуулга нэмэх журмыг
docs/README.md-ээс үзнэ үү.