Merge pull request #74 from Callgent/blog

Blog

Author: dev-callgent

.env.example

@@ -2,6 +2,7 @@
 
 # Set the production url of your site here
 SITE_URL=http://localhost:3030
+APP_URL=http://localhost:8000
 SITE_BASE_PATH=/
 SITE_SIGNUP_URL=http://localhost:3030/signup
 

blog/2024-03-16-nestjs+prisma-transaction-propagation-and-test-rollback-and-tenancy.md

@@ -170,10 +170,10 @@ RLS is only applicable in `postgreSQL`
 
 ### How to implement
 
-1. in `schema.prisma` file, set db column `tenant_id` default value to context variable `tenancy.tenantPk`,
+1. in `schema.prisma` file, set db column `tenant_id` default value to context variable `abac.tenantPk`,
 
    ```prisma
-   tenant_id Int  @default(dbgenerated("(current_setting('tenancy.tenantPk'))::int"))
+   tenant_id Int  @default(dbgenerated("(current_setting('abac.tenantPk'))::int"))
    ```
 
 2. enable postgres row level security(RLS), so that we can filter data by `tenant_id` automatically:
@@ -189,27 +189,27 @@ RLS is only applicable in `postgreSQL`
 4. extend `PrismaClient` to set `tenant_id` before any query, refer to [prisma-tenancy.provider.ts](https://github.com/Callgent/callgent-api/blob/main/src/infra/repo/tenancy/prisma-tenancy.provider.ts),
 
    ```sql
-   SELECT set_config('tenancy.tenantPk', cls.get('TENANT_ID') ...
+   SELECT set_config('abac.tenantPk', cls.get('TENANT_ID') ...
    ```
 
 5. if you want to bypass rls, for example, by admin, or looking up the logon user to determine their tenant ID:
 
    ```sql
-   CREATE POLICY bypass_rls_policy ON "User" USING (current_setting('tenancy.bypass_rls', TRUE)::text = 'on');
+   CREATE POLICY bypass_rls_policy ON "User" USING (current_setting('abac.bypass_rls', TRUE)::text = 'on');
    ```
 
-   then when you want to bypass rls, you must set `tenancy.bypass_rls` to `on` before running the query, refer to [prisma-tenancy.service.ts](https://github.com/Callgent/callgent-api/blob/main/src/infra/repo/tenancy/prisma-tenancy.service.ts),
+   then when you want to bypass rls, you must set `abac.bypass_rls` to `on` before running the query, refer to [prisma-tenancy.service.ts](https://github.com/Callgent/callgent-api/blob/main/src/infra/repo/tenancy/prisma-tenancy.service.ts),
 
    ```js
-   await prisma.$executeRaw`SELECT set_config('tenancy.bypass_rls', 'on', TRUE)`;
+   await prisma.$executeRaw`SELECT set_config('abac.bypass_rls', 'on', TRUE)`;
    ```
 
 ### how it works
 
 1. `tenantPk` is set into `cls` context on each request from current user.
-2. `PrismaClient` is extended on `$allOperations` to set `tenantPk` into db variable `tenancy.tenantPk` before any query.
-3. postgreSQL RLS is enabled, so that all queries will be filtered by `tenancy.tenantPk` automatically.
-4. on db `insert` operation, `tenancy.tenantPk` is set into `tenant_id` column as default value.
+2. `PrismaClient` is extended on `$allOperations` to set `tenantPk` into db variable `abac.tenantPk` before any query.
+3. postgreSQL RLS is enabled, so that all queries will be filtered by `abac.tenantPk` automatically.
+4. on db `insert` operation, `abac.tenantPk` is set into `tenant_id` column as default value.
 
 ## Integrate them all
 

docs/quick-start/pricing.mdx

@@ -0,0 +1,84 @@
+---
+sidebar_position: 5  
+tags: [Demo, Getting Started, Monetization]
+---
+
+# Easily Monetize with Callgent
+
+Callgent offers simple and flexible monetization options! With just a few minutes of configuration, your Callgent can start generating revenue!
+
+## 🚀 Start Monetizing in 3 Easy Steps
+
+:::tip
+This article assumes you already know [how to create a Callgent](/docs/quick-start/create-a-new-callgent)
+:::
+
+import SelectCallgent from "@site/src/components/module/select-callgent"
+import Publish from "@site/src/components/quick-start/publish"
+
+### 1. Select Your Callgent
+
+<pre>
+<SelectCallgent />
+</pre>
+
+### 2. Configure Authentication  
+Set up authentication to ensure service security and specify who pays for the request. Different types of locks indicate different roles.
+
+**Client Entries**: Used for identity verification. If the lock is open, the creator pays; if closed, the caller pays by default. Of cause you may specify a fixed payer.
+
+**Service Adaptors**: Indicate how the current request will be charged.
+
+![Authentication Setup](/img/tutorials/auth.jpg)
+
+## 💸 Flexible Pricing Models
+
+![Pricing Options](/img/tutorials/pricing.jpg)
+
+### Option 1: Per-Call Billing (Ideal for Beginners)  
+Charge a fixed amount per API call. Suitable for standardized services.
+
+- **Use Case**: Fixed, predictable query services  
+- **Example**: $0.01 per call  
+- **How to Set**: Simply input the amount in the pricing field
+
+### Option 2: Per-Token Billing (Great for Content Services)  
+Charge based on token usage. Best for dynamic content services like text generation or translation.
+
+- **Use Case**: Services with variable-length output  
+- **Example Code**:
+```javascript
+// Charge $0.0002 per token
+function calcPrice(req) {
+  return req.tokenUsage * 0.0002;
+}
+```
+
+### 3. Enable Monetization  
+In Figure 1 **test**, find the newly imported API. Click the lock icon, choose your authentication method, and confirm the lock is closed to complete the setup.  
+<a href="/solutions/showcase/user-as-a-service/service-design" target="_blank">How to import an API?</a>
+
+## 🔗 Test Your Monetized Callgent  
+Once setup is complete, you can <Publish name='publish' /> your Callgent service for users to call. 
+
+Learn more: [Call the Callgent](/docs/quick-start/call-the-callgent)
+
+## 🌟 Benefits of Monetizing with Callgent
+
+- **Zero Coding Required**: Start monetizing without writing any code  
+- **Instant Activation**: Monetization takes effect immediately upon setup  
+- **Full Transparency**: Users can clearly see the cost breakdown  
+- **Flexible Options**: Choose the billing method that best fits your service
+- **[Transaction Details](/redirect?app=billing)**: View your income and expense records
+
+![Transaction Details](/img/tutorials/billing.png)
+
+## 🎉 Start Your Monetization Journey Today!  
+With Callgent's powerful monetization tools, turn your AI agent into a revenue-generating machine. Get started now! 🚀
+
+
+The next step is how to promote my cg service based on the interface/tag on the hub.
+
+:::success  
+How to promote my CG service on the hub based on interface or tag.  
+:::

docusaurus.config.ts

@@ -17,6 +17,8 @@ const config: Config = {
     signupUrl: process.env.SITE_SIGNUP_URL,
     apiSiteUrl: process.env.API_SITE_URL,
     cookieDomain: process.env.SITE_URL_DOMAIN,
+    siteUrl: process.env.SITE_URL,
+    appUrl: process.env.APP_URL,
   },
 
   // Set the production url of your site here