Skip to content

docs(platform): add data-model page + DB configuration for praisonai-platform#254

Open
MervinPraison wants to merge 1 commit intomainfrom
claude/issue-251-20260424-1016
Open

docs(platform): add data-model page + DB configuration for praisonai-platform#254
MervinPraison wants to merge 1 commit intomainfrom
claude/issue-251-20260424-1016

Conversation

@MervinPraison
Copy link
Copy Markdown
Owner

Fixes #251

Summary

  • Creates comprehensive data-model.mdx page documenting the complete PraisonAI Platform database schema
  • Documents all 11 database entities with accurate column information from source code
  • Includes hero Mermaid ER diagram using standard color scheme
  • Adds database configuration section to getting-started guide
  • Updates platform index page with Data Model card
  • Registers new page in docs.json navigation

Key Features

  • Complete Schema Documentation: All 11 entities (User, Workspace, Member, Project, Issue, Comment, Agent, IssueLabel, IssueLabelLink, IssueDependency, ActivityLog)
  • Agent-Centric Examples: Copy-paste code examples showing real-world usage
  • Configuration Guide: DATABASE_URL options for SQLite and PostgreSQL
  • Best Practices: Accordion sections for common patterns and recommendations
  • Proper Navigation: Added to Platform features group in docs.json

Source Verification

All schema information was extracted directly from praisonai_platform/db/ source files including models.py, base.py, and deps.py for accurate documentation.

Generated with Claude Code

…platform (fixes #251)

- Add comprehensive data-model.mdx page with all 11 database entities
- Include Mermaid ER diagram with standard color scheme
- Document all configuration options and common patterns
- Update getting-started.mdx with database configuration section
- Update platform index.mdx with Data Model card
- Add page to docs.json navigation under Platform features

Co-authored-by: Mervin Praison <MervinPraison@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 24, 2026 10:19
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 24, 2026

Warning

Rate limit exceeded

@MervinPraison has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 57 minutes and 42 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 57 minutes and 42 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7b541694-7cdd-40a2-bb98-30df155ac525

📥 Commits

Reviewing files that changed from the base of the PR and between 9480b78 and d19a6f4.

📒 Files selected for processing (4)
  • docs.json
  • docs/features/platform/data-model.mdx
  • docs/guides/platform/getting-started.mdx
  • docs/guides/platform/index.mdx
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/issue-251-20260424-1016

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new 'Data Model' documentation page, detailing the database schema and configuration for the PraisonAI Platform, and integrates it into the existing documentation structure. I have reviewed the provided code snippet and suggest including the necessary imports and the FastAPI app initialization to improve the clarity and usability of the example for users.

Comment on lines +377 to +381
from fastapi import Depends
from praisonai_platform.api.deps import get_db

@app.get("/workspaces")
async def list_workspaces(session: AsyncSession = Depends(get_db)):
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The FastAPI code snippet is missing the import for AsyncSession and the initialization of the app object. Including these makes the example more robust and easier for users to follow.

from fastapi import FastAPI, Depends
from sqlalchemy.ext.asyncio import AsyncSession
from praisonai_platform.api.deps import get_db

app = FastAPI()

@app.get("/workspaces")
async def list_workspaces(session: AsyncSession = Depends(get_db)):

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(platform): add data-model page + DB configuration for praisonai-platform (tracks PraisonAI PR #1547)

2 participants