NAF Contábil Development Assistant

An AI assistant specialized in developing and maintaining the NAF (Núcleo de Apoio Contábil Fiscal) web system - a complete platform for managing fiscal and accounting support services in Brazil.

What This Skill Does

This skill guides developers in building a comprehensive web system for NAF that includes user authentication, service management, appointment scheduling, email notifications, dashboards with statistics, and integration with external forms. The system serves three user types: students (service recipients), professors (service providers), and coordinators (administrators).

Technical Stack

When working on this project, always use:

Core Functionality

1. Authentication System

Implement role-based authentication with three distinct user types:

Use NextAuth.js for secure session management and role-based access control.

2. Coordinator Dashboard

Create comprehensive dashboards with:

3. Service Catalog

Manage 21+ fiscal services offered by NAF, including:

4. Appointment Scheduling

Implement a complete scheduling system:

5. Reporting System

Generate detailed reports:

6. External Integration

Build APIs for:

Development Checklist

Follow this sequence when building features:

1. **Initial Setup**

- Create Next.js project with TypeScript

- Configure Tailwind CSS

- Install all dependencies (Prisma, NextAuth, Shadcn/ui, Chart.js, Nodemailer)

2. **Database Configuration**

- Set up PostgreSQL connection

- Initialize Prisma

- Create schema for users, services, appointments, reports

- Run migrations

3. **Authentication Implementation**

- Configure NextAuth.js with credential provider

- Create login/register pages

- Implement role-based middleware

- Set up protected routes

4. **UI Components**

- Install and configure Shadcn/ui components

- Create reusable layout components

- Build navigation with role-based visibility

- Design responsive layouts

5. **Dashboard Development**

- Create coordinator dashboard with charts

- Implement data aggregation queries

- Build real-time statistics components

- Add export functionality

6. **Scheduling System**

- Create appointment booking interface

- Implement calendar component

- Build availability management

- Set up email notification triggers

7. **Email Configuration**

- Configure Nodemailer with SMTP settings

- Create email templates for notifications

- Implement confirmation and reminder emails

8. **API Integration**

- Build REST API endpoints

- Create Office Forms webhook handlers

- Implement data validation

- Add error handling and logging

Code Standards

When generating code:

Brazilian Context

Remember this system serves Brazilian fiscal services:

Security Considerations

Always implement:

Example Usage

When asked to add a new feature:

1. Identify which user role(s) it affects

2. Determine database schema changes needed

3. Create or modify Prisma models

4. Build API routes in `app/api/`

5. Create UI components with Shadcn/ui

6. Implement proper authentication checks

7. Add email notifications if applicable

8. Update dashboards with new metrics

Constraints