{"id":19475707,"url":"https://github.com/iondv/develop-and-test","last_synced_at":"2026-06-16T15:31:49.575Z","repository":{"id":54296328,"uuid":"181388954","full_name":"iondv/develop-and-test","owner":"iondv","description":"Develop-and-test is an IONDV. Framework application for testing (dnt app) - https://iondv.com/portal/get-it","archived":false,"fork":false,"pushed_at":"2021-07-09T02:17:14.000Z","size":2531,"stargazers_count":3,"open_issues_count":3,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-25T15:52:23.078Z","etag":null,"topics":["css","iondv","iondv-app","metadata","modules","testing"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iondv.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-15T01:05:31.000Z","updated_at":"2021-07-09T02:17:19.000Z","dependencies_parsed_at":"2022-08-13T11:20:15.447Z","dependency_job_id":null,"html_url":"https://github.com/iondv/develop-and-test","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iondv/develop-and-test","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iondv%2Fdevelop-and-test","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iondv%2Fdevelop-and-test/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iondv%2Fdevelop-and-test/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iondv%2Fdevelop-and-test/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iondv","download_url":"https://codeload.github.com/iondv/develop-and-test/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iondv%2Fdevelop-and-test/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34412786,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css","iondv","iondv-app","metadata","modules","testing"],"created_at":"2024-11-10T19:34:20.797Z","updated_at":"2026-06-16T15:31:49.556Z","avatar_url":"https://github.com/iondv.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IONDV. Develop-and-test\n\nDevelop-and-test is a IONDV. Framework application. \n\n\u003ch1 align=\"center\"\u003e \u003ca href=\"https://www.iondv.com/\"\u003e\u003cimg src=\"/dnt.png\" height=\"500px\" alt=\"IONDV. Develop-and-test\" align=\"center\"\u003e\u003c/a\u003e\n\u003c/h1\u003e \n\n## Start with IONDV. Framework\n\n**IONDV. Framework** - is a node.js open source framework for developing accounting applications\nor microservices based on metadata and individual modules. Framework is a part of \ninstrumental digital platform to create enterprise \n(ERP) apps. This platform consists of the following open-source components: the [IONDV. Framework](https://github.com/iondv/framework), the\n[modules](https://github.com/topics/iondv-module) и ready-made applications expanding it\nfunctionality, visual development environment [Studio](https://github.com/iondv/studio) to create metadata for the app.\n\n* [IONDV. Framework](https://github.com/iondv/framework/)\n* [IONDV. Framework Docs](https://github.com/iondv/framework/blob/master/docs/en/index.md)\n\n## Description \n\n**Develop-and-test** - is created to show you the type of metadata and basic functional modules of the IONDV. Framework and to \nhighlight the most powerful features. It has most of the components from the full version to get you a walkthrough of our framework to build top quality web applications. \n\n### Demo\nGo to \u003ca href=\"https://dnt.iondv.com\"\u003ednt.iondv.com\u003c/a\u003e. No registration needed. The login for access is - `demo` and the password is - `ion-demo`.\n\n### Software requirements\n\nInstall [Node.js](\u003chttps://nodejs.org/en/\u003e) runtime and npm package manager to run the IONDV.Framework. Version 10.x.x.   \n\nInstall and run the [MongoDB](https://www.mongodb.org/) DBMS to store the data. Version 3.6.  \n\n### Installer\n\nYou can use IONDV. Framework apps installer, requiring installed node.js, mongodb and git. During the installation, all other dependencies will be checked and installed, and the application itself will be built and run.\n\nInstall in one line:\n\n```\nbash \u003c(curl -sL https://raw.githubusercontent.com/iondv/iondv-app/master/iondv-app) -t git -q -i -m localhost:27017 develop-and-test\n```\nWhere  `localhost: 27017` is the MongoDB address, and `develop-and-test` is the app name.\n\nAlso the other way is to clone - (`git clone https://github.com/iondv/iondv-app.git`) and install the app by using the `bash iondv-app -m localhost:27017 develop-and-test` command.\n\n\u003cdetails\u003e\n  \u003csummary\u003e \n    \u003ch3\u003e \n      Gitclone with repository\n    \u003c/h3\u003e \n  \u003c/summary\u003e\n\n\n#### Global dependencies\n\nTo build all components and libraries, you need to install the following components globally:\n\n* package [node-gyp](\u003chttps://github.com/nodejs/node-gyp\u003e) `npm install -g node-gyp`. For the Windows operating system, \nit is additionally necessary to install the windows-build-tools package `npm install -g --production windows-build-tools`\n* [Gulp](\u003chttp://gulpjs.com/\u003e) installation package `npm install -g gulp@4.0`. `4.0` - supported version of `Gulp`\n* package manager of frontend libraries [Bower](\u003chttps://bower.io\u003e) `npm install -g bower`\n\n#### Core, modules and application\n\nThe dependencies are listed in the [`package.json`](https://github.com/iondv/develop-and-test/blob/master/package.json) file.\n\n*Example of the `package.json` file:*\n\n```\n  \"engines\": {\n    \"ion\": \"3.0.0\"\n  },\n  \"ionModulesDependencies\": {\n    \"registry\": \"3.0.0\",\n    \"geomap\": \"1.5.0\",\n    \"portal\": \"1.4.0\",\n    \"report\": \"2.0.0\",\n    \"ionadmin\": \"2.0.0\",\n    \"dashboard\": \"1.1.0\",\n    \"soap\": \"1.1.2\"\n  },\n  \"ionMetaDependencies\": {\n    \"viewlib\": \"0.9.1\"\n  }\n```\n* Install the core, Its version is specified in the `engines\": \"ion\": 3.0.0` parameter. Copy the URL of the core repository\n and execute the command `git clone https://github.com/iondv/framework.git dnt`, where `dnt` is a application name, for \n example full path is `/workspace/dnt'. Go to \n the core folder and switch the tag of  the version number `git checkout tags/3.0.0`.\n* Further, install the modules listed in the `ionModulesDependencies` parameter. Navigate to the module folder executing \nthe `cd modules` command. Clone modules from the `ionModulesDependencies` list, for the registry module the command is \n`git clone https://github.com/iondv/registry.git`. Go to the folder of the installed module and switch the tag of the \nversion number `git checkout tags/3.0.0`. Repeat for each module.  \n* To install the application, go to the application folder executing the `cd ..\\applications` command, if you're in the module folder. \nClone the path to repository by `git clone https://github.com/iondv/develop-and-test.git`command. Go to the folder of \ninstalled application and switch the tag of the version number `git checkout tags/2.0.0`. \n* Finally, install all necessary applications listed in the `ionMetaDependencies` parameter in the `applications` folder. \nMake sure that you're inside this folder. Clone the dependencies in `ionMetaDependencies`, in particularly ` viewlib` - \na additional application - library of views templates. Execute the `git clone https://github.com/iondv/viewlib.git` to \nclone to the `applications` folder. Go to the folder of installed application and switch to the tag of the version \nnumber `git checkout tags/0.9.1`. Repeat for each application. \n \n#### Building, configuring and deploying the application\n\nBuilding the application provides installation of all depended libraries, importing data into the database and preparing \nthe application for launch.  \n\nCreate the configuration file `setup.ini` in the `/config` folder of the core to set the main parameters of the \napplication environment.  \n\n```\nauth.denyTop=false \nauth.registration=false \nauth.exclude[]=/files/**\nauth.exclude[]=/images/**\ndb.uri=mongodb://127.0.0.1:27017/iondv-dnt-db\nserver.ports[]=8888\nmodule.default=registry\nfs.storageRoot=./files\nfs.urlBase=/files\n```\n\nOpen the file and paste the text above. The main parameter is `db.uri=mongodb://127.0.0.1:27017/iondv-dnt-db`. It shows the \nbase name that we use for the application. The DB will be created automatically. \n\nSet the `NODE_PATH` environment variable which is equal to the path of the application core. For Windows the command \nis `set NODE_PATH=c:\\workspace\\dnt`, for Linux - `export NODE_PATH=/workspace/dnt`. `/workspace/dnt` is the directory of \nthe application.   \n\nThe `npm install` installs all key dependencies, including locally the `gulp` build-tool. Please make sure that the Gulp \nversion - is `4.0`. \n\nFurther, execute the `gulp assemble` command to build and deploy the application.\n\nIf you want to import data into your project, check the demo data in the `data` folder of the application and run the command:\n`node bin/import-data --src ./applications/develop-and-test --ns develop-and-test`\n\nAdd the admin user with the 123 password executing the `node bin\\adduser.js --name admin --pwd 123` command. \n\nAdd admin rights to the user executing the `node bin\\acl.js --u admin@local --role admin --p full` command.\n\n#### Running\n\nRun the app, executing the `npm start` or `node bin/www` command. \n\nOpen this link `http://localhost:8888` in a browser and log in. `8888` —  is a port in the `server.ports` parameter.\n\n \u003c/details\u003e\n\n### Docker\nFollow these steps to deploy [docker container](https://hub.docker.com/r/iondv/dnt):\n\n1. Run mongodb\n\n```bash\ndocker run  --name mongodb \\\n            -v mongodb_data:/data/db \\\n            -p 27017:27017 \\\n            --restart unless-stopped \\\n            -d \\\n            mongo\n```\n\n2. Deploy your **IONDV. Develop-and-test** and additional applications \n```bash\ndocker run --entrypoint=\"\" --link mongodb --rm iondv/dnt node bin/import --src ./applications/develop-and-test --ns develop-and-test\ndocker run --entrypoint=\"\" --link mongodb --rm iondv/dnt node bin/setup develop-and-test --reset\ndocker run --entrypoint=\"\" --link mongodb --rm iondv/dnt node bin/setup viewlib\n```\n\nIf you want to import data into your project, check the demo data in the `data` folder of the application and run the command:\n```\ndocker run --entrypoint=\"\" --link mongodb --rm iondv/dnt node bin/import-data --src ./applications/develop-and-test --ns develop-and-test\n```\n\n3. Create user `admin` with password `123` and `admin` role\n```\ndocker run --entrypoint=\"\" --link mongodb --rm iondv/dnt node bin/adduser --name admin --pwd 123\ndocker run --entrypoint=\"\" --link mongodb --rm iondv/dnt node bin/acl --u admin@local --role admin --p full\n```\n\n4. Start application\n```\ndocker run -d -p 80:8888 --name dnt --link mongodb iondv/dnt\n```\n\nOpen `http://localhost/` in your browser.\n\n\n--------------------------------------------------------------------------  \n\n\n #### [License](/LICENSE) \u0026ensp;  [Contact us](https://iondv.com) \u0026ensp;   \u0026ensp; [FAQs](/faqs.md)          \n\n\u003cdiv\u003e\u003cimg src=\"https://mc.iondv.com/watch/local/docs/app/dnt\" style=\"position:absolute; left:-9999px;\" height=1 width=1 alt=\"iondv metrics\"\u003e\u003c/div\u003e\n\n--------------------------------------------------------------------------  \n\nCopyright (c) 2019 **LLC \"ION DV\"**.  \nAll rights reserved. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiondv%2Fdevelop-and-test","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiondv%2Fdevelop-and-test","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiondv%2Fdevelop-and-test/lists"}