Provincial Planning and Development Office (Philippines)
A modern web-based system for managing provincial planning, budgeting, and project tracking.
Built with Next.js 16, Convex, and Tailwind CSS. Designed for government use with role-based access control, real-time collaboration, and comprehensive reporting.
| Documentation | Description |
|---|---|
| 📊 Dashboard Docs | Main dashboard architecture, routing, modules |
| 🧩 Components Docs | Reusable component library documentation |
| 📁 Projects Module Docs | Detailed Projects module (Budget → Projects → Breakdowns → Details) |
| ⚡ PowerShell Automation | Automate deployment with push-staging command |
| 🚀 Setup Guide | Development & production setup instructions |
| File | Topic |
|---|---|
| POWERSHELL_AUTOMATION.md | PowerShell automation for deployment |
| SETUP_GUIDE.md | Development & production setup guide |
| File | Topic |
|---|---|
| README.md | Dashboard overview & quick start |
| 01-architecture-overview.md | System architecture & tech stack |
| 02-routing-structure.md | Route definitions & navigation |
| 03-layout-and-navigation.md | Sidebar, header, contexts |
| 04-module-projects.md | Projects module overview |
| 05-module-particulars.md | Particulars management |
| 06-module-funds.md | Trust Funds, SEF, SHF |
| 07-module-settings.md | User management & updates |
| 08-data-flow.md | Convex integration & data flow |
| 09-access-control.md | RBAC & permissions |
| 10-development-guide.md | Coding standards & patterns |
| File | Topic |
|---|---|
| README.md | Component library overview |
| 01-architecture-overview.md | Component architecture |
| 02-breakdown-components.md | Breakdown module components |
| 03-dashboard-components.md | Charts & dashboard UI |
| 04-projects-components.md | Projects table & forms |
| 05-funds-components.md | Funds management components |
| 06-table-components.md | Table system & print preview |
| 07-shared-components.md | Cross-module shared components |
| 08-static-components.md | Landing page components |
| 09-component-patterns.md | Design patterns & best practices |
| File | Topic |
|---|---|
| README.md | Projects module overview |
| 01-architecture-overview.md | 4-level hierarchy architecture |
| 02-route-structure.md | Route structure & navigation |
| 03-budget-items.md | Budget items (Level 1) |
| 04-projects-list.md | Projects list (Level 2) |
| 05-breakdowns-list.md | Breakdowns (Level 3) |
| 06-project-detail.md | Project detail tabs (Level 4) |
| 07-hooks-data-flow.md | Hooks & data flow |
| 08-print-system.md | Print preview & PDF generation |
- Node.js 18+
- npm or yarn
- Convex account
# Clone the repository
git clone https://github.com/your-org/ppdo-next.git
cd ppdo-next
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env.local
# Run development server
npm run dev# Set Convex environment
npx convex env set APP_ENV developmentWe follow Conventional Commits:
| Prefix | Use For |
|---|---|
feat: |
New features |
fix: |
Bug fixes |
docs: |
Documentation |
style: |
Code formatting |
refactor: |
Code restructuring |
perf: |
Performance improvements |
test: |
Tests |
build: |
Build system |
ci: |
CI/CD |
chore: |
Maintenance |
Example:
git commit -m "feat: add budget approval workflow"
git commit -m "docs: update API documentation"ppdo-next/
├── app/ # Next.js App Router
│ ├── (auth)/ # Auth routes (signin, signup)
│ ├── (dashboard)/ # Dashboard routes
│ │ ├── project/ # Projects module
│ │ ├── particulars/ # Particulars module
│ │ ├── trust-funds/ # Trust Funds module
│ │ ├── settings/ # Settings module
│ │ └── ...
│ └── page.tsx # Landing page
├── components/
│ ├── ppdo/ # PPDO-specific components
│ ├── ui/ # shadcn/ui components
│ ├── sidebar/ # Navigation sidebar
│ └── header/ # App header
├── convex/ # Backend (Convex)
│ ├── schema.ts # Database schema
│ ├── *.ts # Queries & mutations
│ └── lib/ # Shared backend code
├── lib/ # Utilities
├── types/ # TypeScript types
└── ...
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| UI Library | React 19 |
| Styling | Tailwind CSS 4 |
| Components | shadcn/ui + Radix UI |
| Backend | Convex (real-time database) |
| Auth | @convex-dev/auth |
| Forms | React Hook Form + Zod |
| Charts | Recharts |
| jsPDF | |
| Testing | Jest + React Testing Library |
This project is maintained by the PPDO Development Team:
- Product & Documentation Lead - Requirements & documentation
- Backend/Convex Architect - Database & API design
- Frontend/React Specialist - UI development
- UI/UX Designer - Design system & accessibility
- Security & Auth Specialist - Authentication & RBAC
- Data & Business Logic Engineer - Domain logic
- QA & Testing Agent - Quality assurance
- Print & Export Specialist - PDF & document generation
- DevOps & Performance Agent - Deployment & optimization
© 2026 Provincial Planning and Development Office. All rights reserved.
For detailed documentation, see the Developer Docs Index above.