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)"

CSV BULK IMPORT ENHANCEMENTS

• bulk student import (add bulk student modal / screen):
  • add on-screen CSV format example & template guide (headers: LRN, First Name, Middle Name, Last Name, Extension, Sex, Birth Date, 4Ps)
  • add live type / paste CSV input area with "Parse & Preview" to submit directly without needing a separate file
  • validation table / live preview showing valid rows and detected errors before confirming bulk import
• academic & sections setup (teachers & academic setup screen):
  • add bulk CSV import for academic structure:
    • format: Academic Year, Grade Level, Section Name (e.g., 2024-2025, 10, Diamond)
  • add on-screen CSV format example / reference & sample rows
  • add live type / paste CSV input area with instant parse, validation preview, and bulk submit

---

DONT DO

• print list history, print email to the student make it optional, add date of print, add status (done, not done, in progress, picked up), add message to email can be manual message typed by registrar/staff,

• 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

---