TIS_RMS/frontend/AGENTS.md

BACKEND WORKFLOW (F:\SumbrerongBato\tis_rms_server\backend)

1. Read/Analyze Task → Inspect backend directory.
2. Draft Code → Execute Quality Gate (Accept / Decline).
3. Post-Code Loop: Analyze Errors → Resolve → Re-verify until Errors == 0.
4. Terminal Exit: If build clean → Execute git push.

FRONTEND WORKFLOW (F:\SumbrerongBato\tis_rms_server\frontend)

1. Read/Analyze Task → Inspect frontend directory.
2. Draft Components/Logic → Execute Quality Gate (Accept / Decline).
3. Post-Code Loop: Analyze UI/Build Errors → Resolve → Re-verify until Errors == 0.
4. Terminal Exit: If build clean & lint passes → Execute git push.

---

⚡️ TOKEN COMPRESSION PROTOCOL

1. INPUT RESTRICTIONS (CONTEXT DRYING)

• Ignore system-level file-tree re-reads unless files change (Δ).
• Avoid parsing historical chat history beyond the immediate code break.
• Reference internal libraries by name only; do not request full source mappings.

2. OUTPUT SYSTEM CONSTRAINTS (ZERO BLOAT)

• NO natural language intros, greetings, or conversational transitions.
• NO explanations, rationales, or "why this works" breakdowns.
• NO summaries of work completed or code recap commentary.
• Exclude all code comments, inline documentation, and docstrings.

3. PATCH FORMATTING (MICRO-DIFFS ONLY)

• BANNED: Full-file reprinting, multi-line blocks of unchanged code.
• MANDATORY: Return micro-diff format or target lines replacement only:

  - [old line]
  + [new line]
  

• If a file creation is required, generate minimal skeleton logic only.

4. QUOTA BRAKING

• Max output limit per prompt turn = 150 tokens.
• If patch logic requires >150 tokens: STOP, emit [TOKEN LIMIT BRAKE], and wait for chunked instructions.

---

📱 FLUTTER UI/UX RULES

• Stack: Flutter (latest) + Riverpod (AsyncNotifier/Notifier) + Material 3 (useMaterial3: true).
• Palette: Use existing Theme.of(context).colorScheme tokens only. Never hardcode hex values.
• Layout: Stack actions vertically on Android (Column with full-width ElevatedButton).
• Output: No design essays. Return optimized widget code immediately.

---

TODO

• dont do tasks with "(dont do)"

REPORT SCREEN

• deped transparency board -> remove the access and equity -> change the enrollment by sex & year to data on enrollment which compares the previous year students count and active year students count, difference, and remarks if increasing or decreasing, separate the jhs and shs

---

DONT DO

• make the admin side that resets user password send into their email the link to reset password add expiration time -> then push notif the admin that successful or not that email link, if not successful or the time has expired send notif to admin, if successfull push notif the user and admin

• teacher no assigned section theme color

• bug in bulk add student enrollment

• recycle bin -> search history not delete history

• add missing students by document type kpi

• notification separate admin and teacher

• bug in bulk add student enrollment

• report all filter and export

---

TIS_RMS Server Manager (dont do)

Windows Service - NSSM nodejs

• backup/restore db and files

• backup: database backup, automatic schedule, snapshot retention

• restore: restore database, validate backup, restart service automatically

• files: mirror backup, verify files, restore files,

• can choose where to store db and files separately

• dashboard: server status, cpu mem usage, connected users, uptime

• service: controls windows service stop start restart

• logs, server logs, error logs

• settings backup path, file backup path, database location

---

(dont do) add some features

• dark mode -> ongoing

---