-
Notifications
You must be signed in to change notification settings - Fork 2
Added Tests + Schema Updates #33
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
9d0d516
898c763
0ab3a6d
9b7fa8d
81ad36c
e769e67
0a63d12
d544c03
f208535
47342cd
68f809e
58b0b45
93bb050
22016f0
cb5990f
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,175 +1,25 @@ | ||
| # Examples of code.json | ||
|
|
||
| Below are good examples of metadata in CMS code.json files. We hope it helps when creating your repository-level code.json file. | ||
| Below are examples of well-structured and comprehensive metadata in CMS code.json files. These examples demonstrate best practices for repository-level metadata documentation. | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Are these examples just for CMS code.json, or broadly for all Federal code.json?
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Examples are currently just CMS code.jsons. Can def add more examples of other agencies |
||
|
|
||
| For additional reference, the [tests directory](../schemas/tests) contain unit tests of code.json files from various DSACMS repositories. These tests help ensure consistency and compliance as we make future updates to the schemas. | ||
|
|
||
| We encourage you to review these examples and tests when creating or updating your repository-level code.json file to maintain consistency with federal standards. | ||
|
|
||
| ## Example 1: [DedupliFHIR](https://github.com/DSACMS/dedupliFHIR) | ||
|
|
||
| DedupliFHIR is a desktop app tool that uses AI deduplication to identify duplicates in patient records. It is a [tier 3](https://github.com/DSACMS/repo-scaffolder/blob/dev/maturity-model-tiers.md#tier-information) project launched in production that receives user input. | ||
|
|
||
| ``` | ||
| { | ||
| "name": "dedupliFHIR", | ||
| "description": "Prototype for basic deduplication and aggregation of eCQM data", | ||
| "longDescription": "A CLI bundled with an electron front-end that provides data-linkage and AI deduplication for reported ACO data at scale.", | ||
| "status": "Production", | ||
| "permissions": { | ||
| "license": [ | ||
| { | ||
| "name": "CC0 1.0 Universal", | ||
| "URL": "https://github.com/DSACMS/dedupliFHIR/blob/main/LICENSE" | ||
| } | ||
| ], | ||
| "usageType": "openSource", | ||
| "exemptionText": "" | ||
| }, | ||
| "organization": "Centers for Medicare & Medicaid Services", | ||
| "repositoryURL": "https://github.com/DSACMS/dedupliFHIR", | ||
| "projectURL": "", | ||
|
natalialuzuriaga marked this conversation as resolved.
|
||
| "repositoryHost": "github.com/DSACMS", | ||
| "repositoryVisibility": "public", | ||
| "vcs": "git", | ||
| "laborHours": 4271, | ||
| "reuseFrequency": { | ||
| "forks": 3, | ||
| "clones": 0 | ||
| }, | ||
| "platforms": [ | ||
| "windows", | ||
| "mac", | ||
| "linux" | ||
| ], | ||
| "categories": [ | ||
| "data-analytics", | ||
| "application-development", | ||
| "data-collection" | ||
| ], | ||
| "softwareType": "standalone/desktop", | ||
| "languages": [ | ||
| "Python", | ||
| "JavaScript", | ||
| "HTML", | ||
| "CSS", | ||
| "Shell", | ||
| "Makefile" | ||
| ], | ||
| "maintenance": "internal", | ||
| "contractNumber": [], | ||
| "date": { | ||
| "created": "2023-06-22T17:08:19Z", | ||
| "lastModified": "2025-02-13T18:44:26Z", | ||
| "metaDataLastUpdated": "2025-06-10T14:55:32.836Z" | ||
| }, | ||
| "tags": [ | ||
| "AI", | ||
| "deduplication", | ||
| "data", | ||
| "ACA", | ||
| "FHIR", | ||
| "featured" | ||
| ], | ||
| "contact": { | ||
| "email": "opensource@cms.hhs.gov", | ||
| "name": "CMS Open Source Team" | ||
| }, | ||
| "feedbackMechanisms": "https://github.com/DSACMS/dedupliFHIR/issues", | ||
| "AIUseCaseID": "0", | ||
| "localisation": false, | ||
| "repositoryType": "application", | ||
| "userInput": "true", | ||
| "fismaLevel": "Moderate", | ||
| "group": "CMS/OA/DSAC", | ||
| "projects": [], | ||
| "systems": [], | ||
| "upstream": "https://github.com/DSACMS/dedupliFHIR/network/dependencies", | ||
| "subsetInHealthcare": [ | ||
| "Operational" | ||
| ], | ||
| "userType": [ | ||
| "Providers" | ||
| ], | ||
| "maturityModelTier": "3" | ||
| } | ||
| ``` | ||
| Link to code.json file: [codejson-example-dedupliFHIR.json](https://github.com/DSACMS/gov-codejson/blob/main/tests/examples/codejson-example-dedupliFHIR.json) | ||
|
|
||
| ## Example 2: [CMS Metrics Website](https://github.com/DSACMS/metrics) | ||
|
|
||
| The CMS Metrics Website is a [tier 3](https://github.com/DSACMS/repo-scaffolder/blob/dev/maturity-model-tiers.md#tier-information) project where government employees can view repository metrics on CMS open source projects, currently maintained by the CMS OSPO. | ||
|
|
||
| ``` | ||
| { | ||
| "name": "metrics", | ||
| "description": "CMS Open Source Repository Metrics Website", | ||
| "longDescription": "The CMS Repository Metrics Website shows an overview of software development activity across open source projects within a specified organization. It is designed for developers and program managers interested in monitoring health and activity of CMS open source repositories.", | ||
| "status": "Production", | ||
| "permissions": { | ||
| "license": [ | ||
| { | ||
| "name": "CC0 1.0 Universal", | ||
| "URL": "https://github.com/DSACMS/metrics/blob/main/LICENSE.md" | ||
| } | ||
| ], | ||
| "usageType": "openSource", | ||
| "exemptionText": "" | ||
| }, | ||
| "organization": "Centers for Medicare & Medicaid Services", | ||
| "repositoryURL": "https://github.com/DSACMS/metrics", | ||
| "projectURL": "https://dsacms.github.io/metrics/", | ||
| "repositoryHost": "github.com/DSACMS", | ||
| "repositoryVisibility": "public", | ||
| "vcs": "git", | ||
| "laborHours": 20722, | ||
| "reuseFrequency": { | ||
| "forks": 4, | ||
| "clones": 0 | ||
| }, | ||
| "platforms": [ | ||
| "web" | ||
| ], | ||
| "categories": [ | ||
| "data-visualization", | ||
| "data-analytics" | ||
| ], | ||
| "softwareType": "standalone/web", | ||
| "languages": [ | ||
| "Liquid", | ||
| "JavaScript", | ||
| "CSS", | ||
| "Python", | ||
| "Shell" | ||
| ], | ||
| "maintenance": "internal", | ||
| "contractNumber": [], | ||
| "date": { | ||
| "created": "2023-07-18T14:10:58Z", | ||
| "lastModified": "2025-06-01T11:36:12Z", | ||
| "metaDataLastUpdated": "2025-06-06T16:36:38.949Z" | ||
| }, | ||
| "tags": [ | ||
| "metrics", | ||
| "ospo", | ||
| "repository", | ||
| "featured" | ||
| ], | ||
| "contact": { | ||
| "email": "opensource@cms.hhs.gov", | ||
| "name": "CMS/OA/DSAC/OSPO" | ||
| }, | ||
| "feedbackMechanisms": "https://github.com/DSACMS/metrics/issues", | ||
| "AIUseCaseID": "0", | ||
| "localisation": false, | ||
| "repositoryType": "website", | ||
| "userInput": "No", | ||
| "fismaLevel": "Low", | ||
| "group": "CMS/OA/DSAC", | ||
| "projects": [], | ||
| "systems": [], | ||
| "upstream": "https://github.com/DSACMS/metrics/network/dependencies", | ||
| "subsetInHealthcare": [ | ||
| "Operational" | ||
| ], | ||
| "userType": [ | ||
| "Government" | ||
| ], | ||
| "maturityModelTier": 3 | ||
| } | ||
| ``` | ||
| Link to code.json file: [codejson-example-metrics.json](https://github.com/DSACMS/gov-codejson/blob/main/tests/examples/codejson-example-metrics.json) | ||
|
|
||
| ## Example 3: [gov-codejson](https://github.com/DSACMS/gov-codejson) | ||
|
|
||
| gov-codejson (this repository!) is a [tier 3](https://github.com/DSACMS/repo-scaffolder/blob/dev/maturity-model-tiers.md#tier-information) project containing documentation on the code.json metadata standard, currently maintained by the federal government community. | ||
|
|
||
| Link to code.json file: [code.json](https://github.com/DSACMS/gov-codejson/blob/main/code.json) | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| { | ||
| "target": "../schemas/cms/schema-0.2.0.json", | ||
| "$comment": "This test suite validates code.json files for compliance with the CMS schema requirements.", | ||
| "tests": [ | ||
| { | ||
| "description": "Example 1: DedupliFHIR", | ||
| "valid": true, | ||
| "dataPath": "./examples/codejson-example-dedupliFHIR.json" | ||
| }, | ||
| { | ||
| "description": "Example 2: metrics", | ||
| "valid": true, | ||
| "dataPath": "./examples/codejson-example-metrics.json" | ||
| }, | ||
| { | ||
| "description": "Example 3: gov-codejson", | ||
| "valid": true, | ||
| "dataPath": "../code.json" | ||
| } | ||
| ] | ||
| } |
Uh oh!
There was an error while loading. Please reload this page.