මොඩියුලය 14: හොඳම පිළිවෙත් සහ ව්‍යාපෘතිය (Best Practices & Project Work)

Angular කණ්ඩායම විසින්ම යෝජනා කරන ලද style guide එකක් ඇත. එය අනුගමනය කිරීමෙන් ඔබගේ කේතය වඩාත් කියවීමට පහසු, ස්ථාවර (consistent) සහ වෙනත් developers ලාට තේරුම් ගැනීමට පහසු වේ.

ප්‍රධාන කරුණු කිහිපයක්:

• File Naming: ගොනු නම් කිරීමේදී `feature.type.ts` රටාව අනුගමනය කරන්න (උදා: `hero-list.component.ts`, `auth.service.ts`).
• Single Responsibility Principle: සෑම ගොනුවකටම (component, service) එක් නිශ්චිත කාර්යයක් පමණක් තිබිය යුතුය.
• Selector Prefixes: Component selectors සඳහා පොදු prefix එකක් භාවිතා කරන්න (උදා: `app-` හෝ ඔබේ ආයතනයට/ව්‍යාපෘතියට අදාළ prefix එකක්).
• Lifecycle Hooks: Lifecycle hook methods, class එකේ properties සහ constructor එකෙන් පසුව පිළිවෙලට යොදන්න.

Official Angular Style Guide වෙත පිවිසෙන්න

යෙදුම විශාල වන විට, සියලුම components, services ආදිය `AppModule` එකට එකතු කිරීම කළමනාකරණය කිරීමට අපහසු වේ. එමනිසා, යෙදුම කුඩා, තාර්කික modules වලට කඩා වෙන් කිරීම (modularization) ඉතා වැදගත් වේ.

Core Module

යෙදුම ආරම්භයේදී එක් වරක් පමණක් load විය යුතු singleton services (උදා: `AuthService`, `LoggerService`) සහ යෙදුමටම පොදු වන components (උදා: `NavbarComponent`, `FooterComponent`) මෙහි අඩංගු වේ. `CoreModule` එක `AppModule` එකට පමණක් import කරයි.

Shared Module

යෙදුමේ විවිධ feature modules අතර බෙදාහදා ගන්නා components, directives, සහ pipes මෙහි අඩංගු වේ (උදා: `SpinnerComponent`, `CustomCardComponent`). `SharedModule` එක අවශ්‍ය ඕනෑම feature module එකකට import කළ හැක.

Feature Modules

යෙදුමේ නිශ්චිත ව්‍යාපාරික අංශයකට (business domain) අදාළ ක්‍රියාකාරීත්වය මෙහි අඩංගු වේ (උදා: `OrdersModule`, `ProductsModule`, `AdminModule`). මේවා බොහෝ විට Lazy Loading සමඟ භාවිතා කරයි.

• Clean Code: කියවීමට පහසු, තේරුම් ගැනීමට පහසු, සහ නඩත්තු කිරීමට පහසු වන පරිදි කේතය ලියන්න. අර්ථවත් variable නම් භාවිතා කරන්න. Functions කුඩාවට සහ එක් කාර්යයක් පමණක් කරන ලෙස ලියන්න.
• Error Handling: `HttpClient` Interceptors භාවිතයෙන් HTTP errors මධ්‍යගතව හැසිරවිය හැක. පරිශීලකයාට තේරුම් ගත හැකි දෝෂ පණිවිඩ (user-friendly error messages) පෙන්වන්න.
• Logging: යෙදුමේ සිදුවන දෝෂ සහ වැදගත් සිදුවීම් log කිරීමට logging service එකක් භාවිතා කරන්න.