-
Notifications
You must be signed in to change notification settings - Fork 18
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
GITBOOK-870: change request with no subject merged in GitBook
- Loading branch information
1 parent
562bf47
commit 12787c9
Showing
45 changed files
with
156 additions
and
67 deletions.
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
2 changes: 0 additions & 2 deletions
2
contribute/source-code/workflows/form-service/architecture.md
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,3 @@ | ||
# Issue tracker | ||
# Issue tracker/ Create Issue | ||
|
||
Link to issues in Issue tracker - [Link](https://project-sunbird.atlassian.net/jira/software/c/projects/ED/issues/?jql=project%20%3D%20%22ED%22%20AND%20type%20in%20standardIssueTypes\(\)%20ORDER%20BY%20created%20DESC) |
File renamed without changes.
File renamed without changes.
File renamed without changes.
2 changes: 1 addition & 1 deletion
2
...ce-code/architecture-component-diagram.md → use-1/source-code/sunbird-ed-architecture.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,4 @@ | ||
# Sunbird-ED Architecture | ||
# Architecture - Component Diagram | ||
|
||
## Architecuture | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
# Developer Guide | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
# Form service | ||
|
||
{% embed url="https://github.com/project-sunbird/sunbird-ext-framework" %} | ||
|
||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,26 @@ | ||
--- | ||
description: Sample API Reference for Form Service Used in ED Portal | ||
--- | ||
|
||
# API's | ||
|
||
|
||
|
||
## Sunbird-Forms | ||
|
||
This service is owned by Sunbird-ED Building Block. The CRUD API's are documented as part of the below API collection. | ||
|
||
What properties can be used as part of forum create & the details has updated in the below document itself. | ||
|
||
{% embed url="https://documenter.getpostman.com/view/25186239/2s93Y2TNAw" %} | ||
|
||
## **Sunbird ED Portal Postman Forms Config Documentation** | ||
|
||
This Postman Forms collection details about  | ||
|
||
* Configuring forms for the functional features used in the portal | ||
* The documentation of usage of each form API's in the portal. | ||
* Functional form configs with Sample Create and Read API's. | ||
*  Mandatory and Non-mandatory forms with impact. | ||
|
||
{% embed url="https://documenter.getpostman.com/view/25186239/2s946pXoZ2" %} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,44 @@ | ||
# Architecture | ||
|
||
<figure><img src="../../../../.gitbook/assets/Screenshot 2023-08-09 at 3.11.47 PM.png" alt=""><figcaption><p>Form Service Architecture</p></figcaption></figure> | ||
|
||
## From Service | ||
|
||
It's an extensible framework library to create a server side API endpoint.  | ||
|
||
### [EXT Framework Server](https://github.com/project-sunbird/sunbird-ext-framework/blob/master/server/README.md#plugin-lifecycle) | ||
|
||
During this phase, the framework tries to read the manifest.ts file under the plugin's home directory.  | ||
|
||
When it finds the manifest.ts file, it will register the plugin in the "plugin registry" and update the status of the plugin as REGISTERED. | ||
|
||
The framework tries to locate if any schema files are defined in the manifest.ts file. If the plugin has not defined any schema file, the framework would skip this step. | ||
|
||
If there are schema files, then it would try to create a schema(tables/index) on the corresponding database provided based on the schema definition | ||
|
||
### [Framework API /Route](https://github.com/project-sunbird/sunbird-ext-framework/blob/master/demo/plugins/FormService/server/routes.ts) | ||
|
||
During this phase, the framework tries to find `routes.ts` files under the plugin home directory. If the file is not found, the plugin fails to load.  | ||
|
||
The file should export a class named `Router`. The framework registers the routes(endpoint) defined for the plugin with the "prefix" defined in the `manifest.ts` file. | ||
|
||
### [Request Validator](https://github.com/project-sunbird/sunbird-ext-framework/blob/master/demo/plugins/FormService/server/RequestValidator/index.ts) | ||
|
||
During this phase, the framework will validate the request body that is requested by the client app. If the request doesn't have mandatory data or valid input it will throw the error in response. | ||
|
||
### [Server Method](https://github.com/project-sunbird/sunbird-ext-framework/blob/master/demo/plugins/FormService/server/server.ts) | ||
|
||
During this phase, the method retrieves data from a Cassandra database based on the provided query parameters.  | ||
|
||
It tries to find a matching record by gradually relaxing the constraints on the properties. Once a record is found or all attempts are exhausted, the retrieved data is processed and sent back as a response. | ||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
### | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
--- | ||
description: Cassandra database used in Form service | ||
--- | ||
|
||
# Data model | ||
|
||
|
||
|
||
| Column Name | Data Type | Description | Sample Data | | ||
| ------------------ | --------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ||
| id | string | Represents an API uniquely | api.form.create | | ||
| ver | string | Represents the version of the API which was used | 1.0 | | ||
| ts | integer | Represents the EPOCH (UTC) timestamp in milliseconds since EPOCH | 2023-04-13T11:04:52.333Z | | ||
| params | object | | <p>{</p><p> "resmsgid": "bb6c9650-5a04-44e8-9077-452ef7aa5cdf",</p><p> "msgid": "6f64bd31-cf55-4f80-9f13-d19a799fe6fa",</p><p> "status": "successful"</p><p> }</p> | | ||
| msgid | string | Represents the unique ID of the message being sent | 6f64bd31-cf55-4f80-9f13-d19a799fe6fa | | ||
| did | string | Represents the device UUID from which API is called | bb6c9650-5a04-44e8-9077-452ef7aa5cdf | | ||
| type\* | varchar | Represents the type of form being created | content, user, forum, app, program-dashboard, config | | ||
| subtype\* | varchar | Represents the sub-category of form being created | course, collection, textbook, resource, login | | ||
| action\* | varchar | Represents the user action on the form | ilter, create, get, save, review , search | | ||
| component\* | varchar | Represents the consumption platform for the form | portal, mobile | | ||
| root\_org | varchar | Represents the form accesabilty to all (\*) or specific | \*, 123213232332323 | | ||
| framework | varchar | Represents the form accesabilty to all (\*) or specific | \*, 121324324274724 | | ||
| created\_on | timestamp | created time | 2023-04-13T11:08:21.260Z | | ||
| last\_modified\_on | timestamp | modified time | 2023-04-13T12:35:52.143Z | |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes.
File renamed without changes.
Oops, something went wrong.