177 lines
6.4 KiB
Markdown
177 lines
6.4 KiB
Markdown
# 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:
|
|
```diff
|
|
- [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)"
|
|
|
|
<!-- ## (dont do) Connected users api
|
|
- i will use this to separate server manager
|
|
- create a api for this
|
|
- flutter: use heartbeat package
|
|
- connected users, detects windows or android, users admin or teacher, username, ip, login time datenow, last seen datenow
|
|
- every minute
|
|
- in memory list users
|
|
- server status, cpu mem usage, connected users, uptime
|
|
- separate the connected users and status api -->
|
|
|
|
<!-- ## (dont do) backup/restore feature
|
|
- Use better sqlite 3 backup api, db.backup()
|
|
- Automatic backups (Daily, Weekly, Monthly, or Custom)
|
|
- Configurable maximum number of snapshots (e.g., 5, 10, 20)
|
|
- Timestamp-based backup names
|
|
- Backup history in the UI
|
|
- One-click restore
|
|
- Automatic deletion of the oldest snapshot only after the newest backup is successfully created and verified
|
|
- Metadata for version and backup details
|
|
- Use configuration file json for backup and restore
|
|
Files backup/restore - mirror mode or zip -->
|
|
|
|
<!-- ## settings screen
|
|
- add set start day, month and end year. month and day for the active year
|
|
- auto graduated the student that are grade 10 and grade 12 in the active year, make it sequential
|
|
- add logs for these make it on one log compiled all students, separate per grade level
|
|
- if not set the start day, month, end year, do not auto graduate
|
|
- remove database management, this is separate windows app -->
|
|
|
|
<!-- # reports screen
|
|
- exports use the custom success/error dialog
|
|
- add clickable link path for success
|
|
- fix the overflow cards of overall compliance, students with issues, total missing documents -->
|
|
|
|
<!-- ## backend server backup/restore
|
|
- do not use zip and unzip -->
|
|
|
|
<!-- # ANDROID APP
|
|
|
|
# DOCUMENT SCREEN
|
|
- add back prevention active multi select
|
|
- 1st back, deactivates multi select
|
|
- 2nd back, navigates to dashboard screen
|
|
- if the mutli select deactive
|
|
- 1st back, navigate to dashboard
|
|
|
|
- add back prevention inside student folder
|
|
- 1st back, navigates back folder 'Student Folders' tab
|
|
- 2nd back, navigates to dashboard screen
|
|
- if the open folder is not present
|
|
- 1st back, navigate to dashboard
|
|
|
|
# STUDENT SCREEN
|
|
- add back prevention active multi select
|
|
- 1st back, deactivates multi select
|
|
- 2nd back, navigates to dashboard screen
|
|
- if the mutli select deactive
|
|
- 1st back, navigate to dashboard
|
|
|
|
# ARCHIVES SCREEN
|
|
- add back prevention inside student folder
|
|
- 1st back, navigates back folder 'Student Folders' tab
|
|
- 2nd back, navigates to dashboard screen
|
|
- if the open folder is not present
|
|
- 1st back, navigate to dashboard -->
|
|
|
|
<!-- # DOCUMENTS SCREEN
|
|
1. apply dark mode
|
|
# ARCHIVES SCREEN
|
|
1. apply dark mode -->
|
|
|
|
|
|
<!-- - seach feature
|
|
- search icon into 'X' when searched an user, clears search and refresh users list
|
|
- fix searched field didnt hide when searched an user -->
|
|
|
|
<!-- # DOCUMENTS SCREEN
|
|
- copy file rename format remove the timestamp in the copied filename
|
|
- remove the feature: excel to pdf
|
|
|
|
# STUDENT SCREEN
|
|
1. edit student screen -> enrollments tab -> auto enrollment OCR:
|
|
- do not add in database if not 7-12 grade level detect
|
|
- add manual validation to add year level, grade level, section before saving to database
|
|
- in manual validation add actions accept, decline, or delete, use only icons.
|
|
- for icon only icons no container, no background, no border
|
|
- fix drag and drop not working in windows app
|
|
2. Add new student screen:
|
|
- fix drag and drop not working in windows app -->
|
|
|
|
|
|
<!-- # AUTO ENROLLMENT
|
|
- currently supports only SF9 and SF10
|
|
- SF9 is equal to report card, Form 138, School Form 9, Student Report Card, SF1 for JHS/SF9 for SHS
|
|
- SF10 is equal to School Form 10, Form 137, Form 137-A, Student Permanent Record -->
|
|
|
|
# STUDENTS SCREEN
|
|
- remove the count in school year and grade level in filter modal
|
|
|
|
|
|
---
|
|
|
|
# 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
|
|
|
|
|
|
|
|
---
|