- Go 49.9%
- PowerShell 29.4%
- Shell 19.4%
- Python 1%
- Dockerfile 0.2%
- Other 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .cursor/rules | ||
| .forgejo/workflows | ||
| .github/workflows | ||
| api | ||
| cmd/iqv-integration-api | ||
| deploy/docker | ||
| deployments | ||
| docs | ||
| internal | ||
| scripts | ||
| tests/integration | ||
| .dockerignore | ||
| .editorconfig | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| CONTRIBUTING.md | ||
| CONTRIBUTING.tr.md | ||
| docker-compose.local.yml | ||
| docker-compose.yml | ||
| Dockerfile | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| Makefile | ||
| mkdocs.en.yml | ||
| mkdocs.tr.yml | ||
| mkdocs.yml | ||
| README.md | ||
| README.tr.md | ||
| requirements-docs.txt | ||
| SECURITY.md | ||
| SECURITY.tr.md | ||
Language: English | Türkçe
IQV Integration API
Proprietary ERP integration API for IQVizyon. The service receives project and work-order data from ERP systems, validates it, and persists accepted data to a customer-local MongoDB. Outbound worker push remains a scaffold.
Supported deployment methods
| Platform | Native | Docker |
|---|---|---|
| Windows | Windows Service (recommended production) | Docker Desktop, Linux containers (source-tree installer today) |
| Linux | systemd offline prebuilt binary | Docker Engine offline prebuilt image |
All recommended production paths use external MongoDB.
API overview
GET /health/live,GET /health/readyPOST /api/v1/inbound/work-orders(JSON/XML persist)POST /api/v1/inbound/work-orders/test(format only)- Optional
POST /api/v1/auth/tokenwhenAUTH_ENABLED=true - Read APIs: machine events, production performance
- Swagger UI:
/docs/ - OpenAPI:
/openapi.yaml
OpenAPI source of truth: api/openapi.yaml.
Documentation
This README is the repository home page. The documentation website is a MkDocs site:
Source: docs/en · docs/tr. Wiki drafts: docs/wiki.
How Pages is published: docs/en/operations/publishing-documentation.md.
Installation quick links
Windows installers never create .env. Copy .env.example first. Linux production installers may bootstrap an env from the package example + CLI and never overwrite an existing file.
.\scripts\windows\service\install.ps1
sudo ./scripts/install.sh --external-mongodb \
--mongo-uri "mongodb://<MONGODB_HOST>:27017" \
--mongo-database "<DATABASE_NAME>" \
--integration-actor-user-id "<EXISTING_ACTIVE_USER_OBJECT_ID>" \
--port 8080 \
--public-base-url "http://<API_HOST>:8080"
Testing
go fmt ./...
go vet ./...
go test ./... -count=1
go build ./cmd/iqv-integration-api
go test -race needs cgo. Mongo integration tests need MONGODB_INTEGRATION_TEST_URI. Deployment evidence: docs/en/testing/overview.md.
Security
Do not commit secrets or production .env files. Do not log tokens or unredacted Mongo URIs. See SECURITY.md.
Release
One application version = one GitHub Release (four platform archives + SHA256SUMS + release-manifest.json). Windows zips are source packages for the existing installers; Linux tarballs stay offline prebuilt. Build: .\scripts\release\build-release.ps1 -Version v1.0.0. Details: release process.
License
Copyright © IQVizyon. All rights reserved. See LICENSE.