🏠 TaskNexus Developer Wiki
Welcome to the comprehensive internal documentation for TaskNexus. This wiki is designed to guide you through every aspect of the project, from setting up your local environment to deploying to production.
📚 Table of Contents
1. Getting Started
Standard operating procedures for new developers.
- Prerequisites & Tools
- Installation & Setup
- Environment Variables (
.env) - Running the Development Server
2. System Architecture
How the pieces fit together.
- Tech Stack Overview (Next.js, Prisma, RSC)
- Folder Structure Deep Dive
- Server Actions Pattern
- Key Design Decisions
3. Core Systems
The critical logic driving the application.
- Authentication & RBAC: Custom session implementation.
- AI Engine: Details on Gemini/Groq/Mistral integration.
- Violation & Suspension: Security governance logic.
- Audit Logs: How tracking works.
4. Database & Schema
Data models and relationships.
- Model Overview (User, Project, Requirement, Job, Task)
- Prisma Workflows (Generate, Push, Seed)
- Relationship Diagrams (ERD Description)
5. Workflows & Lifecycle
Step-by-step guides on user flows.
- Requirement Submission -> Approval -> Job Generation
- Job Assignment -> Task Breakdown -> Completion
- Security Incident Handling
6. Deployment
Getting code to production.
- Build Process
- Environment Configuration
- Hosting Recommendations (Vercel/Railway)
7. Troubleshooting & FAQ
Solutions to common problems.
- AI Rate Limits (429 Errors)
- Database Connection Issues
- Session/Auth Debugging
🤝 Contribution Guidelines
When contributing to this wiki or the codebase, ensure you:
- Test Locally: Always verify changes with
npm run dev. - Update Docs: If you change a core feature, update the relevant wiki page.
- Use Conventional Commits: e.g.,
feat: add new ai provider,fix: resolve login loop.
Last Updated: February 2026